前言
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>