1.新建maven Web項目

image

image

選擇maven所在目錄conf下的settings.xml文件，repository選擇maven倉庫的路徑

image

image

web項目創(chuàng)建成功

image

2.搭建SSM代碼目錄框架

2.1創(chuàng)建項目代碼目錄

src的main下新建resources，在resources目錄下右鍵->Mark Directory as->resourcesRoot，然后在src下新建java目錄，在java目錄下右鍵->Mark Directory as->Sourcse Root,然后在java下新建包

com.noah.contacts.bean -------->實體對象，對應(yīng)數(shù)據(jù)庫中的表

com.noah.contacts.controller -------->web 接口路由控制

com.noah.contacts.service -------->web 服務(wù)

com.noah.contacts.dao -------->數(shù)據(jù)庫訪問

com.noah.contacts.mapper -------->數(shù)據(jù)庫到實體映射

com.noah.contacts.swagger -------->swagger API框架

image

2.2修改pom.xml

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>noah</groupId>
  <artifactId>WebTest</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>war</packaging>

  <name>WebTest Maven Webapp</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>


  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>

    <!-- spring版本號 -->
    <spring.version>4.2.5.RELEASE</spring.version>

    <!-- mybatis版本號 -->
    <mybatis.version>3.2.8</mybatis.version>

    <!-- mysql驅(qū)動版本號 -->
    <mysql-driver.version>8.0.11</mysql-driver.version>

    <!-- log4j日志包版本號 -->
    <slf4j.version>1.7.7</slf4j.version>
    <log4j.version>1.2.17</log4j.version>

  </properties>

  <dependencies>

    <!-- java ee -->
    <dependency>
      <groupId>javax</groupId>
      <artifactId>javaee-api</artifactId>
      <version>7.0</version>
    </dependency>

    <!-- 單元測試 -->
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.12</version>
    </dependency>

    <!-- 實現(xiàn)slf4j接口并整合 -->
    <dependency>
      <groupId>ch.qos.logback</groupId>
      <artifactId>logback-classic</artifactId>
      <version>1.2.2</version>
    </dependency>

    <!-- JSON -->
    <dependency>
      <groupId>com.fasterxml.jackson.core</groupId>
      <artifactId>jackson-databind</artifactId>
      <version>2.8.7</version>
    </dependency>


    <!-- 數(shù)據(jù)庫 -->
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>8.0.11</version>
      <scope>runtime</scope>
    </dependency>

    <!-- 數(shù)據(jù)庫連接池 -->
    <dependency>
      <groupId>com.mchange</groupId>
      <artifactId>c3p0</artifactId>
      <version>0.9.5.2</version>
    </dependency>

    <!-- MyBatis -->
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>${mybatis.version}</version>
    </dependency>

    <!-- mybatis/spring整合包 -->
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis-spring</artifactId>
      <version>1.3.1</version>
    </dependency>

    <!-- Spring -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-jdbc</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-tx</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-test</artifactId>
      <version>${spring.version}</version>
    </dependency>

    <!--通用mapper-->
    <dependency>
      <groupId>tk.mybatis</groupId>
      <artifactId>mapper</artifactId>
      <version>3.3.8</version>
    </dependency>

    <!--Swagger2 自動生成api接口文檔-->
    <dependency>
      <groupId>io.springfox</groupId>
      <artifactId>springfox-swagger2</artifactId>
      <version>2.7.0</version>
    </dependency>
    <dependency>
      <groupId>io.springfox</groupId>
      <artifactId>springfox-swagger-ui</artifactId>
      <version>2.7.0</version>
    </dependency>
  </dependencies>

  <build>
    <finalName>WebTest</finalName>
    <plugins>
      <plugin>
        <groupId>org.mybatis.generator</groupId>
        <artifactId>mybatis-generator-maven-plugin</artifactId>
        <version>1.3.2</version>
        <configuration>
          <configurationFile>src/main/resources/generatorConfig.xml</configurationFile>
          <verbose>true</verbose>
          <overwrite>true</overwrite>
        </configuration>
        <executions>
          <execution>
            <id>Generate MyBatis Artifacts</id>
            <goals>
              <goal>generate</goal>
            </goals>
          </execution>
        </executions>
        <dependencies>
          <dependency>
            <groupId>org.mybatis.generator</groupId>
            <artifactId>mybatis-generator-core</artifactId>
            <version>1.3.2</version>
          </dependency>
        </dependencies>
      </plugin>
    </plugins>
  </build>
