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标签.
  springmvc学习笔记---idea创建springmvc项目
  2). 选中"Create project from template"标签, 使用默认模板.
  springmvc学习笔记---idea创建springmvc项目
  3). 填充Project Name以及Application server.
  springmvc学习笔记---idea创建springmvc项目
  4). springmvc项目创建完成
  springmvc学习笔记---idea创建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菜单项
  springmvc学习笔记---idea创建springmvc项目
  选中tomcat服务器, 其HTTP port和JMX port端口会自动填充
  2). 在Deployment子Tab中, 添加工程的war包
  springmvc学习笔记---idea创建springmvc项目
  • 代码准备
  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服务
  springmvc学习笔记---idea创建springmvc项目
  2). 浏览器访问
  springmvc学习笔记---idea创建springmvc项目
  遗憾的是出现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服务, 浏览器访问, 这次正常.

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

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

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

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

上一篇:Django:学习笔记(2)——创建第一个应用


下一篇:yii学习笔记--快速创建一个项目