Search the web
Sign In
New User? Sign Up
rest-discuss · REST Discussion Mailing List
? Already a member? Sign in to Yahoo!

Yahoo! Groups Tips

Did you know...
Message search is now enhanced, find messages faster. Take it for a spin.

Best of Y! Groups

   Check them out and nominate your group.
Having problems with message search? Fill out this form to ensure your group is one of the first to be migrated to the new message search system.

Messages

  Messages Help
Advanced
Resources with read-only and read-write parts   Message List  
Reply | Forward Message #13096 of 14436 |
Re: [rest-discuss] Resources with read-only and read-write parts

On Mon, Jul 6, 2009 at 8:38 PM, Moore, Jonathan (CIM) <jonathan_moore@...> wrote:
>
> Sounds like the fingerprint, portrait, and scan could all be subordinate resources. Maybe http://example.com/person/123 returns an HTML or XML document with several links in it, like:

Yes, you should certainly be able to enumerate the available resources but this gets me thinking about a server-side Accept: header (e.g. Offer:). Anyway I'm liking the idea of subordinate resources and it fits with the requirement to upload existing multi-file virtual machines.

> (excuse my not-exactly-Atom XML)...
>
> <entry>
> <id>http://example.com/person/123</id>
> <link rel="http://example.com/schemas/#portrait"
> href="http://example.com/person/123/portrait
> type="image/jpeg"/>
> <link rel="http://example.com/schemas/#fingerprint"
> href="http://example.com/person/123/fingerprint"
> type="image/jpeg"/>
> ...
> </entry>

Another way of achieving the same while eliminating the dependency on Atom & XML is to serve up the best representation available along with Link: headers (draft-nottingham-http-link-header). Given "best" often translates to "biggest" you can get just the links in advance using HEAD (which is also compatible with "simple" clients like wget/curl, thus lowering the barriers to entry).

Sam




Mon Jul 6, 2009 6:58 pm

sam.johnston...
Offline Offline
Send Email Send Email

Forward
Message #13096 of 14436 |
Expand Messages Author Sort by Date

Hi, everyone, I'm a newbie here (though not to REST in general), and the list archives have been a great help in clarifying my understanding of a lot of REST...
Jim Edwards-Hewitt
jimeh_xjs
Offline Send Email
Jul 2, 2009
2:43 pm

Jim, Typically you would express the overall writeability of a resource via OPTIONS (e.g. if you can only GET it's read only), but if you've got, say, a ...
Sam Johnston
sam.johnston...
Offline Send Email
Jul 2, 2009
3:01 pm

Representations in a request (e.g. PUT or POST) and representations in a response (e.g. GET or a PUT) need not be absolutely the same. HTTP servers are not...
Subbu Allamaraju
sallamar
Offline Send Email
Jul 4, 2009
11:04 pm

... The way I read the RFC is "*The PUT method requests that the enclosed entity be stored [as is] under the supplied Request-URI*", which is obvious for ...
Sam Johnston
sam.johnston...
Offline Send Email
Jul 6, 2009
5:29 pm

Well, the "[as is]" isn't actually part of the RFC. The body of the PUT request is simply a *representation* of the state. Consider a resource that could...
Moore, Jonathan (CIM)
jonathan_t_m...
Offline Send Email
Jul 6, 2009
6:28 pm

On Mon, Jul 6, 2009 at 7:51 PM, Moore, Jonathan (CIM) < ... Right, which is why I said "The way I read the RFC is..." ... Which brings me to a question I...
Sam Johnston
sam.johnston...
Offline Send Email
Jul 6, 2009
6:28 pm

Sounds like the fingerprint, portrait, and scan could all be subordinate resources. Maybe http://example.com/person/123 returns an HTML or XML document with...
Moore, Jonathan (CIM)
jonathan_t_m...
Offline Send Email
Jul 6, 2009
6:38 pm

On Mon, Jul 6, 2009 at 8:38 PM, Moore, Jonathan (CIM) < ... resources. Maybe http://example.com/person/123 returns an HTML or XML document with several links...
Sam Johnston
sam.johnston...
Offline Send Email
Jul 6, 2009
6:59 pm

You need to decide if the portrait of user is a resource or a representation in your system. If it's a resource, it should have a URI. If it's a ...
mike amundsen
mamund
Offline Send Email
Jul 6, 2009
6:42 pm

... I don't blame custom media types for that. Proliferation of custom means of expressing semantics limits the usability of the system. A media type is one of...
Subbu Allamaraju
sallamar
Offline Send Email
Jul 6, 2009
7:48 pm

I agree with the inefficiency (it is an inconvenience, to be accurate) part. That is why, there is no need to require clients to supply the immutable parts....
Subbu Allamaraju
sallamar
Offline Send Email
Jul 6, 2009
6:51 pm

I'll certainly admit to my thinking being influenced by past schema-driven projects. I suppose I've also been thinking of GET/PUT formats being the same as a...
Jim Edwards-Hewitt
jimeh_xjs
Offline Send Email
Jul 7, 2009
7:31 pm

I worked on one project where the OPTIONS call returned documentation for that URI. This document detailed the methods, accept-types (GET), content-types (POST...
mike amundsen
mamund
Offline Send Email
Jul 7, 2009
7:48 pm

Jim: I am addressing the security portion of your post. Hopefully this will give you some ideas. <snip> there are some elements that are modifiable or not...
mike amundsen
mamund
Offline Send Email
Jul 2, 2009
5:56 pm

(I posted this reply privately instead of publicly, so I'm re-posting.) Ah, that does make it more clear. So I might have two (or more) different...
Jim Edwards-Hewitt
jimeh_xjs
Offline Send Email
Jul 6, 2009
8:28 pm

Hi Jim, can you provide an example representation for the mutable/immutable use case? Jan...
Jan Algermissen
algermissen1971
Offline Send Email
Jul 3, 2009
3:24 am

The most complicated resource of this type is an Administrator account. The current representation is: <admin> <uid>{id}</uid> <status>{status string}</status>...
Jim Edwards-Hewitt
jimeh_xjs
Offline Send Email
Jul 6, 2009
9:03 pm

Hey Jim, ... IMO, you seem to be confusing between the state of the resource and its representation. GET and PUT allow you to retrieve and set the state of the...
Sandeep Shetty
sandeep.shetty@...
Send Email
Jul 4, 2009
10:03 pm

Ah. That makes a lot of sense, but I don't think I've seen it expressed that way before. Are there content-type definitions that make that explicit? (I suppose...
Jim Edwards-Hewitt
jimeh_xjs
Offline Send Email
Jul 6, 2009
10:04 pm

Hey Jim, ... A form (POST) that accepts only the values that represent the state of the resource is one way to make it explicit (sigh... if only I could say...
Sandeep Shetty
sandeep.shetty@...
Send Email
Jul 7, 2009
6:08 am
Advanced

Copyright © 2009 Yahoo! Inc. All rights reserved.
Privacy Policy - Terms of Service - Guidelines - Help