SpringMVC HelloWorld实例开发及部署

2017-01-24

1 Tomcat及Eclipse Tomcat插件安装配置
1.1 Tomcat的安装
1.2 Eclipse Tomcat插件安装
1.3 配置tomcat
2 创建maven工程HelloSpringMVC项目
2.1 根据向导创建maven-archetype-webapp项目
2.2 项目完成后的目录结构及程序流程
2.3 代码
3 用Eclipse构建项目
4 用Eclipse的embed maven runtime运行项目
5 把HelloSpringMVC部署到Tomcat
5.1 方法一、手动部署（最快速简单）
5.2 方法二、eclipse界面操作
5.3 方法三、maven命令部署
 参考

源代码：HelloSpringMVC.zip

1 Tomcat及Eclipse Tomcat插件安装配置^[1]

1.1 Tomcat的安装

tomcat下载地址：http://tomcat.apache.org/%20

下载后解压到：D:\tomcat

1.2 Eclipse Tomcat插件安装

下载eclipse的tomcat插件：http://www.eclipsetotale.com/tomcatPlugin.html

解压后，把解压文件“com.sysdeo.eclipse.tomcat_3.3.1.jar”放到eclispe安装目录的plugins目录中，重启eclipse

验证安装tomcat插件，打开eclipse看到tomcat菜单，安装成功。

1.3 配置tomcat

Eclipse - toolsbar -> Window -> Prefences -> Tomcat -> 指向刚才 Tomcat 解压

2 创建maven工程HelloSpringMVC项目^[2]

2.1 根据向导创建maven-archetype-webapp项目

1 选择Maven Project向导，点击next

2 默认，点击next

3 选择“maven-archetype-webapp"，点击next

4 输入：

Group Id: com.demo
Artifact Id: HelloSpringMVC
Package: com.demo.springmvc

点击finish

按向导创建的项目结果如下图所示：

2.2 项目完成后的目录结构及程序流程

1 项目后的结构

2 应用程序流程

上面的是springMVC的工作原理图：

1、客户端发出一个http请求给web服务器，web服务器对http请求进行解析，如果匹配DispatcherServlet的请求映射路径（在web.xml中指定），web容器将请求转交给DispatcherServlet.

2、DipatcherServlet接收到这个请求之后将根据请求的信息（包括URL、Http方法、请求报文头和请求参数Cookie等）以及HandlerMapping的配置找到处理请求的处理器（Handler）。

3-4、DispatcherServlet根据HandlerMapping找到对应的Handler,将处理权交给Handler（Handler将具体的处理进行封装），再由具体的HandlerAdapter对Handler进行具体的调用。

5、Handler对数据处理完成以后将返回一个ModelAndView()对象给DispatcherServlet。

6、Handler返回的ModelAndView()只是一个逻辑视图并不是一个正式的视图，DispatcherSevlet通过ViewResolver将逻辑视图转化为真正的视图View。

7、Dispatcher通过model解析出ModelAndView()中的参数进行解析最终展现出完整的view并返回给客户端。

2.3 代码

2.3.1 src\main\webapp\WEB-INF\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>com.demo</groupId>
    <artifactId>HelloSpringMVC</artifactId>
    <packaging>war</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <name>HelloSpringMVC 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>
 
        <!-- Servlet Library -->
        <!-- http://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>
 
        <!-- Spring dependencies -->
        <!-- http://mvnrepository.com/artifact/org.springframework/spring-core -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
            <version>4.1.4.RELEASE</version>
        </dependency>
 
        <!-- http://mvnrepository.com/artifact/org.springframework/spring-web -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-web</artifactId>
            <version>4.1.4.RELEASE</version>
        </dependency>
 
        <!-- http://mvnrepository.com/artifact/org.springframework/spring-webmvc -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>4.1.4.RELEASE</version>
        </dependency>
            </dependencies>
 
    <build>
        <finalName>HelloSpringMVC</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.2</version>
                <configuration>
                    <url>http://localhost:8080/manager/text</url>
                    <username>admin</username>
                    <password>Pass@1</password>
                    <path>/${project.artifactId}</path>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

2.3.2 src\main\webapp\WEB-INF\web.xml

<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/javaeehttp://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
    id="WebApp_ID" version="3.0">
    <display-name>HelloWorldSpring</display-name>
 
    <servlet>
        <servlet-name>spring-mvc</servlet-name>
        <servlet-class>
            org.springframework.web.servlet.DispatcherServlet
        </servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
 
    <servlet-mapping>
        <servlet-name>spring-mvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
 
    <!-- Other XML Configuration -->
    <!-- Load by Spring ContextLoaderListener -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/root-context.xml</param-value>
    </context-param>
 
    <!-- Spring ContextLoaderListener -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener
        </listener-class>
    </listener>
