通常,在Spring MVC中,咱们编写一个控制器类来解决来自客户端的申请。而后,控制器调用业务类来解决与业务相干的工作,而后将客户端重定向到逻辑视图名称,该名称由Spring的调度程序Servlet解析,以出现后果或输入。这样就实现了典型的申请-响应周期的往返。

应用@Controller构造型

这是创立能够解决一个或多个申请的控制器类的最简略办法。仅通过用构造型正文一个类@Controller ,例如:

import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;@Controllerpublic class HomeController {    @RequestMapping("/")    public String visitHome() {              return "home";    }}

如你所见,visitHome()办法通过重定向到名为home的视图来解决来自应用程序上下文门路(/)的申请。

留神:@Controller原型只能在Spring的配置文件中启用注解驱动时应用:

<annotation-driven />

启用正文驱动时,Spring容器主动在以下语句指定的包下扫描类:

<context:component-scan base-package="net.codejava.spring" />

由@Controller 正文正文的类被配置为控制器。这是最可取的,因为它很简略:无需在配置文件中为控制器申明bean。

留神:通过应用@Controller 注解,您能够领有一个多动作控制器类,该类可能解决多个不同的申请。例如:

@Controllerpublic class MultiActionController {    @RequestMapping("/listUsers")    public ModelAndView listUsers() {    }    @RequestMapping("/saveUser")    public ModelAndView saveUser(User user) {    }    @RequestMapping("/deleteUser")    public ModelAndView deleteUser(User user) {    }}

正如你能够在下面的控制器类看,有解决三种不同的申请3种解决办法 /listUsers,/saveUser,和/deleteUser别离。

实现控制器接口

在Spring MVC中创立控制器的另一种(兴许是经典的)办法是让类实现 Controller 接口。例如:

import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;import org.springframework.web.servlet.ModelAndView;import org.springframework.web.servlet.mvc.Controller;public class MainController implements Controller {    @Override    public ModelAndView handleRequest(HttpServletRequest request,            HttpServletResponse response) throws Exception {        System.out.println("Welcome main");        return new ModelAndView("main");    }}

实现类必须重写该 handleRequest() 办法,当匹配申请进入时,该办法将由Spring调度程序Servlet调用。此控制器解决的申请URL模式在Spring的上下文配置文件中定义如下:

<bean name="/main" class="net.codejava.spring.MainController" />

然而,此办法的毛病是控制器类无奈解决多个申请URL。

扩大AbstractController类

如果要轻松管制受反对的HTTP办法,会话和内容缓存。扩大你的控制器 AbstractController 类是现实的抉择。请思考以下示例:

import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;import org.springframework.web.servlet.ModelAndView;import org.springframework.web.servlet.mvc.AbstractController;public class BigController extends AbstractController {    @Override    protected ModelAndView handleRequestInternal(HttpServletRequest request,            HttpServletResponse response) throws Exception {        System.out.println("You're big!");        return new ModelAndView("big");    }}

这将创立具备无关受反对的办法,会话和缓存的配置的单动作控制器,而后能够在控制器的bean申明中指定这些配置。例如:

<bean name="/big" class="net.codejava.spring.BigController">    <property name="supportedMethods" value="POST"/></bean>

此配置批示POST 此控制器的hander 办法仅反对该办法。

Spring MVC还提供了几种针对特定目标而设计的控制器类,包含:

AbstractUrlViewControllerMultiActionControllerParameterizableViewControllerServletForwardingControllerServletWrappingControllerUrlFilenameViewController

为处理程序办法指定URL映射

这是编码控制器类时必须执行的强制性工作,该控制器类旨在解决一个或多个特定申请。Spring MVC提供了@RequestMapping 正文,该注解用于指定URL映射。

例如:

@RequestMapping("/login")

这映射了/login 要由带注解的办法或类解决的URL模式。当在类级别应用此注解时,该类将成为单动作控制器。例如:

 import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RequestMethod;@Controller@RequestMapping("/hello")public class SingleActionController {    @RequestMapping(method = RequestMethod.GET)    public String sayHello() {        return "hello";    }}

当@RequestMapping 注解在办法级别应用的,你能够有一个多动作控制器。例如:

import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;@Controllerpublic class UserController {    @RequestMapping("/listUsers")    public String listUsers() {        return "ListUsers";    }    @RequestMapping("/saveUser")    public String saveUser() {        return "EditUser";    }    @RequestMapping("/deleteUser")    public String deleteUser() {        return "DeleteUser";    }}

@RequestMapping正文还能够用于指定一个办法要解决的多个URL模式。例如:

@RequestMapping({"/hello", "/hi", "/greetings"})

