编写Spring MVC控制器的14个技巧(小结)

2023-08-09 17:54:04 84

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

1.使用@Controller构造型

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

importorg.springframework.stereotype.Controller;
importorg.springframework.web.bind.annotation.RequestMapping;
@Controller
publicclassHomeController{
@RequestMapping("/")
publicStringvisitHome(){

return"home";
}
}

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

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

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

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

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

@Controller
publicclassMultiActionController{
@RequestMapping("/listUsers")
publicModelAndViewlistUsers(){
}
@RequestMapping("/saveUser")
publicModelAndViewsaveUser(Useruser){
}
@RequestMapping("/deleteUser")
publicModelAndViewdeleteUser(Useruser){
}
}

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

2.实现控制器接口

在SpringMVC中创建控制器的另一种（也许是经典的）方法是让类实现 Controller 接口。例如：

importjavax.servlet.http.HttpServletRequest;
importjavax.servlet.http.HttpServletResponse;
importorg.springframework.web.servlet.ModelAndView;
importorg.springframework.web.servlet.mvc.Controller;
publicclassMainControllerimplementsController{
@Override
publicModelAndViewhandleRequest(HttpServletRequestrequest,
HttpServletResponseresponse)throwsException{
System.out.println("Welcomemain");
returnnewModelAndView("main");
}
}

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

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

3.扩展AbstractController类

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

importjavax.servlet.http.HttpServletRequest;
importjavax.servlet.http.HttpServletResponse;
importorg.springframework.web.servlet.ModelAndView;
importorg.springframework.web.servlet.mvc.AbstractController;
publicclassBigControllerextendsAbstractController{
@Override
protectedModelAndViewhandleRequestInternal(HttpServletRequestrequest,
HttpServletResponseresponse)throwsException{
System.out.println("You'rebig!");
returnnewModelAndView("big");
}
}

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

此配置指示POST 此控制器的hander 方法仅支持该方法。

SpringMVC还提供了几种针对特定目的而设计的控制器类，包括：

AbstractUrlViewController
MultiActionController
ParameterizableViewController
ServletForwardingController
ServletWrappingController
UrlFilenameViewController

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

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

@RequestMapping("/login")

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

importorg.springframework.stereotype.Controller;
importorg.springframework.web.bind.annotation.RequestMapping;
importorg.springframework.web.bind.annotation.RequestMethod;
@Controller
@RequestMapping("/hello")
publicclassSingleActionController{
@RequestMapping(method=RequestMethod.GET)
publicStringsayHello(){
return"hello";
}
}

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

importorg.springframework.stereotype.Controller;
importorg.springframework.web.bind.annotation.RequestMapping;
@Controller
publicclassUserController{
@RequestMapping("/listUsers")
publicStringlistUsers(){
return"ListUsers";
}
@RequestMapping("/saveUser")
publicStringsaveUser(){
return"EditUser";
}
@RequestMapping("/deleteUser")
publicStringdeleteUser(){
return"DeleteUser";
}
}

@RequestMapping注释还可以用于指定一个方法要处理的多个URL模式。例如:

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

此外，此注解还具有在某些情况下可能有用的其他属性，例如method。

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

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

importorg.springframework.stereotype.Controller;
importorg.springframework.web.bind.annotation.RequestMapping;
importorg.springframework.web.bind.annotation.RequestMethod;
@Controller
publicclassLoginController{
@RequestMapping(value="/login",method=RequestMethod.GET)
publicStringviewLogin(){
return"LoginForm";
}
@RequestMapping(value="/login",method=RequestMethod.POST)
publicStringdoLogin(){
return"Home";
}
}

此控制器有两个处理相同URL模式的方法/login，但前者用于 GET 方法，而后者用于 POST 方法。

有关使用@RequestMapping 注解的更多信息，请参见 @RequestMapping注解。

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

SpringMVC的很酷的功能之一是，您可以使用@RequestParam 注解将请求参数作为处理程序方法的常规参数进行检索。这是将控制器HttpServletRequest 与ServletAPI 的接口分离的好方法。

@RequestMapping(value="/login",method=RequestMethod.POST)
publicStringdoLogin(@RequestParamStringusername,
@RequestParamStringpassword){
}

Spring将方法参数用户名和密码绑定到具有相同名称的HTTP请求参数。这意味着您可以按以下方式调用URL（如果请求方法是GET）：

http：//localhost：8080/spring/login？username=scott＆password=tiger

类型转换也是自动完成的。例如，如果您声明integer 如下类型的参数：

@RequestParamintsecurityNumber

然后，Spring将在处理程序方法中自动将请求参数（字符串）的值转换为指定的类型（整数）。

如果参数名称与变量名称不同，则可以如下指定参数的实际名称：

@RequestParam("SSN")intsecurityNumber

该@RequestParam 注解也有两个额外的属性，这可能是在某些情况下是有用的。该属性指定参数是否为必需。例如： required

@RequestParam(required=false)Stringcountry

这意味着该参数 country 是可选的；因此，它可能会从请求中丢失。在上面的示例中，country 如果请求中不存在此类参数，则变量将为null。

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

