Hello,Spring MVC

继上一篇Hello,Servlet （Servlet实现后台接口开发）已经过去一年。
在这期间我也使用Servlet进行了一个内部项目的开发，给客户端和管理后台提供接口数据。虽然简单，但是业务多了还是有些不直观，感觉很难规范起来，只能当做入门级别的学习入口。
现在，我们就来学习超级强大的Spring MVC吧。

Spring MVC 属于 SpringFrameWork 的后续产品，已经融合在 Spring Web Flow 里面，是一个强大灵活的 Web 框架。Spring MVC 提供了一个 DispatcherServlet 作为前端控制器来分配请求。通过策略接口，Spring 框架是高度可配置的。Spring MVC 还包含多种视图技术，如 Java Server Pages（JSP）、Velocity、Tiles、iText 和 POI 等。Spring MVC 分离了控制器、模型对象、分派器以及处理程序对象的角色，这种分离让它们更容易进行定制。
Spring MVC 框架主要由 DispatcherServlet、处理器映射器、处理器适配器、处理器(控制器)、视图解析器、视图组成。

JDK，IDEA，TOMCAT，MYSQL，环境和工具可详见上一篇文章配置

• 使用IDEA新建一个项目，选择File>New>Project
  创建项目.png
  Next之后取一个项目名称，选择项目路径后Finish。
  项目目录.png
  项目结构主要为：lib，src，web三个目录，其中的out目录为项目运行后的输出目录，也就是war包的解压目录。
  而web目录下的web.xml，dispatcher-servlet.xml，applicationContext.xml均为web服务器的配置文件，待会在下面会贴出相关的配置内容。

• 如果已经配置了TOMCAT，那就点击右上角的运行，点击Edit Configurations:

  
  image.png
  配置运行环境.png
  

  由于上一个项目在Tomcat中已经把8080端口和JMX的1099端口用了，所以这个我就改成8081和1098吧，可以改成别的只要这端口没有被其他程序占用就行。这时下面会有一个Warning，提示你没有创建Artifacts，你只需要点击右边的Fix就行了，然后就自动添加了，接下来点击OK。

  
  配置容器.png
• 我们展开lib目录，发现IDE已经为我们添加好了Spring MVC的相关jar包，但是要想让项目运行起来，还需要其他的jar包。
  点击File>Project Structure或者右键点击jar包，选择Open Library Setting
  打开依赖配置页面如下：
  配置页面.png
  点击绿色的加号，选择From Maven，然后填入关键词，点击搜索小图标，一会搜索出来后在下拉框里面选择添加上图中的依赖包，并勾选Download 选择框下载到lib目录下，点击OK，点击OK。
  添加jar包1.png
  添加jar包2.png
  添加完jar包后左边Problems会出现错误，这是因为web中Artifacts后的war包也需要依赖这些jar包，很简单，点进去然后点击Fix，选择Add就行了。
  直接点击Apply，然后点击OK。
  Fix.png
  点击Modules，发现Libraries里面的jar都在右边引入了，OK。
  配置.png

• 接下来就是配置文件，我也是在网上找的资源，就贴出来大家参考吧，都有注释。

  
  web配置文件.png

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">
    <!--
       加载Spring容器，不建议直接使用applicationContext.xml，而应根据分类另外创建配置文件
    -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/applicationContext.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!--如果你的DispatcherServlet拦截"/"，为了实现REST风格，拦截了所有的请求，那么同时对*.js,*.jpg等静态文件的访问也就被拦截了。-->
    <!--方案一：激活Tomcat的defaultServlet来处理静态文件-->
    <!--要写在DispatcherServlet的前面， 让 defaultServlet先拦截请求，这样请求就不会进入Spring了，我想性能是最好的吧。-->
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.css</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.swf</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.gif</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.jpg</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.png</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.js</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.html</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.xml</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.json</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.map</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.woff</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.ttf</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>default</servlet-name>
        <url-pattern>*.mp4</url-pattern>
    </servlet-mapping>
    <!--
    配置前端控制器
        这里配置的前端控制器的名字叫dispatcher，SpringMVC默认会加载同目录下的dispatcher-servlet.xml
    这里为了便于分层管理，不使用dispatcher-servlet.xml，而是自己写一个springmvc.xml，用contextConfigLocation
    指定SpringMVC的加载位置。
    要求：spring文件夹的上一层文件夹必须mark为“Resources Root”，同时注意如果一个文件夹一旦配置为“Resources Root”
    其下的配置文件夹都是可以直接写在路径中的，具体检测方式看能否直接打开
    springmvc.xml中配置了
        1、处理器映射器和处理器适配器
        2、处理器
        3、视图解析器
    使用RESTful格式的话，将<url-pattern>标签中的“*.action”变为“/”
    -->
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <!-- ContextconfigLocation配置springmvc加载的配置文件
          适配器、处理映射器等
           -->
            <param-name>contextConfigLocation</param-name>
            <param-value>WEB-INF/config/spring/springmvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <!--配置编码-->
    <filter>
        <filter-name>CharacterEncodingFilter</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>CharacterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
