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命令部署 
参考 

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 应用程序流程

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>

View Code

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>

View Code

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>

View Code

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>

View Code

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; @Controllerpublic class HelloWorldController {     @RequestMapping("/hello")    public String hello(Model model) {                 model.addAttribute("greeting", "Hello Spring MVC");                 return"helloworld";             } }

View Code

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>

View Code

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 方法一、手动部署（最快速简单）

1. 直接把Target下生成文件夹HelloSpringMVC拷贝到tomcat的webapps
2. 运行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)