系列二：spring-mvc项目的搭建

一、开发工具
1.idea
--之前用eclipse，后来同事安利我这个，就掉进去出不来了。集成开发环境软件，有了它，你就不需要将代码拷贝到tomcat目录下面，然后手动启动，当然，还提供很多其它功能。
2.maven
--构建项目必备的软件，出了自动引入jar包之外，还能方便的把项目打包成各种格式的文件，便于部署
3.tomcat
--web容器，为webapp的运行提供环境。

二、流程
1.创建项目
2.编写代码
3.部署测试

三、详情
1.构建项目
--File-new..-project-Maven-webapp，之后一直next。
--File-new..-Module from Existing Sources，选择项目中的pom.xml

[img]http://dl2.iteye.com/upload/attachment/0122/2433/4f36438c-8e89-3f27-81d2-2e0678eced8d.png[/img]


2.编写代码
--在pom.xml文件中添加maven依赖，对于spring-mvc，用到的spring包只有两个，spring-web和spring-webmvc，前者是web核心包，适配环境，后者提供restful风格的接口等；除此spring包，还需要jackson-databind包，spring用该包进行数据绑定，将java对象转换成json，没有该包，spring对于非基本类型会报错：

[img]http://dl2.iteye.com/upload/attachment/0122/2435/4d98a522-aab8-325e-bee9-07d2e2e82820.png[/img]

--处了jar包外，pom.xml文件中还需要对文件打包进行一些配置。
--pom.xml文件如下：

<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/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>ucredit</groupId>
    <artifactId>spring_mvc_demo</artifactId>
    <packaging>war</packaging>
    <version>1.0-SNAPSHOT</version>
    <name>spring_mvc_demo</name>
    <url>http://maven.apache.org</url>
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>4.3.2.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>4.3.2.RELEASE</version>
        </dependency>
        <!--用于将对象转换成json数据,spring默认用这个包,如果没有,会发生转换错误 -->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.5.0</version>
        </dependency>

    </dependencies>
    <build>
        <finalName>spring_mvc_demo</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>2.3</version>
                <configuration>
                    <webResources>
                        <resource>
                            <filtering>true</filtering>
                            <directory>src/main/webapp</directory>
                            <includes>
                                <include>**/spring-mvc.xml</include>
                            </includes>
                        </resource>
                    </webResources>
                    <warSourceDirectory>src/main/webapp</warSourceDirectory>
                    <webXml>src/main/webapp/WEB-INF/web.xml</webXml>
                </configuration>
            </plugin>

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

--上一步仅仅引入了spring-mvc所需要的jar包，这些jar如何工作，还需要单独的配置，我在WEB-INF目录下，即web.xml同级建了spring-mvc.xml文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans-4.3.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-4.3.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc-4.3.xsd">
    <!-- 扫描路径 -->
    <context:component-scan base-package="edu.bupt.demo">
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

    <mvc:default-servlet-handler/>

    <mvc:annotation-driven/>

    <context:annotation-config/>
</beans>

--关于该文档的一些解释
第一部分，就是那些看起来乱七八糟的http链接，实际上是文档类型，这个和webservice有点类似，不清楚里的同学可以去补充下，其实我也不了解，这应该是从这些链接读取一些信息，然后根据这些信息生成对应的bean，下面一些配置，例如context、mvc等，就是这些url定义的；
有了上面的解释，再看文档的第二部分，就比较容易理解了，这也是我们配置代码的地方，比如扫描包路径，开启注解配置，开启注解驱动等，这样controller、service等注解才能生效；

--下一步就是适配spring和servlet了，我理解就是让spring接管部分servlet的功能，至于原理，我觉得spring其实充当了一个过滤器的角色。
以下是web.xml文件的内容：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://java.sun.com/xml/ns/javaee"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
         id="WebApp_ID" version="3.0">

  <display-name>Archetype Created Web Application</display-name>
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
  <!-- 统一编码 -->
  <filter>
    <filter-name>charsetEncoding</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>
    <init-param>
      <param-name>forceEncoding</param-name>
      <param-value>true</param-value>
    </init-param>
  </filter>
  <filter-mapping>
    <filter-name>charsetEncoding</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>
  <!-- 前端控制器 -->
  <servlet>
    <servlet-name>spring_mvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>/WEB-INF/spring-mvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>

  <servlet-mapping>
    <servlet-name>spring_mvc</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

</web-app>

--这三个文件写好之后，整个spring-mvc框架便基本搭建完毕了，下面是项目结构截图：
[img]http://dl2.iteye.com/upload/attachment/0122/2431/441837d0-0dfe-3410-9089-6b7d5b1eab7b.png[/img]

--附上写的测试代码

package edu.bupt.demo;

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

import java.util.HashMap;
import java.util.Map;

/**
 * Created by beibei on 16/12/27.
 */
@Controller
@RequestMapping(value = "/test")
public class Test {

    @ResponseBody
    @RequestMapping(value = "/string")
    public String string() {
        return "spring mvc demo";
    }

    @ResponseBody
    @RequestMapping(value = "/map")
    public Map map() {
        Map<String,Object> result = new HashMap<>();
        result.put("int",1);
        result.put("String","spring");
        return result;
    }
}

3.部署测试
对于idea如何将web应用部署到tomcat容器，我会单独写一篇，这里直接看结果，这里推荐一个json转换网站，[url]http://json.cn/[/url]
浏览器直接访问接口：
[img]http://dl2.iteye.com/upload/attachment/0122/2437/634bf7f9-efcd-3ac0-a29e-0c952d7cb428.png[/img]
网站转换效果：
[img]http://dl2.iteye.com/upload/attachment/0122/2439/3b692ca5-4b27-3c8c-8567-3204bea249aa.png[/img]