跳至内容
技术分享
站点工具
工具
显示页面
修订记录
反向链接
最近更改
媒体管理器
网站地图
登录
>
最近更改
媒体管理器
网站地图
登录
搜索
您的足迹:
服务器技术:微服务:基于maven的springboot_mybatis_druid_swagger2_mybatis-generator框架环境搭建
本页面只读。您可以查看源文件,但不能更改它。如果您觉得这是系统错误,请联系管理员。
<h4 style="">前言</h4><p style="">最近做回后台开发,重新抓起以前学过的SSM(Spring+Spring MVC+Mybatis),但是发现配置实在过于复杂,好多东西配置起来麻烦,虽然最终是配置出来了,但是还是感觉开发速度跟不上,本来打算切换到jfianl,但是后来发现需要用的几个框架不支持jfianl,如Swagger2(根据代码中的注解生成接口文档和测试页面,非常的方便);同时我也不愿意放弃SpringMVC强大的验证参数模块,jfianl中好像只能手动验证(当然我对jfianl只处于简单的开发,并不是特别熟),而SpringMVC中,直接就能通过注解来确定哪些参数是必须的,哪些不是必须的,这对于写接口的人来说,方便了很多,所以决定还是使用Spring家族的东西,下面先一一介绍下本文的主角们</p><h5 style=""><a target="_blank" href="http://projects.spring.io/spring-boot/" style="color:rgb(74,74,74); background:transparent">Spring boot</a></h5><p style="">spring-boot是由<a target="_blank" href="https://pivotal.io/" style="color:rgb(74,74,74); background:transparent">Pivotal</a>团队提供的全新框架,其设计目的是用来简化新Spring应用的初始搭建以及开发过程。该框架使用了特定的方式来进行配置,从而使开发人员不再需要定义样板化的配置。通过这种方式,Boot致力于在蓬勃发展的快速应用开发领域(rapid application development)成为领导者</p><p style="">多年以来,<a target="_blank" href="http://spring.io/" style="color:rgb(74,74,74); background:transparent">Spring IO</a>平台饱受非议的一点就是大量的XML配置以及复杂的依赖管理。在2013年的<a target="_blank" href="https://www.youtube.com/watch?v=jplkJIHPGos" style="color:rgb(74,74,74); background:transparent">SpringOne 2GX</a>会议上,Pivotal的CTO Adrian Colyer回应了这些批评,并且特别提到该平台将来的目标之一就是实现免XML配置的开发体验。Boot所实现的功能超出了这个任务的描述,开发人员不仅不再需要编写XML,而且在一些场景中甚至不需要编写繁琐的import语句。在对外公开的beta版本刚刚发布之时,Boot描述了如何使用该框架在140个字符内实现可运行的web应用,从而获得了极大的关注度,该样例发表在<a target="_blank" href="https://twitter.com/rob_winch/status/364871658483351552" style="color:rgb(74,74,74); background:transparent">tweet</a>上</p><p style="">当然上面又是我抄过来的,因为我觉得要我去介绍一个框架是什么的时候,我只会说我的理解,但是我的理解不能让大家知道它的背景,所以抄了上面那段,那么下面就是我理解的Spring boot是个什么东西</p><p style=""><span style="font-weight:700">无需繁琐配置的Spring集合包</span> Spring boot本身并不是什么新的框架,它可以说只是Spring大家族的一个集合包,当然这个集合包吧基础的配置都给我配置好了,我们无需再进行繁琐的xml配置,甚至是都不用配置web.xml,因为spring boot内部自己集成了一个tomcat,直接通过run的方式就能启动,打包也一样,都可以不用部署tomcat了,当然是针对小项目,大项目肯定是要对中间件进行一些优化的</p><h5 style=""><a target="_blank" href="https://github.com/mybatis/mybatis-3" style="color:rgb(74,74,74); background:transparent">Mybatis</a></h5><p style="">MyBatis是一个支持普通SQL查询,存储过程和高级映射的优秀持久层框架。MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及对结果集的检索封装。MyBatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java的POJO(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录。当然我个人更倾向用注解,因为实在是不怎么喜欢配置xml,尤其是eclipse经常因为xml的一些问题卡主,导致编译要等xml验证通过后才能编译,而我用Mybatis最主要的地方就是因为不用像JDBC那样自己一个属性一个属性来赋值</p><h5 style=""><a target="_blank" href="https://github.com/alibaba/druid" style="color:rgb(74,74,74); background:transparent">Druid</a></h5><p style="">Druid是一个JDBC组件,它包括三部分:</p><p style="">DruidDriver 代理Driver,能够提供基于Filter-Chain模式的插件体系。 <br/>DruidDataSource 高效可管理的数据库连接池。 <br/>SQLParser <br/>Druid可以做什么?</p><p style="">1) 可以监控数据库访问性能,Druid内置提供了一个功能强大的StatFilter插件,能够详细统计SQL的执行性能,这对于线上分析数据库访问性能有帮助。</p><p style="">2) 替换DBCP和C3P0。Druid提供了一个高效、功能强大、可扩展性好的数据库连接池。</p><p style="">3) 数据库密码加密。直接把数据库密码写在配置文件中,这是不好的行为,容易导致安全问题。DruidDruiver和DruidDataSource都支持PasswordCallback。</p><p style="">4) SQL执行日志,Druid提供了不同的LogFilter,能够支持Common-Logging、Log4j和JdkLog,你可以按需要选择相应的LogFilter,监控你应用的数据库访问情况。</p><p style="">扩展JDBC,如果你要对JDBC层有编程的需求,可以通过Druid提供的Filter-Chain机制,很方便编写JDBC层的扩展插件。</p><p style="">其实说简单点Druid就是一个<span style="font-weight:700">功能强大,性能优秀的数据库连接池</span>,是由阿里巴巴的大牛们开发的,除了性能好之外,我最喜欢的就是它的监控功能了,连github上的说明都是“为监控而生的数据库连接池!”</p><h5 style=""><a target="_blank" href="http://swagger.io/" style="color:rgb(74,74,74); background:transparent">Swagger2</a></h5><p style="">关于<a target="_blank" href="http://www.raye.wang/2016/09/29/swaggerhuan-jing-da-jian-zhi-fei-yi-lai-dai-ma-fa/" style="color:rgb(74,74,74); background:transparent">Swagger的介绍和非代码搭建</a>,在之前的文章已经说过了,不过这里的Swagger2只是版本号为2而已,很多核心的东西都没怎么变化,当然如果不用和代码封装在一起,也可以参考<a target="_blank" href="http://www.raye.wang/2016/09/29/swaggerhuan-jing-da-jian-zhi-fei-yi-lai-dai-ma-fa/" style="color:rgb(74,74,74); background:transparent">Swagger的介绍和非代码搭建</a>,不过本文主要讲述在代码中集成,所以不再过多描述</p><h5 style=""><a target="_blank" href="http://www.mybatis.org/generator/" style="color:rgb(74,74,74); background:transparent">mybatis-generator</a></h5><p style="">mybatis-generator是用来根据数据自动生成实体bean和一些常规查询语句的插件,有了这个就不用再一个一个实体bean来写了,而且普通的查询也可以使用自动生成sql语句查询出来</p><h4 style="">开始搭建</h4><h5 style="">一、创建项目</h5><p style="">首先创建一个maven项目,当然最好创建maven-archetype-webapp,原因无他,主要是因为很多时候我还是需要把项目部署到优化过配置的tomcat获取其他容器中,当然也可以创建普通的maven项目</p><h5 style="">二、添加依赖</h5><p>XML</p><pre class=" language-xml" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)"><!-- Springboot --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-jdbc</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-aop</artifactId> </dependency> <!-- Springboot 热部署 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> <optional>true</optional> </dependency> <!-- Swagger API文档 --> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.2.2</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.2.2</version> </dependency> <!-- Mybatis --> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>1.1.1</version> </dependency> <!-- druid阿里巴巴数据库连接池 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.0.26</version> </dependency> <!-- MySql数据库驱动 --> <dependency> <groupId> mysql</groupId> <artifactId> mysql-connector-java</artifactId> <version> 5.0.5</version> </dependency></pre><p style="">其中spring-boot-devtools不是必须,只是如果你想在运行的时候,修改了代码能自动更新,而不用手动重启,就需要加上</p><h5 style="">三、添加Applcation类</h5><p style="">这个就是程序的入口类了,代码如下</p><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">package wang.raye.springboot;import org.mybatis.spring.annotation.MapperScan;import org.springframework.boot.SpringApplication;import org.springframework.boot.autoconfigure.SpringBootApplication;import org.springframework.boot.web.servlet.ServletComponentScan;import org.springframework.boot.web.support.SpringBootServletInitializer;/** * * * @author Raye * @since 2016年10月9日22:22:31 */@MapperScan("wang.raye.springboot.model.mapper")@SpringBootApplication@ServletComponentScanpublic class Application extends SpringBootServletInitializer { public static void main(String[] args) { SpringApplication.run(Application.class); }}</pre><p style="">想要运行项目时可以直接运行此类就可以,如你所见,其中有main方法,所以可以直接运行</p><p style="">下面说说3个注解的含义</p><p style=""><span style="font-weight:700">@MapperScan("wang.raye.springboot.model.mapper")</span>,扫描wang.raye.springboot.model.mapper下面的mapper接口,其中mapper下面的接口是由mybatis-generator自动生成的,会在后面细说,现在就先知道是个什么东西就行了 <span style="font-weight:700">@SpringBootApplication</span>很多Spring Boot开发者总是使用 @Configuration , @EnableAutoConfiguration 和 @ComponentScan 注解他们的main类。由于这些注解被如此频繁地一块使用(特别是你遵循以上最佳实践时),Spring Boot提供一个方便的 @SpringBootApplication 选择。该 @SpringBootApplication 注解等价于以默认属性使用 @Configuration , @EnableAutoConfiguration 和 @ComponentScan</p><p style=""><span style="font-weight:700">@ServletComponentScan</span>有此注解后,项目中如果需要使用java原生的servlet和filter,可以在类中使用注解实现,主要是配置Druid监控时需要用到</p><h5 style="">四、创建配置文件</h5><p style="">虽然spring boot可以不用配置xml,但是也并不是完全不需要配置文件,当然不用配置文件也能跑起来,只是有配置文件我们可以配置很多东西,只是不用像以前xml那么麻烦,首先需要在resource文件夹下面创建application.yml文件</p><pre class=" language-yml" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">server: port: 80 spring: application: name: admin-managee datasource: url: jdbc:mysql://192.168.157.133:3306/springboot username: raye password: 123456 driver-class-name: com.mysql.jdbc.Driver type: com.alibaba.druid.pool.DruidDataSource druid: max-active: 20 initial-size: 1 min-idle: 3 max-wait: 60000 time-between-eviction-runs-millis: 60000 min-evictable-idle-time-millis: 300000 test-while-idle: true test-on-borrow: false test-on-return: false debug: true</pre><p style="">相信这个文件很容易看懂,首先server:下面的port:80这个是定义了运行的端口,之前说过spring boot内置了tomcat服务器,所以如果要使用内置的tomcat并且不想用8080端口,就需要在这里配置</p><p style="">下面就是datasource的配置,这样不写进代码有个好处,那就是如果是给客户用的程序,可以很方便的修改数据库配置,而不用重新编译,当然如果你是打包jar我估计是要重新编译的,如果是war,那么就可以解压出来直接修改application.yml而不用重新编译了</p><p style="">而debug:true就是说明当时是调试状态,这样就会输出很多log</p><h5 style="">五、创建Druid数据源配置类</h5><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">package wang.raye.springboot.config;import java.sql.SQLException;import javax.sql.DataSource;import org.springframework.boot.bind.RelaxedPropertyResolver;import org.springframework.context.EnvironmentAware;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;import org.springframework.core.env.Environment;import org.springframework.transaction.annotation.EnableTransactionManagement;import com.alibaba.druid.pool.DruidDataSource;@Configuration@EnableTransactionManagement/** * Druid的DataResource配置类 * @author Raye * @since 2016年10月7日14:14:18 */public class DruidDataSourceConfig implements EnvironmentAware { private RelaxedPropertyResolver propertyResolver; public void setEnvironment(Environment env) { this.propertyResolver = new RelaxedPropertyResolver(env, "spring.datasource."); } @Bean public DataSource dataSource() { System.out.println("注入druid!!!"); DruidDataSource datasource = new DruidDataSource(); datasource.setUrl(propertyResolver.getProperty("url")); datasource.setDriverClassName(propertyResolver.getProperty("driver-class-name")); datasource.setUsername(propertyResolver.getProperty("username")); datasource.setPassword(propertyResolver.getProperty("password")); datasource.setInitialSize(Integer.valueOf(propertyResolver.getProperty("initial-size"))); datasource.setMinIdle(Integer.valueOf(propertyResolver.getProperty("min-idle"))); datasource.setMaxWait(Long.valueOf(propertyResolver.getProperty("max-wait"))); datasource.setMaxActive(Integer.valueOf(propertyResolver.getProperty("max-active"))); datasource.setMinEvictableIdleTimeMillis(Long.valueOf(propertyResolver.getProperty("min-evictable-idle-time-millis"))); try { datasource.setFilters("stat,wall"); } catch (SQLException e) { e.printStackTrace(); } return datasource; }}</pre><p style="">主要是创建一个druid的DruidDataSource 返回并告诉spring boot这是一个bean</p><h5 style="">六、创建Druid的监控servlet和filter</h5><p style=""><span style="font-weight:700">创建监控Servlet</span></p><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">package wang.raye.springboot.config;import javax.servlet.annotation.WebInitParam;import javax.servlet.annotation.WebServlet;import com.alibaba.druid.support.http.StatViewServlet;/** * Druid的Servlet * @author Raye * @since 2016年10月7日14:13:39 */@SuppressWarnings("serial")@WebServlet(urlPatterns = "/druid/*",initParams={ @WebInitParam(name="allow",value="127.0.0.1,192.168.1.126"),// IP白名单 (没有配置或者为空,则允许所有访问) @WebInitParam(name="deny",value="192.168.1.111"),// IP黑名单 (存在共同时,deny优先于allow) @WebInitParam(name="loginUsername",value="Raye"),// 用户名 @WebInitParam(name="loginPassword",value="123456"),// 密码 @WebInitParam(name="resetEnable",value="false")// 禁用HTML页面上的“Reset All”功能})public class DruidStatViewServlet extends StatViewServlet {}</pre><p style=""><span style="font-weight:700">@WebServlet</span>表明这是一个Servlet,和之前Application中的@ServletComponentScan相对应使用 <span style="font-weight:700">创建filter</span></p><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">package wang.raye.springboot.config;import javax.servlet.annotation.WebFilter;import javax.servlet.annotation.WebInitParam;import com.alibaba.druid.support.http.WebStatFilter;@WebFilter(filterName="druidWebStatFilter",urlPatterns="/*",initParams={ @WebInitParam(name="exclusions",value="*.js,*.gif,*.jpg,*.bmp,*.png,*.css,*.ico,/druid/*")// 忽略资源})/** * Druid拦截器,用于查看Druid监控 * @author Raye * @since 2016年10月7日14:59:27 */public class DruidStatFilter extends WebStatFilter {}</pre><p style="">同样<span style="font-weight:700">@WebFilter</span>表明此类是一个拦截器</p><p style="">创建好之后,我们访问<a target="_blank" href="http://localhost/druid/index.html,%E4%BC%9A%E8%87%AA%E5%8A%A8%E8%B7%B3%E5%88%B0http://localhost/druid/login.html%E7%99%BB%E5%BD%95%E9%A1%B5%E9%9D%A2%EF%BC%8C%E7%99%BB%E5%BD%95%E8%BF%9B%E5%8E%BB%E4%BC%9A%E5%87%BA%E7%8E%B0%E4%BB%A5%E4%B8%8B%E7%95%8C%E9%9D%A2" style="color:rgb(74,74,74); background:transparent">http://localhost/druid/index.html,会自动跳到http://localhost/druid/login.html登录页面,登录进去会出现以下界面</a><img src="https://img-blog.csdn.net/20160318172740791" alt="预览图"/></p><h5 style="">七、配置mybatis</h5><p style="">其实mybatis之前就已经配置好了,就是<span style="font-weight:700">Application</span>类的<span style="font-weight:700">@MapperScan("wang.raye.springboot.model.mapper")</span>注解,这个注解说明了要扫描的mybatis的mapper接口包,当然如果是用xml的话应该还需要其他配置,不过我个人并不喜欢用xml的方式,所以也没有怎么研究</p><h5 style="">八、配置mybatis-generator</h5><p style="">配置MyBatis-generator自动生成实体bean,首先需要在pom.xml中添加相关插件依赖,注:我是用插件的方式来生成实体bean的,</p><p>XML</p><pre class=" language-xml" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)"><build> <finalName>springboot</finalName> <plugins> <plugin> <groupId>org.mybatis.generator</groupId> <artifactId>mybatis-generator-maven-plugin</artifactId> <version>1.3.5</version> <dependencies> <!--数据库驱动 --> <dependency> <groupId> mysql</groupId> <artifactId> mysql-connector-java</artifactId> <version> 5.0.5</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>1.2.2</version> </dependency> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.2.4</version> </dependency> </dependencies> <executions> <execution> <id>Generate MyBatis Artifacts</id> <phase>package</phase> <goals> <goal>generate</goal> </goals> </execution> </executions> <configuration> <!--允许移动生成的文件 --> <verbose>true</verbose> <!-- 是否覆盖 --> <overwrite>true</overwrite> <!-- 自动生成的配置 --> <configurationFile> src/main/resources/mybatis-generator.xml</configurationFile> </configuration> </plugin> <plugin> <artifactId>maven-compiler-plugin</artifactId> <configuration> <encoding>UTF-8</encoding> <source>1.5</source> <target>1.5</target> </configuration> </plugin> </plugins> </build></pre><p style="">其中除了springboot是pom.xml默认的节点外,其他都是配置Mybatis-generator的,当然还有顶部的</p><p>XML</p><pre class=" language-xml" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)"><properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <entity.target.dir>src/main/java/</entity.target.dir> <dao.resources.dir>src/main/resources/</dao.resources.dir></properties></pre><p style="">这个是用来在<span style="font-weight:700">mybatis-generator.xml</span>中需要使用的</p><p style=""><span style="font-weight:700">下面开始配置mybatis-generator.xml</span> 首先在resource文件夹下面创建mybatis-generator.xml文件,然后添加如下配置</p><p>XML</p><pre class=" language-xml" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)"><?xml version="1.0" encoding="UTF-8"?><!DOCTYPE generatorConfiguration PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN" "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd"><generatorConfiguration> <context id="DB2Tables" targetRuntime="MyBatis3" defaultModelType="flat"> <plugin type="org.mybatis.generator.plugins.RenameExampleClassPlugin"> <property name="searchString" value="[e|E]xample$" /> <property name="replaceString" value="Criteria" /> </plugin> <commentGenerator> <property name="suppressDate" value="true" /> </commentGenerator> <jdbcConnection driverClass="com.mysql.jdbc.Driver" connectionURL="jdbc:mysql://192.168.157.133:3306/springboot" userId="root" password="1993316"> </jdbcConnection> <javaTypeResolver> <property name="forceBigDecimals" value="false" /> </javaTypeResolver> <!-- generate Model --> <javaModelGenerator targetPackage="wang.raye.springboot.model" targetProject="${entity.target.dir}"> <property name="enableSubPackages" value="true" /> <property name="trimStrings" value="true" /> </javaModelGenerator> <!-- 自动生成xml(但是好像一直没有生成功,反正也不用xml) --> <sqlMapGenerator targetPackage="wang.raye.springboot.model.mapper" targetProject="${dao.resources.dir}"> <property name="enableSubPackages" value="true" /> </sqlMapGenerator> <!-- 自动生成mapper接口, 可以是 ANNOTATEDMAPPER(注解), XMLMAPPER(xml), MIXEDMAPPER(不知道) --> <javaClientGenerator type="ANNOTATEDMAPPER" targetPackage="wang.raye.springboot.model.mapper" implementationPackage="wang.raye.springboot.model.mapper.impl" targetProject="${entity.target.dir}"> <property name="enableSubPackages" value="true" /> </javaClientGenerator> <table tableName="user" domainObjectName="User" ></table> </context></generatorConfiguration></pre><p style="">其实需要自己修改数据库配置,因为插件不会读取spring boot中的数据库配置,所以需要在mybatis-generator.xml中配置好数据库,同时也需要修改自己的包名</p><p style=""><span style="font-weight:700">table</span>节点中的tableName是指在数据库中的表名,domainObjectName是只生成的实体bean的类名,当然domainObjectName可以不用配置,会默认生成,当然如果有特殊需要可以配置</p><h5 style="">配置Swagger2</h5><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">package wang.raye.springboot;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;import springfox.documentation.builders.PathSelectors;import springfox.documentation.builders.RequestHandlerSelectors;import springfox.documentation.service.ApiInfo;import springfox.documentation.spi.DocumentationType;import springfox.documentation.spring.web.plugins.Docket;import springfox.documentation.swagger2.annotations.EnableSwagger2;import wang.raye.springboot.model.User;/** * SwaggerConfig */@Configuration@EnableSwagger2public class SwaggerConfig { /** * 可以定义多个组,比如本类中定义把test和demo区分开了 (访问页面就可以看到效果了) * */ @Bean public Docket testApi() { return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) .select() .apis(RequestHandlerSelectors.basePackage("wang.raye.springboot")) .paths(PathSelectors.any()).build(); } private ApiInfo apiInfo() { ApiInfo apiInfo = new ApiInfo("SpringBoot学习demo", // 大标题 "Spring boot + swagger + mybatis + druid", // 小标题 "1.0", // 版本 "NO terms of service", "admin@raye.wang", // 作者 "RayeBlog", // 链接显示文字 "http://www.raye.wang/"// 网站链接 ); return apiInfo; }}</pre><p style="">相信看代码很容易看懂,我就不多说了</p><h4 style="">编写demo</h4><p style="">至此,环境配置都配置好了,然后我创建一个简单的接口来添加用户,首先看看我的表结构</p><p>SQL</p><pre class=" language-sql" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">DROP TABLE IF EXISTS `user`;CREATE TABLE `user` ( `id` int(11) NOT NULL AUTO_INCREMENT, `username` varchar(30) NOT NULL, `psw` varchar(40) NOT NULL, PRIMARY KEY (`id`)) ENGINE=InnoDB AUTO_INCREMENT=0 DEFAULT CHARSET=utf8;</pre><p style="">因为只是做演示,所以非常简单,然后看我生成的User.java</p><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">package wang.raye.springboot.model;public class User { private Integer id; private String username; private String psw; public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getUsername() { return username; } public void setUsername(String username) { this.username = username == null ? null : username.trim(); } public String getPsw() { return psw; } public void setPsw(String psw) { this.psw = psw == null ? null : psw.trim(); }}</pre><p style="">当然我是删除了很多自动生成的注释,因为看着太烦,不适合在博客上展示,然后看看UserMapper.java</p><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">package wang.raye.springboot.model.mapper;import java.util.List;import org.apache.ibatis.annotations.Delete;import org.apache.ibatis.annotations.DeleteProvider;import org.apache.ibatis.annotations.Insert;import org.apache.ibatis.annotations.InsertProvider;import org.apache.ibatis.annotations.Param;import org.apache.ibatis.annotations.Result;import org.apache.ibatis.annotations.Results;import org.apache.ibatis.annotations.Select;import org.apache.ibatis.annotations.SelectProvider;import org.apache.ibatis.annotations.Update;import org.apache.ibatis.annotations.UpdateProvider;import org.apache.ibatis.type.JdbcType;import wang.raye.springboot.model.User;import wang.raye.springboot.model.UserCriteria;public interface UserMapper { @SelectProvider(type=UserSqlProvider.class, method="countByExample") long countByExample(UserCriteria example); @DeleteProvider(type=UserSqlProvider.class, method="deleteByExample") int deleteByExample(UserCriteria example); @Delete({ "delete from user", "where id = #{id,jdbcType=INTEGER}" }) int deleteByPrimaryKey(Integer id); @Insert({ "insert into user (id, username, ", "psw)", "values (#{id,jdbcType=INTEGER}, #{username,jdbcType=VARCHAR}, ", "#{psw,jdbcType=VARCHAR})" }) int insert(User record); @InsertProvider(type=UserSqlProvider.class, method="insertSelective") int insertSelective(User record); @SelectProvider(type=UserSqlProvider.class, method="selectByExample") @Results({ @Result(column="id", property="id", jdbcType=JdbcType.INTEGER, id=true), @Result(column="username", property="username", jdbcType=JdbcType.VARCHAR), @Result(column="psw", property="psw", jdbcType=JdbcType.VARCHAR) }) List<User> selectByExample(UserCriteria example); @Select({ "select", "id, username, psw", "from user", "where id = #{id,jdbcType=INTEGER}" }) @Results({ @Result(column="id", property="id", jdbcType=JdbcType.INTEGER, id=true), @Result(column="username", property="username", jdbcType=JdbcType.VARCHAR), @Result(column="psw", property="psw", jdbcType=JdbcType.VARCHAR) }) User selectByPrimaryKey(Integer id); @UpdateProvider(type=UserSqlProvider.class, method="updateByExampleSelective") int updateByExampleSelective(@Param("record") User record, @Param("example") UserCriteria example); @UpdateProvider(type=UserSqlProvider.class, method="updateByExample") int updateByExample(@Param("record") User record, @Param("example") UserCriteria example); @UpdateProvider(type=UserSqlProvider.class, method="updateByPrimaryKeySelective") int updateByPrimaryKeySelective(User record); @Update({ "update user", "set username = #{username,jdbcType=VARCHAR},", "psw = #{psw,jdbcType=VARCHAR}", "where id = #{id,jdbcType=INTEGER}" }) int updateByPrimaryKey(User record);}</pre><p style="">同样删除了注释,当然还会自动生成UserCriteria.java 和UserSqlProvider,这2个类主要用于模板查询,用过myBatis应该都知道,就不贴出来了,主要是我们的demo中也不会用到</p><h5 style="">一、创建UserServer接口</h5><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">package wang.raye.springboot.server;import java.util.List;import wang.raye.springboot.model.User;/** * 用户服务 * @author Raye * @since 2016年9月21日20:57:39 */public interface UserServer { /** * 添加一个用户 * @param user 用户对象 * @since 2016年9月21日20:58:17 * @return 是否添加成功 */ public boolean add(User user);}</pre><h5 style="">二、创建UserServerImpl</h5><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">package wang.raye.springboot.server.impl;import java.util.List;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.stereotype.Repository;import wang.raye.springboot.model.User;import wang.raye.springboot.model.mapper.UserMapper;import wang.raye.springboot.server.UserServer;/** * 用户相关数据库操作实现类 * @author Raye * @since 2016年10月11日19:29:02 */@Repositorypublic class UserServerImpl implements UserServer { @Autowired private UserMapper mapper; public boolean add(User user) { return mapper.insert(user) > 0; } public List<User> findAll() { return mapper.selectByExample(null); }}</pre><h5 style="">三、创建UserController</h5><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">package wang.raye.springboot.controller;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.web.bind.annotation.RequestBody;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;import io.swagger.annotations.Api;import io.swagger.annotations.ApiImplicitParam;import io.swagger.annotations.ApiOperation;import wang.raye.springboot.model.User;import wang.raye.springboot.server.UserServer;@Api(value="用户相关的接口")@RestController@RequestMapping("/user")public class UserController { @Autowired private UserServer server; /** * 添加用户 * @param user 用户对象 * @since 2016年9月21日21:01:50 */ @RequestMapping("/add") @ApiOperation(notes="添加用户",value="添加一个用户",httpMethod="POST") @ApiImplicitParam(name = "user", value = "用户详细实体user", required = true, dataType = "User") public String add(@RequestBody User user){ return "hello "+server.add(user); }}</pre><p style="">到此一个接口就完成了,我们可以到swagger2的文件页面去测试<a target="_blank" href="http://localhost/swagger-ui.htm" style="color:rgb(74,74,74); background:transparent">http://localhost/swagger-ui.htm</a> 注意如果端口不是80需要加上端口号,点开页面中的用户相关的接口 和GET /user/add可以看到如下页面<img src="/dokuwiki/ueditor/php/upload/image/20180614/1528966044173624.png" alt="swagger预览图" class="full-img"/>我们可以在parameters处输入</p><p>JSON</p><pre class=" language-json" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">{ "psw": "Raye", "username": "123456"}</pre><p style="">点击try it out就可以测试了,当然你也可能不想用json的方式,可以使用</p><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">@ApiImplicitParams({ @ApiImplicitParam(name="username",paramType="query",dataType="string"), @ApiImplicitParam(name="psw",paramType="query",dataType="string")})</pre><p style="">代替</p><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">@ApiImplicitParam(name = "user", value = "用户详细实体user", required = true, dataType = "User")</pre><p style="">同时为了隐藏user参数,需要在SwaggerConfig类的testApi方法中添加.ignoredParameterTypes(User.class)</p><p>Java</p><pre class=" language-java" style="font-family:Consolas,Monaco,'Andale Mono','Ubuntu Mono',monospace; font-size:0.9em; margin-top:0.5em; margin-bottom:0.5em; border:1px solid rgb(227,237,243); width:1178px; padding:1em; overflow:auto; color:rgb(248,248,242); word-spacing:normal; word-break:normal; word-wrap:normal; line-height:1.5; background:rgb(39,40,34)">@Beanpublic Docket testApi() { return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) .ignoredParameterTypes(User.class) .select() .apis(RequestHandlerSelectors.basePackage("wang.raye.springboot")) .paths(PathSelectors.any()).build();}</pre><p style="">测试界面就会变为<img src="/dokuwiki/ueditor/php/upload/image/20180614/1528966045168193.png" alt="swagger2预览图"/></p><h4 style="">结尾</h4><p style="">好了,到这里一个Springboot+Mybatis+Druid+Swagger2+mybatis-generator框架环境就搭建完成了,欢迎大家留言交流,另外附上本项目</p><p style=""><a target="_blank" href="http://git.oschina.net/raywang2014/SpringbootMybatis" style="color:rgb(74,74,74); background:transparent">demo oschina地址</a></p><p style=""><a target="_blank" href="https://github.com/RayeWang/SpringbootMybatis" style="color:rgb(74,74,74); background:transparent">demo github地址</a></p><p><br/></p>
服务器技术/微服务/基于maven的springboot_mybatis_druid_swagger2_mybatis-generator框架环境搭建.1528966057.txt.gz
· 最后更改: 2018/09/10 18:01 (外部编辑)
页面工具
显示页面
修订记录
反向链接
页面重命名
回到顶部