1 Spring MVC注解类型

Controller和RequestMapping注释类型是SpringMVC API最重要的两个注释类型。
基于注解的控制器的几个优点：
一个控制器类可以控制几个动作，而一个实现了Controller接口的控制器只能处理一个动作。这就允许将相关操作写在一个控制器类内，从而减少应用类的数量
基于注解的控制器的请求映射不需要存储在配置文件中，而是使用RequestMapping注释类型，可以对一个方法进行请求处理。

1.1 Controller注解类型

下面是一个带注解的控制器

package com.springmvc.controller;
import org.springframework.stereotype.Controller;
@Controller
public class ProductController {
    
    //request-handing method
}

Spring使用扫描机制来找到应用程序中所有基于注解的控制器类。为了保证Spring能够找到你的控制器，需要完成两件事情。
第一：在Spring MVC的配置文件中声明spring-context

<beans xmlns:context="http://www.springframework.org/schema/context" ></beans>

第二步：需要在应用

<context:component-scan base-package="控制器类的基本包"/>  

在这个元素中指定控制器类的基本包位置，例如控制器类都在com.springmvc.controller及其子包下面，则按照下面的写法。

<context:component-scan base-package="com.springmvc.controller"/> 

确保所有控制器类都在基本包之下，并且不要指定一个非常宽泛的包，这样会使得Spring MVC去扫描无关的包。

1.2 RequestMapping注解类型

需要在控制器类的内部为每一个动作开发相应的处理方法，要让Spring知道用那里一种方法来处理它的动作。需要使用org.springframework.web.bind.annotation.RequestMapping注释类型映射的URI方法。
RequestMapping注释类型的作用和其名字所暗示的一样，映射一个请求和一种方法。可以使用@RequestMapping注释一种方法或类。
一个采用@RequestMapping注释的方法将成为一个请求处理的方法，并由调用程序在接收到对应的URL请求时调用。

package com.springmvc.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
……….
@Controller
public class CustomerController {
        
    @RequestMapping(value = "/customer_input")
    public String inputCustomer() {
    
        ………………..
        return "CustomerForm";
    }
    @RequestMapping(value = "/product_save", method = RequestMethod.POST)
    public String saveProduct(ProductForm productForm, RedirectAttributes redirectAttributes) {
            
        return "redirect:/product_view/" + savedProduct.getId();
    }
}

Value是RequestMapping 注释的默认属性，因此下面两个标注的含义相同。
@RequestMapping(value = “/customer_input”)和@RequestMapping( “/customer_input”)
但如果超过一个属性的时候，就必须要写入value的值。
使用RequestMapping注解的value属性将URI映射到方法上。在上面将customer_input映射到inputCustomer方法上。这样可以使用如下URI访问inputCustomer方法。
http://domain/context/customer_input
RequestMapping注释类型也可以用来注释一个控制器类

package com.springmvc.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping("/customer")
public class CustomerController {
        
    @RequestMapping(value = "/delete", method ={
    RequestMethod.POST, RequestMethod.PUT))
    public String deleteCustomer() {
    
        //do something here
        return ……..;}  
    }

由于控制器的映射使用"/customer"，而deleteCustomer方法映射为"/delete"，则如下URL会映射到该方法上。http://domain/context/customer/delete

2 编写请求处理方法

每一个请求处理方法可以有不同类型的参数，以及一个多钟类型的返回结果。例如，如果在请求处理方法中需要访问HttpSession对象，则可以添加的HttpSeesion作为参数，Sring会将对象正确的传递给方法

@requestMapping("/url")
public String myMethod(HttpSession session){
    
	...........
	session.addAttribute(key,value);
	...........
}

或者，如果需要访问客户端语言环境和HttpServletRequest对象，则可以在方法上签名上包括这样的参数

@requestMapping("/url")
public String myOtherMethod(HttpServletRequest request,Locale locale){
    
	...........
	// access Locale and HttpServletRequest here
	...........
}

3 应用基于注解的控制器的案例

3.1 案例的程序构成

3.2 JavaBean和Form

3.2.1 Product

package com.springmvc.domain;
import java.io.Serializable;
public class Product implements Serializable {
    
