RESTfaces, Struts2 REST, SpringMVC+Restlet

RESTFaces

Ryan J. McDonough has written a post called "Not much is RESTful in RestFaces and JBoss Seam", which discusses the RESTfaces JSF extension. On RESTfaces he concludes:

"I just came across a quick article on The Server Side about a JSF framework called RESTFaces. My initial reaction was 'oh cool, a JSF framework that might adhere to RESTful principals.' Sadly, there isn’t very much that is “RESTful” about RESTFaces."

Unfortunately, I have to agree. REST is becoming something of a buzzword these days and I suspect RESTfaces might be suffering from that instead of focusing on what it actually does, which is provided a patch for JSF to allow CGI style links. Looking at the documentation, it says:

 " RESTfaces for JavaServer™ Faces Technology make it possible to write bookmarkable pages using JavaServer™ Faces."

And that's true, it does, You'd think JSF would just get fixed to align itself with web architecture fundamentals, but ok. The documentation describes how links are provided,

 "We want to jump to a page containing item details, when the user clicks on the item link. The resulting detail page should be bookmarkable. The best way to accomplish this is using HTTP parameters."

Parameters are not the best way to do this in general, though they might well be wrt JSF. The documentation goes on to say:

" Now let's see how it's possible to invoke the action with RestFaces."

The giveaway word is "action"; unfortunately that's not REST style, that's RPC. Here's how action is  marked up:

<rest:link value="item">

   <f:param name="itemId" value="#{item.id}" />

   <h:outputText value="#{item.name}" />

</rest:link>

which strikes me as quite cluttered; an "a" tag with href seems like a nicer option.

Looking through the rest of the documentation suggests that RESTfaces is dealing with incidental complexity introduced by JSF itself, as the majority of the examples are about managing internal wiring and mappings. RESTfaces as far as I can tell is an RPC technology. I've described the technique it's using to provide links as "CGI/RPC explicit" in the past. This is where you pass the id of the resource you care about as a query parameter to a script, instead of addressing the resource directly. In OO terms that's just like hiding all your domain objects behind manager classes and passing primary keys around - something that would be unacceptable for modern Java development.

I suspect RESTfaces does what it can to patch around JSF's limitations to provide bookmarks, but part of me wonders, why bother? JSF is clearly not focused on or suitable for working in the REST style to the extent REST principles seem to be actively excluded from the design. So, in the context of the way JSF does things, it's fine to add CGI style extensions for something as fundamental as linking, but then the REST moniker isn't appropriate. I understand I'm being hard on RESTfaces here; in fairness frameworks not being aligned with the Web is the norm and I'm reminded about what Mark Nottingham said about web frameworks:

"URIs are the lynchpin of the Web; to get the full value of the Web infrastructure, you need to be able to identify every interesting part of your Web application with a URI. Unfortunately, common Web APIs don’t encourage this, or even actively discourage it."

Struts2 REST

On a more positive note, Stefan Tilkov links to some material about REST support in Struts2; it looks like someone did some digging into the Web's design. Check it out.

SpringMVC + Restlet

Personally, I think unifying SpringMVC, RESTlet routers and JSR311 annotations would give you most of what you need.

If you've used Django or Rails, then SpringMVC has a controller/view request model that will be intuitive, while being familiar enough to the legions that grew up on Struts ActionController. According to Jurgen Hoeller's post, "Annotated Web MVC controllers in Spring 2.5", Spring 2.5 introduces some web annotations:

"So how does Spring 2.5's annotation-based controller approach fit into this picture? Quite simple: It is essentially an alternative controller type supported by the DispatcherServlet / DispatcherPortlet, not implementing a specific interface but rather using annotations to express request mappings for specific handler methods. It is primarily a next-generation style for implementing multi-action controllers, superseding Spring's good old MultiActionController class"

I think once you go down the road of using annotations such as @Controller and @RequestMapping for HTTP, you'll end up looking at JSR311 annotations.

Beyond JSR311, the best URI mapping I've seen in the Java space is  RESTlet's Router API. Here's an example:


