Dropwizard的历史要早于Spring Boot和WildFly Swarm，它最早是在2011.12发布的v0.1.0版本，在本文编写的过程中，它已经发布了v0.9.2版本，而v1.0.0版本也在准备中了。Dropwizard是Coda Hale在Yammer公司时创立的，它旨在提升公司分布式系统的架构（现在叫：微服务）。虽然它最早被用来构建REST Web 服务，而现在它具备了越来越多的功能，但是它的目标始终是作为轻量化、为生产环境准备且容易使用的web框架。

目前Dropwizard已经发布了v1.1.0版本

    Dropwizard与Spring Boot类似，也是构建微服务可选的工具，但是它显得比Spring Boot更加规范一些。它使用的组件一般不会做可选替换，而好处是可以不需要那么多的修饰，比如写基于REST的web服务。比方说，Dropwizard选择使用Jetty作为Servlet容器，REST库使用Jersey，序列化和反序列化使用了Jackson，而想将其中的Jetty替换成Undertow就没有那么容易。

    Dropwizard默认也不具备依赖注入的容器（像Spring或者CDI），你当然可以自行添加，但是Dropwizard推荐你把微服务弄的简单一些，不需要这些额外的组件。Spring Boot 隐藏的非常多的底层实现，而这些内容十分的复杂，就像Spring隐藏了通过注解可以完成Bean注入这个复杂的场景一样。虽然注解很好用，也解决了某些领域比较琐碎的代码，但是当你想在生产环境DEBUG或者排查问题时，这些东西往往会把简单的问题搞得很复杂。Dropwizard推荐所有的内容都显示的使用，你得到的输出也就更加的肯定和明确。

原文涉及到生产环境的DEBUG，笔者认为更多的是问题排查

    就像Spring Boot一样，Dropwizard推荐将整个工程打包成一个可执行的jar，通过这种方式开发人员不用在担心程序运行的应用服务器是什么，需要什么额外的配置，应用再也不需要被构建成war包了，而且也不会有那么多复杂层级的类加载器了。Dropwizard中的类加载也是扁平结构的，它和我们常用的应用服务器不一样，应用服务器往往具备多层级如同图一般的类加载器，这会涉及到类加载器的优先级，而这些在不同的应用服务器的实现上都是大相径庭的。运行在独立进程中的Dropwizard实例也便于进行各自的JVM调优和监控，因为运行在应用服务器上的多个应用，很可能由于一个应用导致的GC或者内存溢出，进而导致整个应用服务器的崩溃，毕竟它们是在同一个进程中。

    Dropwizard在优秀的三方库协助下，提供了不错的抽象层，使之更有效率，更简单的编写生产用途的微服务。

    Dropwizard偏执的认为框架就是用来写代码的，因此对于框架的底层技术栈的调整，原则上Dropwizard是拒绝的。正因为它这么做，使得Dropwizard开发起代码来更快，而且配置更加容易。Jetty、Jersey和Jackson都是广为人知的项目，使用它们来构造用于生产环境的web服务，看起来没什么毛病，而google的Guava作为提供了工具类的包显然经得住考验，而Dropwizard Metrics更是一个强大工具，它能够暴露出应用相当多的运行细节，而正因为此，Dropwizard Metrics被广泛的使用于Spring Boot和WildFly Swarm。

    Dropwizard暴露了如下抽象，如果你能掌握这些简单的抽象，你就能很快的使用Dropwizard进行开发了。

    当你启动一个Dropwizard应用，一个Jetty服务就会启动，同时它会创建两个Handler：一个在8080，为你的应用提供服务，另一个在8081，这个提供管理功能。Dropwizard之所以这么做，是因为不想将管理功能通过8080进行暴露，这样你可以把端口隐藏在防火墙后面。诸如Metrics和健康检查，这些也是暴露在管理端口上的，区分的很大原因是考虑安全问题。

    Dropwizard没有那些美轮美奂用于创建工程的工具，它只有一个最简单的方式：maven archetype，或者在已经搭建好的项目中，增加一些maven配置。当然你可以使用jboss-forge来完成工程的创建，用它来添加对应的依赖等等，但是本章，我们还是使用maven archetype。

    选择一个目录，然后输入一段maven命令，可以完成项目的创建。

