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)