Request for clarification: Are multiple lines allowed?

Dear members of the occi-wg, In the federated clouds working group, we are having a discussion about the interpretation of the HTTP rendering of the OCCI standard (document GFD.185, http://ogf.org/documents/GFD.185.pdf) Our doubt is the following. In several examples in the document, for examples in section 3.4, page 8 or in section 3.5.1, page 20, we see Category: elements laid out in multiple lines. Our doubt is if this examples are normative, and thus it is acceptable to write them in multiple lines, or if this had been done just for readability, and the answers from the OCCI server should actually lay out a Category in a single line. In the interest of interoperability among our different implementations, can you please clarify this point? Thanks in advance, On behalf of the Federated Clouds Working Group

Hi Vincenzo Having a the same header repeated multiple times with different values is allowable by the HTTP spec. OCCI respects (OCCI always aims to respect the HTTP spec RFC2616) this hence why you may see two different renderings: one with all values "compressed" into one header line or multiple same headers with different values. If you "compress" each value must be ',' delineated. Note these rules also apply if the content is supplied in the body (OCCI specific). HTH, Andy Andy Edmonds Æ Senior Researcher Institute of Information Technology Zürich University of Applied Sciences http://www.cloudcomp.ch, @dizz On 25 February 2013 16:03, Vincenzo Ciaschini < vincenzo.ciaschini@cnaf.infn.it> wrote:
Dear members of the occi-wg,
In the federated clouds working group, we are having a discussion about the interpretation of the HTTP rendering of the OCCI standard (document GFD.185, http://ogf.org/documents/GFD.**185.pdf<http://ogf.org/documents/GFD.185.pdf> )
Our doubt is the following.
In several examples in the document, for examples in section 3.4, page 8 or in section 3.5.1, page 20, we see Category: elements laid out in multiple lines.
Our doubt is if this examples are normative, and thus it is acceptable to write them in multiple lines, or if this had been done just for readability, and the answers from the OCCI server should actually lay out a Category in a single line.
In the interest of interoperability among our different implementations, can you please clarify this point?
Thanks in advance, On behalf of the Federated Clouds Working Group ______________________________**_________________ occi-wg mailing list occi-wg@ogf.org https://www.ogf.org/mailman/**listinfo/occi-wg<https://www.ogf.org/mailman/listinfo/occi-wg>

Hi Andy, Thanks for the fast answer! A clarification is possibly needed: what we are discussing in the Federated Cloud group is not what happens when multiple headers are present, but if a single Category header element can be written on multiple lines. i.e. if the following representation of a category, taken from page 20: Category: storage; scheme="http://schemas.ogf.org/occi/infrastructure#"; class="kind"; title="Storage Resource"; rel="http://schemas.ogf.org/occi/core#resource"; location="/storage/"; attributes="occi.storage.size{required} occi.storage.state{immutable}"; actions="http://schemas.ogf.org/occi/infrastructure/storage/action#resize ..."; Is acceptable in the answer as is, with the newlines between elements and the indentation, or if it is supposed to be on a single line. Thanks in advance, Vincenzo On Mon, 25 Feb 2013 16:10:00 +0100, Andy Edmonds wrote:
Hi Vincenzo Having a the same header repeated multiple times with different values is allowable by the HTTP spec. OCCI respects (OCCI always aims to respect the HTTP spec RFC2616) this hence why you may see two different renderings: one with all values "compressed" into one header line or multiple same headers with different values. If you "compress" each value must be ',' delineated. Note these rules also apply if the content is supplied in the body (OCCI specific).
HTH,
Andy
Andy Edmonds Æ Senior Researcher Institute of Information Technology Zürich University of Applied Sciences http://www.cloudcomp.ch [4], @dizz
On 25 February 2013 16:03, Vincenzo Ciaschini wrote:
Dear members of the occi-wg,
In the federated clouds working group, we are having a discussion about the interpretation of the HTTP rendering of the OCCI standard (document GFD.185, http://ogf.org/documents/GFD.185.pdf [1])
Our doubt is the following.
In several examples in the document, for examples in section 3.4, page 8 or in section 3.5.1, page 20, we see Category: elements laid out in multiple lines.
Our doubt is if this examples are normative, and thus it is acceptable to write them in multiple lines, or if this had been done just for readability, and the answers from the OCCI server should actually lay out a Category in a single line.
In the interest of interoperability among our different implementations, can you please clarify this point?
Thanks in advance, On behalf of the Federated Clouds Working Group _______________________________________________ occi-wg mailing list occi-wg@ogf.org [2] https://www.ogf.org/mailman/listinfo/occi-wg [3]
Links: ------ [1] http://ogf.org/documents/GFD.185.pdf [2] mailto:occi-wg@ogf.org [3] https://www.ogf.org/mailman/listinfo/occi-wg [4] http://www.cloudcomp.ch [5] mailto:vincenzo.ciaschini@cnaf.infn.it

Hello Vincenzo, for what it is worth, this is a point that I have encountered too, I was using the line wrapped value as specified in the HTTP 1.1 standard but it would appear that not many of the programmers that have been involved in writing the HTTP libraries of languages such as Python, Perl and Php, are aware of the HTTP 1.1 specifications. As a result if you line wrap values you may crash the client or server code due to this kind of thing. I have dropped back onto the simple stuff. SincerelyJamie
Date: Mon, 25 Feb 2013 16:44:36 +0100 From: vincenzo.ciaschini@cnaf.infn.it To: andrew.edmonds@zhaw.ch CC: occi-wg@ogf.org; fedcloud-tf@mailman.egi.eu Subject: Re: [occi-wg] Request for clarification: Are multiple lines allowed?
Hi Andy,
Thanks for the fast answer!
A clarification is possibly needed: what we are discussing in the Federated Cloud group is not what happens when multiple headers are present, but if a single Category header element can be written on multiple lines. i.e. if the following representation of a category, taken from page 20:
Category: storage; scheme="http://schemas.ogf.org/occi/infrastructure#"; class="kind"; title="Storage Resource"; rel="http://schemas.ogf.org/occi/core#resource"; location="/storage/"; attributes="occi.storage.size{required} occi.storage.state{immutable}";
actions="http://schemas.ogf.org/occi/infrastructure/storage/action#resize ...";
Is acceptable in the answer as is, with the newlines between elements and the indentation, or if it is supposed to be on a single line.
Thanks in advance, Vincenzo
On Mon, 25 Feb 2013 16:10:00 +0100, Andy Edmonds wrote:
Hi Vincenzo Having a the same header repeated multiple times with different values is allowable by the HTTP spec. OCCI respects (OCCI always aims to respect the HTTP spec RFC2616) this hence why you may see two different renderings: one with all values "compressed" into one header line or multiple same headers with different values. If you "compress" each value must be ',' delineated. Note these rules also apply if the content is supplied in the body (OCCI specific).
HTH,
Andy
Andy Edmonds Æ Senior Researcher Institute of Information Technology Zürich University of Applied Sciences http://www.cloudcomp.ch [4], @dizz
On 25 February 2013 16:03, Vincenzo Ciaschini wrote:
Dear members of the occi-wg,
In the federated clouds working group, we are having a discussion about the interpretation of the HTTP rendering of the OCCI standard (document GFD.185, http://ogf.org/documents/GFD.185.pdf [1])
Our doubt is the following.
In several examples in the document, for examples in section 3.4, page 8 or in section 3.5.1, page 20, we see Category: elements laid out in multiple lines.
Our doubt is if this examples are normative, and thus it is acceptable to write them in multiple lines, or if this had been done just for readability, and the answers from the OCCI server should actually lay out a Category in a single line.
In the interest of interoperability among our different implementations, can you please clarify this point?
Thanks in advance, On behalf of the Federated Clouds Working Group _______________________________________________ occi-wg mailing list occi-wg@ogf.org [2] https://www.ogf.org/mailman/listinfo/occi-wg [3]
Links: ------ [1] http://ogf.org/documents/GFD.185.pdf [2] mailto:occi-wg@ogf.org [3] https://www.ogf.org/mailman/listinfo/occi-wg [4] http://www.cloudcomp.ch [5] mailto:vincenzo.ciaschini@cnaf.infn.it
_______________________________________________ occi-wg mailing list occi-wg@ogf.org https://www.ogf.org/mailman/listinfo/occi-wg
participants (3)
-
Andy Edmonds
-
Jamie Marshall
-
Vincenzo Ciaschini