</project>

2.3 修改web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">

  <display-name>WebTest</display-name>
  <description>ChatRobot_Alpha_0.0.1</description>

  <!-- 編碼過濾器 -->
  <filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
      <param-name>encoding</param-name>
      <param-value>UTF-8</param-value>
    </init-param>
  </filter>
  <filter-mapping>
    <filter-name>encodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

  <!-- 配置DispatcherServlet -->
  <servlet>
    <servlet-name>SpringMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 配置springMVC需要加載的配置文件-->
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring-*.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
    <async-supported>true</async-supported>
  </servlet>
  <servlet-mapping>
    <servlet-name>SpringMVC</servlet-name>
    <!-- 匹配所有請求，此處也可以配置成 *.do 形式 -->
    <url-pattern>/</url-pattern>
  </servlet-mapping>

  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>

</web-app>

2.4 在resources下新增spring-mvc.xml如下:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context.xsd
       http://www.springframework.org/schema/mvc
       http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd">

    <!-- 掃描web相關(guān)的bean -->
    <context:component-scan base-package="com.noah.contacts.controller"/>

    <!-- 開啟SpringMVC注解模式 -->
    <mvc:annotation-driven/>

    <!-- 靜態(tài)資源默認(rèn)servlet配置 -->
    <mvc:default-servlet-handler/>

    <!--重要！將你的SwaggerConfig配置類注入-->
    <bean class="com.noah.contacts.swagger.SwaggerConfig"/>
    <!--重要！配置swagger資源不被攔截-->
    <mvc:resources mapping="swagger-ui.html" location="classpath:/META-INF/resources/" />
    <mvc:resources mapping="/webjars/**" location="classpath:/META-INF/resources/webjars/" />

    <!-- 配置jsp 顯示ViewResolver -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
        <property name="prefix" value="/WEB-INF/views/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

    <!-- 配置json轉(zhuǎn)換器 -->
    <bean id="jsonMessageConverters" class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
        <property name="supportedMediaTypes">
            <list>
                <value>application/json;charset=UTF-8</value>
            </list>
        </property>
    </bean>
</beans>

2.5 在swagger包下新建SwaggerConfig.java文件如下，配置Swagger

package com.noah.contacts.swagger;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.test.context.web.WebAppConfiguration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import springfox.documentation.builders.ApiInfoBuilder;
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;

/*重要！如果你的項目引入junit測試，此處需要使用@WebAppConfiguration，如果沒有使用junit使用@Configuration(很多的博客都沒有注明這個問題，為此我花了非常多的時間解決問題)*/
@WebAppConfiguration
@EnableSwagger2//重要！
@EnableWebMvc
@ComponentScan(basePackages = "com.XXXXX.control")//掃描control所在的package請修改為你control所在package
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("XXX項目接口文檔")
                .description("XXX項目接口測試")
                .version("1.0.0")
                .termsOfServiceUrl("")
                .license("")
                .licenseUrl("")
                .build();
    }
}

