Dropwizard Java REST 框架发布 1.0.0 版本

在近五年的开发之后，Dropwizard 的 Java RESTful Web 服务框架发布了 1.0.0 版本，它提供了一系列的新特性，并提供了支撑 Java API 的最新版本。

在这个里程碑发布版本中，包含了如下的特性：

• 对 Java 8 的完全支持
• 支撑软件的最新版本，例如：
  • Apache HTTP Client
  • Guava
  • Hibernate (pull request 1429 )
  • HSQLDB
  • Jackson
  • Jetty (pull request 1330 )

在他们 Web 站点的发布说明上，能够看到完整的列表。

在 Web 站点上，Dropwizard 是这样定义的：

Dropwizard 是一个 Java 框架，用于开发运维友好、高性能、RESTful 的 Web 服务。

Dropwizard 被组织成了一系列的模块：

• Dropwizard Core（大多数应用都需要的内容）
• Dropwizard Client（ Apache HttpClient 和 Jersey Client ）
• Dropwizard JDBI（管理对 JDBI 的访问）
• Dropwizard Migrations（针对 Liquibase 的包装器）
• Dropwizard Hibernate（管理对 Hibernate 的访问）
• Dropwizard Authentication（提供基于基本认证或 OAuth 的认证功能）
• Dropwizard Forms（通过 Jersey ，提供对 multipart 表单的支持）
• Dropwizard Validation（包含了 Hibernate Validator ）
• Dropwizard Views（ FreeMarker 和 Mustache ）

另外，还提供了针对 Dropwizard 的 Scala 支持。

起步

起步指南提供了概述，包含了构建基本“hello, world!”应用的详细指导。这个指南推荐使用 Maven 来构建应用，但是其他的构建工具如 Ant 、 Gant 、 Gradle 或 SBT 也可以使用。

如下的 Maven 命令会按照交互模式生成基础的 Dropwizard 应用：

mvn archetype:generate -DarchetypeGroupId=io.dropwizard.archetypes -DarchetypeArtifactId=java-simple -DarchetypeVersion=1.0.0正确地回答这些提示问题非常重要，比如：

• $groupId：用于源码的打包，比如 com.example 或 io.dropwizard，它会作为 $package 的默认值；
• $artifactID：用于生成应用的根目录，比如 dropwizard-1.0.0；
• $version：默认值是 1.0-SNAPSHOT；
• $package：默认值是通过$groupId的值读取到的；
• $name：按照驼峰规则的名称，比如 HelloWorld。这样的话会生成 HelloWorldApplication.java 和 HelloWorldConfiguration.java，它们扩展自基础类，分别是 Application.java 和 Configuration.java。

[点击图片放大]

在文档剩下的步骤完成后，这个样例就可以在用户本地的机器上运行了，使用 http://localhost:8080/hello-world?name=Michael+Redlich 这样的 URL，将会得到如下的服务器响应：

我们在 GitHub 上可以找到针对数据库版本的“hello, world!”应用。

更为复杂的样例

Al Scott 创建过更为复杂的应用，他是 Campspot 的开发领导，并且还是 Atomic Object博客（Atomic Spin）的长期贡献者。他撰写过由三部分所组成的博客系列，分别实现了认证、授权和多租户功能，用来阐述Dropwizard 的相关特性。因为Scott 的系列文章是基于Dropwizard 0.9.x 编写的，所以InfoQ 与他进行了交流，探讨了他对这次里程碑版本发布的看法。

InfoQ：你为什么会钟情于 Dropwizard？

Al Scott：在我的职业生涯中，曾经使用过多个不同的 Web 平台，但是没有一个像 Dropwizard 这样高效。所有的组件都坚若磐石并且经过了深思熟虑，所以，我能够集中精力完成自己的事情。如果需要深入框架源码来了解某些功能是如何实现的话，你会发现这是非常有趣的事情，因为 Dropwizard 的源码可以说是我见过的最棒和最易于理解的代码。另外，我还很欣赏这个框架的整体稳定性。更新通常会带来丰富的特性，这些特性能够以最小的破坏性非常便捷地进行运用。底层的核心库（Jersey、Jetty、Jackson 和 Hibernate）也非常稳定，所以当版本变更的时候，很少会有较大的意外出现。

InfoQ：在开发 RESTful Web 服务方面，Dropwizard 与其他 Java 框架的区别是什么？

Al Scott：我认为，构建和运行过程的简洁性是让 Dropwizard 与众不同的关键所在。我曾经见识过各种 Spring MVC 和 Tomcat/Websphere 的搭建过程，Dropwizard 只需一个 pom 文件，并且能够得到一个可直接运行的 jar 文件，对于这种方式，我是非常欣赏的。在运维方面，这一点意义重大，因为这会让服务的部署过程变得非常简单，不必再去处理繁琐的 WAR 文件和复杂的 XML 配置。另外，我比较欣赏的一点就是 Dropwizard 没有偏离其底层库的初衷，在能够提供帮助的地方，它进行了一些很好的抽象，但是整体而言保持了这些库的原貌，所以我们可以很容易地按照这些底层库的文档来使用它们。

InfoQ：在升级到 Dropwizard 1.0 的过程中，你的示例应用受到过什么负面的影响吗？

Al Scott：针对我的博客文章所创建的 Github repository 其实已经更新到了 Dropwizard 1.0。这大约耗费了 10 分钟的时间，其中有个接口 io.dropwizard.auth.Authenticator 有所变更。原来它使用的是 Guava 的 optional 类，现在改成了 Java 8 内置的 Optional。在升级生产环境的应用时，我也遇到过类似的情况，生产环境的应用所对应的代码库会更大一些。在生产环境中，我遇到的唯一一个问题就是需要添加一个我们所使用的 logging appender，它目前还没有转换到 1.0 的版本中。整体的升级非常简单，我实在想不出大家不尽快进行升级的理由。

InfoQ：在升级在 Dropwizard 1.0 版本之后，你的示例应用有机会进行一些增强吗？

Al Scott：在我们的生产环境应用中，我们一直比较喜欢的是资源方法（resource method）对返回值的校验。另外，对 Java 8 支持的增强也是非常棒的，在原来的一些场景中，我们必须要使用 Guava Optionals 和 Joda time，现在就可以直接使用 Java 8 中对应的特性了。

在生产环境采用 Dropwizard 的组织包括：

• Yammer
• Change.org
• FullContact
• Airbnb

Dropwizard 提供了一个供我们学习的用户指导，另外他们还鼓励开发人员通过访问Dropwizard GitHub 的 repository 来为这个项目作出贡献。

查看英文原文： Dropwizard Java REST Framework Version 1.0.0 Features Updated Library Support, Scala, and Java 8