使用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下便可完成部署。