Declarative Hyperlinking in Jersey

One of the areas I'm keen to improve in the next version of JAX-RS is link creation. JAX-RS already offers UriBuilder but I think an annotation driven approach could save a lot of repetitive coding. I've been experimenting with a couple of annotations that I think would be useful and I just checked in an experimental extension that partially implements what I have in mind. Suppose you have a resource like this: @Path{"widgets"} public class WidgetsResource { ... } and you want to include a URI to this resource in a representation. Using the new extension you can just annotate a field in your representation class like this: @Link(resource=WidgetsResource.class) URI link; and then Jersey will build the appropriate URI and inject it into the representation before the representation is serialized by a message body writer. If the URI template contains parameters, their values are obtained by looking for a bean property or field by the same name in the representation. E.g. consider the following representation class: public class WidgetRepresentation { @Link("widgets/{widgetId}") URI link; String getWidgetId() {...} } After processing by the extension, if the getWidgetId method returned "abc123", the value of the link field would be /context/widgets/abc123 where context is the deployment context. The optional style property of the @Link annotation can be used to select between absolute URIs, absolute path an...

Date: March, 10 2010
Url: http://www.java.net/blog/mhadley/archive/2010/03/10/declarative-hyperlinking-jersey

Others News