OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

xri message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Revised _xrd_r proposal & Outputs section


In keeping with the points made in the previous thread - namely, that we
have defined three possible outputs of XRI resolution, this is a revised
proposal for the definition and use of the _xrd_r (Return) parameter.

Note: if we have consensus on this proposal, we would also change the
existing "Input Processing" section to the spec to one called "Inputs and
Outputs" where this content would appear.

The proposal is to define the _xrd_r (Return) parameter as an enumerated
list whose values are:

xrds		XRDS document
sep		Service endpoint
uri		URI

There is NO default value if the parameter is absent or null. See below for
the rules for that case.

The proposed rules when this parameter is PRESENT AND NON-NULL are:

1) IF THE VALUE IS XRDS

SUCCESS - LOCAL RESOLVER: MUST return an XRDS document.

ERROR - LOCAL RESOLVER: Same - the XRDS document will describe the error.

SUCCESS - PROXY RESOLVER: Same.

ERROR - PROXY RESOLVER: Same.


2) IF THE VALUE IS SEP

SUCCESS - LOCAL RESOLVER: SHOULD return an array of name/value pairs where
the name is the fully-qualified XPATH of each element/attribute in the
selected service endpoint and the value is the contents of the
element/attribute. In this array, element values must be followed by
attribute values for that element, and elements must be in the priority
order specified in the XRI resolution spec. 

ERROR - LOCAL RESOLVER: SHOULD return the error code and message in the same
fully-qualified XPATH name/value pair format.

SUCCESS - PROXY RESOLVER: MUST return the selected service endpoint as a
single <Service> element in the XRD namespace. 

ERROR - PROXY RESOLVER: MUST return a single <Status> element in the XRD
namespace describing the error.


3) IF THE VALUE IS URI

SUCCESS - LOCAL RESOLVER: SHOULD return a string with the fully-constructed
highest priority URI from the selected service endpoint. 

ERROR - LOCAL RESOLVER: SHOULD return a string containing the error code
followed by a space followed by an error description string.

SUCCESS - PROXY RESOLVER: MUST return the fully-constructed highest priority
URI from the selected service endpoint as a string with content type
"text/plain".

ERROR - PROXY RESOLVER: MUST return a string containing the error code
followed by a space followed by an error description string with content
type "text/plain".


******
The proposed rules when the _xrd_r input parameter is ABSENT OR NULL ARE:

1) WHEN TYPE=NULL, PATH=NULL, AND MEDIATYPE=APPLICATION/XRDS+XML (OR -SAML)

Same as option 1 above.

2) FOR ANY OTHER SET OF INPUT PARAMETERS

SUCCESS - LOCAL RESOLVER: Same as option 2 above.

ERROR - LOCAL RESOLVER: Same as option 2 above.

SUCCESS - PROXY RESOLVER: MUST return an 3xx redirect to highest priority
URI from the selected service endpoint.

ERROR - PROXY RESOLVER: SHOULD return a human-readable error message with
content type "text/plain" or "html".

=Drummond 





[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]