Spring Boot实战：Restful API的构建

在现在的开发流程中，为了最大程度实现前后端的分离，通常后端接口只提供数据接口，由前端通过Ajax请求从后端获取数据并进行渲染再展示给用户。我们用的最多的方式就是后端会返回给前端一个JSON字符串，前端解析JSON字符串生成JavaScript的对象，然后再做处理。

本文就来演示一下Spring boot如何实现这种模式，本文重点会讲解如何设计一个Restful的API，并通过Spring boot来实现相关的API。不过，为了大家更好的了解Restful风格的API，我们先设计一个传统的数据返回接口，这样大家可以对比着来理解。

一、非Restful接口的支持

我们这里以文章列表为例，实现一个返回文章列表的接口，代码如下：

@Controller

@RequestMapping("/article")

public class ArticleController {

   @Autowired

   private ArticleService articleService;

   @RequestMapping("/list.json")

   @ResponseBody

   public 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 {

   @Autowired

   private ArticleMapper articleMapper;

   @Override

   public Long saveArticle(@RequestBody Article article) {

       return articleMapper.insertArticle(article);

   }

   @Override

   public 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);

   }

   @Override

   public Article getById(Long id) {

       return articleMapper.queryById(id);

   }

   @Override

   public void updateArticle(Article article) {

       article.setUpdateTime(new Date());

       articleMapper.updateArticleById(article);

   }

}

运行Application.java这个类，然后访问：http://locahost:8080/article/list.json，就可以看到如下的结果：

ArticleServiceImpl这个类是一个很普通的类，只有一个Spring的注解@Service，标识为一个bean以便于通过Spring IoC容器来管理。我们再来看看ArticleController这个类，其实用过Spring MVC的人应该都熟悉这几个注解，这里简单解释一下：

@Controller 标识一个类为控制器。

@RequestMapping URL的映射。

@ResponseBody 返回结果转换为JSON字符串。

@RequestBody 表示接收JSON格式字符串参数。

通过这个三个注解，我们就能轻松的实现通过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 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方法来指定。

三、Restful API实现

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

@RestController

@RequestMapping("/rest")

public class ArticleRestController {

   @Autowired

   private 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;

   }

}

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

我们使用的是@RestController这个注解，而不是@Controller，不过这个注解同样不是Spring boot提供的，而是Spring MVC4中的提供的注解，表示一个支持Restful的控制器。

这个类中有三个URL映射是相同的，即都是/article/{id}，这在@Controller标识的类中是不允许出现的。这里的可以通过method来进行区分，produces的作用是表示返回结果的类型是JSON。

@PathVariable这个注解，也是Spring MVC提供的，其作用是表示该变量的值是从访问路径中获取。

所以看来看去，这个代码还是跟Spring boot没太多的关系，Spring boot也仅仅是提供自动配置的功能，这也是Spring boot用起来很舒服的一个很重要的原因，因为它的侵入性非常非常小，你基本感觉不到它的存在。

四、测试

代码写完了，怎么测试？除了GET的方法外，都不能直接通过浏览器来访问，当然，我们可以直接通过postman来发送各种http请求。不过我还是比较支持通过单元测试类来测试各个方法。这里我们就通过Junit来测试各个方法：

@RunWith(SpringJUnit4ClassRunner.class)

@SpringBootTest(classes = Application.class)

public class ArticleControllerTest {

   @Autowired

   private ArticleRestController restController;

   private MockMvc mvc;

   @Before

   public void setUp() throws Exception {

       mvc = MockMvcBuilders.standaloneSetup(restController).build();

   }

   @Test

   public 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());

   }

   @Test

   public 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();

   }

   @Test

   public 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());

   }

   @Test

   public 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();

   }

}

执行结果这里就不给大家贴了，大家有兴趣的话可以自己实验一下。整个类要说明的点还是很少，主要这些东西都与Spring boot没关系，支持这些操作的原因还是上一篇文章中提到的引入对应的starter：

<dependency>

     <groupId>org.springframework.boot</groupId>

     <artifactId>spring-boot-starter-test</artifactId>

     <scope>test</scope>

</dependency>

因为要执行HTTP请求，所以这里使用了MockMvc，ArticleRestController通过注入的方式实例化，不能直接new，否则ArticleRestController就不能通过Spring IoC容器来管理，因而其依赖的其他类也无法正常注入。通过MockMvc我们就可以轻松的实现HTTP的DELETE/PUT/POST等方法了。

五、总结

本文讲解了如果通过Spring boot来实现Restful的API，其实大部分东西都是Spring和Spring MVC提供的，Spring boot只是提供自动配置的功能。但是，正是这种自动配置，为我们减少了很多的开发和维护工作，使我们能更加简单、高效的实现一个web工程，从而让我们能够更加专注于业务本身的开发，而不需要去关心框架的东西。这篇文章中我们提到了可以通过postman和junit的方式来访问Restful 接口，下篇文章我们会介绍另外一种方式来访问，有兴趣的可以继续关注一下。

扩展阅读

springboot知识点整理

Springboot Mybatis整合（完整版）

Spring Boot配置随机数那些小技巧

给你一份详细的Spring Boot知识清单

Spring MVC到Spring BOOT的简化之路

来源：https://www.cnblogs.com/paddix/p/8215245.html

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 204,684评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 87,143评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 151,214评论 0赞 337
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,788评论 1赞 277
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,796评论 5赞 368
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,665评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,027评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,679评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 41,346评论 1赞 299
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,664评论 2赞 321
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,766评论 1赞 331
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,412评论 4赞 321
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,015评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,974评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,073评论 2赞 350
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,501评论 2赞 343