</web-app>

2.3.3 src\main\webapp\WEB-INF\spring-mvc-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"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
      http://www.springframework.org/schema/beans/spring-beans-4.1.xsd
      http://www.springframework.org/schema/context
      http://www.springframework.org/schema/context/spring-context-4.1.xsd
      http://www.springframework.org/schema/mvc
      http://www.springframework.org/schema/mvc/spring-mvc-4.1.xsd">
 
   <context:component-scan base-package="com.demo.springmvc"/>
 
   <context:annotation-config/>
 
   <bean
       class="org.springframework.web.servlet.view.InternalResourceViewResolver">
 
       <property name="prefix">
           <value>/WEB-INF/pages/</value>
       </property>
       <property name="suffix">
           <value>.jsp</value>
       </property>
   </bean>
</beans>

2.3.4 src\main\webapp\WEB-INF\root-context.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
   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.xsd">
 
  <!-- Empty -->
 
</beans>

2.3.5 com.demo.springmvc.HelloWorldController.java

package com.demo.springmvc;
 
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
 
@Controller
public class HelloWorldController {
 
    @RequestMapping("/hello")
    public String hello(Model model) {
        model.addAttribute("greeting", "Hello Spring MVC");
        return"helloworld";
    }
}

2.3.6 src\main\webapp\WEB-INF\pages\helloworld.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>Spring4 MVC - HelloWorld</title>
</head>
<body>
    <h1>${greeting}</h1>
</body>
</html>

3 用Eclipse构建项目^[2]

右击该项目并选择Run As->Maven install，运行成功后，会在工作目录的target目录下生成HelloSpringMVC文件夹和HelloSpringMVC.war，且会把HelloSpringMVC.war和pom.xml改名后安装到相应的的maven目录下（若按在Eclipse中配置maven配置，会安装到 D:\Dev\maven\repo\m2\）。运行结果如下图所示：

4 用Eclipse的embed maven runtime运行项目^[2]

右击项目，选择“Run Configurations...”,在弹出的“Run Configurations”窗口，右击“Maven Build”，选择“New”，输入：

Name: Run HelloSpringMVC （随意命名）
Base directory: ${workspace_loc:/HelloSpringMVC} =>${workspace_loc:/HelloSpringMVC Maven Webapp}
Goals: tomcat7:run

运行结果，如下图所示：

浏览器输入：http://localhost:8080/HelloSpringMVC/hello，结果如下：

注意：上图中，若按红色方框按钮停止运行embed tomcat，浏览器就会返回“无法显示此页”。

5 把HelloSpringMVC部署到Tomcat^[3]

这里提供三种方法：

5.1 方法一、手动部署（最快速简单）

直接把Target下生成文件夹HelloSpringMVC拷贝到tomcat的webapps
运行combat的bin目录下批处理startup.bat

注意：步骤1、2顺序可以互换，应为当把文件夹HelloSpringMVC考到tomcat下时，tomcat会自动部署这个项目

5.2 方法二、eclipse界面操作

1 配置tomcat

在tomcat7\conf\tomcat-users.xml加入

    <role rolename="admin-gui" />
    <role rolename="manager-gui" />
    <role rolename="manager-script"/>
    <user username="admin" password="Pass@1" roles="admin-gui,manager-gui,manager-script"/>

2 运行combat的bin目录下批处理startup.bat

3 配置pom.xml
在pom.xml更改tomcat7-maven-plugin配置，其中username和password要和tomcat中的一致

            <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.2</version>
                <configuration>
                    <url>http://localhost:8080/manager/text</url>
                    <username>admin</username>
                    <password>Pass@1</password>
                    <path>/${project.artifactId}</path>
                </configuration>
            </plugin>

4 选择“Run Configurations...”,在弹出的“Run Configurations”窗口，右击“Maven Build”，选择“New”，输入：

Name: Deploy HelloSpringMVC （随意命名）
Base directory: ${workspace_loc:/HelloSpringMVC} =>${workspace_loc:/HelloSpringMVC Maven Webapp}
Goals: tomcat7:deploy

注意：deploy:如果已经部署过,再deploy就会失败.去tomcat7的webapps删除已经部署过的就行了。或者改为Goals: tomcat7:redeploy

结果如下：

5.3 方法三、maven命令部署

前三步和5.2一样

最后一步，在命令行转到项目目录下输入。

D:\Dev\maven\bin\mvn tomcat7:deploy

注意：tomcat7是你安装的版本

结果如下：

浏览器输入：http://localhost:8080/HelloSpringMVC/hello 就可以看到页面了。

参考

[1] Eclipse Tomcat插件的配置，及 Tomcat 的配

[2] Spring4 MVC HelloWord实例

[3] Eclipse下maven部署web项目到tomcat7(兼容tomcat8)