全能编程开发工程师手把手教你写controller层

一、什么是controller层

在MVC架构中，controller层是应用程序的控制器，主要作用是把前端的请求映射到后端的具体处理方法上。

在Spring框架中，controller层通常使用注解@Controller来定义，每个方法都对应一个具体的请求路径（@RequestMapping），方法的返回值通常是一个视图或者数据模型对象。

下面是一个简单的controller示例：

@Controller
@RequestMapping("/user")
public class UserController {
    @Autowired
    private UserService userService;

    @RequestMapping("/list")
    public String list(Model model) {
        List userList = userService.getAllUsers();
        model.addAttribute("userList", userList);
        return "user/list";
    }

    @RequestMapping("/add")
    public String add(Model model) {
        model.addAttribute("user", new User());
        return "user/form";
    }

    @RequestMapping("/save")
    public String save(@ModelAttribute("user") User user) {
        userService.saveUser(user);
        return "redirect:/user/list";
    }

    @RequestMapping("/edit/{id}")
    public String edit(@PathVariable("id") Long id, Model model) {
        User user = userService.getUserById(id);
        model.addAttribute("user", user);
        return "user/form";
    }

    @RequestMapping("/delete/{id}")
    public String delete(@PathVariable("id") Long id) {
        userService.deleteUserById(id);
        return "redirect:/user/list";
    }
}

  

二、controller层的工作流程

controller层通常作为应用程序的入口，它接收前端的请求，将请求参数转发给业务逻辑层进行处理，最终返回数据模型或者视图给前端页面。

下面是一个典型的controller层的工作流程：

• 前端向后端发送HTTP请求。
• 请求被映射到对应的controller方法。
• controller方法解析请求参数，根据业务逻辑调用对应的服务层方法。
• 服务层方法处理业务逻辑，返回数据模型或结果码。
• controller方法根据服务层的返回结果构造HTTP响应，并将结果传递给前端。

三、controller层的网络请求处理

在controller层中，我们通常使用注解@RequestMapping来标记处理请求的方法。通过@RequestMapping注解可以指定请求URL、请求方法、请求参数等一系列参数。

下面是一个@RequestMapping注解的用法示例：

@RequestMapping(value = "/user/{id}", method = RequestMethod.GET, params = {"name=admin"})
@ResponseBody
public User getUserById(@PathVariable("id") Long id) {
    return userService.getUserById(id);
}

• value：指定请求URL路径，可以是绝对路径或相对路径。
• method：指定请求方法，可以是GET、POST、PUT、DELETE等HTTP请求方法。
• params：指定请求参数，可以是一个或多个参数值。
• @PathVariable：用于获取URL路径中的参数值。
• @RequestParam：用于获取请求参数中的参数值。
• @RequestBody：用于获取请求体中的参数值。
• @ResponseBody：用于将方法的返回值序列化成JSON字符串并返回给前端。

四、controller层的异常处理

在controller层中，我们通常会对请求过程中可能出现的异常进行处理，以保证应用程序的健壮性和稳定性。

下面是一个异常处理的controller示例：

@ControllerAdvice
public class ExceptionHandlerAdvice {
    @ExceptionHandler(Exception.class)
    public ResponseEntity handleException(Exception e) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("系统错误：" + e.getMessage());
    }

    @ExceptionHandler(UserNotFoundException.class)
    public ResponseEntity
    handleUserNotFoundException(UserNotFoundException e) {
        return ResponseEntity.status(HttpStatus.NOT_FOUND).body(e.getMessage());
    }
}

   
  

在上述代码中，@ControllerAdvice注解表示该类是全局异常处理类，@ExceptionHandler注解表示该方法处理指定的异常类型。

在实际编程过程中，我们应该根据具体的业务需求对异常进行详细的分类和处理。

五、controller层的单元测试

在controller层中，单元测试通常使用mockMvc来模拟HTTP请求并对返回结果进行断言。mockMvc可以有效地模拟接口请求、参数设置、返回结果验证等功能。

下面是一个mockMvc单元测试的示例：

@RunWith(SpringRunner.class)
@SpringBootTest(classes = Application.class)
@AutoConfigureMockMvc
public class UserControllerTest {
    @Autowired
    private MockMvc mockMvc;

    @Test
    public void testGetUserById() throws Exception {
        MvcResult result = mockMvc.perform(MockMvcRequestBuilders.get("/user/123").param("name", "admin"))
                .andExpect(MockMvcResultMatchers.status().isOk())
                .andExpect(MockMvcResultMatchers.jsonPath("$.id", Matchers.is(123)))
                .andReturn();
        String content = result.getResponse().getContentAsString();
        System.out.println(content);
    }
}

在上述代码中，@RunWith注解表示使用SpringRunner作为测试运行器，@SpringBootTest注解表示启动Spring应用上下文，@AutoConfigureMockMvc注解表示自动配置MockMvc。

testGetUserById()方法模拟了一个HTTP GET请求，并验证了返回结果的状态码和JSON属性值是否正确。

六、controller层的安全性考虑

在controller层中，安全性问题非常关键，我们需要注意以下几点：

• 禁止在controller层中使用明文密码和敏感信息。
• 避免使用GET请求传递敏感数据，尽可能使用POST方法。
• 使用token、JWT等方式进行用户身份验证和权限控制。
• 前后端交互过程中使用HTTPS协议，保证数据传输的安全性。

七、总结

以上就是全能编程开发工程师手把手教你写controller层的全部内容，希望对大家有所帮助。