</web-app>

dispatcher-servlet.xml这里没有使用这个文件，配置内容为空。
而是使用了springmvc.xml，如下

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:aop="http://www.springframework.org/schema/aop"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-3.2.xsd
        http://www.springframework.org/schema/aop
        http://www.springframework.org/schema/aop/spring-aop-3.2.xsd
        http://www.springframework.org/schema/tx
        http://www.springframework.org/schema/tx/spring-tx-3.2.xsd ">

    <!--
    配置处理器映射器和处理器适配器
    使用<mvc:annotation-drvier/>配置注解映射器和注解适配器
    -->
    <mvc:annotation-driven/>

    <!--
    配置处理器
      使用<context:component-sacn/>组件扫描器自动扫描包中标记为@Controller的注解类，
      注意：多个包中间使用半角逗号分隔
      要求：base-package对应的包中应该是controller包
    -->
    <context:component-scan base-package="xiangshang.controller"/>

    <!--
    配置视图解析器
        要求：
        1、配置解析JSP的视图解析器，默认使用JSTL，因此classpath下需要有JSTL的包
        2、根据前缀和后缀，在WEB-INF目录下要有pages目录，其中存放jsp文件
    -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
        <property name="prefix" value="/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

    <!--配置上传文件数据解析器  -->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <property name="maxUploadSize">
            <value>9242880</value>
        </property>
    </bean>

    <!--<mvc:resources mapping="/css/**" location="/layui/layui/css/" />-->
    <!--<mvc:resources mapping="/css/**" location="/css/" />-->
    <!--<mvc:resources mapping="/js/**" location="/js/" />-->
    <!--<mvc:resources mapping="/js/**" location="/layui/layui/" />-->
    <!--<mvc:resources mapping="/imgdata/**" location="/resource/" />-->

    <bean id="jsonConverter"
          class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
    <bean
            class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
        <property name="messageConverters">
            <list>
                <ref bean="mappingJackson2HttpMessageConverter" />
            </list>
        </property>
    </bean>
    <bean id="mappingJackson2HttpMessageConverter"
          class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
        <property name="supportedMediaTypes">
            <list>
                <value>text/html;charset=UTF-8</value>
                <value>text/json;charset=UTF-8</value>
                <value>application/json;charset=UTF-8</value>
            </list>
        </property>
    </bean>

</beans>

applicationContxt.xml