2.6 在resources下新增mybatis配置文件spring-mybatis.xml如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context.xsd
       http://www.springframework.org/schema/tx
       http://www.springframework.org/schema/tx/spring-tx.xsd">

    <!-- 掃描service包下所有使用注解的類型 -->
    <context:component-scan base-package="com.noah.contacts.service"/>

    <!-- 配置數(shù)據(jù)庫相關(guān)參數(shù)properties的屬性：${url} -->
    <context:property-placeholder location="classpath:jdbc.properties"/>

    <!-- 數(shù)據(jù)庫連接池 -->
    <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
        <property name="driverClass" value="${jdbc.driver}"/>
        <property name="jdbcUrl" value="${jdbc.url}"/>
        <property name="user" value="${jdbc.username}"/>
        <property name="password" value="${jdbc.password}"/>
        <property name="maxPoolSize" value="${c3p0.maxPoolSize}"/>
        <property name="minPoolSize" value="${c3p0.minPoolSize}"/>
        <property name="autoCommitOnClose" value="${c3p0.autoCommitOnClose}"/>
        <property name="checkoutTimeout" value="${c3p0.checkoutTimeout}"/>
        <property name="acquireRetryAttempts" value="${c3p0.acquireRetryAttempts}"/>
    </bean>

    <!-- 配置SqlSessionFactory對象 -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <!-- 注入數(shù)據(jù)庫連接池 -->
        <property name="dataSource" ref="dataSource"/>
        <!-- 掃描model包 使用別名 -->
        <property name="typeAliasesPackage" value="com.noah.model"/>
        <!-- 掃描sql配置文件:mapper需要的xml文件 -->
        <property name="mapperLocations" value="classpath:com/noah/contacts/mapper/*.xml"/>
    </bean>

    <bean class="tk.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.noah.dao"/>
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" />
    </bean>

    <!-- 配置掃描Dao接口包，動態(tài)實現(xiàn)Dao接口，注入到spring容器中 -->
    <!--<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        &lt;!&ndash; 注入sqlSessionFactory &ndash;&gt;
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
        &lt;!&ndash; 給出需要掃描Dao接口包 &ndash;&gt;
        <property name="basePackage" value="com.noah.dao"/>
    </bean>-->

    <!-- 配置事務(wù)管理器 -->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <!-- 注入數(shù)據(jù)庫連接池 -->
        <property name="dataSource" ref="dataSource"/>
    </bean>

    <!-- 配置基于注解的聲明式事務(wù) -->
    <tx:annotation-driven transaction-manager="transactionManager"/>

</beans>

2.7 在resources目錄下新增數(shù)據(jù)庫連接配置文件jdbc.properties如下：

jdbc.driver=com.mysql.cj.jdbc.Driver
#數(shù)據(jù)庫地址
jdbc.url=jdbc:mysql://localhost:3306/contacts?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Hongkong
#用戶名
jdbc.username=xxxx
#密碼
jdbc.password=xxxxxxxxx
#最大連接數(shù)
c3p0.maxPoolSize=30
#最小連接數(shù)
c3p0.minPoolSize=10
#關(guān)閉連接后不自動commit
c3p0.autoCommitOnClose=false
#獲取連接超時時間
c3p0.checkoutTimeout=10000
#當(dāng)獲取連接失敗重試次數(shù)
c3p0.acquireRetryAttempts=2

2.8 在resources目錄下添加mybatis自動映射配置（pom.xml中插件中聲明的配置文件）,MyBatis Generator自動生成實體、mapper和dao層

