重拾后端之Spring Boot（三）：找回熟悉的Controller，Service

重拾后端之Spring Boot（一）：REST API的搭建能够这样简单
重拾后端之Spring Boot（二）：MongoDb的无缝集成
重拾后端之Spring Boot（三）：找回熟悉的Controller，Service
重拾后端之Spring Boot（四）：使用 JWT 和 Spring Security 保护 REST API

找回熟悉的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;
    }
}复制代码

上面的代码中须要再说明几个要点：

1. 为何在类上标记 @RequestMapping("/todos") 后在每一个方法上还须要添加 @RequestMapping？类上面定义的 @RequestMapping 的参数会默认应用于全部方法，但若是咱们发现某个方法须要有本身的特殊值时，就须要定义这个方法的映射参数。好比上面例子中 addTodo，路径也是 todos，但要求 Request的方法是 POST，因此咱们给出了 @RequestMapping(method = RequestMethod.POST)。但 getTodo 方法的路径应该是 todos/:id，这时咱们要给出 @RequestMapping(value = "/{id}", method = RequestMethod.GET)
2. 这些方法接受的参数也使用了各类修饰符，@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作一下测试：

测试一下Controller

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带给咱们的便利吧。

本章代码：github.com/wpcfan/spri…

重拾后端之Spring Boot（一）：REST API的搭建能够这样简单
重拾后端之Spring Boot（二）：MongoDb的无缝集成
重拾后端之Spring Boot（三）：找回熟悉的Controller，Service
重拾后端之Spring Boot（四）：使用 JWT 和 Spring Security 保护 REST API