SpringMVC框架入门配置 IDEA下搭建Maven项目

2017-10-30 本文已影响6人 NET快速开发框架

关于SpringMVC的介绍我就不在此赘述了，想必每一个配置Spring的人都已经或多或少了解过一些SpringMVC的基础知识，可能有的人用的myeclipse或者eclipse进行项目的搭建，我会告诉你这里步骤是很相似的，在myeclipse里面需要建立web项目，然后加入Spring支持，后续的jar包自己下载导入，其他配置和本文别无二致。但是本人推荐大家使用idea，这个编译器公认的java最好用的编译器，想必编写代码会更加的舒适快捷！
这里只讲解如何在IntelliJ IDEA下搭建maven SpringMVC项目：
一、首先需要有一个IntelliJ IDEA 可以去官网下载，虽然是收费的，然而并不算贵。
二、运行编译器新建项目

在弹出的窗体中选择maven，然后勾选要建的maven模板--这里选webApp

然后填入相应的maven项目组信息（这个是比较随意的）

这里填写自己的maven本地仓库路径（这个不用过多解释吧，用maven的基础）；

这里填写项目名称以及项目生成路径，然后在下方检查填写是否正确：

如果正确就点击Finish->
maven会自动创建需要的一些配置信息以及目录结构，在这段时间里我们可以查找需要的jar包并在maven配置文件pom.xml里面进行配置，见下面步骤：
这里如果不知道要用到什么jar包就去百度SpringMVC需要的jar包，然后在maven的官方链接单独查找jar包来配置pom.xml，实例如下（这里我示范去maven官网查找xml配置的部分，具体需要的jar包去我后面展示的pom.xml里面查找）：
登录http://mvnrepository.com/示例查找spring-beans

点击查找结果

这里可以看到最新版以及使用人数最多的版本，自己选择--配置文件里面的jar包版本最好选择同一个版本避免版本冲突；

我们选择第一个进入网页，里面可以看到maven的配置pom.xml文件写法，点击代码直接复制（自动复制）；

然后将复制的代码拷贝到pom.xml文件中去即可，maven会自动下载所需要的jar包，我们不需要理会（如果有网络不顺畅情况，请自行想办法下载jar包或联系本人，然后将下载好的jar包拷贝到对应的maven本地仓库文件夹中也可以的）；

这里我展示我配置的mavenpom.xml，maven会自动到库里面下载需要的jar包到maven仓库。

<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>qixiao</groupId>
  <artifactId>me</artifactId>
  <packaging>war</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>me 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>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-test</artifactId>
      <version>4.3.1.RELEASE</version>
    </dependency>
    <!--spring-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-beans</artifactId>
      <version>4.3.1.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>4.3.1.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>4.3.1.RELEASE</version>
    </dependency>

    <!--Spring Web + Spring MVC-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>4.3.1.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>4.3.1.RELEASE</version>
    </dependency>

    <!--json支持-->
    <!-- https://mvnrepository.com/artifact/org.json/json -->
    <dependency>
      <groupId>org.json</groupId>
      <artifactId>json</artifactId>
      <version>20160212</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/net.sf.json-lib/json-lib -->
    <dependency>
      <groupId>net.sf.json-lib</groupId>
      <artifactId>json-lib</artifactId>
      <version>2.4</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/commons-lang/commons-lang -->
    <dependency>
      <groupId>commons-lang</groupId>
      <artifactId>commons-lang</artifactId>
      <version>2.6</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/commons-beanutils/commons-beanutils -->
    <dependency>
      <groupId>commons-beanutils</groupId>
      <artifactId>commons-beanutils</artifactId>
      <version>1.8.3</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/commons-collections/commons-collections -->
    <dependency>
      <groupId>commons-collections</groupId>
      <artifactId>commons-collections</artifactId>
      <version>3.2.1</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/commons-logging/commons-logging -->
    <dependency>
      <groupId>commons-logging</groupId>
      <artifactId>commons-logging</artifactId>
      <version>1.2</version>
    </dependency>
    <!-- https://mvnrepository.com/artifact/net.sf.ezmorph/ezmorph -->
    <dependency>
      <groupId>net.sf.ezmorph</groupId>
      <artifactId>ezmorph</artifactId>
      <version>1.0.6</version>
    </dependency>
    <!--json serialize and deserialization-->
    <!-- 引入fastjson依赖 -->
    <dependency>
      <groupId>com.alibaba</groupId>
      <artifactId>fastjson</artifactId>
      <version>1.2.12</version>
    </dependency>
    <!-- 引入gson依赖 -->
    <dependency>
      <groupId>com.google.code.gson</groupId>
      <artifactId>gson</artifactId>
      <version>2.6.2</version>
    </dependency>
    <!--NoClassDefFoundError: javax/servlet/jsp/jstl/core/Config-->
    <!-- https://mvnrepository.com/artifact/jstl/jstl -->
    <dependency>
      <groupId>jstl</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>



  </dependencies>
  <build>
    <finalName>me</finalName>
  </build>
