restful api 例子 java_实战：SpringBoot & 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 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的操作，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 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 a