尋求快速， 輕松地創(chuàng)建可用于生產(chǎn)環(huán)境的RESTful JSON HTTP Web服務(wù)的Java開發(fā)人員應(yīng)該考慮Dropwizard框架。 Dropwizard匯集了相互補充的廣受好評的庫，因此您可以了解重要的內(nèi)容：編寫和交付工作代碼。 對于那些對所用庫的詳細信息感興趣的人，請參閱Dropwizard概述 。 幸運的是，Dropwizard不會使您處理其所有單個組件。 您將可以專注于手頭的工作。 如果您有時間，請堅持學(xué)習(xí)，讓我們與Dropwizard一起做點事情。

可以在GitHub上獲得本教程的所有代碼。

如何開始使用Dropwizard？

一個Maven，Gradle或Ivy依賴項將為您提供制作Dropwizard支持的Web服務(wù)所需的所有組件。

<dependency><groupId>com.yammer.dropwizard</groupId><artifactId>dropwizard-core</artifactId><version>0.6.2</version> </dependency>

注意 ：如果您發(fā)現(xiàn)本簡短的帖子中沒有充分解釋的內(nèi)容，請參考Dropwizard的出色文檔 。

我們要做什么？

讓我們做一個Web服務(wù)，它返回給定時區(qū)的當(dāng)前日期和時間。 如果客戶端決定不指定默認時區(qū)，我們將使用可配置的默認時區(qū)。

組態(tài)

我們的超級簡單的time-service.yml配置文件如下所示。

defaultTimezone: UTC

在后臺，Dropwizard將加載，解析，驗證并將該配置轉(zhuǎn)換為對象。 我們需要做的就是將其指定為類。

public class TimezoneConfiguration extends Configuration {@NotEmpty@JsonPropertyprivate String defaultTimezone;public String getDefaultTimezone() { return defaultTimezone; } }

服務(wù)輸出

假設(shè)我們希望Web服務(wù)的輸出看起來像這樣。

{ "time": "2014-02-04 13:45:02" }

相應(yīng)的類很簡單。

public class Time {private final String time;public Time(String time) {this.time = time;}public String getTime() { return time; } }

資源資源

接下來，我們決定將Web服務(wù)的URL路徑設(shè)置為/time 。 并且我們需要指定資源將返回JSON。 將這些放在一起可以為我們提供這一切。

@Path("/time") @Produces(MediaType.APPLICATION_JSON) public class TimeResource { }

現(xiàn)在，對于我們的演示W(wǎng)eb服務(wù)而言，唯一有意義的RESTful操作是GET ，因此讓我們?yōu)樗鼊?chuàng)建一個方法。 使用我們的Web服務(wù)時，客戶端可以提供時區(qū)作為查詢字符串參數(shù)。

@GET public Time getTime(@QueryParam("timezone") String timezone) { }

這使我們還有三件事要做：

從客戶端處理給定的時區(qū)

如果沒有給出默認時區(qū)

用時區(qū)格式化當(dāng)前日期和時間

@Path("/time") @Produces(MediaType.APPLICATION_JSON) public class TimeResource {private final String defaultTimezone;public TimeResource(String defaultTimezone) {this.defaultTimezone = defaultTimezone;}@GETpublic Time getTime(@QueryParam("timezone") Optional timezone) {DateFormat formatter = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");TimeZone timeZone = TimeZone.getTimeZone(timezone.or(defaultTimezone));formatter.setTimeZone(timeZone);String formatted = formatter.format(new Date());return new Time(formatted);} }

服務(wù)

現(xiàn)在，讓我們將我們的Web服務(wù)的所有部分整合到我們稱為TimeService入口點類中。 在這里，我們將使用TimezoneConfiguration將默認時TimezoneConfiguration傳遞給TimeResource 。

public class TimeService extends Service {public static void main(String[] args) throws Exception {new TimeService().run(args);}@Overridepublic void run(TimezoneConfiguration config, Environment environment) {String defaultTimezone = config.getDefaultTimezone();TimeResource timeResource = new TimeResource(defaultTimezone);environment.addResource(timeResource);}@Overridepublic void initialize(Bootstrap timezoneConfigurationBootstrap) {} }

鉛筆下來

而已！ 我們剛剛編寫了一個基于Dropwizard的Web服務(wù)，但沒有引起人們的注意，也沒有成堆的老式XML配置。

跑步

運行Web服務(wù)就像執(zhí)行命令行Java應(yīng)用程序一樣簡單-無需擔(dān)心.war文件或servlet容器。

java -cp libraries/* name.christianson.mike.TimeService server time-service.yml

現(xiàn)在，將您的Web瀏覽器指向http://localhost:8080/time?timezone=MST或卷曲一下，玩得開心！

• 可以在GitHub上獲得本教程的所有代碼。

翻譯自: https://www.javacodegeeks.com/2014/04/dropwizard-painless-restful-json-http-web-services.html

總結(jié)

以上是生活随笔為你收集整理的Dropwizard：轻松的RESTful JSON HTTP Web服务的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。