翻译了一位韩国哥们儿的博客,再加上一些自己的理解。写一个spring mvc开发的系列,当个自己的学习笔记。
原文链接:http://www.mkyong.com/spring3/spring-3-mvc-hello-world-example/
开发一个最简单的spring mvc版的hello world应用。
技术准备:
1、Spring 3.0.5.RELEASE
2、JDK 1.6
3、Maven 3
4、Eclipse 3.6(或者是IntellJ IDEA韩国哥们儿用的是Eclipse,我这儿用的是IntellJ IDEA 12.1.4)
一、 工程依赖pom文件
<?xml version="1.0" encoding="UTF-8"?> <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/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>hellospring</groupId> <artifactId>hellospring</artifactId> <version>1.0-SNAPSHOT</version> <packaging>war</packaging> <properties> <spring.version>3.0.5.RELEASE</spring.version> </properties> <dependencies> <!-- Spring 3 dependencies --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> </dependencies> </project>二、控制器和映射
package controller; 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("/welcome") public class HelloController { @RequestMapping(method = RequestMethod.GET) public String printWelcome(ModelMap model) { model.addAttribute("message", "Spring 3 MVC Hello World"); return "hello"; } }三、jsp视图
<html> <body> <h1>Message : ${message}</h1> </body> </html>四、spring配置文件
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context" 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.0.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd"> <context:component-scan base-package="controller" /> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix"> <value>/WEB-INF/pages/</value> </property> <property name="suffix"> <value>.jsp</value> </property> </bean> </beans>五、web.xml文件
<web-app id="WebApp_ID" version="2.4"
<span style="white-space:pre"> </span>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 Web 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> <context-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/mvc-dispatcher-servlet.xml</param-value> </context-param> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> </web-app>6、Demo效果图
七、工程结构图:
八、自己的理解:
咱们可以简单的来分析一下这个简单的demo是怎么执行的,首先在浏览器中输入一个URL:http://localhost:8080/hellospring/welcome
hellospring是这个应用的上下文即application context,welcome是一个请求映射。
服务器在收到这样的一个请求以后,首先会查看web.xml文件,在web.xml中配置了spring的配置文件地址
<context-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/mvc-dispatcher-servlet.xml</param-value> </context-param>然后又在spring配置文件mvc-dispatcher-servlet.xml中查找,发现了
<context:component-scan base-package="controller" />Spring采用的是组件扫描方式来查找映射请求处理方法,即Spring会扫描包controller下的所有类,查看哪个个类被注解所标记。然后在controller包下找到了HelloController.java这个类,在这个类的头上有两个annotation(注解)
@Controller @RequestMapping("/welcome")@Controller大概代表的就是该类是一个控制器吧
@RequestMapping大概代表的就是请求映射吧,@RequestMapping("/welcome")代表的就是刚才在浏览器中输入一个URL:http://localhost:8080/hellospring/welcome的最后一个映射名称吧,即welcome。综合起来,就可以确定这个类就是用来处理welcome这个请求的。
@RequestMapping(method = RequestMethod.GET) public String printWelcome(ModelMap model)代表的是用pringWelcome(ModelMap model)这个方法来处理get方式的请求,welcome这个请求正好是get方式的,所以就可以确定welcome这个请求就是由HelloController.java这个类的printWelcome(ModelMap model)这个方法来处理的。
public String printWelcome(ModelMap model) { model.addAttribute("message", "Spring 3 MVC Hello World"); return "hello"; }那么,这个方法处理完请求后,最终返回给我们的页面又是哪一个呢?在这个方法中设置了一个属性,键是"message",值是“ Spring 3 MVC Hello World”,这又有什么作用呢?该方法的返回值是“hello”让我们再回到 mvc-dispatcher-servlet.xml这个文件中,我们又找到了
<property name="prefix"> <span style="white-space:pre"> </span><value>/WEB-INF/pages/</value> </property> <property name="suffix"> <span style="white-space:pre"> </span><value>.jsp</value> </property>
第一个属性大概代表的就是要返回给浏览器的页面的路径即/WEB-INF/pages/
第二个属性大概代表的就是要返回的后缀,即返回的文件的格式是.jsp,即返回的文件类型是jsp页面而不是html页面,那么返回给浏览器的到底是/WEB-INF/pages/下的哪一个页面呢,哈哈,在printWelcome(Model model)方法中不是返回了一个"hello"字符串吗,这个字符串就是返回的页面的文件名,而返回文件的类型是.jsp格式,所以最终返回给浏览器的页面就是hello.jsp页面,再具体一点就是/WEB-INF/pages/路径下的hello.jsp即/WEB-INF/pages/hello.jsp在我们的这个路径下也正好有个hello.jsp页面。下面让我们来见识见识hello.jsp页面的庐山面目:
<html> <body> <h1>Message : ${message}</h1> </body> </html>咦?${message}这个是什么东东呢,其实在好多地方我们都见过${XXX}这种用法,比如在maven中我们会定义一些属性:
<properties> <spring.version>3.0.5.RELEASE</spring.version> </properties> <dependencies> <!-- Spring 3 dependencies --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>${spring.version}</version> </dependency>${spring.version}代表的就是3.0.5.RELEASE。那么${message}中的message又是在哪里定义的属性呢,哈哈,还记得printWelcome(ModelMap model)方法吧:
public String printWelcome(ModelMap model) { model.addAttribute("message", "Spring 3 MVC Hello World"); return "hello"; }在该方法中设置了一个属性model.addAttribute("message", "Spring 3 MVC Hello World");键正好是"message",而值是"Spring 3 MVC Hello World",所以最终返回给浏览器的页面中的文字是Message : Spring 3 MVC Hello World