编写 Spring MVC 控制器的 14 个技巧

通常,在Spring MVC中,我们编写一个控制器类来处理来自客户端的请求。然后,控制器调用业务类来处理与业务相关的任务,然后将客户端重定向到逻辑视图名称,该名称由Spring的调度程序Servlet解析,以呈现结果或输出。这样就完成了典型的请求-响应周期的往返。今天整理了一下编写Spring MVC控制器的14个技巧,你今天get到了吗? (≧▽≦)/

1.使用@Controller构造型

这是创建可以处理一个或多个请求的控制器类的最简单方法。仅通过用构造型注释一个类@Controller,例如:

@Controller
publicclassHomeController{
@RequestMapping("/")
public String visitHome {

return "home";
}
}

如你所见,visitHome方法通过重定向到名为home的视图来处理来自应用程序上下文路径(/)的请求。

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

启用注释驱动时,Spring容器自动在以下语句指定的包下扫描类:

@Controller注释注释的类被配置为控制器。这是最可取的,因为它很简单:无需在配置文件中为控制器声明bean。

注意:通过使用@Controller注解,您可以拥有一个多动作控制器类,该类能够处理多个不同的请求。例如:

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

正如你可以在上面的控制器类看,有处理三种不同的请求3种处理方法 和/deleteUser分别。

2.实现控制器接口

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

public classMainControllerimplementsController{
@Override
public ModelAndView handleRequest(HttpServletRequest request,
HttpServletResponse response) throws Exception {
System.out.println("Welcome main");
return new ModelAndView("main");
}
}

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

但是,此方法的缺点是控制器类无法处理多个请求URL。

3.扩展AbstractController类

如果要轻松控制受支持的HTTP方法,会话和内容缓存。扩展你的控制器 AbstractController类是理想的选择。请考虑以下示例:

public classBigControllerextendsAbstractController{
@Override
protected ModelAndView handleRequestInternal(HttpServletRequest request,
HttpServletResponse response) throws Exception {
System.out.println("You're big!");
return new ModelAndView("big");
}
}

这将创建具有有关受支持的方法,会话和缓存的配置的单动作控制器,然后可以在控制器的bean声明中指定这些配置。例如:



此配置指示POST此控制器的hander方法仅支持该方法。Spring MVC还提供了几种针对特定目的而设计的控制器类,包括:

4.为处理程序方法指定URL映射

这是编码控制器类时必须执行的强制性任务,该控制器类旨在处理一个或多个特定请求。Spring MVC提供了@RequestMapping注释,该注解用于指定URL映射。例如:

@RequestMapping("/login")

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

@Controller
@RequestMapping("/hello")
publicclassSingleActionController{
@RequestMapping(method = RequestMethod.GET)
public String sayHello {
return "hello";
}
}

@RequestMapping注解在方法级别使用的,你可以有一个多动作控制器。例如:

@Controller
publicclassUserController{
@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

5.为处理程序方法指定HTTP请求方法

可以使用 注解的method属性 指定处理程序方法支持哪种HTTP方法(GET,POST,PUT等)@RequestMapping。这是一个例子:

@Controller
publicclassLoginController{
@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注解。

6.将请求参数映射到处理程序方法

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如果请求中不存在此类参数,则变量 将为。

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

@RequestParam(defaultValue = "18") int age

Map如果方法参数是type,Spring还允许我们将所有参数作为对象 访问Map。例如:

doLogin(@RequestParam Map params)

然后,映射参数包含键-值对形式的所有请求参数。有关使用@RequestParam注释的更多信息,请参见 @RequestParam注解。

7.返回模型和视图

处理完业务逻辑后,处理程序方法应返回一个视图,然后由Spring的调度程序servlet对其进行解析。Spring允许我们ModelAndViewhandler方法中返回String或 对象 。在以下示例中,该handler方法返回一个String并表示一个名为的视图LoginForm

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

这是返回视图名称的最简单方法。但是,如果要将其他数据发送到视图,则必须返回一个 ModelAndView对象。考虑以下处理程序方法:

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

如您所见,此处理程序方法返回一个 ModelAndView保存视图名称UserListUser对象和一个可在视图中使用的对象集合 。

Spring也非常灵活,因为您可以将ModelAndView对象声明 为处理程序方法的参数,而不用创建一个新的对象。因此,以上示例可以重写如下:

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

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

8.将对象放入模型

在遵循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 model) {

model.put("siteName", "CodeJava.net");

model.put("pageviews", 320000);

return "Stats";

}

这比使用ModelAndView对象还要简单 。根据你的喜好,可以使用Map或 使用ModelAndView对象。在这里要感谢Spring的灵活性。

9.处理程序方法中的重定向

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

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

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

10.处理表格提交和表格验证

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

@Controller
public 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接口的更多信息 :

11.处理文件上传

通过自动将上传数据绑定到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";
}

12.在控制器中自动装配业务类

控制器应将业务逻辑的处理委托给相关的业务类。为此,您可以使用@Autowired注解让Spring自动将业务类的实际实现注入控制器。考虑以下控制器类的代码段:

@Controller
public 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 list;
void save(User user);
void checkLogin(User user);
}

有关@Autowired注解的更多信息,请参见 注释类型自动装配。

13.访问HttpServletRequest和HttpServletResponse

在某些情况下,您需要直接 在处理程序方法中访问 HttpServletRequestHttpServletResponse对象。通过Spring的灵活性,只需在处理方法中添加相关参数即可。例如:

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

Spring检测并自动将 HttpServletRequestHttpServletResponse对象注入方法中。然后,可以访问请求和响应如获取InputStreamOutputStream或返回一个特定的HTTP代码。

14.遵循单一责任原则

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

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

@Controller
public 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工作流程, 用于控制订单处理的工作流程等。例如:

@Controller
public class UserController {
}
@Controller
public class ProductController {
}
@Controller
public class OrderController {
}
@Controller
public class PaymentController {
}

这14个小技巧,可以帮助你正确有效地在 Spring MVC 中编写控制器类。

转自:不坠青云~

来源:csdn.net/Summer_Lyf/article/details/102911215

如果看到这里,说明你喜欢这篇文章,请

编写 Spring MVC 控制器的 14 个技巧
展开阅读全文

页面更新:2024-05-05

标签:控制器   注解   视图   表单   示例   注释   模型   接口   对象   名称   参数   业务   技巧   程序   方法   用户   科技

1 2 3 4 5

上滑加载更多 ↓
推荐阅读:
友情链接:
更多:

本站资料均由网友自行发布提供,仅用于学习交流。如有版权问题,请与我联系,QQ:4156828  

© CopyRight 2020-2024 All Rights Reserved. Powered By 71396.com 闽ICP备11008920号-4
闽公网安备35020302034903号

Top