最好的8個 Java RESTful 框架

這篇文章旨在提供目前最好的 Java RESTfulful 框架。我只介紹請輕量級的產品， 略過了那些臃腫的過度設計的框架。同時，我只想要他們穩定和成熟，提供簡單，輕量級的特點。我只在介紹Play frameworks時打破這條規則，理由稍后給出。

在將來的項目中使用哪個 Java RESTful框架完全取決于你當前的需求。為了便于你取舍方便，我將列出最突出的框架功能。希望這能節省一些你的時間。

Dropwizard

誕生時間: 2011評分: 4.5/5

優點

• 快速的項目構建和啟動
• 模塊化
• 無可思議的快(至少根據內建的 metric 測得的結果)
• Jetty for HTTP, Jersey for REST, 以及 Jackson for JSON
• 也支持其它的庫， 比如 Mustache, Logback, JDBI, Hibernate Validator, Guava, …
• 使用Metrics支持監控
• Main方法啟動 Jetty server，可以容易地調試和維護
• 社區力度強

缺點

• Dropwizard文檔是主要的知識來源，但談不上優秀。你可能需要搜索和發掘第三方類庫的文檔。
• 因為某些原因錯誤被當作普通文本, 如果你希望響應結果總是JSON，這可能有問題
• 確保使用最新的Dropwizard， 一些老版本使用了廢棄的第三方庫。 而且早期的Dropwizzard也很難升級

例子

packagecom.example.helloworld;

importio.dropwizard.Application;
importio.dropwizard.setup.Bootstrap;
importio.dropwizard.setup.Environment;
importcom.example.helloworld.resources.HelloWorldResource;
importcom.example.helloworld.health.TemplateHealthCheck;

publicclassHelloWorldApplicationextendsApplication<HelloWorldConfiguration>{
publicstaticvoidmain(String[] args)throwsException {
newHelloWorldApplication().run(args);
 }

@Override
publicStringgetName() {
return"hello-world";
 }

@Override
publicvoidinitialize(Bootstrap<HelloWorldConfiguration> bootstrap) {
// nothing to do yet
 }

@Override
publicvoidrun(HelloWorldConfiguration configuration,
 Environment environment) {
// nothing to do yet
 }

}

Jersey

誕生時間: 2012 (Jersey 2.X)評分: 5/5

Jersey RESTful 框架是開源的RESTful框架, 實現了JAX-RS (JSR 311 & JSR 339) 規范。它擴展了JAX-RS 參考實現， 提供了更多的特性和工具， 可以進一步地簡化 RESTful service 和 client 開發。盡管相對年輕，它已經是一個產品級的 RESTful service 和 client 框架。

優點

• 優秀的文檔和例子
• 快速
• 超級容易的路由
• 平滑的 JUnit 集成
• 就個人而言, 當開發 RESTful service 時, JAX-RS 實現要好于 MVC 框架。
• 可以集成到其它庫/框架 (Grizzly, Netty). 這也可能是很多產品使用它的原因。
• 支持異步鏈接
• 不喜歡 servlet container? 使用Jersey的時候可以不用它們。
• WADL, XML/JSON support
• 包含在Glassfish中

缺點

• Jersey 2.0+使用了有些復雜的依賴注入實現
• 可能不是一件壞事。Jersey 1.X 使用較老的 JAX-RS 實現
• 一大堆第三方庫只支持 Jersey 1.X， 在 Jersey 2.X 不可用

例子

packageorg.glassfish.jersey.examples.helloworld;

importjavax.ws.rs.GET;
importjavax.ws.rs.Path;
importjavax.ws.rs.Produces;

@Path("helloworld")
publicclassHelloWorldResource{
publicstaticfinalString CLICHED_MESSAGE ="Hello World!";

@GET
@Produces("text/plain")
publicStringgetHello() {
returnCLICHED_MESSAGE;
 }
}

Ninja Web Framework

優點

• 快
• 快速的項目構建和啟動
• 模塊化
• XML, HTML, JSON渲染
• 也支持其它的庫 (如 Guice, Logback, Guava, etc.)
• 很好的數據持久化和緩存
• 不喜歡 servlet container? U可以選擇你喜歡的容器
• 如果根本就不喜歡容器，可以使用 standalone 模式, 使用Jetty作為一個自執行的jar

缺點

• 同樣，就像DropWizzard, 文檔有但是不夠好。我花了好長時間去了解它。這個框架也依賴很多其它的庫，有時候想得到所需的信息很麻煩。
• 不怎么出名，社區小。 有謠言說這個框架是由那些切換到Scala的 Play 2.X 用戶創建的

例子

packagecontrollers;

publicclassApplicationController{

publicResultindex() {

 Person person = newPerson();
 person.name = "John Johnson";

returnResults.json().render(person);

 }
}

Play Framework

誕生時間: 2011評分: 4/5