</project>

pom.xml

等系统构建完成以后，我们就可以看到目录结构

不全的可以按照需求来补全文件结构，maven项目中的文件结构分为Sources，Tests，Resources，Test Resources，Excluded几种，我们需要详细区分各个文件夹的类型：

配置文件夹类型方法如下：

可以选中文件夹点击上面的按钮来标注文件夹类型！
三、配置SpringMVC
一切就绪后接下来我们继续配置SpringMVC的具体信息：
首先需要配置Web.xml这个不必多说，网站项目运行第一个加载的就是web.xml，进入
src->main->webapp->WEB-INF->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"
         version="3.0">
    <welcome-file-list>
        <welcome-file>/index.jsp</welcome-file>
    </welcome-file-list>
    <!-- Spring MVC配置 -->
    <servlet>
        <servlet-name>spring</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

        <!-- 可以自定义servlet.xml配置文件的位置和名称，默认为WEB-INF目录下，名称为[<servlet-name>]-servlet.xml，如spring-servlet.xml
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/spring-servlet.xml</param-value>
        </init-param>-->

        <!-- load-on-startup元素标记容器是否在启动的时候就加载这个servlet(实例化并调用其init()方法) -->
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>spring</servlet-name>
        <url-pattern>/</url-pattern>
        <!--<url-pattern>*.do</url-pattern>-->
    </servlet-mapping>

    <!-- Spring配置 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!-- 指定Spring Bean的配置文件所在目录。默认配置在WEB-INF目录下 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:applicationContext.xml</param-value>
    </context-param>

</web-app>

然后在WEB-INF文件夹下新建 spring-servlet.xml

配置spring-servlet.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"
       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-3.1.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.1.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd">

    <!-- 启动注解驱动的Spring MVC功能，注册请求url和注解POJO类方法的映射-->  
    <mvc:annotation-driven >
         
    </mvc:annotation-driven>
   
    <!-- 启动包扫描功能，以便注册带有@Controller、@service、@repository、@Component等注解的类成为spring的bean -->
    <context:component-scan base-package="HelloSpringMvc.controller" />
    <!-- 对模型视图名称的解析，在请求时模型视图名称添加前后缀 -->
     <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
         <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
         <property name="prefix" value="/"/>    <!-- 前缀 -->
         <property name="suffix" value=".jsp"/>    <!-- 后缀 -->
     </bean>
    <!-- 访问静态文件（jpg,js,css）的方法 -->
    <mvc:resources location="/files/" mapping="/files/**" />
    <mvc:resources location="/scripts/" mapping="/scripts/**" />
    <mvc:resources location="/styles/" mapping="/styles/**" />
    <mvc:resources location="/Views/" mapping="/Views/**" />
</beans>

这里我们配置了静态文件路径，因此在目录结构新建几个文件夹用以放静态文件例如脚本，图片文件，视图之类的。

** 然后在Resources资源文件夹下新建applicationContext.xml**

配置applicationContext.xml这里并没有进行配置什么信息，因为本人用的是mysql jdbc连接数据库，没有用到Hibernate之类的orm，这里可以将hibernate相关配置项放在里面。

<?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-3.1.xsd">
    <!-- 我们可以在其中添加我们所需要配置的bean，也可以添加相应的数据库连接和事务处理等等，方便后续拓展
           -->
</beans>

这里我们就将SpringMVC的基本XML配置文件设置完毕，接下来我们进行一个小实例进行测试配置好的SpringMVC。

四：测试SpringMVC配置：
1、在controller文件夹下新建一个类名字叫TestController，代码如下：

package HelloSpringMvc.controller;

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

/**
 * Created by Administrator on 2016/8/29.
 */

@Controller
@RequestMapping(value = "/Test/*") //访问的url地址前缀，可以不写，写了就必须在方法url前面先加上class url 进行区分控制器
public class TestController
{
    //访问地址：http://localhost:8080/Test/returnSuccess
    @RequestMapping(value = "returnSuccess")    //实际访问的url地址
    public String returnSuccess() {
        return "/Views/success";    //返回Views文件夹下的success.jsp页面
    }

    //访问地址：http://localhost:8080/Test/returnString
    @RequestMapping(value = "returnString", produces = {"text/plain;charset=UTF-8"})
    //produces用于解决返回中文乱码问题，application/json;为json解决中文乱码
    @ResponseBody       //用于返回字符串,不写即返回视图
    public String returnString() {
        return "hello return string 这是中文，并没有乱码";
    }
}

然后我们在Views文件夹下建一个success.jsp 随便写点什么：