@RequestParam(defaultValue="18")intage

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

doLogin(@RequestParamMapparams)

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

7.返回模型和视图

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

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

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

@RequestMapping("/listUsers")
publicModelAndViewlistUsers(){
ListlistUser=newArrayList<>();
//从DAO获取用户列表…
ModelAndViewmodelView=newModelAndView("UserList");
modelView.addObject("listUser",listUser);
returnmodelView;
}

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

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

@RequestMapping("/listUsers")
publicModelAndViewlistUsers(ModelAndViewmodelView){
ListlistUser=newArrayList<>();
//从DAO获取用户列表…
modelView.setViewName("UserList");
modelView.addObject("listUser",listUser);
returnmodelView;
}

了解有关该类的更多信息，请参见：ModelAndViewclass。

8.将对象放入模型

在遵循MVC架构的应用程序中，控制器（C）应该将数据传递到模型（M）中，然后在视图（V）中使用该模型。正如我们在前面的示例中看到的那样，该类的addObject() 方法 ModelAndView是以名称-值对的形式将对象放入模型中：

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

同样，Spring非常灵活。你可以Map 在处理程序方法中声明类型的参数。Spring使用此映射存储模型的对象。让我们看另一个例子：

@RequestMapping(method=RequestMethod.GET)
publicStringviewStats(Mapmodel){
model.put("siteName","CodeJava.net");
model.put("pageviews",320000);
return"Stats";
}

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

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

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

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

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

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

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

@Controller
publicclassRegistrationController{
@RequestMapping(value="/doRegister",method=RequestMethod.POST)
publicStringdoRegister(
@ModelAttribute("userForm")Useruser,BindingResultbindingResult){
if(bindingResult.hasErrors()){
//表单验证错误
}else{
//表单输入没问题
}
//注册过程……
return"Success";
}
}

从Spring的官方文档中了解有关@ModelAttribute 注释和BindingResult 接口的更多信息：

在方法参数上使用@ModelAttribute
在方法上使用@ModelAttribute
接口绑定结果

11.处理文件上传

通过自动将上传数据绑定到CommonsMultipartFile 对象数组，Spring还使在处理程序方法中处理文件上传变得容易。Spring使用ApacheCommonsFileUpload作为基础的多部分解析器。

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

@RequestMapping(value="/uploadFiles",method=RequestMethod.POST)
publicStringhandleFileUpload(
@RequestParamCommonsMultipartFile[]fileUpload)throwsException{
for(CommonsMultipartFileaFile:fileUpload){
//存储上传的文件
aFile.transferTo(newFile(aFile.getOriginalFilename()));
}
return"Success";
}

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

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

@Controller
publicclassUserController{
@Autowired
privateUserDAOuserDAO;
publicStringlistUser(){
//列出所有用户的处理方法
userDAO.list();
}
publicStringsaveUser(Useruser){
//保存/更新用户的处理方法
userDAO.save(user);
}
publicStringdeleteUser(Useruser){
//删除用户的处理方法
userDAO.delete(user);
}
publicStringgetUser(intuserId){
//获取用户的处理方法
userDAO.get(userId);
}
}

在此，与用户管理有关的所有业务逻辑都由该UserDAO 接口的实现提供。例如：

interfaceUserDAO{
Listlist();
voidsave(Useruser);
voidcheckLogin(Useruser);
}

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

13.访问HttpServletRequest和HttpServletResponse

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

@RequestMapping("/download")
publicStringdoDownloadFile(
HttpServletRequestrequest,HttpServletResponseresponse){
//访问请求
//访问响应
return"DownloadPage";
}

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

14.遵循单一责任原则

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

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

@Controller
publicclassUserController{
@Autowired
privateUserDAOuserDAO;
publicStringlistUser(){
userDAO.list();
}
publicStringsaveUser(Useruser){
userDAO.save(user);
}
publicStringdeleteUser(Useruser){
userDAO.delete(user);
}
publicStringgetUser(intuserId){
userDAO.get(userId);
}
}

为每个业务域创建每个单独的控制器。例如， UserController 用于控制用户管理的OrderController 工作流程，用于控制订单处理的工作流程等。例如：

@Controller
publicclassUserController{
}
@Controller
publicclassProductController{
}
@Controller
publicclassOrderController{
}
@Controller
publicclassPaymentController{
}

这14个小技巧，可以帮助你正确有效地在SpringMVC中编写控制器类。如果你有其他提示或建议，请随时在评论中分享您的想法。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持毛票票。

声明：本文内容来源于网络，版权归原作者所有，内容由互联网用户自发贡献自行上传，本网站不拥有所有权，未作人工编辑处理，也不承担相关法律责任。如果您发现有涉嫌版权的内容，欢迎发送邮件至：czq8825#qq.com（发邮件时，请将#更换为@）进行举报，并提供相关证据，一经查实，本站将立刻删除涉嫌侵权内容。

编写Spring MVC控制器的14个技巧(小结)

热门推荐

随机推荐