spring MVC 框架的搭建（myeclipse +maven）--（上）

 spring mvc 的框架搭建过程如下，这个框架建议新手去看，因为搭建的是一个比较简单的矿建，当然里面涉及到的spring +hibernate相关的知识，是值得学习的。

这个项目是基于maven的主要是maven 能够很好的帮我们管理jar 包。

 spring mvc 框架搭建过程如下：

第一步：使用maven引入springMVC所需要的jar包

               引入与springmvc相关的jar包，在pom.xml的<dependencise>标签下添加以下3个jar包

              (1) spring-webmvc 

              (2) spring-orm 

              (3)spring-context

              (4)sprign-web

             在pom.xml文件添加如下依赖：        

<dependencies>
<!-- springMVC begin -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>4.1.1.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>4.1.1.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>4.1.1.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-orm</artifactId>
<version>4.1.1.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>4.1.1.RELEASE</version>
</dependency>
<!-- springMVC end -->
</dependencies>

当添加完之后，通过更新工程，maven就会自动给我们的项目引入我们所需要的jar包，当引入完成之后我们可以去我们工程的Maven Dependencies目录下

看见与springMVC相关的jar包如下：



第二步：添加web.xml配置文件中关于springMVC和spring 的配置

 2.1、配置springMVC

  DispatcherServletj简介:

              DispatcherServlet是前置控制器，配置在web.xml文件中的，拦截匹配的请求，Servlet拦截匹配规则要自已定义，把拦截下来的请求，依据某某规则分发到目标Controller(我们写的Action)来处理。

springMVC的配置代码如下：

  <!-- ******************springMvc的配置*********************************** -->
  <!--1、配置DispatcherServlet -->
  <servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
      <init-param>
        <param-name>contextConfigLocation</param-name>
        <!-- 指定自定义的文件名和文件路径 -->
        <param-value>classpath*:/META-INF/spring-mvc.xml</param-value>
      </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <!-- 设置dispatchservlet的匹配模式 -->
  <servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <!-- *.action代表所有的后缀为.action的请求都要经过经过DispatcherServlet控制器 -->
    <url-pattern>*.action</url-pattern>
  </servlet-mapping>
 <!--******************************************************************-->
  

<servlet-name>：这个属性非常重要，默认情况下，DispatchServlet会加载一个名字叫做【servlet-name】-servlet.xml的文件，可以看出上面的代码中servlet-name的值设置                        的为 springmvc 那么默认情况下就会加载一个名叫 springmvc-servlet.xml的文件
，这个文件默认是放在WEB-INF目录下 。

<load-on-startup>：这个值设置为1，表示启动容器时初始化该Servlet；

<servlet-mapping>:  设置dispatchservlet的匹配模式

                                    可以把dispatchservlet映射到/，这时候默认servlet会处理所有的请求，包括静态资源

                                    也可以把dispatcherservlet映射到*.action，这时候servlet只会拦截以
.action结尾的请求

2.2、配置spring

<!-- ******************spring 的配置******************************* -->
<!-- 指定Spring Bean的配置文件所在目录。默认配置在WEB-INF目录下-->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath*:/META-INF/spring-*.xml</param-value>
</context-param>
<!--配置监听器listener， 如果不写这个就无法扫描到spring-core文件，相当于程序的入入口  -->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!--******************************************************************-->

2.3、配置字符集过滤器

配置代码如下：

<!-- 字符集过滤器 -->
<filter>
<filter-name>encodingFilter</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>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

需要说明的是这个字符集过滤器的配置不是必须的，但是如果要处理中文的话，加上还是好一些。

第三步：配置springmvc-servlet.xml

springmvc-servlet这个名字是因为上面web.xml中<servlet-name>标签配的值为springmvc（<servlet-name>springmvc</servlet-name>），再加上“-servlet”后缀而形成的springmvc-servlet.xml文件名，如果改为spring-mvc，对应的文件名则为spring-mvc.xml。

需要注意的是有两种方式可以创建这个配置文件：