<?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>
    <!--導(dǎo)入屬性配置-->
    <properties resource="jdbc.properties"></properties>

    <!--指定特定數(shù)據(jù)庫的jdbc驅(qū)動jar包的位置-->
    <classPathEntry location="D://soft/apache-maven-3.5.3/repository/mysql/mysql-connector-java/8.0.11/mysql-connector-java-8.0.11.jar"/>

    <context id="default" targetRuntime="MyBatis3">

        <!-- optional，旨在創(chuàng)建class時，對注釋進(jìn)行控制 -->
        <commentGenerator>
            <property name="suppressDate" value="true"/>
            <property name="suppressAllComments" value="true"/>
        </commentGenerator>

        <!--jdbc的數(shù)據(jù)庫連接 -->
        <jdbcConnection
                driverClass="${jdbc.driver}"
                connectionURL="${jdbc.url}"
                userId="${jdbc.username}"
                password="${jdbc.password}">
        </jdbcConnection>


        <!-- 非必需，類型處理器，在數(shù)據(jù)庫類型和java類型之間的轉(zhuǎn)換控制-->
        <javaTypeResolver>
            <property name="forceBigDecimals" value="false"/>
        </javaTypeResolver>


        <!-- Model模型生成器,用來生成含有主鍵key的類，記錄類 以及查詢Example類
            targetPackage     指定生成的model生成所在的包名
            targetProject     指定在該項目下所在的路徑
        -->
        <javaModelGenerator targetPackage="com.noah.contacts.bean"
                            targetProject="src/main/java">

            <!-- 是否允許子包，即targetPackage.schemaName.tableName -->
            <property name="enableSubPackages" value="false"/>
            <!-- 是否對model添加 構(gòu)造函數(shù) -->
            <property name="constructorBased" value="true"/>
            <!-- 是否對類CHAR類型的列的數(shù)據(jù)進(jìn)行trim操作 -->
            <property name="trimStrings" value="true"/>
            <!-- 建立的Model對象是否 不可改變  即生成的Model對象不會有 setter方法，只有構(gòu)造方法 -->
            <property name="immutable" value="false"/>
        </javaModelGenerator>

        <!--Mapper映射文件生成所在的目錄 為每一個數(shù)據(jù)庫的表生成對應(yīng)的SqlMap文件 -->
        <sqlMapGenerator targetPackage="com.noah.contacts.mapper"
                         targetProject="src/main/java">
            <property name="enableSubPackages" value="false"/>
        </sqlMapGenerator>

        <!-- 客戶端代碼，生成易于使用的針對Model對象和XML配置文件 的代碼
                type="ANNOTATEDMAPPER",生成Java Model 和基于注解的Mapper對象
                type="MIXEDMAPPER",生成基于注解的Java Model 和相應(yīng)的Mapper對象
                type="XMLMAPPER",生成SQLMap XML文件和獨立的Mapper接口
        -->
        <javaClientGenerator targetPackage="com.noah.contacts.dao"
                             targetProject="src/main/java" type="XMLMAPPER">
            <property name="enableSubPackages" value="true"/>
        </javaClientGenerator>


        <table tableName="user"  domainObjectName="User"
               enableCountByExample="false" enableUpdateByExample="false"
               enableDeleteByExample="false" enableSelectByExample="false"
               selectByExampleQueryId="false"
                >

            <!-- 參考 javaModelGenerator 的 constructorBased屬性-->
            <property name="constructorBased" value="false"/>

            <!-- 默認(rèn)為false，如果設(shè)置為true，在生成的SQL中，table名字不會加上catalog或schema； -->
            <property name="ignoreQualifiersAtRuntime" value="false"/>

            <!-- 參考 javaModelGenerator 的 immutable 屬性 -->
            <property name="immutable" value="false"/>

            <!-- 指定是否只生成domain類，如果設(shè)置為true，只生成domain類，如果還配置了sqlMapGenerator，那么在mapper XML文件中，只生成resultMap元素 -->
            <property name="modelOnly" value="false"/>

            <!-- 參考 javaModelGenerator 的 rootClass 屬性
            <property name="rootClass" value=""/>
             -->

            <!-- 參考javaClientGenerator 的  rootInterface 屬性
            <property name="rootInterface" value=""/>
            -->

            <!-- 如果設(shè)置了runtimeCatalog，那么在生成的SQL中，使用該指定的catalog，而不是table元素上的catalog
            <property name="runtimeCatalog" value=""/>
            -->

            <!-- 如果設(shè)置了runtimeSchema，那么在生成的SQL中，使用該指定的schema，而不是table元素上的schema
            <property name="runtimeSchema" value=""/>
            -->

            <!-- 如果設(shè)置了runtimeTableName，那么在生成的SQL中，使用該指定的tablename，而不是table元素上的tablename
            <property name="runtimeTableName" value=""/>
            -->

            <!-- 注意，該屬性只針對MyBatis3Simple有用；
                如果選擇的runtime是MyBatis3Simple，那么會生成一個SelectAll方法，如果指定了selectAllOrderByClause，那么會在該SQL中添加指定的這個order條件；
             -->
            <property name="selectAllOrderByClause" value="_id desc,name asc"/>

            <!-- 如果設(shè)置為true，生成的model類會直接使用column本身的名字，而不會再使用駝峰命名方法，比如BORN_DATE，生成的屬性名字就是BORN_DATE,而不會是bornDate -->
            <property name="useActualColumnNames" value="true"/>


            <!-- generatedKey用于生成生成主鍵的方法，
                如果設(shè)置了該元素，MBG會在生成的<insert>元素中生成一條正確的<selectKey>元素，該元素可選
                column:主鍵的列名；
                sqlStatement：要生成的selectKey語句，有以下可選項：
                    Cloudscape:相當(dāng)于selectKey的SQL為： VALUES IDENTITY_VAL_LOCAL()
                    DB2       :相當(dāng)于selectKey的SQL為： VALUES IDENTITY_VAL_LOCAL()
                    DB2_MF    :相當(dāng)于selectKey的SQL為：SELECT IDENTITY_VAL_LOCAL() FROM SYSIBM.SYSDUMMY1
                    Derby     :相當(dāng)于selectKey的SQL為：VALUES IDENTITY_VAL_LOCAL()
                    HSQLDB    :相當(dāng)于selectKey的SQL為：CALL IDENTITY()
                    Informix  :相當(dāng)于selectKey的SQL為：select dbinfo('sqlca.sqlerrd1') from systables where tabid=1
                    MySql     :相當(dāng)于selectKey的SQL為：SELECT LAST_INSERT_ID()
                    SqlServer :相當(dāng)于selectKey的SQL為：SELECT SCOPE_IDENTITY()
                    SYBASE    :相當(dāng)于selectKey的SQL為：SELECT @@IDENTITY
                    JDBC      :相當(dāng)于在生成的insert元素上添加useGeneratedKeys="true"和keyProperty屬性
            <generatedKey column="" sqlStatement=""/>
             -->

            <!--
                該元素會在根據(jù)表中列名計算對象屬性名之前先重命名列名，非常適合用于表中的列都有公用的前綴字符串的時候，
                比如列名為：CUST_ID,CUST_NAME,CUST_EMAIL,CUST_ADDRESS等；
                那么就可以設(shè)置searchString為"^CUST_"，并使用空白替換，那么生成的Customer對象中的屬性名稱就不是
                custId,custName等，而是先被替換為ID,NAME,EMAIL,然后變成屬性：id，name，email；

                注意，MBG是使用java.util.regex.Matcher.replaceAll來替換searchString和replaceString的，
                如果使用了columnOverride元素，該屬性無效；

            <columnRenamingRule searchString="" replaceString=""/>
             -->


            <!-- 用來修改表中某個列的屬性，MBG會使用修改后的列來生成domain的屬性；
               column:要重新設(shè)置的列名；
               注意，一個table元素中可以有多個columnOverride元素哈~
             -->
           <!-- <columnOverride column="username">
                &lt;!&ndash; 使用property屬性來指定列要生成的屬性名稱 &ndash;&gt;
                <property name="property" value="userName"/>

                &lt;!&ndash; javaType用于指定生成的domain的屬性類型，使用類型的全限定名
                <property name="javaType" value=""/>
                 &ndash;&gt;

                &lt;!&ndash; jdbcType用于指定該列的JDBC類型
                <property name="jdbcType" value=""/>
                 &ndash;&gt;

                &lt;!&ndash; typeHandler 用于指定該列使用到的TypeHandler，如果要指定，配置類型處理器的全限定名
                    注意，mybatis中，不會生成到mybatis-config.xml中的typeHandler
                    只會生成類似：where id = #{id,jdbcType=BIGINT,typeHandler=com._520it.mybatis.MyTypeHandler}的參數(shù)描述
                <property name="jdbcType" value=""/>
                &ndash;&gt;

                &lt;!&ndash; 參考table元素的delimitAllColumns配置，默認(rèn)為false
                <property name="delimitedColumnName" value=""/>
                 &ndash;&gt;
            </columnOverride>-->

            <!-- ignoreColumn設(shè)置一個MGB忽略的列，如果設(shè)置了改列，那么在生成的domain中，生成的SQL中，都不會有該列出現(xiàn)
               column:指定要忽略的列的名字；
               delimitedColumnName：參考table元素的delimitAllColumns配置，默認(rèn)為false

               注意，一個table元素中可以有多個ignoreColumn元素
            <ignoreColumn column="deptId" delimitedColumnName=""/>
            -->
        </table>


   <!--     <table tableName="adminuser" domainObjectName="Admin"
               enableCountByExample="false" enableUpdateByExample="false"
               enableDeleteByExample="false" enableSelectByExample="false"
               selectByExampleQueryId="false">
        </table>
        <table tableName="configinfo" domainObjectName="Confinfo"
               enableCountByExample="false" enableUpdateByExample="false"
               enableDeleteByExample="false" enableSelectByExample="false"
               selectByExampleQueryId="false">
        </table>
        <table tableName="grade" domainObjectName="Grade"
               enableCountByExample="false" enableUpdateByExample="false"
               enableDeleteByExample="false" enableSelectByExample="false"
               selectByExampleQueryId="false">
        </table>
        <table tableName="gradelog" domainObjectName="Gradelog"
               enableCountByExample="false" enableUpdateByExample="false"
               enableDeleteByExample="false" enableSelectByExample="false"
               selectByExampleQueryId="false">
        </table>
        <table tableName="reginfo" domainObjectName="Reginfo"
               enableCountByExample="false" enableUpdateByExample="false"
               enableDeleteByExample="false" enableSelectByExample="false"
               selectByExampleQueryId="false">
        </table>-->
    </context>
</generatorConfiguration>

運行方法：使用maven運行mybatis-generator-maven-plugin插件：工程名->Plugins->mybatis-generator->mybatis-generator:generate->Run Maven Build，這里自動生成了數(shù)據(jù)庫中的User表。

image.png

3.編寫測試代碼

先把項目的結(jié)構(gòu)曬一下

image.png

3.1 修改User.java ,之前用的mybatis-generator-maven-plugin插件雖然通過配置文件自動生成了 bean、dao、mapper，但是生成的代碼看起來不太簡潔，后面就改用tk.mybatis的框架（前面的pom.xml中已經(jīng)集成）

package com.noah.contacts.bean;

import javax.persistence.Column;
import javax.persistence.Id;
import javax.persistence.Table;
import java.util.Date;

/***
 * 表名默認(rèn)使用類名,駝峰轉(zhuǎn)下劃線(只對大寫字母進(jìn)行處理),如UserInfo默認(rèn)對應(yīng)的表名為user_info。
 * 表名可以使用@Table(name = "tableName")進(jìn)行指定,對不符合第一條默認(rèn)規(guī)則的可以通過這種方式指定表名.
 * 字段默認(rèn)和@Column一樣,都會作為表字段,表字段默認(rèn)為Java對象的Field名字駝峰轉(zhuǎn)下劃線形式.
 * 可以使用@Column(name = "fieldName")指定不符合第3條規(guī)則的字段名
 * 使用@Transient注解可以忽略字段,添加該注解的字段不會作為表字段使用.
 * 建議一定是有一個@Id注解作為主鍵的字段,可以有多個@Id注解的字段作為聯(lián)合主鍵.
 * 如果是MySQL的自增字段，加上@GeneratedValue(generator = "JDBC")即可。如果是其他數(shù)據(jù)庫，可以參考官網(wǎng)文檔。
 */

