15.工具
15.1.HAL 浏览器
HAL spec的开发人员有一个很有用的应用程序: the HAL Browser. 这是一个采用了一点 HAL-powered JavaScript的web应用程序,你可以把他指向任何一个Spring Data REST API。并且使用它来导航应用程序, 并创建新的资源.
而不是下拉文件,将它们嵌入到您的应用程序中,并且制作一个Spring mvc 控制器来为他们服务,你只需要添加一个单独的附属.
在 Maven:
<dependencies><dependency><groupId>org.springframework.data</groupId><artifactId>spring-data-rest-hal-browser</artifactId></dependency></dependencies>
在Gradle
dependencies {
compile 'org.springframework.data:spring-data-rest-hal-browser'}
如果你用了Spring Boot 或者Spring Data BOM(材料单),你不需要指定版本. | |
---|---|
当你在浏览器里面访问你的应用的root URI时候, 这种依赖性将会自动配置HAL Browser来服务.
上面的屏幕截图显示了root 的 API 路径.在右边是反应中的细节,包括标题和内容.(一个HAL文件).
HAL的浏览器读取响应的链接放在左侧列表.你可以单击GET按钮,导航到其中的一个或者单击non-GET选项来进行更改.
HAL Browser 说URI Template,你也许会注意到GET旁边的persons有一个问题标志图标.一个扩展对话框将会弹出如果你选择像下面这个一样导航到他:
如果你没有加入任何东西单击Follow URI,这些变量将基本上被忽略 .就像这个情况 Projections and Excerpts 或者 [Paging and Sorting] (http://docs.spring.io/spring-data/rest/docs/2.5.2.RELEASE/reference/html/#paging-and-sorting),这将会很有用.
当你点击non-GET这个按钮,会出现一个对话框,默认情况下,这会显示POST,这里可以被调整为PUT 或者 PATCH,这个头文件被填写正确会提交一个新的JSON文档.
URI下面,方法,标题是字段,这些都是基于资源的数据自动提供上去的,通过Spring Data REST自动生成,更新你的域对象,会弹出对话框来反应这个.