重拾后端之Spring Boot（一）：REST API的搭建可以这样简单
重拾后端之Spring Boot（二）：MongoDb的无缝集成
重拾后端之Spring Boot（三）：找回熟悉的Controller，Service
重拾后端之Spring Boot（四）：使用 JWT 和 Spring Security 保护 REST API
重拾后端之Spring Boot（五）：跨域、自定义查询及分页
重拾后端之Spring Boot（六）：热加载、容器和多项目
找回熟悉的Controller，Service
Controller哪儿去了？
对于很多习惯了Spring开发的同学来讲，Controller，Service，DAO 这些套路突然间都没了会有不适感。其实呢，这些东西还在，只不过对于较简单的情景下，这些都变成了系统背后帮你做的事情。这一小节我们就先来看看如何将Controller再召唤回来。召唤回来的好处有哪些呢？首先我们可以自定义API URL的路径，其次可以对参数和返回的json结构做一定的处理。
如果要让 TodoController 可以和 TodoRepository 配合工作的话，我们当然需要在 TodoController 中需要引用 TodoRepository。
public class TodoController {
@Autowired
private TodoRepository repository;
//省略其它部分
}
@Autowired 这个修饰符是用于做依赖性注入的，上面的用法叫做 field injection，直接做类成员的注入。但Spring现在鼓励用构造函数来做注入，所以，我们来看看构造函数的注入方法：
public class TodoController {
private TodoRepository repository;
@Autowired
public TodoController(TodoRepository repository){
this.repository = repository;
}
//省略其它部分
}
当然我们为了可以让Spring知道这是一个支持REST API的 Controller ，还是需要标记其为 @RestController。由于默认的路径映射会在资源根用复数形式，由于todo是辅音后的o结尾，按英语习惯，会映射成 todoes。但这里用 todos 比 todoes 更舒服一些，所以我们再使用另一个 @RequestMapping("/todos") 来自定义路径。这个 Controller 中的其它方法比较简单，就是利用repository中的方法去增删改查即可。
package dev.local.todo;
import org.bson.types.ObjectId;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
@RequestMapping("/todos")
public class TodoController {
private TodoRepository repository;
@Autowired
public TodoController(TodoRepository repository){
this.repository = repository;
}
@RequestMapping(method = RequestMethod.GET)
public List<Todo> getAllTodos(@RequestHeader(value = "userId") String userId) {
return repository.findByUserId(new ObjectId(userId));
}
@RequestMapping(method = RequestMethod.POST)
Todo addTodo(@RequestBody Todo addedTodo) {
return repository.insert(addedTodo);
}
@RequestMapping(value = "/{id}", method = RequestMethod.GET)
public Todo getTodo(@PathVariable String id) {
return repository.findOne(id);
}
@RequestMapping(value = "/{id}", method = RequestMethod.PUT)
Todo updateTodo(@PathVariable String id, @RequestBody Todo updatedTodo) {
updatedTodo.setId(id);
return repository.save(updatedTodo);
}
@RequestMapping(value = "/{id}", method = RequestMethod.DELETE)
Todo removeTodo(@PathVariable String id) {
Todo deletedTodo = repository.findOne(id);
repository.delete(id);
return deletedTodo;
}
}
上面的代码中需要再说明几个要点：
- 为什么在类上标记
@RequestMapping("/todos")后在每个方法上还需要添加@RequestMapping？类上面定义的@RequestMapping的参数会默认应用于所有方法，但如果我们发现某个方法需要有自己的特殊值时，就需要定义这个方法的映射参数。比如上面例子中addTodo，路径也是todos，但要求 Request的方法是POST，所以我们给出了@RequestMapping(method = RequestMethod.POST)。但getTodo方法的路径应该是todos/:id，这时我们要给出@RequestMapping(value = "/{id}", method = RequestMethod.GET) - 这些方法接受的参数也使用了各种修饰符，
@PathVariable表示参数是从路径中得来的，而@RequestBody表示参数应该从 Http Request的body中解析，类似的@RequestHeader表示参数是 Http Request的Header中定义的。
在可以测试之前，我们还需要使用 @Repository 来标记 TodoRepository，以便于Spring可以在依赖注入时可以找到这个类。
package dev.local.todo;
import org.bson.types.ObjectId;
import org.springframework.data.mongodb.repository.MongoRepository;
import org.springframework.stereotype.Repository;
import java.util.List;
/**
* Created by wangpeng on 2017/1/26.
*/
@Repository
public interface TodoRepository extends MongoRepository<Todo, String>{
List<Todo> findByUserId(ObjectId userId);
}
接下来就可以用PostMan做一下测试：
Service呢？在哪里？
熟悉Spring的童鞋肯定会问，我们刚才的做法等于直接是Controller访问Data了，隔离不够啊。其实我觉得有很多时候，这种简单设计是挺好的，因为业务还没有到达那步，过于复杂的设计其实没啥太大意义。但这里我们还是一步步来实践一下，找回大家熟悉的感觉。
回到原来的熟悉模式再简单不过的，新建一个 TodoService 接口，定义一下目前的增删改查几个操作：
public interface TodoService {
Todo addTodo(Todo todo);
Todo deleteTodo(String id);
List<Todo> findAll(String userId);
Todo findById(String id);
Todo update(Todo todo);
}
为预防我们以后使用 MySQL 等潜在的 “可扩展性”，我们给这个接口的实现命名为 MongoTodoServiceImpl，然后把 Controller 中的大部分代码拿过来改改就行了。当然为了系统可以找到这个依赖并注入需要的类中，我们标记它为 @Service
@Service
public class MongoTodoServiceImpl implements TodoService{
private final TodoRepository repository;
@Autowired
MongoTodoServiceImpl(TodoRepository repository) {
this.repository = repository;
}
@Override
public Todo addTodo(Todo todo) {
return repository.insert(todo);
}
@Override
public Todo deleteTodo(String id) {
Todo deletedTodo = repository.findOne(id);
repository.delete(id);
return deletedTodo;
}
@Override
public List<Todo> findAll(String userId) {
return repository.findByUserId(new ObjectId(userId));
}
@Override
public Todo findById(String id) {
return repository.findOne(id);
}
@Override
public Todo update(Todo todo) {
repository.save(todo);
return todo;
}
}
最后把Controller中的所有方法改为使用Service的简单调用就大功告成了。
public class TodoController {
private TodoService service;
@Autowired
public TodoController(TodoService service){
this.service = service;
}
@RequestMapping(method = RequestMethod.GET)
public List<Todo> getAllTodos(@RequestHeader(value = "userId") String userId) {
return service.findAll(userId);
}
@RequestMapping(method = RequestMethod.POST)
Todo addTodo(@RequestBody Todo addedTodo) {
return service.addTodo(addedTodo);
}
@RequestMapping(value = "/{id}", method = RequestMethod.GET)
public Todo getTodo(@PathVariable String id) {
return service.findById(id);
}
@RequestMapping(value = "/{id}", method = RequestMethod.PUT)
Todo updateTodo(@PathVariable String id, @RequestBody Todo updatedTodo) {
updatedTodo.setId(id);
return service.update(updatedTodo);
}
@RequestMapping(value = "/{id}", method = RequestMethod.DELETE)
Todo removeTodo(@PathVariable String id) {
return service.deleteTodo(id);
}
}
说实话如果每个简单类都这么写，我深深地赶脚背离了Spring Boot的意图，虽然你能举出1000个理由这么做有好处。类似的，DAO或DTO要写起来也很简单，但我还是建议在业务没有复杂之前还是享受Spring Boot带给我们的便利吧。
本章代码：https://github.com/wpcfan/spring-boot-tut/tree/chap03
重拾后端之Spring Boot（一）：REST API的搭建可以这样简单
重拾后端之Spring Boot（二）：MongoDb的无缝集成
重拾后端之Spring Boot（三）：找回熟悉的Controller，Service
重拾后端之Spring Boot（四）：使用 JWT 和 Spring Security 保护 REST API
重拾后端之Spring Boot（五）：跨域、自定义查询及分页
有问题的童鞋可以加入我的小密圈讨论： http://t.xiaomiquan.com/jayRnaQ (该链接7天内(5月14日前)有效)
另外，我的 《Angular 从零到一》出版了，下面是书籍的内容简介:
本书系统介绍Angular的基础知识与开发技巧，可帮助前端开发者快速入门。共有9章，第1章介绍Angular的基本概念，第2~7章从零开始搭建一个待办事项应用，然后逐步增加功能，如增加登录验证、将应用模块化、多用户版本的实现、使用第三方样式库、动态效果制作等。第8章介绍响应式编程的概念和Rx在Angular中的应用。第9章介绍在React中非常流行的Redux状态管理机制，这种机制的引入可以让代码和逻辑隔离得更好，在团队工作中强烈建议采用这种方案。本书不仅讲解Angular的基本概念和最佳实践，而且分享了作者解决问题的过程和逻辑，讲解细腻，风趣幽默，适合有面向对象编程基础的读者阅读。
欢迎大家围观、订购、提出宝贵意见。
京东链接：https://item.m.jd.com/product/12059091.html?from=singlemessage&isappinstalled=0
