[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: Issue 137 - DPWS - Discovery/Service types WSDL attribute
What happens if you have a device that has multiple services in
it? Which discovery type would actually be used? Is the assumption that they
would all have the same discovery type? This seems to completely defeat the
reuse of standard services in multiple device classes. Toby Nixon |
Senior Standards Program Manager | Windows Device and Storage Technologies
| Microsoft Corporation toby.nixon@microsoft.com
| www.microsoft.com
| V: +1 425 706 2792 | M: +1 206 790 6377 | F: +1 425 708 4811 From: Dan Driscoll
[mailto:Dan.Driscoll@microsoft.com] I keep forgetting to add a
concrete example of what this would look like. Sorry for the delay. The proposed addition is highlighted. <wsdl:definitions
xmlns:wsdl="..."
xmlns:dpws="..."
xmlns:tns="http://example.org/example"
targetNamespace="http://example.org/example"
... >
<!-- WSDL Types and Messages go here -->
<wsdl:portType name="WSDToasterService" dpws:DiscoveryType="tns:WSDToasterDevice">
<!-- WSDToasterService operations go here -->
</wsdl:portType>
<!-- optionally, also include an empty portType for the device-layer type.
-->
<wsdl:portType name="WSDToasterDevice" /> </wsdl:definitions> From: Ram Jeyaraman
[mailto:Ram.Jeyaraman@microsoft.com] This issue is assigned the number 137. For further discussions
on this issue, please refer to this issue number or use this thread. From: Dan Driscoll This issue covers the case where we need an automated way to
identify the empty discovery-layer portType from the Hosted Service type.
Unless otherwise overridden in another spec, I expect all applications
require a discovery-layer type to advertise at the Device endpoint. We
can generate much better code for these applications by inspecting these in the
WSDL that defines the service-layer portType. Richer type description languages may also be defined
outside of DPWS 1.1, but this lightweight solution meets a basic requirement
for all WSDLs built for DPWS. This mechanism cannot be mandatory, since some non-DPWS
WSDLs are sometimes hosted in DPWS devices, and it is unreasonable to change
the WSDL solely to fit into DPWS. I propose adding an Appendix that describes how applications
may add an attribute to identify this discovery-layer type. Proposed addition: Appendix ??? – Declaring
Discovery Types in WSDL Solutions built on DPWS often
define portTypes implemented by Hosted Services, and a discovery-layer portType
implemented by the Host Service so the presence of these functional services
can be determined at the discovery layer. The binding between a
service-layer type and its discovery-layer type can be defined purely in
descriptive text, but this appendix provides an optional mechanism to declare a
discovery-layer type inside WSDL that can be consumed and understood by tools. This appendix defines
@dpws:DiscoveryType attribute to annotate the portType for the service-layer
type. The normative outline for @dpws:DiscoveryType is: <wsdl:definitions …> [<wsdl:portType
[dpws:DiscoveryType=”xs:QName”]? > … </wsdl:portType>]* </wsdl:definitions> The following describes additional,
normative constraints to the outline listed above: /wsdl:definitions/wsdl:portType/@dpws:DiscoveryType The
name of the portType to be advertised by the Host Service to indicate that this
device supports the annotated Hosted Service portType.
If omitted, no implied value [example usage follows] |
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]