本教程中,我们将教给大家如何创建一个基于Spring MVC 的 Maven Web Project。
用到的技术/工具:
1、Eclipse 4.9
2、Maven 3.6.2
3、Tomcat 8.5.34
4、JDK 1.8
5、Spring 4.3.14.RELEASE
2.1 新建Maven Project
打开Eclipse IDE,新建Maven Project,步骤:File->Project->Maven->Maven Project
在此不要勾选“Create a simple project(skip archetype selection)”,勾选了将会跳过模板选择,框架结构就需要自己手动去建了,不要勾选。接下来选择一下项目工程的路径
我们给项目命名“maven_webapp”,如果这个目录不存在,可以自己创建一个,选择这个文件目录
选择模板“maven-archetype-webapp”:
配置:Group Id一般指项目所属的组织机构,Artifact Id指项目名称,Package会根据前面的两项自动生成,接着下一步完成,一个Maven的Web项目就创建完毕了。
创建完成后,可以看一下项目的目录结构:
上图发现了两个问题:
1、 项目目录出现了错误红叉
2、 而且目录结构缺少java和test的结构目录
原因:打开index.jsp文件后,鼠标移到左边的红叉上,提示没有找到javax.servlet.http.HttpServlet ,这是没有Java Build Path 中没有引入Tomcat Server的原因。
2.2 添加Tomcat Server
两种方式:
1、右键->项目名称->Build Path->Configure Build Path->Java Build Path
2、菜单:Project->Properties->Java Build Path
Libraries中并没有Tomcat,所以需要“Add Library...”来添加
现在Libraries中已经添加了Tomcat。再来看一下项目的结构目录中不但红叉的错误消失了,而且增加了java和test的结构目录,让项目结构完整了。
2.3 配置pom.xml
引入依赖包:spring-web、spring-webmvc、commons-logging、servlet、jsp.jstl、taglibs
<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.gg</groupId> <artifactId>maven_webapp</artifactId> <packaging>war</packaging> <version>0.0.1-SNAPSHOT</version> <name>maven_webapp Maven Webapp</name> <url>http://maven.apache.org</url> <!-- 公共属性,方便控制,可通过类似于表达式EL一样引用 --> <properties> <spring.version>4.3.14.RELEASE</spring.version> </properties> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> <!-- 搭建Springmvc框架只需要引用spring-web,spring-webmvc两个包即可Maven会自动引用他们的依赖包 --> <!-- https://mvnrepository.com/artifact/org.springframework/spring-web --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <!-- Maven中通过类似与EL表达式一样可以引用上方配置公共属性 --> <version>${spring.version}</version> </dependency> <!-- https://mvnrepository.com/artifact/org.springframework/spring-webmvc --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <!-- https://mvnrepository.com/artifact/commons-logging/commons-logging --> <dependency> <groupId>commons-logging</groupId> <artifactId>commons-logging</artifactId> <version>1.1.1</version> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.1.0</version> </dependency> <dependency> <groupId>javax.servlet.jsp.jstl</groupId> <artifactId>jstl-api</artifactId> <version>1.2</version> </dependency> <dependency> <groupId>taglibs</groupId> <artifactId>standard</artifactId> <version>1.1.2</version> </dependency> </dependencies> <build> <finalName>maven_webapp</finalName> </build> </project>
2.4 配置web.xml
设置spring-mvc的配置文件路径/WEB-INF/mvc-dispatcher-servlet.xml,mvc-dispatcher-servlet.xml文件可以在后面创建。
<web-app 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_2_5.xsd" version="2.5"> <display-name>Archetype Created Web Application</display-name> <!-- The front controller of this Spring Web application, responsible for handling all application requests --> <servlet> <servlet-name>mvc-dispatcher</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <!-- 配置springmvc配置文件的加载位置,如果不配置的话默认加载WEB-INF目录下的 [servlet-name]-servlet.xml 这里没配置的话将加载目录下的springDispatcherServlet-servlet.xml --> <param-name>contextConfigLocation</param-name> <!-- 这里需要注意项目中的classpath并不是/src目录下,而是存放编译后的代码的地方, 通常默认为/classes目录下 --> <!--<param-value>classpath:springmvc-servlet.xml</param-value>--> <param-value>/WEB-INF/mvc-dispatcher-servlet.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <!-- Map all requests to the DispatcherServlet for handling --> <servlet-mapping> <servlet-name>mvc-dispatcher</servlet-name> <!-- 配置DispatcherServlet需要拦截配置,共有 *.[xx], /*, /, /xx/* 几种方式 这里我们配置为/ 即为拦截所有的资源,后面我们会在springmvc配置文件中单独配置 静态资源让其不拦截 --> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>
2.5 spring-mvc配置
根据上一步web.xml中的spring-mvc的文件路径配置,需要在WEB-INF目录下手动创建一个名字为mvc-dispatcher-servlet.xml的文件,添加配置:
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:mvc="http://www.springframework.org/schema/mvc" 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.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd" > <!-- 开启springmvc的注解 下面就不需要手动注册注解类型的处理器映射器与处理器适配器 --> <mvc:annotation-driven/> <!-- 扫描注解,配置到需要扫描的包即可 --> <context:component-scan base-package="com.gg.maven_webapp"></context:component-scan> <!-- 设置静态资源路径,这样就不会被前端控制器拦截处理 --> <mvc:resources location="/resources/" mapping="/resources/**"></mvc:resources> <!-- 注册视图解析器 --> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <!-- jsp中会使用到jstl,所以设置为jstlView --> <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/> <!-- 视图路径前缀 --> <property name="prefix" value="/resources/jsp/" /> <!-- 视图后缀 --> <property name="suffix" value=".jsp" /> </bean> </beans>
2.6 创建spring mvc的控制器类
创建一个spring mcv控制器类BaseController:
源代码:BaseController.java
package com.gg.maven_webapp; import javax.servlet.http.HttpServletRequest; import org.springframework.stereotype.Controller; import org.springframework.ui.ModelMap; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.servlet.ModelAndView; import org.springframework.ui.Model; @Controller @RequestMapping("/say") public class BaseController { @RequestMapping("/hello") public String hello(ModelAndView modelAndView,Model model,HttpServletRequest request) { String context = " say hello"; modelAndView.addObject("modelview", "modelview"+context); model.addAttribute("model", "model"+context); request.setAttribute("request", "request"+context); System.out.println(context); return "result"; } }
代码中的return “result”表示对应的视图result.jsp文件,根据mvc-dispatcher-servlet.xml文件中的配置,视图的文件放置在/webapp/resources/jsp/,对应文件result.jsp。
稍后通过 http://localhost:8080/maven_webapp/say/hello 访问。
2.7 创建jsp视图文件
在对应目录下创建result.jsp视图文件
html源代码:
<html> <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> <body> <h2>Hello World!</h2> <body> <p>modelAndView结果${modelview}</p> <p>model结果${model }</p> <p>request结果${request }</p> </body> </body> </html>
2.8 Tomcat运行项目
如果项目中已经添加了Tomcat Server的话,可以 右键->Add And Remove…,将项目添加到启动配置中。
启动运行tomcat,打开浏览器访问:http://127.0.0.1:8080/maven_webapp/say/hello