@Table(name="user")
public class User {
    @Id
    @Column(name = "_id")
    private Long id;

    private String name;

    private String password;

    private String mobile;

    @Column(name = "registTime")
    private Date registTime;

    @Column(name = "lastLoginTime")
    private Date lastLoginTime;

    @Column(name = "deviceMac")
    private String deviceMac;

    private String openid;

    private String session_key;

    public Long get_id() {
        return id;
    }

    public void set_id(Long _id) {
        this.id = _id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name == null ? null : name.trim();
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password == null ? null : password.trim();
    }

    public String getMobile() {
        return mobile;
    }

    public void setMobile(String mobile) {
        this.mobile = mobile == null ? null : mobile.trim();
    }

    public Date getRegistTime() {
        return registTime;
    }

    public void setRegistTime(Date registTime) {
        this.registTime = registTime;
    }

    public Date getLastLoginTime() {
        return lastLoginTime;
    }

    public void setLastLoginTime(Date lastLoginTime) {
        this.lastLoginTime = lastLoginTime;
    }

    public String getDeviceMac() {
        return deviceMac;
    }

    public void setDeviceMac(String deviceMac) {
        this.deviceMac = deviceMac == null ? null : deviceMac.trim();
    }

    public String getOpenid() {
        return openid;
    }

