原标题:Spring认证中国教育管理中心-Spring Data REST框架教程二(Spring中国教育管理中心)
4.2.馆藏资源
Spring Data REST 公开了一个以导出存储库正在处理的域类的非大写复数版本命名的集合资源。资源的名称和路径都可以通过@RepositoryRestResource在存储库界面上使用来自定义。
4.2.1.支持的 HTTP 方法
集合资源同时支持GET和POST. 所有其他 HTTP 方法都会导致405 Method Not Allowed.
GET
通过其findAll(…)方法返回存储库服务器的所有实体。如果存储库是分页存储库,我们会在必要时包含分页链接和其他页面元数据。
用于调用的方法
如果存在,则使用以下方法(降序):
- findAll(Pageable)
- findAll(Sort)
- findAll()
有关方法默认公开的更多信息,请参阅存储库方法公开。
参数
如果存储库具有分页功能,则资源采用以下参数:
- page: 要访问的页码(0 索引,默认为 0)。
- size:请求的页面大小(默认为 20)。
- sort: 格式为($propertyname,)+[asc|desc]?的排序指令的集合。
自定义状态代码
该GET方法只有一个自定义状态代码:
- 405 Method Not Allowed:如果findAll(…)方法未导出(通过@RestResource(exported = false))或不存在于存储库中。
支持的媒体类型
该GET方法支持以下媒体类型:
- application/hal+json
- application/json
相关资源
该GET方法支持用于发现相关资源的单个链接:
- search:如果后备存储库公开查询方法,则公开搜索资源。
HEAD
该HEAD方法返回集合资源是否可用。它没有状态代码、媒体类型或相关资源。
用于调用的方法
如果存在,则使用以下方法(降序):
- findAll(Pageable)
- findAll(Sort)
- findAll()
有关方法默认公开的更多信息,请参阅存储库方法公开。
POST
该POST方法从给定的请求正文创建一个新实体。默认情况下,响应是否包含正文由Accept随请求发送的标头控制。如果发送了一个,则会创建一个响应正文。如果不是,则响应正文为空,并且可以通过以下Location响应标头中包含的链接获取所创建资源的表示。可以通过相应的配置来覆盖此行为
RepositoryRestConfiguration.setReturnBodyOnCreate(…)。
用于调用的方法
如果存在,则使用以下方法(降序):
- save(…)
有关方法默认公开的更多信息,请参阅存储库方法公开。
自定义状态代码
该POST方法只有一个自定义状态代码:
- 405 Method Not Allowed:如果save(…)方法未导出(通过@RestResource(exported = false))或根本不存在于存储库中。