spring以及包括springmvc在内的子项目提倡使用注解开发。使用了注解开发一段时间后发现,确实快捷方便。下面讲解在使用springMVC时,一些常用的注解。我们通过一个示例代码注解的使用以及展示form表单怎么封装到model中的。
下面开始创建项目。下面1-5步是准备工作,每个案例都必不可少的。
1,新建web工程。
2,web.xml
<?xml version="1.0" encoding="UTF-8"?> <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> <display-name></display-name> <!-- 加载spring核心配置文件 --> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:applicationContext.xml</param-value> </context-param> <!-- 全局编码过滤器 --> <filter> <filter-name>characterEncoding</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>utf-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>characterEncoding</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!-- 配置springmvc的核心配置文件 --> <servlet> <servlet-name>SpringMVC</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:SpringMVC-servlet.xml</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>SpringMVC</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> </web-app>3,spring核心配置文件:applicationContext.xml
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" 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.xsd"> <!-- 本案例重点演示springmvc的使用,用不到DataSource,service,dao等bean以及事务管理,可以不用写内容 --> </beans>4,springMVC核心配置文件:SpringMVC-servlet.xml
<?xml version="1.0" encoding="UTF-8"?> <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" xmlns:mvc="http://www.springframework.org/schema/mvc" 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 http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd "> <!-- 使用注解开发,必须添加注解扫描器,指定包名,spring会扫描包下的注解 --> <context:component-scan base-package="com.jimmy.controller"></context:component-scan> <!-- 使用注解开发,可以使用下面配置来自动注册DefaultAnnotationHandlerMapping与AnnotationMethodHandlerAdapter这两个bean --> <mvc:annotation-driven/> <!-- 配置视图解析器 --> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/"></property> <property name="suffix" value=".jsp"></property> </bean> </beans>5,domain类:User
package com.jimmy.domain; public class User { private String username; private String password; private Integer age; public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public String getPassword() { return password; } public void setPassword(String password) { this.password = password; } @Override public String toString() { return "User [username=" + username + ", password=" + password + ", age=" + age + "]"; } }至此,准备工作已经做好啦。接下来就是编写controller类和视图了。
6,表单页面:index.jsp
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>test</title> </head> <body> <form action="${pageContext.request.contextPath }/user/hello4.do" method="post"> 用户名:<input type="text" name="username"><br> 密码:<input type="password" name="password"><br> 年龄: <input type="text" name="age"><br> <input type="submit" value="提交"> <input type="reset" value="重置"> </form> </body> </html>我们在编写Controller类时,会用到以下常用的注解。最重要的也是最不可或缺的是@Controller和@RequestMapping。
@Controller:表示标注的类是一个controller类。在pojo类上头标注@Controller,再通过context:component-scan扫描响应的包,即可使pojo成为一个能够处理http请求的控制器。它跟@Service和@Repository是一套的,其他2个分别标注service层和dao层的类。
@RequestMapping(value=”/xxx”):如何将请求url映射到对应的控制器方法是框架的一项重要任务,这项任务就是由@RequestMapping来承担。@RequestMapping可以加在方法上,也可以加在类和方法上。如果类和方法都加了,请求url就要写成叠加的。
@RequestParam(“xxx”):用来标注参数,如下代码所示,方法paramPack1中的参数“@RequestParam(“username”) String MyUsername”意思就是将http请求参数“username”绑定到函数的形参“MyUsername”,这样就可以在方法中处理这个http请求参数了。当然也可以不用@RequestParam注解,但是方法的参数要跟form表单input标签的name属性值相同,就像paramPack2方法所示一样,不然会报错。
@RequestHeader(“http头字段”):该注解可以将http头字段绑定到方法参数。如代码所示。
@ModelAttribute(“xxx”):如果想把方法的bean对象添加到model中,仅需在参数前面使用@ModelAttribute注解即可。如paramPack3方法所示,请求将请求参数绑定到User对象,然后再以“user”为key放到model中以供视图渲染。也可以不用@ModelAttribute,而是如paramPack4方法那样,调用model.addAttribute方法添加“user”到model。
@SessionAttributes(“xxx”):如果想在多个请求之间共用某个model数据,则可以在控制器类标注一个@SessionAttributes。框架就会将model中的属性存储到HttpSession中。如本案例中的@SessionAttributes(“user”)会自动将本类中任何处理方法属性名为user的model属性存储到HttpSession中。在结果视图success.jsp中我们添加一个跳转路径,跳转到success2.jsp。那么,success2.jsp中同样可以取到user对象。
注意一点!!!在使用@SessionAttributes时,虽然paramPack3和paramPack4方法都能添加“user”到model,但是要用paramPack4方法中model.addAttribute(“user”, user)形式,才能正确添加“user”到session。如果用paramPack3的形式会报错。
7,Controller类
package com.jimmy.controller; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.ModelAttribute; import org.springframework.web.bind.annotation.RequestHeader; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestParam; import com.jimmy.domain.User; @Controller @RequestMapping(value="/user") @SessionAttributes("user") public class MyController { @RequestMapping(value="/hello1.do") public String paramPack1(@RequestParam("username") String MyUsername, @RequestParam("password") String MyPassword, @RequestParam("age") int MyAge, @RequestHeader("User-Agent") String userAgent){ System.out.println(MyUsername); System.out.println(MyPassword); System.out.println(MyAge); System.out.println(userAgent); return "success"; } @RequestMapping(value="/hello2.do") public String paramPack2(String username, String password, int age, @RequestHeader("User-Agent") String UserAgent){ System.out.println(username); System.out.println(password); System.out.println(age); System.out.println(UserAgent); return "success"; } @RequestMapping(value="/hello3.do") public String paramPack3(@ModelAttribute("user") User user){ System.out.println(user); return "success"; } @RequestMapping(value="/hello4.do") public String paramPack4(User user, Model model){ model.addAttribute("user", user); System.out.println(user); return "success"; } }8,结果视图
success.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <h1>用户信息</h1> 用户名:${user.username }<br> 密码:${user.password }<br> 性别:${user.age }<br> <a href="${pageContext.request.contextPath }/success2.jsp">点击跳转</a> </body> </html>success2.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <h1>welcome</h1> ${user.username } </body> </html>