使用Spring Web MVC和Maven构建web项目

使用Spring Web MVC和Maven构建web项目

创建日期：2016年5月24日
最后编辑：2016年6月8日
 
1 创建目录

以下所示，创建Maven使用的目录结构。
├─src
│  ├─main
│  │  ├─java
│  │  └─webapp
│  │      └─WEB-INF
│  └─test
│      └─java
└─pom.xml
其中，src/main/java/中保存Java源代码文件。src/main/webapp中保存部署到应用根目录下的文件。src/test保存测试使用的文件。pom.xml是Maven项目文件。

2 编写POM

一个用于Spring Web MVC项目的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/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
 
  <groupId>org.web.app</groupId>
  <artifactId>HelloSpring</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>war</packaging>
 
  <dependencies>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>4.2.6.RELEASE</version>
      <scope>compile</scope>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
      <version>4.2.6.RELEASE</version>
      <scope>compile</scope>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>4.2.6.RELEASE</version>
      <scope>compile</scope>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>4.2.6.RELEASE</version>
      <scope>compile</scope>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>servlet-api</artifactId>
      <version>2.5</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
      <scope>compile</scope>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.0</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>
 
  <build>
    <finalName>HelloSpring</finalName>
  </build>
</project>
在web项目中，<packaging>标签要定义为war，并要引入servlet-api和jsp-api、jstl等依赖项。

3 开发
示例代码
package org.experimental;

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

@Controller
public class HelloSpring {
    
    @RequestMapping("/hellospring")
    @ResponseBody
    public String helloSpring(){
      return "Hello, Spring!";
    }
}

4 编写web.xml
<web-app>
  <servlet>
    <servlet-name>hello</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>hello</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>
web.xml文件要保存在src/main/webapp/WEB-INF目录下。

5 编写servlet配置
<?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:p="http://www.springframework.org/schema/p"
       xmlns:context="http://www.springframework.org/schema/context"
       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">
  <context:component-scan base-package="org.experimental"/>
</beans>
此处<context:component-scan>标签中的base-package须要和第3步中Java类的包一致。这个文件要保存在src/main/webapp/WEB-INF目录下，文件名为XXX-servlet.xml。这里的XXX是第4步中的<servlet-name>的值。

6 打包

执行mvn package

7 部署

打包操做完成后，会建立一个target目录。将其中的war文件复制到Tomcat的$CATALINA_HOME/webapps下便可完成部署。