分享 14 个 Spring MVC 顶级技巧！
做者：Nam Ha Minh
https://dzone.com/articles/14...译文：blog.csdn.net/Summer_Lyf/article/details/102911215java
一般，在Spring MVC中，咱们编写一个控制器类来处理来自客户端的请求。而后，控制器调用业务类来处理与业务相关的任务，而后将客户端重定向到逻辑视图名称，该名称由Spring的调度程序Servlet解析，以呈现结果或输出。 web
这样就完成了典型的请求-响应周期的往返。面试
今天整理了一下编写Spring MVC控制器的14个技巧，你今天get到了吗？ \(≧▽≦)/spring
1.使用@Controller构造型
这是建立能够处理一个或多个请求的控制器类的最简单方法。仅经过用构造型注释一个类@Controller，例如：后端
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class HomeController {
@RequestMapping("/")
public String visitHome() {
return "home";
}
}
如你所见，visitHome()方法经过重定向到名为home的视图来处理来自应用程序上下文路径(/)的请求。数组
注意： @Controller原型只能在Spring的配置文件中启用注解驱动时使用:spring-mvc
<annotation-driven />
启用注释驱动时，Spring容器自动在如下语句指定的包下扫描类：缓存
<context:component-scan base-package="net.codejava.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种处理方法 /listUsers，/saveUser_，_和/deleteUser分别。
2.实现控制器接口
在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。
3.扩展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还提供了几种针对特定目的而设计的控制器类，包括：
- AbstractUrlViewController
- MultiActionController
- ParameterizableViewController
- ServletForwardingController
- ServletWrappingController
- UrlFilenameViewController
4.为处理程序方法指定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;
@Controller
public 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。
5.为处理程序方法指定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;
@Controller
public 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注解。
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 若是请求中不存在此类参数，则变量 将为null。
另外一个属性是 defaultValue，能够在请求参数为空时用做后备值。例如：
@RequestParam(defaultValue = "18") int age
Map 若是方法参数是type，Spring还容许咱们将全部参数做为对象 访问 Map<String, String>。例如：
doLogin(@RequestParam Map<String, String> params)
而后，映射参数包含键-值对形式的全部请求参数。有关使用@RequestParam 注释的更多信息，请参见 @RequestParam注解。关注微信公众号：Java技术栈，在后台回复：spring，能够获取我整理的 N 篇最新 Spring 教程，都是干货。
7.返回模型和视图
处理完业务逻辑后，处理程序方法应返回一个视图，而后由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 面试 7 大问题，推荐看下。
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。
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<String, Object> 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接口的更多信息：
- 在方法参数上使用@ModelAttribute
- 在方法上使用@ModelAttribute
- 接口绑定结果
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自动将业务类的实际实现注入控制器。关注微信公众号：Java技术栈，在后台回复：spring，能够获取我整理的 N 篇最新Spring Boot 教程，都是干货。
考虑如下控制器类的代码段：
@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<User> list();
void save(User user);
void checkLogin(User user);
}
有关@Autowired 注解的更多信息，请参见 注释类型自动装配。
13.访问HttpServletRequest和HttpServletResponse
在某些状况下，您须要直接 在处理程序方法中访问 HttpServletRequest 或 HttpServletResponse对象。
经过Spring的灵活性，只需在处理方法中添加相关参数便可。例如：
@RequestMapping("/download")
public String doDownloadFile(
HttpServletRequest request, HttpServletResponse response) {
// 访问请求
// 访问响应
return "DownloadPage";
}
Spring检测并自动将 HttpServletRequest 和 HttpServletResponse 对象注入方法中。而后，能够访问请求和响应如获取 InputStream， OutputStream或返回一个特定的HTTP代码。
14.遵循单一责任原则
最后，在设计和编写Spring MVC控制器时，有两个很好的实践是你应该遵循的:
1）控制器类不该执行业务逻辑。相反，它应该将业务处理委托给相关的业务类别。这使控制器始终专一于其设计职责是控制应用程序的工做流程。例如：
@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);
}
}
2）为每一个业务域建立每一个单独的控制器。例如， UserController 用于控制用户管理的OrderController 工做流程， 用于控制订单处理的工做流程等。例如：
@Controller
public class UserController {
}
@Controller
public class ProductController {
}
@Controller
public class OrderController {
}
@Controller
public class PaymentController {
}
这14个小技巧，能够帮助你正确有效地在Spring MVC中编写控制器类。若是你有其余提示或建议，请随时在评论中分享您的想法。
推荐去个人博客阅读更多：
2.Spring MVC、Spring Boot、Spring Cloud 系列教程
3.Maven、Git、Eclipse、Intellij IDEA 系列工具教程
生活很美好，明天见～
- 1. 编写Spring MVC控制器的14个技巧
- 2. 50个js技巧（分享）
- 3. 【Spring】Spring MVC高级技术
- 4. Web 技巧（14）
- 5. spring-mvc高级技术
- 6. Spring MVC ⾼级技术
- 7. 顶级Kagglers的心得和技巧
- 8. Java 8 开发顶级技巧
- 9. 分享 ：几个超级实用的excel小技巧
- 10. 再分享 5 个 vs 调试技巧
- 更多相关文章...
- • Markdown 高级技巧 - Markdown 教程
- • 第一个Spring程序 - Spring教程
- • Spring Cloud 微服务实战(三) - 服务注册与发现
- • 算法总结-二分查找法
-
每一个你不满意的现在，都有一个你没有努力的曾经。
- 1. 编写Spring MVC控制器的14个技巧
- 2. 50个js技巧（分享）
- 3. 【Spring】Spring MVC高级技术
- 4. Web 技巧（14）
- 5. spring-mvc高级技术
- 6. Spring MVC ⾼级技术
- 7. 顶级Kagglers的心得和技巧
- 8. Java 8 开发顶级技巧
- 9. 分享 ：几个超级实用的excel小技巧
- 10. 再分享 5 个 vs 调试技巧