本示例演示，在microservices-camp目录下运行

    该命令会在microservices-camp目录下创建一个名为hola-dropwizard的工程，你可以选择将其导入到自己的IDE中，或者你可以在hola-dropwizard目录下运行mvn clean install完成构建。

    导入hola-dropwizard工程后，你可以看到如下结构：

    Dropwizard已经创建了你需要开发放置的包，它推荐你按照约定进行开发。

    同样我们还可以看到一家创建好的类型HolaDropwizardApplication和HolaDropwizardConfiguration，它们使用来启动和配置应用的。先看一下HolaDropwizardApplication长得样子。

    这个类包含了一个public static void main()方法，可以想象，它是入口，而getName()方法将会在应用启动时展示。initialize()和run()方法是用来启动应用的地方。

    配置类型已经创建了，但是目前是空的。

    虽然Dropwizard没有定义自己的maven plugin，但是它为我们生成了pom.xml。打开pom.xml，可以看到Dropwizard使用maven-shade-plugin将依赖打包成一个jar，这意味着工程依赖的jar包和代码将全部解压，然后重新组合成一个jar。而针对这个构建好的jar，我们可以使用maven-jar-plugin运行它。

    我们唯一需要的一个插件就是exec-maven-plugin，这样我们就可以像使用mvn spring-boot:run一样运行它。

    接下来，可以在hola-dropwizard使用mvn exec:java来启动它。看到如下内容，代表启动成功了。

    你可以打开浏览器，访问默认的REST端点：http://localhost:8080，这会不会返回很多内容，你可能看到：

    如果你访问管理端口：http://localhost:8081，你会看到一个简单页面以及链接，这里面是当前应用的运行时信息。

    现在使用Dropwizard构建的工程已经准备好了，让我们添加一个REST端点。我们会在/api/holaV1暴露一个HTTP/REST端点，访问它，将会返回 Hola Dropwizard @ X，而 X 指的是运行应用的机器IP。如果想做到这个，首先需要在resources包下面新建类型，比如：HolaRestResourceV1（记住，类型放置的包，必须符合Dropwizard的约定）。添加一个方法hola()，然后在其中返回所需的内容。

    可以针对这个hola()方法做测试。

    这看起来很像Spring Boot，我们想创建REST端点以及服务，也是在POJO上增加一些JAX-RS的注解。

    现在，打开之间生成的HolaDropwizardApplication，在run()方法中添加新创建的HolaRestResourceV1（REST资源）。

    接着就可以在hola-dropwizard目录下执行mvn clean package exec:java，随着应用的启动，我们打开浏览器访问http://localhost:8080/api/holaV1，可以看到如下内容。

    Dropwizard提供了针对内置组件的诸多配置（比如：servlet引擎或者数据源）方式，你可以使用配置文件来完成配置。可以使用系统环境变量或者Java System properties来进行配置，这样可以使应用运行在不同的环境上。如同之前介绍的Spring Boot，Dropwizard也可以将配置绑定到指定的实例上。在接下来的例子中，我们就将helloapp.*下面的配置，绑定到HolaRestResourceV2上。不像Spring Boot通过application.properties完成配置，Dropwizard只支持YAML。

    在工程的根目录（hola-dropwizard）下（注意：不是类路径下），创建一个conf/application.yml（如果conf目录不存在，你需要创建它），我们将配置文件放置在该目录中，先给conf/application.yml添加一些内容：

    这样我们为属性指定了值，如果我们需要为某些环境更改这个值，该如何做呢？可以通过Java System properties来做到，可以通过定义-Ddw.helloapp.saying=Guten Tag。注意dw.*代表着Dropwizard可以覆盖该配置的值，但是如果需要使用操作系统变量来进行覆盖呢，如何做到？

    可以看到对saying的配置首先回去查看环境变量HELLOAPP_SAYING，如果该环境变量不存在，那么就会使用默认的Guten Tag aus，默认Dropwizard不会从环境变量中获取配置，如果需要让Dropwizard使用环境变量，需要做一些额外改动。打开HolaDropwizardApplication，编辑initialize()方法。

    接下来创建配置，我们定义了一个专门的配置类型，这个配置类型用于接受来自helloapp下的配置，接下来看如何将配置类型和application.yml绑定。在resources包下，创建一个类型。

    这个简单的Java Bean上增加了一些注解，比如：Jackson和Bean Validator，这个配置对象将会包装在application.yml中，处于helloapp之下的配置。这一刻，只有一个配置属性saying，下面需要将HolaDropwizardConfiguration与它关联起来。

