【本系列其他教程正在陆续翻译中,点击分类:spring 4 mvc 进行查看】
【翻译 by 明明如月 QQ 605283073】
#项目下载地址:http://websystique.com/?smd_process_download=1&download_id=1722#。
上一篇:Spring 4 MVC hello world 教程-完全基于XML(带项目源码)
下一篇:
在上一个例子:Spring 4 MVC hello world 教程-完全基于XML(带项目源码) 中,
我们采用了纯xml方式演示了spring 4 mvc的hello world 教程。然而xml不是配置spring的唯一方式。
我们同样也可以采用纯注解的方式。
如果你回看一下上一篇文章你就会发现,主要有两个地方采用了xml方式。
第一:spring-servlet.xml 定义了view-resolver 来转到真是的视图,
通过component-scanning(组件扫描)来定位bean。
第二:web.xml 我们定义了 前置处理器和url pattern。
本教程,我们也是创建hello world例子,但是这次是基于java 注解。
我们将不再使用xml文件,起而代之的是java 对应的注解。
------------------------------------------------
所用的技术或者软件
让我们开始吧。。。
在上一篇文章已经讲过怎样在eclipse里创建maven项目,就不再多说。
下面是最终的文件结构:
接下来 我们添加或者更新上面项目结构中的文件。
Spring 基于java的配置 我们采用的是servlet 3.0 api.所以我们要添加对应的依赖。
4.0.0
com.websystique.springmvc
Spring4MVCHelloWorldNoXMLDemo
war
1.0.0
Spring4MVCHelloWorldNoXMLDemo
4.0.6.RELEASE
org.springframework
spring-webmvc
${springframework.version}
javax.servlet
javax.servlet-api
3.1.0
javax.servlet.jsp
javax.servlet.jsp-api
2.3.1
javax.servlet
jstl
1.2
org.apache.maven.plugins
maven-compiler-plugin
3.2
1.6
1.6
org.apache.maven.plugins
maven-war-plugin
2.4
src/main/webapp
Spring4MVCHelloWorldNoXMLDemo
false
Spring4MVCHelloWorldNoXMLDemo
首先要注意的是 maven-war-plugin
的声明.
因为我们想完
全不用xml,我们需要配置这个插件防止maven创建war包失败。
第二个变化是,添加了JSP/Servlet/Jstl依赖,因为我们在视图代码里面将会用到servlet api和jstl表达式。
一般来说,容器已经包含了这些库,你可以在pom.xml文件中设置它们的scope为provided 。
另外, maven-compiler-plugin已经在这里明确指定了jdk的版本。
注意:上面的配置也指明了eclipse使用的jdk版本。如果没有上面的配置而且你在eclipse里执行了mvn-update,eclipse 将切换到jdk默认的版本( 1.5)。
在 src/main/java 下添加类
com.websystique.springmvc.controller.HelloWorldController
package com.websystique.springmvc.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("/")
public class HelloWorldController {
@RequestMapping(method = RequestMethod.GET)
public String sayHello(ModelMap model) {
model.addAttribute("greeting", "Hello World from Spring 4 MVC");
return "welcome";
}
@RequestMapping(value = "/helloagain", method = RequestMethod.GET)
public String sayHelloAgain(ModelMap model) {
model.addAttribute("greeting", "Hello World Again, from Spring 4 MVC");
return "welcome";
}
}
@Controller
annotation marks this class as spring bean which may handle different HTTP requests based on mapping specified on class or individual controller methods.
@RequestMapping
注解用来映射web请求到指定的处理器类或者处理方法。 在本例中,我们在类级别也用了它,就是说此类是所有http“/”请求的默认处理器, @RequestMapping 也有很多属性 [value,method,params,..]能给用来更加详细的进行映射。
第一个方法,没有进行任何url映射声明,因此它将会继承类上面的映射声明,左右http Get请求的默认处理方法。
第二个方法(添加了带value的映射声明),它将用来处理带/helloagain 的请求。method
属性是用来指明此方法处理的http请求类型。
如果@RequestMapping
里面没有指明 method 则它将处理映射url的所有类型(GET POST等)的请求。
ModelMap
是一个Map 的实现类,它的目的是取代以前的 request.getAttribute/ request.setAttribute方法,
它提供一种 从request或者session中设置 或者获取属性的方式。
留意一下这些方法的返回值。这些值将是view resolver 的前缀或者后缀,来产生视图文件的真是名称。
在WEB-INF中创建views文件夹,在里面创建jsp页面如 ( WEB-INF/views/welcome.jsp) 。
简单的来访问controller总发送的model的值
<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
pageEncoding="ISO-8859-1"%>
HelloWorld page
Greeting : ${greeting}
在 src/main/java下创建一个包,然后写配置来来替代spring-servlet.xml
里面将包含所有的 component-scanning和view resolver 信息。
com.websystique.springmvc.configuration.HelloWorldConfiguration
package com.websystique.springmvc.configuration;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.ViewResolver;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.view.InternalResourceViewResolver;
import org.springframework.web.servlet.view.JstlView;
@Configuration
@EnableWebMvc
@ComponentScan(basePackages = "com.websystique.springmvc")
public class HelloWorldConfiguration {
@Bean
public ViewResolver viewResolver() {
InternalResourceViewResolver viewResolver = new InternalResourceViewResolver();
viewResolver.setViewClass(JstlView.class);
viewResolver.setPrefix("/WEB-INF/views/");
viewResolver.setSuffix(".jsp");
return viewResolver;
}
}
@Configuration
表明此类包含一个或者多个含有 @Bean注解的方法,提供spring 容器的bean的管理。
和上面配置类 等价的xml如下:
/WEB-INF/views/
.jsp
@EnableWebMvc
等价于 xml中的mvc:annotation-driven
. 他使得 @Controller注解的类通过@RequestMapping
来映射请求url对应的处理器。
@ComponentScan等价于
context:component-scan base-package="..." 通过此配置spring来扫描bean
初始化类在 src/main/java 下创建并实现 WebApplicationInitializer 接口。
在servlet 3.0容器启动时,该类将被加载和实例化,其onStartup方法将被servlet容器调用。
com.websystique.springmvc.configuration.HelloWorldInitializer
package com.websystique.springmvc.configuration;
import javax.servlet.ServletContext;
import javax.servlet.ServletException;
import javax.servlet.ServletRegistration;
import org.springframework.web.WebApplicationInitializer;
import org.springframework.web.context.support.AnnotationConfigWebApplicationContext;
import org.springframework.web.servlet.DispatcherServlet;
public class HelloWorldInitializer implements WebApplicationInitializer {
public void onStartup(ServletContext container) throws ServletException {
AnnotationConfigWebApplicationContext ctx = new AnnotationConfigWebApplicationContext();
ctx.register(HelloWorldConfiguration.class);
ctx.setServletContext(container);
ServletRegistration.Dynamic servlet = container.addServlet("dispatcher", new DispatcherServlet(ctx));
servlet.setLoadOnStartup(1);
servlet.addMapping("/");
}
}
此类代替了 web.xml。
更新:其实上面的类通过继承AbstractAnnotationConfigDispatcherServletInitializer类可以写的更简洁。
package com.websystique.springmvc.configuration;
import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;
public class HelloWorldInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
@Override
protected Class[] getRootConfigClasses() {
return new Class[] { HelloWorldConfiguration.class };
}
@Override
protected Class[] getServletConfigClasses() {
return null;
}
@Override
protected String[] getServletMappings() {
return new String[] { "/" };
}
}
可以打包成war或者直接run as 选择并在tomcat中运行。