[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: On hashes, fragments and portions in Akoma Ntoso URIs
Dear all, Just a summary of my understanding of the possible syntaxes for hashes, portions and fragments in URIs. I'll be using ~ as the separator, but I am in now way attached to it. -- Hashes (1) /akn/us/act/123#sect_13 Dear server, please get me your best manifestation for US act 123. Get me the whole document. I'll scroll down to section 13 myself. Return 404 only if you do not know of act 123. (2) /akn/us/act/123/[something]#sect_13 Dear server, please get me your best manifestation for US act 123 that matches Expression and Manifestation specification [something]. Get me the whole document. I'll scroll down to section 13 myself. Return 404 if you do not know of act 123 or if you can't match [something]. -- Portions Portions are queries. They can be satisfied by the exact match or any other that contains the exact match, up to and including the whole document. (3) /akn/us/act/123~sect_13 Dear server, please get me your best manifestation for the portion "section 13" of US act 123. Depending on your flexibility and expressive power, get me just section 13, or a larger portion containing section 13, or the whole document (which is the maximum portion containing section 13). Return 404 only if you do not know of act 123. (4) /akn/us/act/123~sect_13/en@2014-05-15 Dear server, please get me your best manifestation for the portion "section 13" of US act 123, in the version that entered in force on May 15, 2014, and as long as it is in English. Depending on your flexibility and expressive power, get me just section 13, or a larger portion containing section 13, or the whole document (which is the maximum portion containing section 13). Return 404 if you do not know of act 123, if no version of it entered in force on May 15, 2014, or if no English version of the document exists. (5) /akn/us/act/123~sect_13/en@2014-05-15/GPO.xml Dear server, please get me your best manifestation for the portion "section 13" of US act 123, in the version that entered in force on May 15, 2014, and as long as it is in English, was published by GPO and is in XML. Depending on your flexibility and expressive power, get me just section 13, or a larger portion containing section 13, or the whole document (which is the maximum portion containing section 13). Return 404 if you do not know of act 123, if no version of it entered in force on May 15, 2014, if no English version of the document exists, if you have no such document created by GPO or if you have no such document in XML. -- Fragments Fragments are documents (manifestations, specifically). If you request a specific manifestation, you must either receive that exact manifestation, or a 404. (6) /akn/us/act/123/en@2014-05-15/GPO~sect_13.xml Dear server, please get me the fragment containing just section 13 of US act 123, in the version that entered in force on May 15, 2014, and in English and was created by GPO. Return 404 if you do not know of this manifestation. Of course even manifestations can have a level of uncertainty, and be subject of query, but only on the features that are NOT specified: (7) /akn/us/act/123/en@2014-05-15~sect_13.xml Dear server, please get me any fragment containing just section 13 of US act 123, in the version that entered in force on May 15, 2014, and in English regardless by who created it. Return 404 if you do not know of any such manifestation. --------------------- To summarize, the main difference between (5) and (6) is that (6) the the actual Manifestation URI of a document (a fragment), and requesting it means wanting exactly THAT document, and not something similar, while (5) indicates a query: get me the closest thing you can to what I am looking for. Also, (6) CAN and WILL be the URI of the response, while (5) will NEVER be a response. I hope we can agree on this Ciao Fabio -- Fabio Vitali Tiger got to hunt, bird got to fly, Dept. of Computer Science Man got to sit and wonder "Why, why, why?' Univ. of Bologna ITALY Tiger got to sleep, bird got to land, phone: +39 051 2094872 Man got to tell himself he understand. e-mail: fabio@cs.unibo.it Kurt Vonnegut (1922-2007), "Cat's cradle" http://vitali.web.cs.unibo.it/
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]