建立你的第一個spring工程（下）

接上回，一個基本的java web已經建立好，那麼怎麼樣才能把它變成spring工程呢？

首先我們需要在pom.xml裡面配置對spring的依賴（就是引入spring的jar包），pom.xml裡面訓示了所有maven的依賴，也就是說你從maven上需要取什麼東西，就在這裡配置好，maven會自動去把這個東西拿到我們的工程裡面去。

可以用看到在<dependency>之間的部分就是所引入的jar包，maven已經幫我們引入了一個junit包，我們現在把spring引入。

<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>Jarvan</groupId>
  <artifactId>demo</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>demo Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
    	<groupId>org.springframework</groupId>
    	<artifactId>spring-core</artifactId>
    	<version>4.0.4.RELEASE</version>
    </dependency>
        <dependency>
    	<groupId>org.springframework</groupId>
    	<artifactId>spring-webmvc</artifactId>
    	<version>4.0.4.RELEASE</version>
    </dependency>
        <dependency>
    	<groupId>org.springframework</groupId>
    	<artifactId>spring-beans</artifactId>
    	<version>4.0.4.RELEASE</version>
    </dependency>
        <dependency>
    	<groupId>org.springframework</groupId>
    	<artifactId>spring-aop</artifactId>
    	<version>4.0.4.RELEASE</version>
    </dependency>
        <dependency>
    	<groupId>org.springframework</groupId>
    	<artifactId>spring-context</artifactId>
    	<version>4.0.4.RELEASE</version>
    </dependency>
        <dependency>
    	<groupId>org.springframework</groupId>
    	<artifactId>spring-expression</artifactId>
    	<version>4.0.4.RELEASE</version>
    </dependency>
        <dependency>
    	<groupId>org.springframework</groupId>
    	<artifactId>spring-web</artifactId>
    	<version>4.0.4.RELEASE</version>
    </dependency>
    <dependency>
    	<groupId>commons-logging</groupId>
    	<artifactId>commons-logging</artifactId>
    	<version>1.1.3</version>
	</dependency>
    
  </dependencies>
  <build>
    <finalName>demo</finalName>
  </build>
</project>
           

這裡引入jar包有不少方法，如果你不喜歡這樣的代碼界面，eclipse有專門的視圖界面讓你配置，pom.xml下面有一個dependencies的标簽，打開可以看到剛才配置的東西在這裡形成一個清單，我們點選左邊的add

彈出如下：

可以發現上面的groupID，artifactID和version都是我們配置時候的标簽。另外如果你需要某個包但不知道它的配置代碼怎麼寫的話，推薦一個網站 http://maven.outofmemory.cn/  這個網站是專門的maven中央庫查詢，maven上有的庫都可以在上面找到，例如common-logging我不知道怎麼配置，在下面的頁面直接搜尋即可：

搜尋後我們甚至可以直接得到配置代碼：

接着我們編輯web.xml檔案：

<web-app version="3.0" xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
    http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
    
  <display-name>Archetype Created Web Application</display-name>
  
  <servlet>
      <servlet-name>dispatcher</servlet-name>
      <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
          <init-param>
             <param-name>contextConfigLocation</param-name>
          <param-value>classpath:springContext.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>
  <context-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:springContext.xml</param-value>
  </context-param>
  <listener>
      <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>
</web-app>
           

但是改完後會發現這樣的錯誤：

這是由于maven所建立的webapp預設版本過老導緻（2.3版本），從這裡可以看出來：

而如今Tomcat 8和spring4.0.0以上版本都要求是3.0才行，這就需要我們改一下。在window -> show view -> navigator打開

打開org.eclipse.jdt.core.prefs檔案，如下圖：

把1.5改為1.7，然後再打開org.eclipse.wst.common.project.facet.core.xml，如下：

更改為：

然後再把web.xml上的<!DOCTYPE>标簽及其内容都删去，錯誤就解決了。

接下來我們在src/main/resourse下面建立springContext.xml檔案（其實就是上面web.xml裡面context-param标簽下面的.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:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.0.xsd">
    
    <!-- 搜尋spring控件 -->
    <context:component-scan base-package="com.test"></context:component-scan>
    <!-- 視圖頁面配置 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix">
            <value>/WEB-INF/views/</value>
        </property>
        <property name="suffix">
            <value>.jsp</value>
        </property>
    </bean>
</beans>
           

在springContext.xml中，base-package是指定spring控制器控件的包，prefix指定的是視圖目錄，被設定為/WEB-INF/views，即視圖目錄被放到WEB-INF下。suffix指定的是視圖的擴充名。例如，"hellospring"視圖，将被放到/WEB-INF/views/hellospring.jsp。

接下來我們建立spring控制器和視圖：

在com.test裡面建立一個HelloSpringController.java類

package com.test;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.servlet.ModelAndView;

 
@Controller
public class HelloSpringController {
    String message = "Welcome to Spring MVC!";
 
    @RequestMapping("/hello")
    public ModelAndView showMessage(@RequestParam(value = "name", required = false, defaultValue = "Spring") String name) {
 
        ModelAndView mv = new ModelAndView("hellospring");//指定視圖
        mv.addObject("message", message);
        mv.addObject("name", name);
        return mv;
    }
}
           

然後是項目的首頁index.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Spring 4 MVC - HelloWorld Index Page</title>
</head>
<body>
 
    <center>
        <h2>Hello World</h2>
        <h3>
            <a href="hello?name=Jarvan" target="_blank" rel="external nofollow" >點選跳轉</a>
        </h3>
    </center>
</body>
</html>
           

接着是首頁所要跳轉的頁面，建立如下目錄：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Spring 4 MVC -HelloWorld</title>
</head>
<body>
    <center>
        <h2>Hello World</h2>
        <h2>
            ${message} ${name}     </h2>
    </center>
</body>
</html>
           

好的，至此我們的第一個spring工程已經全部配置完畢了，接下來就在Tomcat上運作一下看看：