Router router = new Router(getContext());
router.attach("/users/{user}", UserResource.class);
router.attach("/users/{user}/orders", OrdersResource.class);
router.attach("/users/{user}/orders/{order}", OrderResource.class);

which is quite a bit more flexible than the default mappers shipped with SpringMVC. As an aside Guice Binders vaguely remind me of Restlet Routers. I'm guess I'm saying that your Java interfaces are merely Resource implementations ;)

  • November 19, 2007
  • Posted by: dehora

Tags:

28 Comments


    What do you think about our DIY Framework?
    http://www.xml.lt/Resources/Framework

    It is written in PHP, however completely object-oriented, based on REST, MVC, and XSLT.

    Martynas Jusevicius
    November 19, 2007 at 9:52 a.m.

    I wouldn't be too hard on 'id' query string parameters. Yeah, they aren't as tidy looking, but they are still just as much part of the URL as path components are. The URL format doesn't really have much architectural significance.

    David Powell
    November 19, 2007 at 12:18 p.m.

    First, sorry for my english.

    I admit REST is probably not the approriate word. Well, let's call it GetFaces or something similar. Unfortunly I don't think I can change the name of the java.net project. Surely I can fix the summary (REST appears only in the project name and summary).

    About the the post, you said "Parameters are not the best way to do this in general". Although I think they are good because they work, I can agree that URI templates are smarter. I hope to bring URI templates in RestFaces very soon.

    About the cluttered tags, you are not right here. You can still use a normal <h:outputLink> and restfaces will continue to do its work.
    For more complex tasks the rest:link is instead very usefull. For example it auto append parameters. But can do more.

    About passing IDs etc.. you should explain the alternatives.
    I am really interested about this (I am not sarcastic).

    Anyway RestFaces is a very simple library and not a big framework like Seam.
    It only tries to improve bookmarking support for JavaServer Faces. Not much more. I am also reticent about calling it a framework at the moment. It went out because I have seen a lot of people complaining about how difficult is to implement bookmarkable pages in JSF.

    So we are not proposing a new programming model, or to be the framework of the future, like for example Seam.

    And its name is misleading, true.

    restfaces developer
    November 19, 2007 at 12:41 p.m.

    "...which strikes me as quite cluttered; an "a" tag with href seems like a nicer option."

    Are you advocating only coding in the expected content-type? Granted, having the natural representation for HTML is much easier to read and maintain, but that assumes text/html and no other. Also, applications can be very complex and having a one to one binding between development artifact and content-type may not be practical.

    Noah Campbell
    November 19, 2007 at 4:45 p.m.

    I agree with David. The syntax of an HTTP URL is just a clue about whether REST or RPC or some other architecture is being used. I experienced this when implementing an Atom Publishing Protocol server. My server uses "edit" and "edit-media" links of the form {collection-uri}?entry={atom:id} and {collection-uri}?media={atom:id}. It looks a lot like "CGI/RPC Explicit" but it is just as RESTful as any other AtomPub server that doesn't require that the atom:id of an entry be the same as its edit URI.

    In particular, using links of the form {collection-uri}/entry/{atom:id} and {collection-uri}/media/{atom:id} would not change how my applications work at all, except making the web servers URL mapping configuration more complicated.

    Brian
    November 19, 2007 at 5:49 p.m.

    "The syntax of an HTTP URL is just a clue about whether REST or RPC or some other architecture is being used. "

    Links of the form "{collection-uri}?entry={atom:id}" identify the collection resource, not the entry. The question mark in the URI is used to separate the URI from parameters which are appended to it to perform an operation. I understand this might not be a well known aspect of HTTP/URIs.

    Bill de hOra
    November 19, 2007 at 9:23 p.m.

    Bill, I consider you to be an authority on such matters, but I cannot find anything in RFC 3896 or RFC 2616 that supports that line of thinking. What am I overlooking?

    RFC 3986 says "The query component contains non-hierarchical data that, along with data in the path component (Section 3.3), serves to identify a resource[.]" Basically, there is basically no distinction between "/" and "?" other than syntax and that segments between slashes have some hierarchical properties that query strings don't have. RFC 2616 gives no semantics to query strings whatsoever.

    I am particularly interested in hearing of any advantages that your interpretation of query string semantics over mine.

    Thanks,
    Brian

    Brian
    November 20, 2007 at 12:08 a.m.

    I don't have time to dig up the reference now, but I believe Roy said on rest-discuss that the special handling of "?" URIs is a legacy and no longer relevant in practice.

    Stefan Tilkov
    November 20, 2007 at 6:17 a.m.

    The thread you are talking about is here: http://tech.groups.yahoo.com/group/re...

    In that discussion, Bill brings up the point that RFC 2616, section 3.2.2 says "...the Request-URI for the resource is abs_path...." (omitting the query parameter).

    There is a proposal for RFC2616bis to change this to include the query parameter:

    http://www.w3.org/Protocols/HTTP/1.1/...
    http://lists.w3.org/Archives/Public/i...

    Brian
    November 20, 2007 at 3 p.m.

    "There is a proposal for RFC2616bis to change this"

    Yeah, they need to do that.

    Bill de hOra
    November 20, 2007 at 10:11 p.m.

    Wu9F1V sd89f984q34slf

    gary
    March 28, 2008 at 3:44 p.m.

    < url=http://krotkin-krotov.narod.ru/index.html>?????/a>
    <a href="http://krotkin-krotov.narod.ru/index.html">?????/a>
    http://krotkin-krotov.narod.ru/index....

    krotz888888
    January 22, 2009 at 3:18 a.m.


    http://lobzikl.narod.ru

    Globus2008
    January 27, 2009 at 3:19 p.m.

    <a href="http://bremen.craigslist.org/res/1005496905.html">PAMELA ANDERSON PORN</a>
    http://bremen.craigslist.org/res/1005... - PAMELA ANDERSON PORN
    <a href=http://bremen.craigslist.org/res/1005496905.html>PAMELA ANDERSON PORN</a>
    http://bremen.craigslist.org/res/1005... - PAMELA ANDERSON PORN
    <a href="http://cologne.craigslist.org/roo/1005498011.html">PAMELA UNCENSORED</a>
    http://cologne.craigslist.org/roo/100... - PAMELA UNCENSORED
    <a href=http://cologne.craigslist.org/roo/1005498011.html>PAMELA UNCENSORED</a>
    http://cologne.craigslist.org/roo/100... - PAMELA UNCENSORED
    <a href="http://toulouse.craigslist.org/adg/1005500091.html">PAMELA ANDERSON SEX SCENE</a>
    http://toulouse.craigslist.org/adg/10... - PAMELA ANDERSON SEX SCENE
    <a href=http://toulouse.craigslist.org/adg/1005500091.html>PAMELA ANDERSON SEX SCENE</a>
    http://toulouse.craigslist.org/adg/10... - PAMELA ANDERSON SEX SCENE

    axespmr
    January 29, 2009 at 7:53 p.m.

    <a href="http://www.bookcrossing.com/mybookshelf/single-man">single man seeking woman</a>, <a href=http://www.bookcrossing.com/mybookshelf/single-man>single man seeking woman</a>, http://www.bookcrossing.com/mybookshe... single man seeking woman, <a href="http://www.motime.com/profile/dating_divorced_man">dating divorced men</a>, <a href=http://www.motime.com/profile/dating_divorced_man>dating divorced men</a>, http://www.motime.com/profile/dating_... dating divorced men, <a href="http://www.giantbomb.com/profile/dating_older_man/">dating older man</a>, <a href=http://www.giantbomb.com/profile/dating_older_man/>dating older man</a>, http://www.giantbomb.com/profile/dati... dating older man

    Dating_Single_Man
    January 31, 2009 at 2:05 a.m.

    Hello. And Bye. :)

    kookimebux
    February 1, 2009 at 5:31 p.m.

    <a href="http://basel.craigslist.ch/res/1014653953.html">MILEY CYRUS NAKED</a>
    http://basel.craigslist.ch/res/101465... - MILEY CYRUS NAKED
    <a href=http://basel.craigslist.ch/res/1014653953.html>MILEY CYRUS NAKED</a>
    http://basel.craigslist.ch/res/101465... - MILEY CYRUS NAKED
    <a href="http://canberra.craigslist.com.au/roo/1014670074.html">MILEY CYRUS PORN</a>
    http://canberra.craigslist.com.au/roo... - MILEY CYRUS PORN
    <a href=http://canberra.craigslist.com.au/roo/1014670074.html>MILEY CYRUS PORN</a>
    http://canberra.craigslist.com.au/roo... - MILEY CYRUS PORN
    <a href="http://lille.craigslist.org/wan/1014689512.html">MILEY CYRUS NUDE PICS</a>
    http://lille.craigslist.org/wan/10146... - MILEY CYRUS NUDE PICS
    <a href=http://lille.craigslist.org/wan/1014689512.html>MILEY CYRUS NUDE PICS</a>
    http://lille.craigslist.org/wan/10146... - MILEY CYRUS NUDE PICS

    fucglopidm
    February 2, 2009 at 12:06 a.m.

    I love the comparisons you have made. Absolutly true.

    Dating_Older_Man
    February 2, 2009 at 4:19 a.m.

    I like the comparisons you have made. Absolutly true.

    Dating_Divorced_Man
    February 2, 2009 at 7:43 p.m.

    sorry for my bad english
    [url=http://wis.dm/users/72276-awentiaocp78] man wis [/url]
    <a href='http://wis.dm/users/72275-alistairyjt79' > word wis </a>
    [url=http://wis.dm/users/72281-mississippiaeq15] one wis [/url]
    [url=http://wis.dm/users/72274-aibhneemn84] take wis [/url]
    http://wis.dm/users/72281-mississippi...

    baby sweet

    Helga
    February 3, 2009 at 2:28 a.m.

    sorry for my bad english
    <a href='http://wis.dm/users/72295-ouraybry69' > of wis </a>
    <a href='http://wis.dm/users/72283-averyana30' > with wis </a>
    [url=http://wis.dm/users/72277-aindreazmp56] a wis [/url]
    http://wis.dm/users/72292-shoneahtwg94
    http://wis.dm/users/72284-pahukumaakjr69

    baby sweet

    Helga
    February 5, 2009 at 9:27 p.m.

    nice

    lpjigynjvgfft
    February 9, 2009 at 6:41 p.m.

    <a href="http://basel.craigslist.ch/res/1014653953.html">MILEY CYRUS NAKED</a>
    http://basel.craigslist.ch/res/101465... - MILEY CYRUS NAKED
    <a href=http://basel.craigslist.ch/res/1014653953.html>MILEY CYRUS NAKED</a>
    http://basel.craigslist.ch/res/101465... - MILEY CYRUS NAKED
    <a href="http://costarica.craigslist.org/adg/1014703633.html">MILEY CYRUS BOOBS</a>
    http://costarica.craigslist.org/adg/1... - MILEY CYRUS BOOBS
    <a href=http://costarica.craigslist.org/adg/1014703633.html>MILEY CYRUS BOOBS</a>
    http://costarica.craigslist.org/adg/1... - MILEY CYRUS BOOBS
    <a href="http://rennes.craigslist.org/res/1017441971.html">SARAH PALIN NAKED</a>
    http://rennes.craigslist.org/res/1017... - SARAH PALIN NAKED
    <a href=http://rennes.craigslist.org/res/1017441971.html>SARAH PALIN NAKED</a>
    http://rennes.craigslist.org/res/1017... - SARAH PALIN NAKED
    <a href="http://copenhagen.craigslist.org/laf/1017463907.html">ADRIENNE BAILON NUDE</a>
    http://copenhagen.craigslist.org/laf/... - ADRIENNE BAILON NUDE
    <a href=http://copenhagen.craigslist.org/laf/1017463907.html>ADRIENNE BAILON NUDE</a>
    http://copenhagen.craigslist.org/laf/... - ADRIENNE BAILON NUDE
    <a href="http://canberra.craigslist.com.au/roo/1014670074.html">MILEY CYRUS PORN</a>
    http://canberra.craigslist.com.au/roo... - MILEY CYRUS PORN
    <a href=http://canberra.craigslist.com.au/roo/1014670074.html>MILEY CYRUS PORN</a>
    http://canberra.craigslist.com.au/roo... - MILEY CYRUS PORN

    ydmscefrgf
    February 10, 2009 at 2:54 a.m.

    illegal immigrant fuck porn -<a href=http://www.hqtube.com/?5736000000/><b>>>>holly ryder porn <<<</b></a>
    <a href=http://hqtube.com/gallery/?873700-224/><img>http://pics.hqtube.com/gallery/amateur_hardcore_1_sc1_1.jpg</img></a> <a href=http://hqtube.com/gallery/?873700-276/><img>http://pics.hqtube.com/gallery/naughty_little_nymphs_9_sc3_2.jpg</img></a> <a href=http://hqtube.com/gallery/?873700-26/><img>http://pics.hqtube.com/gallery/pink_eye_1_sc2_2.jpg</img></a> <a href=http://hqtube.com/gallery/?873700-3/><img>http://pics.hqtube.com/gallery/my_thick_black_ass_6_sc3_3.jpg</img></a>
    <b>>>><a href=http://www.hqtube.com/?5736010478/>porn eskimo</a> - porn eskimo <<<</b>sick anal porn
    <a href=http://hqtube.com/gallery/?873700-254/><img>http://pics.hqtube.com/gallery/over_eighteen_11_sc2_2.jpg</img></a> <a href=http://hqtube.com/gallery/?873700-332/><img>http://pics.hqtube.com/gallery/blame_it_on_daddy_2_sc4_1.jpg</img></a> <a href=http://hqtube.com/gallery/?873700-120/><img>http://pics.hqtube.com/gallery/pink_eye_2_sc3_1.jpg</img></a> <a href=http://hqtube.com/gallery/?873700-245/><img>http://pics.hqtube.com/gallery/babewatch_6_sc3_1.jpg</img></a>
    <b>>>><a href=http://www.hqtube.com/?5736000023/>xxx porn stars</a> - xxx porn stars <<<</b>milf porn sites
    <a href=http://www.hqtube.com/?5736010185/>keeley hazell porn</a> - keeley hazell porn
    <a href=http://www.hqtube.com/?5736010571/>granny and boy porn</a> - granny and boy porn
    <a href=http://www.hqtube.com/?5736020181/>porn blow jobs</a> - porn blow jobs
    <a href=http://www.hqtube.com/?5736030653/>ebony porn</a> - ebony porn
    <a href=http://www.hqtube.com/?5736000246/>milf anal</a> - milf anal
    <a href=http://hqtube.com/gallery/?573603-12/>porn vedio</a> - british porn paki
    <a href=http://www.hqtube.com/?5736020105/>buffie the body porn</a> - porn star amme
    <a href=http://hqtube.com/gallery/?573603-40/>asian porn sluts wife</a> - teenage boys only gay porn
    <a href=http://hqtube.com/gallery/?573602-161/>young leafs porn</a> - amberlynn in porn
    <a href=http://hqtube.com/gallery/?573605-227/>review of big booty porn review</a> - asian babes free porn

    JarargUnkcany
    February 10, 2009 at 5:53 a.m.

    Yo everyone!
    All of the current talks of the corruption of the economy and loss of jobs has been driving most americans insane!
    I began searching everywhere for some way to get help and found that the government gives free grants.
    What I want to know is.... does anyone know what website I can find <a href=http://swik.net/User:freegrantapplication>free online grant applications</a> at?

    THANKS!

    __________

    <a href=http://www.twine.com/user/freeitunescodes>Free Itunes Codes</a>

    CathyChuThtet
    February 26, 2009 at 5:39 p.m.


    <a href= http://coe.alasu.edu/leminternshipfor... viagra in canada</a>

    viagra sample
    June 20, 2009 at 10:31 a.m.

Post a comment