基本注解
Path 资源路径
Get,Put,Post,Delete 等资源获取方式
Consumes 定义资源的请求类型
Produces 定义资源的响应类型
Context 注入各种上下文对象
Suspended 注入response对象,并使用异步模式
映射机制:主要包括资源响应类型与java对象类型直接的映射;响应方式与java异常类直接的映射。
1,当资源方法使用Produces 注解,支持直接返回String,File等对象。
2,当资源方法直接返回Response对象时,可以不加Produces,因为可以通过Response对象指定响应类型。实际上是一种更灵活的方式。
3,资源方法不支持返回自定义对象,除非注册一个mapping provider。比如,对于响应类型为“*/json”的情况,可以使用内置的json处理器JacksonJsonProvider类。注册到ResouceConfig对象中,这样就可以支持在资源方法中返回任意自定义对象。
4,异常类型,需要编写映射类自行处理。如果在发生异常时,需要根据不同异常类型返回不同的http状态码,可以使用此功能。
过滤器和拦截器
当需要统一处理资源时,有可能会用到过滤器。与structs框架思想类似。
异步
当某项服务执行的时间,超过了请求端所能接受的范围或者超过发挥最佳效率的范围,就可能用到异步响应模式。而默认的正常模式适合处理能够快速响应的服务。
本文深入探讨了RESTful API的基本注解、资源获取方式、映射机制及过滤器、异步响应模式等内容,详细阐述了如何通过Path、Get、Put、Post、Delete等操作实现资源的高效管理和响应,同时介绍了如何利用过滤器和拦截器进行统一处理,以及异步响应模式在处理长时间任务时的优势。文章旨在帮助开发者掌握RESTful API的设计与实现关键点。
464

被折叠的 条评论
为什么被折叠?



