1、restlet 2.3 用户指南（一）概要

最新推荐文章于 2021-02-16 17:53:44 发布

Simon-Ezer

最新推荐文章于 2021-02-16 17:53:44 发布

阅读量605

点赞数

分类专栏： restlet 文章标签： restlet 2.3 指南 java

4 篇文章 0 订阅

订阅专栏

以下翻译，以直译方式为主，内容主要针对目前应用最为广泛的基于 Java 的服务器端的开发与应用，并修复原文中涉及到的代码 bug。

PS：下文中resources、representation、RESTful 等属于一组相关的领域内专有名词，不便翻译。其中 resources 可以理解为“资源”。representation 可以理解为“表现层对象”。RESTful 可以理解为基于 REST 理念或架构的框架和应用。

测试环境：

Mac OS X Yosemite Version 10.10.4

IntelliJ IDEA 14.app jdk1.8.0_51.jdk

maven 3.3.3

1 概要介绍

在 java 开发者中，restlet 框架是使用最广泛的开源解决方案之一。

基于 REST 架构风格，restlet 框架帮助 java 开发者构建更好的 web API。由于被众多 java 开发者社区的采纳和支持，restlet 框架受惠于互联网的大量资源。 restlet 是完全开源的，完全可以免费下载，并且可以在 Apache 软件协议下使用。

1.1 介绍

restlet 框架是成熟的、稳定的，基于小内核和大量丰富的扩展，使得它能够适应任何的 web API，以及可以跨网站跨应用。

1.2 web API 支持

REST 内核与 HTTP 层面的应用均包含了相应的 java 构件（resources、representation，例如连接器和组件类）。
restlet 框架同时适用于客户端和服务端的 web 应用。其创新之处在于使用了相同的 java API，降低了学习曲线和软件使用门槛。
restlet 框架基于 URI 模板标准，支持“URI”和“UI”概念。这个结果说明，使用者可以通过灵活且简单的路由方式从 request 属性中自动获取 URI 变量。
restlet 框架通道服务使得浏览器可以通过一个简单的 HTTP POST 机制传递发出任何的 HTTP 方法（例如：PUT, DELETE, PATCH）。这个服务对于 restlet 应用来说是透明的。
关于这份方便的 API文档，感谢 WADL 的支持以及 Swagger 的整合。

1.3 特性（此处省略了原文大部分非建设性的内容）

REST 的原理使得它的应用范围是不会受限的，它可以广泛应用于 web 应用中，甚至在没有网络的场景，如果需要对接通讯或者解耦，它依然适用。根据开发场景的不同具有众多相应的版本，例如：Java SE、Java EE、GAE、GWT、Android、OSGi等
基于 REST 架构和 HTTP 及 URI 标准，restlet 是实现更好的 servlet API 的一种尝试。因此restlet API 并不会依赖servlet API，而仅仅依赖 Java SE。但使用restlet API 对于发布 restlet 应用到 java EE 应用服务器或者 servlet 容器之中，可行性是非常高的。它具备了扩展 servlet 适配器的可能性。
具有众多的连接器（在使用到的时候再了解，大概需要知道应用的场景和对象有：HTTP server/client、邮件、文件、搜索引擎等）
具有众多展现模式（在使用到的时候再了解，大概需要知道应用的场景和对象有：XML、Freermaker、velocity、文件上传、Json、搜索引擎等）

1.4 restlet 2.3 改变，除加入新功能以及重构代码外，特别新增的特性和要求：必须基于 JDK7 以上使用，内置 jetty 升级到 9.2 。