    private static final long serialVersionUID = 5784L;
	private long id;
	private String name;
    private String description;
    private float price;
    public long getId() {
    return id;}
	public void setId(long id) {
    this.id = id;}
    public String getName() {
    return name;}
	public void setName(String name) {
    this.name = name;}
    public String getDescription() {
    return description;}
    public void setDescription(String description) {
    this.description = description;
    }
    public float getPrice() {
    return price;}
    public void setPrice(float price) {
    this.price = price;}
}

3.2.2 ProductForm

package com.springmvc.form;
public class ProductForm {
    
    private String name;
    private String description;
    private String price;
    public String getName() {
    return name; }
    public void setName(String name) {
     this.name = name;}
    public String getDescription() {
    return description;}
    public void setDescription(String description) {
    this.description = description;}
    public String getPrice() {
    return price;}
    public void setPrice(String price) {
    this.price = price;}
}

3.3 Controller

package com.springmvc.controller;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import com.springmvc.domain.Product;
import com.springmvc.form.ProductForm;
@Controller
public class ProductController {
    
    private static final Log logger = LogFactory.getLog(ProductController.class);
    @RequestMapping(value="/product_input")
    public String inputProduct() {
    
        logger.info("inputProduct called");
        return "ProductForm";
    }
    @RequestMapping(value="/product_save")
    public String saveProduct(ProductForm productForm, Model model) {
    
        logger.info("saveProduct called");
        // no need to create and instantiate a ProductForm
        // create Product
        Product product = new Product();
        product.setName(productForm.getName());
        product.setDescription(productForm.getDescription());
        try {
    
            product.setPrice(Float.parseFloat(
                    productForm.getPrice()));
        } catch (NumberFormatException e) {
    
        }
        // add product
        model.addAttribute("product", product);
        return "ProductDetails";
    }
}

3.4 Spring MVC的配置文件

<?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:p="http://www.springframework.org/schema/p"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xmlns:context="http://www.springframework.org/schema/context"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd     
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">
    <context:component-scan base-package="com.springmvc.controller"/>
    <mvc:annotation-driven/>
    <mvc:resources mapping="/css/**" location="/css/"/>
    <mvc:resources mapping="/*.html" location="/"/>    
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

3.5 View视图层

3.5.1 CSS

#global {
    text-align: left; border: 1px solid #dedede;background: #efefef;
    width: 560px;padding: 20px;margin: 100px auto;}
form {
    font:100% verdana;min-width: 500px;max-width: 600px;width: 560px;}
form fieldset {
    border-color: #bdbebf;border-width: 3px;margin: 0;}
legend {
    font-size: 1.3em;}
form label {
     width: 250px;display: block;float: left;text-align: right;padding: 2px;}
#buttons {
    text-align: right;}
#errors, li {
    color: red;}

3.5.2 ProductForm.jsp

<!DOCTYPE HTML>
<html>
<head>
<title>Add Product Form</title>
<style type="text/css">@import url(css/main.css);</style>
</head>
<body>
<div id="global">
<form action="product_save" method="post">
    <fieldset>
        <legend>Add a product</legend>
        <p>
            <label for="name">Product Name: </label>
            <input type="text" id="name" name="name"  tabindex="1">
        </p>
        <p>
            <label for="description">Description: </label>
            <input type="text" id="description"   name="description" tabindex="2">
        </p>
        <p>
            <label for="price">Price: </label>
            <input type="text" id="price" name="price"  tabindex="3">
        </p>
        <p id="buttons">
            <input id="reset" type="reset" tabindex="4">
            <input id="submit" type="submit" tabindex="5"   value="Add Product">
        </p>
    </fieldset>
</form>
</div>
</body>
</html>

3.5.3 ProductDetails.jsp

<!DOCTYPE HTML>
<html>
<head>
<title>Save Product</title>
<style type="text/css">@import url(css/main.css);</style>
</head>
<body>
<div id="global">
    <h4>The product has been saved.</h4>
    <p>
        <h5>Details:</h5>
        Product Name: ${
    product.name}<br/>
        Description: ${
    product.description}<br/>
        Price: $${
    product.price}
    </p>
</div>
</body>
</html>

3.6 web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" id="WebApp_ID" version="3.1">
  <display-name>YJYSpring_MVC_Annotation_PaulDeckCH04</display-name>
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
  <servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>
            org.springframework.web.servlet.DispatcherServlet
        </servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>/WEB-INF/config/springmvc-config.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

4 运行和测试

http://localhost:8080/YJYSpring_MVC_Annotation_PaulDeckCH04/product_input.action