Dropwizard: 开发轻量RESTful服务
2017-08-15 14:51
274 查看
Java开发者需要一个快速 轻量无痛苦的创建一个为产品环境准备的RESTful + JSON +HTTP的web 服务,Dropwizard只需通过简单配置就能让你的类提供RESTful服务,如今已经超越SpringMVC成为轻量REST框架首选。
![](http://simage.jdon.com/soa/dropwizard.png)
下面,展示如何使用Dropwizard开发一个轻量的RESTful服务。首先,配置Maven依赖:
<dependency>
<groupId>com.yammer.dropwizard</groupId>
<artifactId>dropwizard-core</artifactId>
<version>0.6.2</version>
</dependency>
案例:让我们返回一个给定的时区的当前日期和时间的Web服务。如果用户不指定时区就使用缺省默认的。
defaultTimezone: UTC
Dropwizard 会加载这个配置然后分析校验,然后将其转为对象,我们要做的就是指定一个类:
{ "time": "2014-02-04 13:45:02" }
其相应的类如下:
public class Time {
private final String time;
public Time(String time) {
this.time = time;
}
public String getTime() { return time; }
}
@Path("/time")
@Produces(MediaType.APPLICATION_JSON)
public class TimeResource {
}
在这个类型中,我们进行如下处理:处理来自客户端指定的时区,如果没有指定使用缺省的时区体会,用当前时区格式化日期和时间。
增加一个方法处理GET方式,从/time获得查询参数timezone的值:
就是这样!我们刚刚写了一个Dropwizard为基础的Web服务,而无需头脑麻木的样板或一堆XML配置。
直接通过命令行可以运行这个Web服务:
java -cp libraries/* name.christianson.mike.TimeService server time-service.yml
通过浏览器浏览:
http://localhost:8080/time?timezone=MST
![](http://simage.jdon.com/soa/dropwizard.png)
下面,展示如何使用Dropwizard开发一个轻量的RESTful服务。首先,配置Maven依赖:
<dependency>
<groupId>com.yammer.dropwizard</groupId>
<artifactId>dropwizard-core</artifactId>
<version>0.6.2</version>
</dependency>
案例:让我们返回一个给定的时区的当前日期和时间的Web服务。如果用户不指定时区就使用缺省默认的。
配置
我们在配置一个time-service.yml文件缺省时区的配置如下:defaultTimezone: UTC
Dropwizard 会加载这个配置然后分析校验,然后将其转为对象,我们要做的就是指定一个类:
public class TimezoneConfiguration extends Configuration { @NotEmpty @JsonProperty private String defaultTimezone; public String getDefaultTimezone() { return defaultTimezone; } }
服务输出
我们的Web服务输出的格式如下:{ "time": "2014-02-04 13:45:02" }
其相应的类如下:
public class Time {
private final String time;
public Time(String time) {
this.time = time;
}
public String getTime() { return time; }
}
资源Resource
下面我们要为我们的Web服务指定URL路径为/time 我们需要指定一个资源返回JSON:@Path("/time")
@Produces(MediaType.APPLICATION_JSON)
public class TimeResource {
}
在这个类型中,我们进行如下处理:处理来自客户端指定的时区,如果没有指定使用缺省的时区体会,用当前时区格式化日期和时间。
增加一个方法处理GET方式,从/time获得查询参数timezone的值:
@GET public Time getTime(@QueryParam("timezone") String timezone) { } 完整代码如: public class TimeResource { private final String defaultTimezone; public TimeResource(String defaultTimezone) { this.defaultTimezone = defaultTimezone; } @GET public 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); } }
服务
端点TimeService代码如下:public class TimeService extends Service { public static void main(String[] args) throws Exception { new TimeService().run(args); } @Override public void run(TimezoneConfiguration config, Environment environment) { String defaultTimezone = config.getDefaultTimezone(); TimeResource timeResource = new TimeResource(defaultTimezone); environment.addResource(timeResource); } @Override public void initialize(Bootstrap timezoneConfigurationBootstrap) { } }
就是这样!我们刚刚写了一个Dropwizard为基础的Web服务,而无需头脑麻木的样板或一堆XML配置。
直接通过命令行可以运行这个Web服务:
java -cp libraries/* name.christianson.mike.TimeService server time-service.yml
通过浏览器浏览:
http://localhost:8080/time?timezone=MST
相关文章推荐
- Dropwizard: 开发轻量RESTful服务
- Dropwizard - 开发Java RESTful Web服务
- Dropwizard - 开发Java RESTful Web服务
- Heroku:快速部署Dropwizard开发的RESTful Service
- Java微服务框架Dropwizard --- jersey常用的注解类型
- 使用 Struts 2 开发 RESTful 服务
- 用Jersey1.9开发RESTful服务
- 使用CXF开发RESTFul服务
- java 利用JAX-RS快速开发RESTful 服务
- [置顶] 基于SpringBoot开发一个Restful服务,实现增删改查功能
- WebDevHelper -- RESTful服务和Ajax开发时的利器
- 用Jersey、Grizzly在eclipse中开发第一个RESTful服务helloworld
- 使用CXF开发RESTFul服务(对于asopapi是实现可以很好地理解)
- 使用CXF开发RESTFul服务
- 使用 Struts 2 开发 RESTful 服务
- 使用 Apache Wink、Eclipse 和 Maven 开发 RESTful Web 服务
- 使用CXF开发RESTFul服务
- 使用 Struts 2 开发 RESTful 服务
- 使用SpringBoot开发Restful服务实现增删改查功能
- 使用CXF开发RESTFul服务