1.使用@Controller构造型
@Controller
public class HomeController {
@RequestMapping("/")
public String visitHome() {
return "home";
}
}
注意:@Controller原型只能在Spring的配置文件中启用注解驱动时使用:
<annotation-driven />
启用注释驱动时,Spring容器自动在以下语句指定的包下扫描类:
<context:component-scan base-package="net.codejava.spring" />
由@Controller
注释注释的类被配置为控制器。这是最可取的,因为它很简单:无需在配置文件中为控制器声明bean。
2.实现控制器接口
在Spring 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
类是理想的选择。请考虑以下示例:
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映射
@Controller
@RequestMapping("/hello")
public class SingleActionController {
@RequestMapping(method = RequestMethod.GET)
public String sayHello() {
return "hello";
}
}
@RequestMapping注释还可以用于指定一个方法要处理的多个URL模式。例如:
@RequestMapping({"/hello", "/hi", "/greetings"})
此外,此注解还具有在某些情况下可能有用的其他属性,例如method
。
5.为处理程序方法指定HTTP请求方法
@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";
}
}
6.将请求参数映射到处理程序方法
您可以使用@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
如果参数名称与变量名称不同,则可以如下指定参数的实际名称:
@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)
http://localhost:8080/test1?name=%E5%BC%A0%E4%B8%89&age=22
{name=张三, age=22}
然后,映射参数包含键-值对形式的所有请求参数。有关使用@RequestParam
注释的更多信息,请参见 @RequestParam注解。
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也非常灵活,因为您可以将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";
}
//这种测试的,不行,错误信息不想找了。
- 亲测 下面的可行
@PostMapping(value = "/save",
consumes = {MediaType.MULTIPART_FORM_DATA_VALUE})
public ResultDTO<> save(
@RequestPart(name = "file") MultipartFile file) {
System.out.println(file.getOriginalFilename());
}
@PathVariable("id") String id
12.在控制器中自动装配业务类
@Controller
public class UserController {
@Autowired
private UserDAO userDAO;
public String listUser() {
// 列出所有用户的处理方法
userDAO.list();
}
}
13.访问HttpServletRequest和Response
只需在处理方法中添加相关参数即可。例如:
@RequestMapping("/download")
public String doDownloadFile(
HttpServletRequest request, HttpServletResponse response) {
// 访问请求
// 访问响应
return "DownloadPage";
}
Spring检测并自动将 HttpServletRequest
和 HttpServletResponse
对象注入方法中。
然后,可以访问请求和响应如获取 InputStream
, OutputStream
或返回一个特定的HTTP代码。
14.遵循单一责任原则
控制器类不应执行业务逻辑。相反,它应该将业务处理委托给相关的业务类别。这使控制器始终专注于其设计职责是控制应用程序的工作流程。
为每个业务域创建每个单独的控制器。例如, UserController
用于控制用户管理的OrderController
工作流程, 用于控制订单处理的工作流程等。