    public void setOpenid(String openid) {
        this.openid = openid == null ? null : openid.trim();
    }

    public String getSession_key() {
        return session_key;
    }

    public void setSession_key(String session_key) {
        this.session_key = session_key == null ? null : session_key.trim();
    }
}

3.2 項目一般會有同一的數(shù)據(jù)返回格式，這里我定義一個統(tǒng)一的返回對象為BaseResponse，代碼如下,里面加入了swagger的描述

package com.noah.contacts.bean;

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;

@ApiModel(value = "通用返回對象" , description = "BaseResponse<T> 為返回的具體的數(shù)據(jù)對象")
public class BaseResponse <T>{
    @ApiModelProperty(value = "成功或異常標(biāo)志位，1為成功，0為異常",dataType = "Integer",required = true)
    private int result;
    @ApiModelProperty(value = "描述",dataType = "String",required = true)
    private String msg;
    @ApiModelProperty
    private T data;

    public int getResult() {
        return result;
    }

    public void setResult(int result) {
        this.result = result;
    }

    public String getMsg() {
        return msg;
    }

    public void setMsg(String msg) {
        this.msg = msg;
    }

    public T getData() {
        return data;
    }

    public void setData(T data) {
        this.data = data;
    }
}

3.3 刪除bean下除了User和BaseResponse外的mybatis-generator-maven-plugin插件生成的其他文件，刪除mapper下的文件，修改dao下的UserDao.java如下:

package com.noah.contacts.dao;

import com.noah.contacts.bean.User;

import tk.mybatis.mapper.common.Mapper;

public interface UserDao extends Mapper<User> {

}

3.4 增加UserController.java,IUserService.java,Userservice.java

package com.noah.contacts.controller;

import com.noah.contacts.bean.BaseResponse;
import com.noah.contacts.bean.User;
import com.noah.contacts.service.IUserService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiImplicitParam;
import io.swagger.annotations.ApiImplicitParams;
import io.swagger.annotations.ApiOperation;
import org.springframework.context.annotation.Scope;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

import javax.annotation.Resource;

@Controller
@Scope(value="prototype")
@RequestMapping("/user")
@Api(value = "/user",tags = "用戶管理接口")
public class UserContorller {

    @Resource
    private IUserService userService;

    @ResponseBody
    @RequestMapping(value = "/doLogin", method = RequestMethod.POST)
    @ApiOperation(value = "登錄", notes = "獲取用戶信息", httpMethod = "POST")
    @ApiImplicitParams({
            @ApiImplicitParam(paramType = "query", name = "username", value = "用戶名", required = true, dataType = "String"),
            @ApiImplicitParam(paramType = "query", name = "password", value = "密碼", required = true, dataType = "String")})
    public BaseResponse<User> doLogin(@RequestParam("username") String username, @RequestParam("password") String password) throws Exception {
        BaseResponse<User> response = new BaseResponse<User>();
        response.setResult(1);
        response.setMsg("登錄成功");
        User user = userService.doLogin(username, password);
        response.setData(user);
        return response;
    }

}

package com.noah.contacts.service;

import com.noah.contacts.bean.User;

public interface IUserService {
    public User doLogin(String name, String password);
}

package com.noah.contacts.service;

import com.noah.contacts.bean.User;
import com.noah.contacts.dao.UserDao;
import org.springframework.stereotype.Service;

import javax.annotation.Resource;

@Service("IUserService")
public class UserService implements IUserService{

    @Resource
    UserDao userMapper;

    public User doLogin(String name, String password) {
        User selectUser = new User();
        selectUser.setName(name);
        selectUser.setPassword(password);
        User result = userMapper.selectOne(selectUser);
        return result;
    }
}

到這里就可以調(diào)用接口測試了，運行項目后，在瀏覽器輸入http://localhost:8080/swagger-ui.html

image.png