(1)默认方式：

 （1）这个文件的文件名格式为：<servlet-name> + '-' +servlet.xml组成，不能随意的改变这个文件名的名称

  （2）这个文件的创建位置是WEB-INF文件夹下面

(2)自定义方式：

假如我要创建的文件名我设置为：spring-mvc.xml（文件格式可不能随意改变噢还是为.xml）

创建的位置设置为：META-INF目录下（当然这个文件目录在我们创建的web工程下也是没有的，我就自己创建在）

<?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:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.2.xsd"> <!-- 自动扫描且只扫描@Controller -->
<!-- 设置使用注解的类所在的包 为：com.mayday.activiti 包-->
<context:component-scan base-package="com.mayday.activiti" use-default-filters="false">
<context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
<context:include-filter type="annotation" expression="org.springframework.web.bind.annotation.ControllerAdvice"/>
</context:component-scan>

<!-- 要使用spring mvc中的@Controller注解，就必须要配置<mvc:annotation-driven />
否则org.springframework.web.servlet.DispatcherServlet无法找到控制器并把请求分发到控制器。 -->
<mvc:annotation-driven />

<!-- 完成请求和注解POJO的映射 -->
<bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter" />

<!-- 对转向页面的路径解析。prefix：前缀， suffix：后缀 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/"/>
<property name="suffix" value=".jsp"/>
</bean>
</beans>

第四步：spring-core.xml配置

这个配置文件主要是用来进行spring的公共配置，比如Hibernate相关的配置，我们留在介绍Hibernate的时候介绍，现在大家可以先创建一个文件放在那里不用。

当我们创建完这两个配置文件，可以看见我们项目的目录结构变成下面这样：



好啦，简单的springmvc框架搭建至此已经搭建完成了，现在我把我们的核心配置文件web.xml的配置给大家贴出来：

<?xml version="1.0" encoding="UTF-8"?>
<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/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">
<display-name>activitiProject</display-name>

<!-- ******************spring 的配置******************************* -->
<!-- 指定Spring Bean的配置文件所在目录。默认配置在WEB-INF目录下-->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath*:/META-INF/spring-*.xml</param-value>
</context-param>
<!--配置监听器listener， 如果不写这个就无法扫描到spring-core文件，相当于程序的入入口  -->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!--******************************************************************-->

<!-- ******************springMvc的配置*********************************** -->
<!--1、配置DispatcherServlet -->
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<!-- 指定自定义的文件名和文件路径 -->
<param-value>classpath*:/META-INF/spring-mvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<!-- 设置dispatchservlet的匹配模式 -->
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<!-- *.action代表所有的后缀为.action的请求都要经过经过DispatcherServlet控制器 -->
<url-pattern>*.action</url-pattern>
</servlet-mapping>
<!--******************************************************************-->

<!-- 字符集过滤器 -->
<filter>
<filter-name>encodingFilter</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>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
</web-app>

第五步：测试

最有一步就是来测试我们的框架是否搭建成功，我们需要建一个java类activitiController.java在com.mayday.activiti包下面

代码如下：

package com.mayday.activiti;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class activitiController {

@RequestMapping(value ="index.action")
public String index(){
return "activiti";
}

}

我们可以发现在类的上面我们添加@controller的注解，表示这个类属于控制层，index函数的作用是返回activiti.jsp页面，这样的访问方式就是对应spring-mvc.xml

3、在WEB-INF下创建views文件夹，下面创建要访问的activiti.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>Insert title here</title>
</head>
<body>
hello activiti..............
</body>
</html>

如果框架搭建成功的话我们部署程序在浏览器访问url: http://localhost:8080/activitiProject/index.action 

就可以正确的跳转到activiti.jsp页面，输出页面上的内容



需要提示的是：

这个url的格式为： http://localhost:8080/activitiProject/index.action

index.action 表示要访问的index（）函数，具体为什么，大家可以去查一下注解@requestmapping参数

如果我配置的哪里有问题，也欢迎大家指出，下一篇将继续介绍springmvc框架的搭建与Hibernate相关的部分。