Embed Size (px)
Citation preview
Dropwizard
A RESTful Love Story
Ryan Kennedy (@rckenned) Core Services @ Yammer
Dropwizard
A RESTful Love Story
Ryan Kennedy (@rckenned) Core Services @ Yammer + MicrosoE
What on earth is Dropwizard?
Some bearded jerk in a pointy hat…
or…
Started at Yammer as three services with largely copy/pasted code
By service number three we idenOfied and disOlled the paQern
What was the paQern?
“Dropwizard has out-‐of-‐the-‐box support for sophisOcated
configuraOon, applicaOon metrics, logging, operaOonal tools, and much more, allowing you and your team to ship a producOon-‐quality HTTP
+JSON web service …”
“Dropwizard has out-‐of-‐the-‐box support for sophisOcated
configuraOon, applicaOon metrics, logging, operaOonal tools, and much more, allowing you and your team to ship a producOon-‐quality HTTP
+JSON web service …”
YAML configuraOon file
hQp: port: 8080 adminPort: 8081 # a string foo: foo value # a duraOon bar: 60 seconds # a number baz: 10101
ConfiguraOon validaOon
public class MyAppConfiguraOon extends ConfiguraOon {
@NotBlank private String foo; @NotNull private DuraOon bar = DuraOon.minutes(10); @Min(1) @Max(1024) private long baz = 1; }
“Dropwizard has out-‐of-‐the-‐box support for sophisOcated
configuraOon, applicaOon metrics, logging, operaOonal tools, and much more, allowing you and your team to ship a producOon-‐quality HTTP
+JSON web service …”
Gauges
Metrics.newGauge(My.class, “jobs", new Gauge<Integer>() { @Override public Integer value() { return queue.size(); } }
);
Counters Counter pendingJobs = Metrics.newCounter(My.class, “jobs"); public void addJob(Job job) { pendingJobs.inc(); queue.offer(job); } public Job takeJob() { pendingJobs.dec(); return queue.take(); }
Meters Meter requests = Metrics.newMeter(
My.class, "requests", "requests", TimeUnit.SECONDS);
public void handleRequest(Request request,
Response response) { requests.mark(); // etc }
Histograms Histogram responseSizes = Metrics.newHistogram(
My.class, "response-‐sizes"); public void handleRequest(Request request,
Response response) { // etc int length = response.getContent().length; responseSizes.update(length); }
Timers Timer responses = Metrics.newTimer(My.class, "responses",
TimeUnit.MILLISECONDS, TimeUnit.SECONDS); public String handleRequest(Request request, Response response) { final TimerContext context = responses.Ome(); try { // etc; return "OK"; } finally { context.stop(); } }
Health Checks public class DatabaseHealthCheck extends HealthCheck { @Override public Result check() throws ExcepOon { if (database.isConnected()) { return Result.healthy(); } else { return Result.unhealthy("Cannot connect to db”); } } }
“Dropwizard has out-‐of-‐the-‐box support for sophisOcated
configuraOon, applicaOon metrics, logging, operaOonal tools, and much more, allowing you and your team to ship a producOon-‐quality HTTP
+JSON web service …”
JMX ReporOng
HTTP ReporOng
Metrics
hQp://host:adminPort/metrics
Metrics reporters can be added to adapt dropwizard metrics to your
collecOon system of choice
Health Checks
hQp://host:adminPort/healthcheck
Thread Dumps
hQp://hostname:adminPort/threads
Ping
hQp://hostname:adminPort/ping
“Dropwizard has out-‐of-‐the-‐box support for sophisOcated
configuraOon, applicaOon metrics, logging, operaOonal tools, and much more, allowing you and your team to ship a producOon-‐quality HTTP
+JSON web service …”
Dropwizard provides its own applicaOon logging abstracOon
HTTP request logging is supported as well
Dropwizard provides log file rotaOon and compression
“Dropwizard has out-‐of-‐the-‐box support for sophisOcated
configuraOon, applicaOon metrics, logging, operaOonal tools, and much more, allowing you and your team to ship a producOon-‐quality HTTP
+JSON web service …”
The unbeatable Jackson
“Dropwizard has out-‐of-‐the-‐box support for sophisOcated
configuraOon, applicaOon metrics, logging, operaOonal tools, and much more, allowing you and your team to ship a producOon-‐quality HTTP
+JSON web service …”
Dropwizard embeds JeQy for all your HTTP serving needs
JAX-‐RS (JSR-‐311) for all your RESTful needs
@Path(“/users/{id}”) public class UserResource { @GET public User get(@PathParam(“id”) long id) { return db.findUserById(id); } @PUT public User update(@PathParam(“id”) long id,
User user) { return db.updateUser(id, user); } }
How Yammer uses Dropwizard
Lots of small services…16 and counOng
Maven is our friend
SOck the code in GitHub
Shade your JARs
Get yourself some conOnuous integraOon
Write yourself a startup script
Have a good deploy story
Over Ome, Dropwizard has grown a few appendages
Dropwizard Client
HQpClient or JerseyClient flavors
Dropwizard DB
JDBI as a service
Dropwizard AuthenOcaOon
Abstracted authenOcaOon…providers for OAuth 2 and Basic Auth
An example… @Path("/my") public class MyResource { @GET public MyResponse get(
@Auth(required = false) Token token) { if (token != null) { return new MyResponse(getUser(token)); } else { return new MyResponse(getGuestUser()); } } }
Dropwizard Views
Full blown applicaOon UIs or just a nice admin interface
Dropwizard Scala
The original Dropwizard…for those who don’t know any beQer
Dropwizard TesOng
Test JSON representaOons and resources
I blew through that preQy quickly, fortunately you have…
hQp://dropwizard.codahale.com/
And the sample applicaOon
hQps://github.com/codahale/dropwizard
And (hopefully) Ome for quesOons!
Also…WE’RE HIRING!
