Maven 工程下 Spring MVC 站点配置 (一)
最近,查找一些具体资料时,虽然会有很多,但是系统的却很少,尤其是对maven 下 spring mvc 站点搭建的配置,总是说的很多但让新手一目了然的步骤却少之又少.
对此闲暇时整理了一下,做了一套较为完整的图文配置系列流程,供新手参考;
Maven 工程下 Spring MVC 站点配置 (一)
Maven 工程下 Spring MVC 站点配置 (二) Mybatis数据操作
Eclipse IDE 工具版本:
首先创建一个Maven工程:
File --> New --> Other,然后选择Maven目录下的Maven Project,如下图:
然后在弹出的面板中选择选择配置后,下一步即可,如图:
Create a simple project (skip archetype selection) :此选项表示跳过后续的配置选项框。
Use default Workspace location:表示将项目放置到默认的工作区域下。
配置好后,Next下一步,再进行如下图的配置:
点击Finish后,便完成了Maven工程的创建。
此时在你开发工具的Workspace工作区的树桩菜单中出现了McqueenXingSpring这个项目工程.如图:
接下来我们进行详细的项目搭建,首先配置maven 工程文件 pom.xml,
因为我们要搭建Spring MVC这个工程,所以就要将相关的jar包配置到Maven工程中进行引用管理;
pom.xml文件配置如下:
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>McqueenXingSpring</groupId>
<artifactId>McqueenXingSpring</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>war</packaging>
<dependencies>
<!-- 支持servlet的jar包 -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
<scope>provided</scope>
</dependency>
<!-- Spring MVC 依赖配置 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>4.1.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>4.1.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>4.1.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<version>4.1.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>4.1.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>4.1.2.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>4.1.2.RELEASE</version>
</dependency>
</dependencies>
</project>
Maven配置好后,我们就需要在项目中进行WEB站点搭建了;
因为一开始创建Maven工程时,选择的是 Create a simple project 属性,
所以在webapp项目下可能会没有任何文件,如图:
这个时候就需要我们自己去创建它们。
首先在 webapp 下增加一个 WEB-INF 文件夹;
然后在 WEB-INF 文件夹中增加一个 web.xml(部署描述符文件);
接下来我们就要在这个文件中进行一些配置工作;
我们先解决编码问题, 这个是经常会遇到并且让人头疼的问题,内容如下:
<filter-name>Set Character Encoding</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
<init-param>
<param-name>Set Character Encoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>Set Character Encoding</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
然后在WEB-INF中增加一个 mcqueenxing-servlet.xml 文件;
这个文件的作用是配置Spring和servlet容器的,内容如下:
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:tx="http://www.springframework.org/schema/tx"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop-3.0.xsd
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
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx-3.0.xsd">
<!-- 激活@Controller -->
<mvc:annotation-driven />
<!-- 自动扫描工程包. -->
<context:component-scan base-package="mcqueen.controller" />
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/" />
<property name="suffix" value=".jsp" />
</bean>
</beans>
在上面这个配置文件中我们看到这样一个节点中的内容,base-package="mcqueen.controller";
这个mcqueen.controller就是你架构网站时的包结构;
那么我们把它创建出来,如图:
在这个包下面增加一个IndexController.java文件,内容如下:
2
3 import org.springframework.stereotype.Controller;
4 import org.springframework.ui.Model;
5 import org.springframework.web.bind.annotation.RequestMapping;
6
7 @Controller
8 public class IndexController {
9
10 @RequestMapping(value="index.html")
11 public void index(Model m){
12 m.addAttribute("result", "Yor are welcome to use Spring MVC, My name is Mcqueen Xing.");
13 }
14 }
然后我们再从网站 WEB-INF 目录下增加一个 views 目录,并增加一个index.jsp文件,如图:
在jsp页面body中增加以下html代码:
<h1>${ result }</h1>
这段代码适用于将后台Controller 传递过来的参数输出到页面上;
接下来回头找到/WEB-INF/web.xml文件,我们在里面增加一组Spring MVC的拦截配置,代码如下:
2 <servlet-name>mcqueenxing</servlet-name>
3 <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
4 <init-param>
5 <param-name>contextConfigLocation</param-name>
7 <param-value>/WEB-INF/mcqueenxing-servlet.xml</param-value>
8 </init-param>
9 <load-on-startup>1</load-on-startup>
10 </servlet>
11 <servlet-mapping>
12 <servlet-name>mcqueenxing</servlet-name>
13 <url-pattern>*.html</url-pattern>
14 </servlet-mapping>
配置到此时,Spring MVC 站点基本已经配置完成。
启动调试运行后,如图: