1. OpenSG Service Definition, Feb 2010 RESTful Service Discussions Shawn Hu

2. OpenSG Service Definition, Feb 2010 Design Artifact Considerations XML schemas for message payload definition WSDL 2.0 for service definition in REST style –Operation style & pattern style="http://www.w3.org/ns/wsdl/style/iri" pattern="http://www.w3.org/ns/wsdl/in-out" –Binding type: type="http://www.w3.org/ns/wsdl/http" –Operation method (http verbs) whttp:method="GET" (or others)

3. OpenSG Service Definition, Feb 2010 Consumption XML Schema Consumption.xsd

4. OpenSG Service Definition, Feb 2010 RESTful Service Definition Input –Using HTTP GET or POST following URL naming convention Output –Using XSD for return

5. OpenSG Service Definition, Feb 2010 Xpath for URI Design http://www.openade.org/datastore/Consumption/MeterReading/IntervalBlocks/IntervalReadings/value

6. OpenSG Service Definition, Feb 2010 URI = + + – - A base address where a web service is located such as http://www.openade.org/datastore/ (not real address but for example only) – - A path to access resource component. This path follows XSD Xpath convention such as /Consumption/MeterReading/IntervalBlocks/IntervalReadings/ to access interval readings as consumption – - An optional field for arguments such as ?timeStamp=2010-02-02T00:00:00Z –Example URI for a resource: http://www.openade.org/datastore/Consumption/MeterReading/I ntervalBlocks/IntervalReadings?timeStamp=2010-02- 02T00:00:00Z URI Naming Convention

7. OpenSG Service Definition, Feb 2010 Service Table

8. OpenSG Service Definition, Feb 2010 Entry URI: http://www.OpenSG.org/datastore/Consumption/MeterReading/IntervalBloc ks/IntervalReadings/value?timeStamp= 2009-12-17T09:30:47Z Note: may need to truncated to only list such as http://www.OpenSG.org/datastore/IntervalReadings/value?timeStamp= 2009- 12-17T09:30:47Z Return XML: 2009-12-17T09:30:47Z 12.35 GET URI & Return XML

9. OpenSG Service Definition, Feb 2010 Entry URI: http://www.OpenSG.org/datastore/Consumption/MeterReading/IntervalBloc ks/IntervalReadings/value Resulting XML to post: 12345 2009-12-17T09:30:47Z 12.35 POST Entry URI & XML

10. OpenSG Service Definition, Feb 2010 XML can be compressed or truncated as below if space is limited using the POST XML as an example: 12345 2009-12- 17T09:30:47Z 12.35 Compressed/Truncated XML

11. OpenSG Service Definition, Feb 2010 WSDL Design –Operation Style & Pattern style=http://www.w3.org/ns/wsdl/style/ iri(W3C WSDL2.0) –The content model of this element is defined using a complex type that contains a sequence from XML Schema. –The sequence MUST only contain elements.† It MUST NOT contain other structures such as xs:choice. There are no occurrence constraints on the sequence.† –The sequence MUST contain only local element children.† Note these child elements can contain the nillable attribute.† –The localPart of the element's QName MUST be the same as the Interface Operation component's {name}.† Interface Operationname† –The complex type that defines the body of the element or its children elements MUST NOT contain any attributes.†† –The children elements of the sequence MUST derive from xs:simpleType, and MUST NOT be of the type or derive from xs:QName, xs:NOTATION, xs:hexBinary or xs:base64Binary.†† Note: IRIs – Internationalized Resource Identifiers (IETF)

12. OpenSG Service Definition, Feb 2010 WSDL Design –Operation Style & Pattern pattern=http://www.w3.org/ns/wsdl/ in-out (W3C WSDL2.0) –The in-out message exchange pattern consists of exactly two messages, in order, as follows:†† –A message: »indicated by a Interface Message Reference component whose {message label} is "In" and {direction} is "in"Interface Message Referencemessage labeldirection »received from some node N –A message: »indicated by a Interface Message Reference component whose {message label} is "Out" and {direction} is "out"Interface Message Referencemessage labeldirection »sent to node N –The in-out message exchange pattern uses the rule 2.2.1 Fault Replaces Message propagation rule.†2.2.1 Fault Replaces Message propagation rule† –An operation using this message exchange pattern has a {message exchange pattern} property with the value "http://www.w3.org/ns/wsdl/in-out".message exchange pattern

13. OpenSG Service Definition, Feb 2010 Service Output –In-Out Pattern for a GET return (message)

14. OpenSG Service Definition, Feb 2010 Service Output –In-Out Pattern for a POST return (ack)

15. OpenSG Service Definition, Feb 2010 Summary –Definition using WSDL 2.0 (IRI style & In- Out pattern) –URL naming pattern (to follow XSD XPath) –SLA on services such as limited return data size –Return data in XSD format (CIM based) –GET for non state change and POST for state change

16. OpenSG Service Definition, Feb 2010 Questions & Comments