使用Play Framework 很容易地創建，構建和發布 web 應用程序，支持 Java & Scala。它使用Akka, 基于一個輕量級的無狀態的架構。它應該應用于大規模地低CPU和內存消耗的應用。

優點

• 易于開發
• 快，但是沒有其它的一些框架快
• 基于 Netty, 支持非阻塞的 I/O. 并行處理遠程調用的時候很優秀
• 社區很大
• 快速的項目構建和啟動
• 模塊化
• MVC
• REST, JSON/XML, Web Sockets, non-blocking I/O
• 只需刷新瀏覽器就可以看到最新的改變
• 支持Async
• 有出版的書

缺點

• 版本2.0 是最有爭議的Java框架。 切換至Switch to Scala made some Java developers outraged.
• 不向后兼容; Play 2.X 重寫了
• 號稱輕量級，但有些臃腫
• SBT構建工具. 號稱 Maven 殺手, 但是從沒有優秀到替換它。難以學習和配置
• 非 servlet
• Breaking changes across releases

例子

packagecontrollers

importplay.api._
importplay.api.mvc._

classApplicationextendsController{

defhello(name: String) = Action {
 Ok("Hello "+ name +"!")
 }

}

RestExpress

誕生時間: 2009評分: 3/5

RestExpress是一個非容器的輕量級的 Netty HTTP棧的包裝， 以便更容易地創建 Java RESTful services.RestExpress 目標是支持最好的 RESTful 實踐。

優點

• 真正的微框架
• 頂級的性能，快，可靠
• XML/JSON
• 最老的也是最穩定的 RESTful 框架之一

缺點

• 沒有文檔
• 幾乎沒有支持
• 很小的社區

例子

packagecom.example;

importjava.io.IOException;

importio.netty.handler.codec.http.HttpMethod;
importorg.restexpress.RestExpress;

publicclassMain
{
publicstaticRestExpressstartServer(String[] args)throwsIOException
 {
 RestExpress server = newRestExpress();
 MyResource r = newMyResource();

 server.uri("/myapp/myresource", r)
 .method(HttpMethod.GET)
 .noSerialization();

 server.uri("/myapp/myresource", r)
 .method(HttpMethod.POST);

 server.bind(8080);
returnserver;
 }

publicstaticvoidmain(String[] args)throwsException
 {
 RestExpress server = startServer(args);
 System.out.println("Hit enter to stop it...");
 System.in.read();
 server.shutdown();
 }
}

Restlet

誕生時間: 2005評分: 4.5/5

優點

• 強大
• 企業級的框架
• 多平臺 Java SE, Java EE, Google Web Toolkit, Google AppEngine, Android, OSGi environments
• 支持JAX-RS (就像 Jersey)
• 大部分高級 RESTful 支持
• 模塊化
• 支持其它庫
• 開發一直活躍
• 智能的url綁定， 全功能的 URI 路由
• 有相關的書籍

缺點

• 非常陡峭的學習曲線
• 關閉的社區，盡管 StackOverflow 上還是開放的
• 不再流行，更多的是因為 Play Framework 和 Jersey

例子

publicclassPart03extendsServerResource{

publicstaticvoidmain(String[] args)throwsException {
// Create the HTTP server and listen on port 8182
newServer(Protocol.HTTP,8182, Part03.class).start();
 }

@Get("txt")
publicStringtoString() {
return"hello, world";
 }

}

Restx

誕生時間: 2013評分: 3.5/5

Restx 是一個輕量級的,模塊化的,特性眾多的，超快的開源 Java REST 框架。

優點

• 快速，輕量級
• 容易搭建
• 真正的微框架
• 模塊化
• 支持其它庫
• 支持MongoDB

缺點

• 不友好的令人迷惑的文檔。對于這類框架我期望能有好一點的文檔
• 太年輕
• 目前還不支持異步Async

例子

@GET("/message/{id}")
publicMessagesayHello(String id, // path param
 String who // query param
 ) {
returnnewMessage().setMessage(String.format(
"hello %s, it's %s",
 who, DateTime.now().toString("HH:mm:ss")));
 }
@POST("/message/{id}")
publicMessagesayHello(String id, // path param
 Message msg // body param
 ) {
returnmsg.setMessage(String.format(
"%s @ %s",
 msg.getMessage(), DateTime.now().toString("HH:mm:ss")));
 }

Spark Framework

它有一個不到1M的最小化的內核， 提供了所有基本的特性, 用來構建 RESTful 或者傳統的 web 應用程序。

優點

• 快，輕量級
• 優秀的快速原型
• 易于搭建
• 經常和AngularJS搭配使用
• 真正的微框架
• 使用 Jetty
• 可以用在容器中或者獨立運行

缺點

• 文檔可以更好，它不適合初學者
• 不適合大型項目
• 社區小

例子

importstaticspark.Spark.*;

publicclassHelloWorld{
publicstaticvoidmain(String[] args) {
 get("/hello", (req, res) ->"Hello World");
 }
}