SpringMVC常用注解

一，@Controller

负责注册一个bean 到spring 上下文中，bean 的ID 默认为类名称开头字母小写。

在SpringMVC 中，控制器Controller 负责处理由DispatcherServlet 分发的请求，它把用户请求的数据经过业务处理层处理之后封装成一个Model ，然后再把该Model 返回给对应的View 进行展示。在SpringMVC 中提供了一个非常简便的定义Controller 的方法，你无需继承特定的类或实现特定的接口，只需使用@Controller 标记一个类是Controller ，然后使用@RequestMapping 和@RequestParam 等一些注解用以定义URL 请求和Controller 方法之间的映射，这样的Controller 就能被外界访问到。此外Controller 不会直接依赖于HttpServletRequest 和HttpServletResponse 等HttpServlet 对象，它们可以通过Controller 的方法参数灵活的获取到。

@Controller 用于标记在一个类上，使用它标记的类就是一个SpringMVC Controller 对象。分发处理器将会扫描使用了该注解的类的方法，并检测该方法是否使用了@RequestMapping 注解。@Controller 只是定义了一个控制器类，而使用@RequestMapping 注解的方法才是真正处理请求的处理器。单单使用@Controller 标记在一个类上还不能真正意义上的说它就是SpringMVC 的一个控制器类，因为这个时候Spring 还不认识它。那么要如何做Spring 才能认识它呢？这个时候就需要我们把这个控制器类交给Spring 来管理。有两种方式：

　　（1）在SpringMVC 的配置文件中定义MyController 的bean 对象。

　　（2）在SpringMVC 的配置文件中告诉Spring 该到哪里去找标记为@Controller 的Controller 控制器。

<!--方式一-->
<bean class="com.host.app.web.controller.MyController"/>
<!--方式二-->
< context:component-scan base-package = "com.host.app.web" />//路径写到controller的上一层(扫描包详解见下面浅析)

2、@RequestMapping

RequestMapping是一个用来处理请求地址映射的注解，可用于类或方法上。用于类上，表示类中的所有响应请求的方法都是以该地址作为父路径。

RequestMapping注解有六个属性:

value： 指定请求的实际地址。

method：  指定请求的method类型， GET、POST、PUT、DELETE等；

consumes： 指定处理请求的提交内容类型（Content-Type），例如application/json, text/html;

produces:    指定返回的内容类型，仅当request请求头中的(Accept)类型中包含该指定类型才返回；

params： 指定request中必须包含某些参数值是，才让该方法处理。

headers： 指定request中必须包含某些指定的header值，才能让该方法处理请求。

3、@RequestParam

主要用于在SpringMVC后台控制层获取参数，类似一种是request.getParameter("name")，它有三个常用参数：defaultValue, required , valu；

value 值表示接受的传入的参数名，required是否必须，默认是true,表示请求中必须包含对应的参数名，defaultValue 表示设置默认值，不推荐使用。

	@RequestMapping("/add")
	public String add(@RequestParam("name") String name,@RequestParam(value="age") int age){
		System.out.println("I am add() method!");
		System.out.println("name is "+name);
		System.out.println("age is "+age);
		return "student/add";
	}
	

4、@PathVariable

用于将请求URL中的模板变量映射到功能处理方法的参数上，即取出uri模板中的变量作为参数。如：

	@RequestMapping(value="/delete/sid/{sid}",method = RequestMethod.GET)
	public String delete(@PathVariable("sid") String sid){
		System.out.println("I am delete() method! sid is "+sid);
		return "student/delete";
	}

5、@ModelAttribute

主要有两种使用方式，一种是标注在方法上，一种是标注在 Controller 方法参数上。

标记到方法上如下   

	@ModelAttribute("myTeacher")
	public Teacher getTeacher(){
		Teacher teacher = new Teacher();
		teacher.setAge(24);
		teacher.setId(1);
		teacher.setName("json");
		return teacher;
	}

表示把id为myTeacher的数据模型，放入隐藏模型中。

二标注在 Controller 方法参数上

        @RequestMapping("/list")
	public ModelAndView list( @ModelAttribute ( "myTeacher" ) Teacher teacher){
		ArrayList<Teacher> teacher1 = new ArrayList<Teacher>();
			teacher1.add(teacher);
		ModelAndView mv=new ModelAndView("teacher/list", "teacher", teacher1);
		return mv;
	}
	

在访问此方法是会根据myTeacher这个id，找到隐藏模型中的数据模型作为参数传入方法体。如果没有找到，就自动创建一个放入隐藏模型中，可以返回到页面使用。

6、@RequestBody

该注解用于读取Request请求的body部分数据，使用系统默认配置的HttpMessageConverter进行解析，然后把相应的数据绑定到要返回的对象上 ,再把HttpMessageConverter返回的对象数据绑定到 controller中方法的参数上

7、@ResponseBody

　 该注解用于将Controller的方法返回的对象，通过适当的HttpMessageConverter转换为指定格式后，写入到Response对象的body数据区,

系统默认转化器配置

	<!-- 典型的转换器  HttpMessageConverter -->
	<bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
		<property name="messageConverters">
			<list>
				<bean class="org.springframework.http.converter.ByteArrayHttpMessageConverter"/>
				<bean class="org.springframework.http.converter.StringHttpMessageConverter"/>
				<bean class="org.springframework.http.converter.xml.SourceHttpMessageConverter"/>
				<bean class="org.springframework.http.converter.xml.XmlAwareFormHttpMessageConverter"/>
				<bean class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter"/>
			</list>
		</property>
	</bean>

访问下面这个方法 直接返回json格式的数据

        @ResponseBody
	@RequestMapping("/list")
	public Teacher list(){
		Teacher teacher = new Teacher();
		teacher.setAge(24);
		teacher.setId(1);
		teacher.setName("json");
		return teacher;
	}