springmvc学习笔记---idea创建springmvc项目

前言:
　　真的是很久没搞java的web服务开发了, 最近一次搞还是读研的时候, 想来感慨万千. 英雄没落, Eclipse的盟主地位隐隐然有被IntelliJ IDEA超越的趋势. Spring从2.x到现在4.x, 一眨眼已是二代的积淀.
　　本文想借助Idea, 来简单搭建一个基于springmvc的web程序, 一为体验, 二为技术积累.

环境配置:
　　idea版本为14.0.2, tomcat版本为8.0.23, idea创建的springmvc为4.1.1.RELEASE.
　　网上有很多图文并茂的搭建案例, 同时也有很多教学视频. 但我一直觉得: 纸上得来终觉浅，绝知此事要躬行. 权作学习笔记.

项目创建:
　　1). idea中新建工程, 选择左侧的Spring项, 再右侧选择Spring MVC标签.
　　
　　2). 选中"Create project from template"标签, 使用默认模板.
　　
　　3). 填充Project Name以及Application server.
　　
　　4). springmvc项目创建完成
　　
　　其是由maven管理的web服务工程
　　其web.xml自动填充为如下内容:

<web-app version="2.4"
　　xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
　　xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
　　http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

　　<display-name>Spring MVC Application</display-name>
　　<servlet>
　　　　<servlet-name>mvc-dispatcher</servlet-name>
　　　　<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
　　　　<load-on-startup>1</load-on-startup>
　　</servlet>

　　<servlet-mapping>
　　　　<servlet-name>mvc-dispatcher</servlet-name>
　　　　<url-pattern>/</url-pattern>
　　</servlet-mapping>

</web-app>

　　springmvc的DispatcherServlet会自动装载以mvc-dispatcher开头的xml配置文件.
　　而mvc-dispatcher-servlet.xml配置文件, 其内容如下所示:

<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"
　　xsi:schemaLocation="http://www.springframework.org/schema/beans
　　http://www.springframework.org/schema/beans/spring-beans.xsd
　　http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">

　　<context:component-scan base-package="com.springapp.mvcaa"/>

　　<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
　　　　<property name="prefix" value="/WEB-INF/pages/"/>
　　　　<property name="suffix" value=".jsp"/>
　　</bean>

</beans>

　　这些配置文件和文件目录组织都是自动生成的, 大大降低了开发springmvc的门槛. 体验First, 然后才是熟悉和深入.

服务测试:
　　• web应用服务配置
　　1). 配置web应用服务, 点击Run->Edit Configurations菜单项
　　
　　选中tomcat服务器, 其HTTP port和JMX port端口会自动填充
　　2). 在Deployment子Tab中, 添加工程的war包
　　
　　• 代码准备
　　springmvc在创建时, 就已经带有了HelloController的sample类.

package com.springapp.mvcaa;

import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
@RequestMapping("/")
public class HelloController {
　　@RequestMapping(method = RequestMethod.GET)
　　public String printWelcome(ModelMap model) {
　　　　model.addAttribute("message", "Hello world!");
　　　　return "hello";
　　}
}

　　具体的代码细节, 我们暂且搁置不细讲, 大致为填充key/value对 (message=>Hello World), 然后控制器转到名为hello的jsp文件进行渲染.
　　• 浏览器测试
　　1). 启动tomcat服务
　　
　　2). 浏览器访问
　　
　　遗憾的是出现Unable to compile class for JSP的错误.
　　网上寻找资料后知晓, 该问题由maven引入的servlet-api和tomcat自带的servlet-api版本发生了冲突.
　　解决方案如下:
　　maven的pom文件中, 把servlet-api依赖项的scope改为provided(即参与compile和test, 但不参与package).

<dependency>
　　<groupId>javax.servlet</groupId>
　　<artifactId>servlet-api</artifactId>
　　<version>2.5</version>
</dependency>

　　改为如下所示:

<dependency>
　　<groupId>javax.servlet</groupId>
　　<artifactId>servlet-api</artifactId>
　　<version>2.5</version>
　　<scope>provided</scope>
</dependency>

　　再次重启web服务, 浏览器访问, 这次正常.

　　

总结:
　　idea创建springmvc项目, 还是比较顺利, "Hello World"的sample样例也自动帮我们生成了. 唯一一个坑就是 servlet-api的版本冲突问题. 解决方案对maven的依赖理解可以更深入一步. 下文将讲解基于springmvc的restful项目的搭建, 希望越来越好.

写在最后：
　　如果你觉得这篇文章对你有帮助, 请小小打赏下. 其实我想试试, 看看写博客能否给自己带来一点小小的收益. 无论多少, 都是对楼主一种由衷的肯定.