wadl 生成java_在Spring MVC REST应用程序中自动生成WADL
wadl 生成java
JSR 311的许多实现:JAX-RS:RESTful Web服务的Java API提供了开箱即用的运行时WADL生成: Apache CXF , Jersey和Restlet 。 RESTeasy还在等待。 基本上,这些框架检查带有JSR-311批注的Java代码,并在某些URL下生成WADL文档。 不幸的是,Spring MVC不仅不实现JSR-311标准(请参阅: Spring MVC是否支持JSR 311注释? ),而且即使它非常适合于我们,也不会为我们生成WADL(请参阅: SPR-8705 )。公开REST服务。
由于种种原因,我开始使用Spring MVC开发服务器端REST服务,过了一会儿(比如说以后有第三方资源),我开始迷路了。 我确实需要一种对所有可用资源和操作进行分类和记录的方法。 WADL似乎是一个不错的选择。
幸运的是,Spring框架已开放扩展,如果您愿意在一段时间内挖掘代码,可以轻松地基于现有基础结构添加新功能。 为了生成WADL,我需要一个应用程序处理的URI列表,实现的HTTP方法以及(理想情况下)哪种Java方法处理每个方法。 为@Controller,@RequestMapping,@PathVariable等扫描- -显然Spring启动捆扎MVC 的DispatcherServlet在做这项工作已经某处这样看来聪明重用这些信息而不是再次执行任务。
猜猜看,我们需要的所有信息看起来都保存在一个奇怪的RequestMappingHandlerMapping类中。 这是一个调试器屏幕截图,仅用于概述如何提供丰富的信息:
但是它变得更好:RequestMappingHandlerMapping实际上是一个Spring Bean,您可以轻松地注入和使用它:
@Controller
class WadlController @Autowired()(mapping: RequestMappingHandlerMapping) {@RequestMapping(method = Array(GET))@ResponseBody def generate(request: HttpServletRequest) = new WadlApplication()}
没错,我们将使用另一个Spring MVC控制器来生成WADL文档。 上一次我们设法生成表示WADL文档的JAXB类(毕竟WADL是XML文件),因此通过返回空的WadlApplication实例,我们实际上返回的是空的但有效的WADL:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<application xmlns="http://wadl.dev.java.net/2009/02"/>
我不会解释实现的细节(提供完整的源代码 ,包括示例应用程序)。 基本上,这是将Spring模型重写为WADL类的问题。 如果您有兴趣,请查看WadlGenerator.scala,它是解决方案和测试用例的中心点。 这是其中之一:
test("should add parameter info for template parameter in URL") {given("")val mapping = Map(mappingInfo("/books", GET) -> handlerMethod("listBooks"),mappingInfo("/books/{bookId}", GET) -> handlerMethod("readBook"))when("")val wadl = generate(mapping)then("")assertXMLEqual(wadlHeader + """<resource path="books"><method name="GET"><doc title="com.blogspot.nurkiewicz.springwadl.TestController.listBooks"/></method><resource path="{bookId}"><param name="bookId" required="true" /><method name="GET"><doc title="com.blogspot.nurkiewicz.springwadl.TestController.readBook"/></method></resource></resource>""" + wadlFooter, wadl)
}
不幸的是,我懒得不能正确命名给定的/何时/然后块。 但是测试应该可读性强。
我要提及的唯一技术难题是将Spring基础结构提供的平面URI模式转换为分层的WADL对象(基本上是树)。 这是此问题的简化版本:具有URI模式列表,如下所示:
/books
/books/{bookId}
/books/{bookId}/reviews
/books/best-sellers
/readers
/readers/{readerId}
/readers/{readerId}/account/new-password
/readers/active
/readers/passive
生成以下树数据结构:
当然,数据结构就像持有标签和Node子列表的Node对象一样简单。 并不是那么有挑战性,但是可能是一个有趣的CodeKata 。
那么,这个WADL有什么意义呢? XML真的更具可读性,并有助于管理大量使用REST的应用程序吗? 如果不是对WADL的强大soapUI 支持,我什至都不会打扰。 为我推送的示例应用程序生成的WADL也可以轻松导入到soapUI:
值得一提的两个功能。 首先soapUI显示一棵 REST资源树 (与导入WSDL时的平面操作列表相反)。 每个HTTP方法旁边都有一个相应的Java方法(可以禁用此方法)来处理它,以进行故障排除和调试。 其次,我们可以选择任何HTTP方法/资源并调用它。 基于WADL的描述,soapUI将创建一个用户友好的向导,可以在其中输入参数。 默认值将自动填充。 完成后,应用程序将生成带有正确URL和内容的HTTP请求,并在到达时显示响应。 真的很有帮助!
顺便说一句,您是否注意到max和page查询参数? 我们的小型图书馆使用反射来查找@RequestParam注释,例如以下控制器:
@Controller
@RequestMapping(value = Array("/book/{bookId}/review"))
class ReviewController @Autowired()(reviewService: ReviewService) {@RequestMapping(method = Array(GET))@ResponseBody def listReviews(@RequestParam(value = "page", required = false, defaultValue = "1") page: Int,@RequestParam(value = "max", required = false, defaultValue = "20") max: Int) =new ResultPage(reviewService.listReviews(new PageRequest(page - 1, max)))//...}
将被翻译成与WADL兼容的描述:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<application xmlns="http://wadl.dev.java.net/2009/02"><doc title="Spring MVC REST appllication"/><resources base="http://localhost:8080/api"><resource path="book"><!-- --><resource path="{bookId}"><param required="true" style="template" name="bookId"/><!-- --><resource path="review"><method name="GET"><doc title="com.blogspot.nurkiewicz.web.ReviewController.listReviews"/><request><param required="false" default="1" style="query" name="page"/><param required="false" default="20" style="query" name="max"/></request></resource></resource></resource></resource
</application>
希望您对我编写的这个小型图书馆感到开心。 随时将其包含在您的项目中,不要犹豫,报告错误。 可以在GitHub上获得Apache许可的完整源代码: https : //github.com/nurkiewicz/spring-rest-wadl。
参考: JCG合作伙伴 在Spring MVC REST应用程序中自动生成WADL Java和社区博客中的Tomasz Nurkiewicz。
翻译自: https://www.javacodegeeks.com/2012/02/automatically-generating-wadl-in-spring.html
wadl 生成java
wadl 生成java_在Spring MVC REST应用程序中自动生成WADL相关推荐
- 在Spring MVC REST应用程序中自动生成WADL
上一次我们学习了WADL的基础知识 . 语言本身并没有那么有趣,只写了一篇有关它的文章,但是本文的标题揭示了为什么我们需要这些知识. JSR 311的许多实现:JAX-RS:RESTful Web服务 ...
- 如何使用recaptcha_在Spring MVC Web应用程序中使用reCaptcha
如何使用recaptcha CAPTCHA是一个程序,可以生成人类可以通过但计算机程序" 不能 "通过的测试并对其进行评分. 所采取的策略之一是向用户显示具有扭曲文本的图像,并且用 ...
- 在Spring MVC Web应用程序中添加社交登录:集成测试
我已经写了关于为使用Spring Social 1.1.0的应用程序编写单元测试的挑战,并为此提供了一种解决方案 . 尽管单元测试很有价值,但是它并不能真正告诉我们我们的应用程序是否正常运行. 这就是 ...
- 在Spring MVC Web应用程序中使用reCaptcha
CAPTCHA是一种程序,可以生成人类可以通过的测试并对其进行评分,而计算机程序" 不能 "通过. 所采取的策略之一是向用户显示具有扭曲文本的图像,并且用户应在输入区域中书写文本. ...
- 在基于Spring MVC的应用程序中配置favicon.ico
Favicon是与您的网站相关的图标(favicon.ico). 并非每个网站都在使用favicon. 但是大多数浏览器并不关心它,反正他们都要求它. 当图标图标不在适当位置时,服务器将返回不必要的4 ...
- 在Spring MVC Web应用程序中添加社交登录:单元测试
Spring Social 1.0具有spring-social-test模块,该模块为测试Connect实现和API绑定提供支持. 该模块已从Spring Social 1.1.0中删除,并由 Sp ...
- jeesite如何已生成数据的数据源_如何在postman中自动生成接口请求数据,这个功能你需要知道,可结合浏览器和两大抓包工具使用...
在做接口调试或测试时,请求中的每个参数都要按照接口文档填写到postman的对应位置中,很是麻烦.那是否有这样一个功能?可以帮我们自动生成接口数据,无需修改,直接发送请求就可以呢. 这里面我们需要借助 ...
- 集成spring mvc_向Spring MVC Web应用程序添加社交登录:集成测试
集成spring mvc 我已经写了关于为使用Spring Social 1.1.0的应用程序编写单元测试的挑战,并为此提供了一种解决方案 . 尽管单元测试很有价值,但它并不能真正告诉我们我们的应用程 ...
- 将社交登录添加到Spring MVC Web应用程序:配置
过去,用户使用用户名和密码组合登录. 尽管如今有些人仍然偏爱传统方式,但越来越多的用户希望使用其社交媒体帐户登录. 这就是使Spring Social(及其子项目)成为Spring项目组合有用的补充的 ...
最新文章
- 为什么要选择useState而不是useReducer
- RabbitMQ(九):RabbitMQ 延迟队列,消息延迟推送(Spring boot 版)
- 从 Java 档案(JAR) 中读取文件
- 【学习笔记】java核心技术学习笔记整理
- docker-compose配置固定IP各种问题
- VS2015新建项目无法选择framework 4.6.2
- Vue组件学习之事件总线和消息发布订阅
- 解决ifconfig没有网卡问题
- 40个极简WordPress主题
- 优秀程序员必须知道的八件事情
- 【游戏】基于matlab GUI时钟设计【含Matlab源码 1102期】
- Linux下数学(科学)软件简介(一)
- Angular 字符串替换
- excel 错位插入_Excel中图表插件导入错位的操作方法
- Python 小型项目大全 36~40
- android关机重启流程代码
- 拉依达准则python实现
- 【STL】rb_tree (multi)set (multi)map
- jmeter创建快捷方式到桌面
- 我是如何学习 Linux 的?