笔者注：HolaDropwizardConfiguration代表着指定的application.yml，而helloapp是配置中的一个节点，而该节点以下的结构，将会设置到类型HelloSayingFactory实例中

    接下来需要将配置引入到REST资源中，在resources包下，创建类型HolaRestResourceV2。

    由于Dropwizard没有依赖注入框架的帮助，所以你需要依靠自己将配置注入到REST资源中。编辑HolaDropwizardApplication：

    到目前为止，一个具备配置注入的项目已经基本搭建完成，这个例子中对于配置，我们故意设计的复杂一些，目的是还原一个真实场景。虽然开起来零碎的步骤不少，但是可以看到最关键的几个步骤：定义application.yml，并且将HolaDropwizardConfiguration与之绑定，而后续配置的添加就变得很简单了。

    如果想在maven中运行，还需要将配置文件的位置传递给Dropwizard，所以还需要编辑一下pom.xml

    在项目目录hola-dropwizard下，执行mvn clean package exec:java，然后打开浏览器访问http://localhost:8080/api/holaV2，可以看到：

    接下来停止应用，然后导出一个环境变量，再启动它，随后访问原来的页面：

    Dropwizard中做的最好的是将Metrics作为了一等公民，Dropwizard从一开始就考虑了Metrics，而非像其他框架一样事后考虑，所以当一个Dropwizard应用启动的同时，8081管理端口就暴露了Metrics信息。我们只需要在对应的REST资源上增加一些注解就可以做到。

    在HolaRestResourceV2中的hola()方法，增加注解@Timed，它将跟踪该服务的调用耗时与次数等信息，当然还有其他的Metrics组件可供选择。

不能都添加上，只能选择一种

    重新启动Dropwizard应用，然后访问几次http://localhost:8080/api/holaV2，然后用浏览器打开http://localhost:8081/metrics?pretty=true，然后搜索hola，你可以看到类似如下内容：

    Dropwizard通过maven-shade-plugin打包成了一个jar，所以只需要通过java -jar就可以运行，我们唯一需要知道的就是传递配置给Dropwizard，比如这样：java -jar target/hola-dropwizard-1.0.jar server conf/application.yml。

    在微服务环境下，服务之间需要相互调用，和之前的Spring Boot应用一样，Dropwizard提供了自己的REST客户端供我们使用。类似之前在Spring Boot的章节，我们使用Dropwizard完成这项工作。

在开始之前，先在hola-dropwizard项目中添加依赖。

    首先创建GreeterSayingFactory配置，在这个配置中将描述调用hola-backend的具体URL和端口等信息。

    然后需要将application.yml中的配置设置到GreeterSayingFactory中，所以需要将greeter下面的配置完成设置，这时，需要继续编辑HolaDropwizardConfiguration，增加以下两个方法。

    对于GreeterSayingFactory中属性的具体配置，需要在conf/application.yml中编辑，增加以下内容：

    通过这样就可以使用系统环境变量对应用做不同的配置了，到此配置基本结束，我们编写一个REST端点用于提供HTTP服务。

    可以看到，通过访问：http://localhost:8080/api/greeting/1，能够进行Book资源的查询工作，但是可以看到GreeterRestResource的构造函数，需要一个javax.ws.rs.client.Client。前面提到，Dropwizard没有依赖注入的帮助，一切都要靠自己来完成组装，所以最后还需要编辑HolaDropwizardApplication，在run()方法中，增加以下内容：

    Dropwizard提供了两种REST调用方式：HttpComponents和Jersey/JAX-RS，默认使用的后者，我们就使用它来完成调用。接下来我们在开发机上部署了hola-backend，它的ip是11.239.175.192，你的环境也许是其他。我们需要将ip设置到环境变量GREETER_BACKEND_HOST上。在hola-dropwizard工程目录下执行：

    访问http://localhost:8080/api/greeting/1，可以看到如下内容：

    本章介绍了Dropwizard的基本知识，可以看到一个不同于Spring Boot的方式去暴露REST端点、以及不同的方式进行应用配置，如果你想深入了解Dropwizard可以访问如下内容。