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

推荐阅读更多精彩内容