<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:aop="http://www.springframework.org/schema/aop"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans-4.2.xsd
        http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context-4.2.xsd
       http://www.springframework.org/schema/aop
       http://www.springframework.org/schema/aop/spring-aop-4.2.xsd
       http://www.springframework.org/schema/tx
       http://www.springframework.org/schema/tx/spring-tx-4.2.xsd">
    <!-- 配置组件扫描器，使用注解方式开发,不用配置dao和service -->
    <!-- 在springmvc.xml文件中也可以配置这个属性 -->
    <context:component-scan base-package="xiangshang.controller"/>

    <!--                       定义dao                   -->
    <!-- 加载数据库连接的资源文件 -->
    <context:property-placeholder location="/WEB-INF/config/jdbc/jdbc.properties"/>
    <!-- 数据源 -->
    <bean id="dataSource"
          class="org.springframework.jdbc.datasource.DriverManagerDataSource">
        <property name="driverClassName" value="${jdbc.driver}" />
        <property name="url" value="${jdbc.url}" />
        <property name="username" value="${jdbc.username}" />
        <property name="password" value="${jdbc.password}" />
    </bean>

    <!-- 配置session工厂 -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <property name="configLocation" value="/WEB-INF/config/mybatis/mybatis-config.xml"/>
    </bean>

    <!-- 配置mapper扫描器 -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <!-- 扫描包路径，如果需要扫描多个包中间用半角逗号隔开 -->
        <property name="basePackage" value="xiangshang.mapper" />
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
    </bean>

    <!--                       业务逻辑控制 定义service                   -->
    <!--<bean id="userService" class="com.wxisme.ssm.service.impl.UserServiceImpl"/>-->


    <!--                       事务控制 定义service                   -->
    <!-- 事务管理器 -->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"/>
    </bean>

    <!-- 配置AOP通知 -->
    <tx:advice id="txAdvice" transaction-manager="transactionManager">
        <tx:attributes>
            <!-- 传播行为 -->
            <tx:method name="save*" propagation="REQUIRED"/>
            <tx:method name="insert*" propagation="REQUIRED"/>
            <tx:method name="update*" propagation="REQUIRED"/>
            <tx:method name="delete*" propagation="REQUIRED"/>
            <tx:method name="find*" propagation="SUPPORTS" read-only="true"/>
            <tx:method name="select*" propagation="SUPPORTS" read-only="true"/>
        </tx:attributes>
    </tx:advice>

    <!-- 配置AOP，为添加事务管理的操作配置AOP -->
    <aop:config>
        <!-- 引入的Spring定义的事务通知，需要使用aop:advisor -->
        <!-- 下面难 -->
        <!-- <aop:advisor advice-ref="txAdvice" pointcut="execution(* com.wxisme.ssm.service.impl.*.*(..))"/>-->
        <!--/>-->
    </aop:config>
</beans>

jdbc.properties

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://10.200.1.144/xiangshangclub?useSSL=false
jdbc.username=root
jdbc.password=123456

mybatis-config.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>

    <!-- 将数据库连接数据抽取到属性文件中方便测试 -->
    <!-- <properties resource="/WEB-INF/classes/jdbc.properties"></properties> -->
    <!-- 别名的定义 -->
    <typeAliases>
        <!-- 批量定义别名 ，指定包名，自动扫描包中的类，别名即为类名，首字母大小写无所谓-->
        <!--<package name="com.wxisme.ssm.po"/>-->
    </typeAliases>

    <!-- 数据库连接用数据库连接池 -->

    <mappers>
        <!-- 通过扫描包的方式来进行批量加载映射文件 -->
        <!--<package name="com.wxisme.ssm.mapper"/>-->
    </mappers>
</configuration>

• 这次就不写jsp了，也不用数据库，先写个简单的Hello,World接口吧，复杂的操作我们之后再学习。
  在controller包下面创建一个Class，取名Hello。
  特别注意，在上面的mvc配置文件中：

<context:component-scan base-package="xiangshang.controller"/>

这里面要改成你自己的包路径。
Hello.java

package xiangshang.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;

/**
 * Created with IntelliJ IDEA.
 * Description:
 * User: ZhongZiMing
 * Date: 2018-03-09
 * Time: 15:09
 */
@Controller
@RequestMapping("/mvc")
public class Hello {

    @RequestMapping(value = "/hello", method = RequestMethod.GET)
    public @ResponseBody
    String printWelcome() {
        return "{\"code\":200,\"message\":\"hello world\",\"data\":\"\"}";
    }

}

• 接下来，我们点击右上角的运行，开启服务，看看我们的接口地址能否访问：http://localhost:8081/mvc/hello
  结果肯定是可以的啦，踩了那么多坑，终于好了。
  如图：
  controller的get请求.png
  最后，谢谢观看，如果不足之处请留言。

参考链接：
http://www.php.cn/java-article-368898.html
http://www.importnew.com/22880.html