此外,此注解还具备在某些状况下可能有用的其余属性,例如method。

为处理程序办法指定HTTP申请办法

能够应用 注解的method 属性 指定处理程序办法反对哪种HTTP办法(GET,POST,PUT等) @RequestMapping。这是一个例子:

import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RequestMethod;@Controllerpublic class LoginController {    @RequestMapping(value = "/login", method = RequestMethod.GET)    public String viewLogin() {        return "LoginForm";    }    @RequestMapping(value = "/login", method = RequestMethod.POST)    public String doLogin() {        return "Home";    }}

此控制器有两个解决雷同URL模式的办法/login,但前者用于 GET 办法,而后者用于 POST 办法。

无关应用@RequestMapping 注解的更多信息,请参见 @RequestMapping注解。

将申请参数映射到处理程序办法

Spring MVC的很酷的性能之一是,您能够应用@RequestParam 注解将申请参数作为处理程序办法的惯例参数进行检索。这是将控制器HttpServletRequest 与Servlet API 的接口拆散的好办法。

@RequestMapping(value = "/login", method = RequestMethod.POST)public String doLogin(@RequestParam String username,                      @RequestParam String password) {}

Spring将办法参数用户名和明码绑定到具备雷同名称的HTTP申请参数。这意味着您能够按以下形式调用URL(如果申请办法是GET):

http:// localhost:8080 / spring / login?username = scott&password = tiger

类型转换也是主动实现的。例如,如果您申明integer 如下类型的参数 :

@RequestParam int securityNumber

而后,Spring将在处理程序办法中主动将申请参数(字符串)的值转换为指定的类型(整数)。

如果参数名称与变量名称不同,则能够如下指定参数的理论名称:

@RequestParam("SSN") int securityNumber

该@RequestParam 注解也有两个额定的属性,这可能是在某些状况下是有用的。该属性指定参数是否为必须。例如:required

@RequestParam(required = false) String country

这意味着该参数 country 是可选的;因而,它可能会从申请中失落。在下面的示例中,country 如果申请中不存在此类参数,则变量 将为null。

另一个属性是 defaultValue,能够在申请参数为空时用作后备值。例如:

@RequestParam(defaultValue = "18") int age

Map 如果办法参数是type,Spring还容许咱们将所有参数作为对象 拜访 Map<String, String>。例如:

doLogin(@RequestParam Map<String, String> params)

而后,映射参数蕴含键-值对模式的所有申请参数。无关应用@RequestParam 正文的更多信息,请参见 @RequestParam注解。

返回模型和视图

解决完业务逻辑后,处理程序办法应返回一个视图,而后由Spring的调度程序servlet对其进行解析。Spring容许咱们ModelAndView 从handler 办法中返回String或 对象 。在以下示例中,该 handler 办法返回一个String并示意一个名为的视图 LoginForm:

 @RequestMapping(value = "/login", method = RequestMethod.GET)public String viewLogin() {    return "LoginForm";}

这是返回视图名称的最简略办法。然而,如果要将其余数据发送到视图,则必须返回一个 ModelAndView 对象。思考以下处理程序办法:

@RequestMapping("/listUsers")public ModelAndView listUsers() {    List<User> listUser = new ArrayList<>();    // 从DAO获取用户列表…    ModelAndView modelView = new ModelAndView("UserList");    modelView.addObject("listUser", listUser);    return modelView;}

如您所见,此处理程序办法返回一个 ModelAndView 保留视图名称 UserList 的User 对象和一个可在视图中应用的对象汇合 。

Spring也非常灵活,因为您能够将ModelAndView 对象申明 为处理程序办法的参数,而不必创立一个新的对象。因而,以上示例能够重写如下:

@RequestMapping("/listUsers")public ModelAndView listUsers(ModelAndView modelView) {    List<User> listUser = new ArrayList<>();    //从DAO获取用户列表…    modelView.setViewName("UserList");    modelView.addObject("listUser", listUser);    return modelView;}

理解无关该类的更多信息,请参见 :ModelAndView class。

将对象放入模型

在遵循MVC架构的应用程序中,控制器(C)应该将数据传递到模型(M)中,而后在视图(V)中应用该模型。正如咱们在后面的示例中看到的那样, 该类的addObject() 办法 ModelAndView是以名称-值对的模式将对象放入模型中:

modelView.addObject("listUser", listUser);modelView.addObject("siteName", new String("CodeJava.net"));modelView.addObject("users", 1200000);

同样,Spring非常灵活。你能够Map 在处理程序办法中申明类型的参数 。Spring应用此映射存储模型的对象。让咱们看另一个例子:

@RequestMapping(method = RequestMethod.GET)public String viewStats(Map<String, Object> model) {    model.put("siteName", "CodeJava.net");    model.put("pageviews", 320000);    return "Stats";}

这比应用ModelAndView 对象还要简略 。依据你的爱好,能够应用Map 或 应用 ModelAndView 对象。在这里要感激Spring的灵活性。

处理程序办法中的重定向

如果你心愿在满足条件的状况下将用户重定向到另一个URL,请redirect:/ 在URL之前追加。以下代码段给出了一个示例:

// 查看登录状态....if (!isLogin) {    return new ModelAndView("redirect:/login");}// 返回用户列表

在下面的代码中,/login 如果未登录,用户将被重定向到该 URL。

解决表格提交和表格验证

通过提供@ModelAttribute 用于将表单字段绑定到表单反对对象的注解以及BindingResult 用于验证表单字段的界面,Spring使解决表单提交变得容易。java培训上面的代码片段显示了一种典型的处理程序办法,该办法负责解决和验证表单数据:

@Controllerpublic class RegistrationController {    @RequestMapping(value = "/doRegister", method = RequestMethod.POST)    public String doRegister(        @ModelAttribute("userForm") User user, BindingResult bindingResult) {        if (bindingResult.hasErrors()) {            // 表单验证谬误        } else {            // 表单输出没问题        }        // 注册过程……        return "Success";    }}

从Spring的官网文档中理解无关@ModelAttribute 正文和BindingResult 接口的更多信息 :

在办法参数上应用@ModelAttribute

在办法上应用@ModelAttribute

接口绑定后果

解决文件上传

通过主动将上传数据绑定到CommonsMultipartFile 对象数组,Spring还使在处理程序办法中解决文件上传变得容易。Spring应用Apache Commons FileUpload作为根底的多局部解析器。

以下代码段显示了从客户端上传文件有如许容易

@RequestMapping(value = "/uploadFiles", method = RequestMethod.POST)public String handleFileUpload(        @RequestParam CommonsMultipartFile[] fileUpload) throws Exception {    for (CommonsMultipartFile aFile : fileUpload){        // 存储上传的文件        aFile.transferTo(new File(aFile.getOriginalFilename()));    }    return "Success";}

在控制器中主动拆卸业务类

控制器应将业务逻辑的解决委托给相干的业务类。为此,您能够应用@Autowired 注解让Spring主动将业务类的理论实现注入控制器。思考以下控制器类的代码段:

@Controllerpublic class UserController {    @Autowired    private UserDAO userDAO;    public String listUser() {        // 列出所有用户的解决办法        userDAO.list();    }    public String saveUser(User user) {        // 保留/更新用户的解决办法        userDAO.save(user);    }    public String deleteUser(User user) {        // 删除用户的解决办法        userDAO.delete(user);    }    public String getUser(int userId) {        // 获取用户的解决办法        userDAO.get(userId);    }}

在此,与用户治理无关的所有业务逻辑都由该UserDAO 接口的实现提供 。例如:

interface UserDAO {    List<User> list();    void save(User user);    void checkLogin(User user);}

无关@Autowired 注解的更多信息,请参见 正文类型主动拆卸。

拜访HttpServletRequest和HttpServletResponse

在某些状况下,您须要间接 在处理程序办法中拜访 HttpServletRequest 或 HttpServletResponse对象。通过Spring的灵活性,只需在解决办法中增加相干参数即可。例如:

@RequestMapping("/download")public String doDownloadFile(        HttpServletRequest request, HttpServletResponse response) {    // 拜访申请    // 拜访响应    return "DownloadPage";}

Spring检测并主动将 HttpServletRequest 和 HttpServletResponse 对象注入办法中。而后,能够拜访申请和响应如获取 InputStream, OutputStream或返回一个特定的HTTP代码。

遵循繁多责任准则

最初,在设计和编写Spring MVC控制器时,有两个很好的实际是你应该遵循的:

控制器类不应执行业务逻辑。相同,它应该将业务解决委托给相干的业务类别。这使控制器始终专一于其设计职责是控制应用程序的工作流程。例如:

@Controllerpublic class UserController {    @Autowired    private UserDAO userDAO;    public String listUser() {        userDAO.list();    }    public String saveUser(User user) {        userDAO.save(user);    }    public String deleteUser(User user) {        userDAO.delete(user);    }    public String getUser(int userId) {        userDAO.get(userId);    }}

为每个业务域创立每个独自的控制器。例如, UserController 用于管制用户治理的OrderController 工作流程, 用于管制订单解决的工作流程等。例如:

 @Controllerpublic class UserController {}@Controllerpublic class ProductController {}@Controllerpublic class OrderController {}@Controllerpublic class PaymentController {}