利用Maven搭建第一个Spring测试项目

在开始之前请先配置好Spring和Maven。

• 配置Spring可以到Spring官方下载开发包。更详细的地址。
  PS：利用官方发布的Spring依赖包可以手动管理jar包，但是在Spring 3.0.2的版本之后官方已经停止对依赖包的更新（可以在这里下载spring-3.0.2.依赖包），因此推荐舍弃手动管理，直接使用maven。
• 配置Maven可参考Maven的下载以及安装、关于使用eclipse自带的maven插件以及使用自己安装maven插件。

1 在Eclipse中利用Maven配置依赖包

1.打开Eclipse，新建一个Maven工程。

File-New-Maven Project

选择workspace，点击Next

选择webapp，点击Next

命名，点击Finish

提示是有错误的

找到错误提示

这时我们需要修改一个地方。

右键项目选择Build Path

Libraries-Add Library..-Server Runtime-Next

选中Tomcat，点击Finish

完成后如果还有提示，可以发现是版本不对

右键，选择Properties

改成1.8版本

创建Web项目无误

2.双击打开pom.xml，默认是Overview视图，可以点击下面的页签来切换页面。编辑pom.xml文件，导入需要的包，这里使用的Spring开发包为4.3.22版本，代码如下。

    
    
        org.springframework
        spring-beans
        4.3.22.RELEASE
    
    
        org.springframework
        spring-context
        4.3.22.RELEASE
    
    
        org.springframework
        spring-core
        4.3.22.RELEASE
    
    
        org.springframework
        spring-expression
        4.3.22.RELEASE
    


    
        org.springframework
        spring-jdbc
        4.3.22.RELEASE
    
    
        org.springframework
        spring-tx
        4.3.22.RELEASE
    
   
        org.springframework
        spring-aop
        4.3.22.RELEASE
    
    
    
        org.springframework
        spring-web
        4.3.22.RELEASE
    
    
        org.springframework
        spring-webmvc
        4.3.22.RELEASE
    
  
    
        commons-logging
        commons-logging
        1.1.3
    
    
    
        org.springframework
        spring-test
        4.3.22.RELEASE
　　

如果你需要某个包但不知道它的配置代码怎么写的话，推荐一个网站 http://maven.outofmemory.cn/ 这个网站是专门的maven中央库查询，maven上有的库都可以在上面找到。
3.保存pom.xml文件后，Maven自动进行jar包管理。

目录下可查看

2 修改webapp默认配置

一般情况下，maven所创建的webapp默认版本过老。比如默认生成的Dynamic Web Module 为2.3版本，而如今Tomcat 8和spring4.0.0以上版本都要求是3.0才行。同样的还有Java和JavaScript等等。
通常情况下，我们会右键点击项目名称，选择Properties，进入项目属性页面，左侧选择Project Facts，直接进行webapp的修改。

image.png

但是在maven所创建的这个项目里，系统却无法点击 Apply 和 OK，例如我们将Dynamic Web Module修改为3.0。

image.png

没有探寻原因，可能是一个bug。我们直接采用另一种办法来解决即可。

window - show view - navigator

进入本项目目录下的.settings文件夹内，修改该目录下的三个配置文件内容：

image.png

在org.eclipse.jdt.core.prefs中，将1.5修改为1.8（当前jdk版本）。
在org.eclipse.wst.common.component中，将project-version="1.5.0"修改为project-version="1.8.0"。
在org.eclipse.wst.common.project.facet.core.xml中，将修改为3.0、修改为1.8。
保存修改过后的文件，然后右键项目名称，选择Properties，在左侧选择栏中选择Project Facts，可以看到配置已经修改成功。

3 一个最基本的Spring项目

Maven创建的web项目目录结构浅析可参考这里，下面开始搭建一个最基本的Spring项目。

1.配置web.xml

找到目录下文件

修改代码如下。

   

    
  Archetype Created Web Application
  
  
      dispatcher
      org.springframework.web.servlet.DispatcherServlet
          
             contextConfigLocation
          classpath:springContext.xml
      
      1
  
  
      dispatcher
      /
  
  
      contextConfigLocation
      classpath:springContext.xml
  
  
      org.springframework.web.context.ContextLoaderListener
  

2.在src/main/resourse下创建springContext.xml文件
注意和web.xml里面context-param标签下面的.xml文件名和这里新建的.xm文件名保持一致。

    
    
    
    
    
        
            /WEB-INF/views/
        
        
            .jsp
        
    

在springContext.xml中，base-package是指定spring控制器控件的包，prefix指定的是视图目录，被设置为/WEB-INF/views，即视图目录被放到WEB-INF下。suffix指定的是视图的扩展名。例如，"hellospring"视图，将被放到/WEB-INF/views/hellospring.jsp。
3.创建spring控制器。

在Java Resource/src/main/java下新建com.test包

在com.test里面建立一个HelloSpringController.java类

代码如下。

package com.test;
 
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.servlet.ModelAndView;
 
 
@Controller
public class HelloSpringController {
    String message = "Welcome to Spring MVC!";
 
    @RequestMapping("/hello")
    public ModelAndView showMessage(@RequestParam(value = "name", required = false, defaultValue = "Spring") String name) {
 
        ModelAndView mv = new ModelAndView("hellospring");//指定视图
        mv.addObject("message", message);
        mv.addObject("name", name);
        return mv;
    }
}

4.创建spring视图。项目的首页index.jsp代码如下。

<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>







 
    
        
Hello World
        

            点击跳转
        
    

5.建立跳转页面。

首先建立目录views

接着在views目录下新建跳转页面hellospring.jsp

代码如下。

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>







    
        
Hello World
        

            ${message} ${name}     
    

至此，一个最基本的Spring工程已经全部配置完毕了。

4 运行结果

Tomcat运行结果1

点击跳转链接，Tomcat运行结果2

5 总结

Spring入门第0.5天。利用Maven搭建第一个Spring测试项目，成功。

注：项目代码来自怀英兄