@Controller
@RequestMapping("/article")
public class ArticleController {@Autowiredprivate ArticleService articleService;@RequestMapping("/list.json")@ResponseBodypublic List<Article> listArticles(String title, Integer pageSize, Integer pageNum) {if (pageSize == null) {pageSize = 10;}if (pageNum == null) {pageNum = 1;}int offset = (pageNum - 1) * pageSize;return articleService.getArticles(title, 1L, offset, pageSize);}}

这个ArticleService的实现很简单，就是简单的封装了ArticleMapper的操作，ArticleMapper的内容大家可以参考上一篇的文章，ArticleService的实现类如下：

@Service
public class ArticleServiceImpl implements ArticleService {@Autowiredprivate ArticleMapper articleMapper;@Overridepublic Long saveArticle(@RequestBody Article article) {return articleMapper.insertArticle(article);}@Overridepublic List<Article> getArticles(String title,Long userId,int offset,int pageSize) {Article article = new Article();article.setTitle(title);article.setUserId(userId);return articleMapper.queryArticlesByPage(article,offset,pageSize);}@Overridepublic Article getById(Long id) {return articleMapper.queryById(id);}@Overridepublic void updateArticle(Article article) {article.setUpdateTime(new Date());articleMapper.updateArticleById(article);}}

ArticleServiceImpl这个类是一个很普通的类，只有一个Spring的注解@Service，标识为一个bean以便于通过Spring IoC容器来管理。

我们再来看看ArticleController这个类，其实用过Spring MVC的人应该都熟悉这几个注解，这里简单解释一下：

通过这个三个注解，我们就能轻松的实现通过URL给前端返回JSON格式数据的功能。不过大家肯定有点疑惑，这不都是Spring MVC的东西吗？跟Spring boot有什么关系？

其实Spring boot的作用就是为我们省去了配置的过程，其他功能确实都是Spring与Spring MVC来为我们提供的，大家应该记得Spring boot通过各种starter来为我们提供自动配置的服务，我们的工程里面之前引入过这个依赖：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId>
</dependency>

这个是所有Spring boot的web工程都需要引入的jar包，也就是说只要是Spring boot的web的工程，都默认支持上述的功能。这里我们进一步发现，通过Spring boot来开发web工程，确实为我们省了许多配置的工作。

好了，我们现在再来看看如何实现Restful API。实际上Restful本身不是一项什么高深的技术，而只是一种编程风格，或者说是一种设计风格。

在传统的http接口设计中，我们一般只使用了get和post两个方法，然后用我们自己定义的词汇来表示不同的操作，比如上面查询文章的接口，我们定义了article/list.json来表示查询文章列表，可以通过get或者post方法来访问。

而Restful API的设计则通过HTTP的方法来表示CRUD相关的操作。因此，除了get和post方法外，还会用到其他的HTTP方法，如PUT、DELETE、HEAD等，通过不同的HTTP方法来表示不同含义的操作。下面是我设计的一组对文章的增删改查的Restful API：

这里可以看出，URL仅仅是标识资源的路劲，而具体的行为由HTTP方法来指定。

现在我们再来看看如何实现上面的接口，其他就不多说，直接看代码：

@RestController
@RequestMapping("/rest")
public class ArticleRestController {@Autowiredprivate ArticleService articleService;@RequestMapping(value = "/article", method = POST, produces = "application/json")public WebResponse<Map<String, Object>> saveArticle(@RequestBody Article article) {article.setUserId(1L);articleService.saveArticle(article);Map<String, Object> ret = new HashMap<>();ret.put("id", article.getId());WebResponse<Map<String, Object>> response = WebResponse.getSuccessResponse(ret);return response;}@RequestMapping(value = "/article/{id}", method = DELETE, produces = "application/json")public WebResponse<?> deleteArticle(@PathVariable Long id) {Article article = articleService.getById(id);article.setStatus(-1);articleService.updateArticle(article);WebResponse<Object> response = WebResponse.getSuccessResponse(null);return response;}@RequestMapping(value = "/article/{id}", method = PUT, produces = "application/json")public WebResponse<Object> updateArticle(@PathVariable Long id, @RequestBody Article article) {article.setId(id);articleService.updateArticle(article);WebResponse<Object> response = WebResponse.getSuccessResponse(null);return response;}@RequestMapping(value = "/article/{id}", method = GET, produces = "application/json")public WebResponse<Article> getArticle(@PathVariable Long id) {Article article = articleService.getById(id);WebResponse<Article> response = WebResponse.getSuccessResponse(article);return response;}}

我们再来分析一下这段代码，这段代码和之前代码的区别在于：

代码写完了，怎么测试？

除了GET的方法外，都不能直接通过浏览器来访问，当然，我们可以直接通过postman来发送各种http请求。

不过我还是比较支持通过单元测试类来测试各个方法。推这里我们就通过Junit来测试各个方法：

@RunWith(SpringJUnit4ClassRunner.class)
@SpringBootTest(classes = Application.class)
public class ArticleControllerTest {@Autowiredprivate ArticleRestController restController;private MockMvc mvc;@Beforepublic void setUp() throws Exception {mvc = MockMvcBuilders.standaloneSetup(restController).build();}@Testpublic void testAddArticle() throws Exception {Article article = new Article();article.setTitle("测试文章000000");article.setType(1);article.setStatus(2);article.setSummary("这是一篇测试文章");Gson gosn = new Gson();RequestBuilder builder = MockMvcRequestBuilders.post("/rest/article").accept(MediaType.APPLICATION_JSON) .contentType(MediaType.APPLICATION_JSON_UTF8).content(gosn.toJson(article));MvcResult result = mvc.perform(builder).andReturn(); System.out.println(result.getResponse().getContentAsString());}@Testpublic void testUpdateArticle() throws Exception {Article article = new Article();article.setTitle("更新测试文章");article.setType(1);article.setStatus(2);article.setSummary("这是一篇更新测试文章");Gson gosn = new Gson();RequestBuilder builder = MockMvcRequestBuilders.put("/rest/article/1").accept(MediaType.APPLICATION_JSON).contentType(MediaType.APPLICATION_JSON_UTF8).content(gosn.toJson(article));MvcResult result = mvc.perform(builder).andReturn();}@Testpublic void testQueryArticle() throws Exception {RequestBuilder builder = MockMvcRequestBuilders.get("/rest/article/1").accept(MediaType.APPLICATION_JSON) .contentType(MediaType.APPLICATION_JSON_UTF8);MvcResult result = mvc.perform(builder).andReturn(); System.out.println(result.getResponse().getContentAsString());}@Testpublic void testDeleteArticle() throws Exception {RequestBuilder builder = MockMvcRequestBuilders.delete("/rest/article/1").accept(MediaType.APPLICATION_JSON) .contentType(MediaType.APPLICATION_JSON_UTF8);MvcResult result = mvc.perform(builder).andReturn();}}

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope>
</dependency>

正文结束