Hi,
I have been playing a bit so maybe you prefer using URI?
For example in case of version on URI I can use the subresource approach:
@Path("/{version: [v]\\d+[[.]\\d+]?}/")
public AppApiSubResource getVersionedSubResource(@PathParam("version")
String fullVersion) {
String version = parse(fullVersion);
return SubResourceFactory.getResource(version);
}
It looks pretty well, at least centralize all logic inside a factory.
2014-10-20 10:10 GMT+02:00 Jean-Louis Monteiro <[email protected]>:
> Right. No magic solution.
>
> I've seen the content type pattern, but it has many drawbacks so I would
> not go with this one.
>
> --
> Jean-Louis Monteiro
> http://twitter.com/jlouismonteiro
> http://www.tomitribe.com
>
> On Sun, Oct 19, 2014 at 1:48 PM, Alex Soto <[email protected]> wrote:
>
> > Yes this is what I though about creating a central place, but I was
> > thinking about using a rewrite instead of a subresource. I am going to
> > google a bit about this pattern. For what I see there is no magic
> solution
> > yet :(
> >
> > Thanks.
> >
> > 2014-10-19 13:44 GMT+02:00 Romain Manni-Bucau <[email protected]
> >:
> >
> > > Hi
> > >
> > > What about sub resource locator pattern?
> > >
> > > For versioning I used a sub resource facade delegating to the real
> > > service then. This is just a router but it allows to put all the logic
> > > in a single place.
> > > Romain Manni-Bucau
> > > Twitter: @rmannibucau
> > > Blog: http://rmannibucau.wordpress.com/
> > > LinkedIn: http://fr.linkedin.com/in/rmannibucau
> > > Github: https://github.com/rmannibucau
> > >
> > >
> > >
> > > 2014-10-19 13:19 GMT+02:00 Alex Soto <[email protected]>:
> > > > Hi guys,
> > > >
> > > > this is more a design question than a question about how to do
> > something
> > > > with JAX-RS.
> > > >
> > > > Currently I am developing an API using JAX-RS which must be
> > versionable.
> > > > That means that the API will evolve and client must specify which
> > version
> > > > of the API want to use. There are a lot of strategies but finally I
> > > decided
> > > > to use the one using Header and ContentType. Let me show an example:
> > > >
> > > > @Consumes*({*"application/vnd.blog.v1+xml"*,*
> > > "application/vnd.blog.v1+json"
> > > > *})*
> > > >
> > > > @Produces*({*"application/vnd.blog.v1+xml"*,*
> > > "application/vnd.blog.v1+json"
> > > > *})*
> > > >
> > > > *public* *class* Book*RestfulService* *{*
> > > >
> > > >
> > > >
> > > > @GET
> > > >
> > > > @Path*(*"/books"*)*
> > > >
> > > > ….
> > > >
> > > > }
> > > >
> > > > @Consumes*({*"application/vnd.blog.v1+xml"*,*
> > > "application/vnd.blog.v1+json"
> > > > *})*
> > > >
> > > > @Produces*({*"application/vnd.blog.v1+xml"*,*
> > > "application/vnd.blog.v1+json"
> > > > *})*
> > > >
> > > > *public* *class* Author*RestfulService* *{*
> > > >
> > > >
> > > >
> > > > @GET
> > > >
> > > > @Path*(*“/authors”*)*
> > > >
> > > > ….
> > > >
> > > > }
> > > >
> > > > That's an example of version one, but now let's say I have a
> > modification
> > > > only in Author endpoint. I can do it and then the restful will be v2.
> > So
> > > I
> > > > will have something like:
> > > >
> > > > @Consumes*({*"application/vnd.blog.v2+xml"*,*
> > > "application/vnd.blog.v2+json"
> > > > *})*
> > > >
> > > > @Produces*({*"application/vnd.blog.v2+xml"*,*
> > > "application/vnd.blog.v2+json"
> > > > *})*
> > > >
> > > > *public* *class* Author2*RestfulService* *{*
> > > >
> > > >
> > > >
> > > > @GET
> > > >
> > > > @Path*(*“/authors”*)*
> > > >
> > > > ….
> > > >
> > > > }
> > > > The problem is that because Book has not received any modification, I
> > > > should add @Consumes and @Produces with v2 as well, something like:
> > > >
> > > > @Consumes*({*"application/vnd.blog.v1+xml"*,*
> > > "application/vnd.blog.v1+json",
> > > > "application/vnd.blog.v2+xml"*,* "application/vnd.blog.v2+json"*})*
> > > >
> > > > @Produces*({*"application/vnd.blog.v1+xml"*,*
> > > "application/vnd.blog.v1+json",
> > > > ....*})*
> > > >
> > > > *public* *class* Book*RestfulService* *{*
> > > >
> > > > *}*
> > > >
> > > > So now it is easy but if I have 25 services then I would need to go
> one
> > > by
> > > > one and add the media type as well. The problem is that I can miss
> one
> > > and
> > > > then the API had a misplaced endpoint.
> > > >
> > > > One thing that I have thought about it is create a rewriting filter
> > > where I
> > > > can intercept the calls and then redirect to the correct endpoint. In
> > > this
> > > > way all the rules will be placed in a single place.
> > > >
> > > > Any hints/experience on this?
> > > >
> > > > Thank you so much.
> > > >
> > > >
> > > > --
> > > > +----------------------------------------------------------+
> > > > Alex Soto Bueno
> > > > www.lordofthejars.com
> > > > +----------------------------------------------------------+
> > >
> >
> >
> >
> > --
> > +----------------------------------------------------------+
> > Alex Soto Bueno - Computer Engineer
> > www.lordofthejars.com
> > +----------------------------------------------------------+
> >
>
--
+----------------------------------------------------------+
Alex Soto Bueno - Computer Engineer
www.lordofthejars.com
+----------------------------------------------------------+
