Endpoint references
provide a standard mechanism to encapsulate information about specific
endpoints. Endpoint references can be propagated to other parties
and then used to target the Web service endpoint that they represent.
The following table summarizes the information model for endpoint
references.
Table 1. Information model for
endpoint references
Abstract Property name, using the notational
convention of the W3C XML Information Set |
Property type |
Multiplicity |
Description |
[address] |
xs:anyURI |
1..1 |
The absolute URI that specifies the address
of the endpoint. |
[reference parameters]* |
xs:any |
0..unbounded |
Namespace qualified element information items
that are required to interact with the endpoint. |
[metadata] |
xs:any |
0..unbounded |
Description of the behavior, policies and capabilities
of the endpoint. |
The following prefix and corresponding namespace is used in
the previous table.
Table 2. Prefix and
corresponding namespace
Prefix |
Namespace |
xs |
http://www.w3.org/2001/XMLSchema |
The following XML fragment illustrates an endpoint
reference. This element references the endpoint at the URI http://example.com/fabrikam/acct,
has metadata specifying the interface to which the endpoint reference
refers, and has application-defined reference parameters of the http://example.com/fabrikam
namespace.
<wsa:EndpointReference xmlns:wsa="http://www.w3.org/2005/08/addressing"
xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"
xmlns:fabrikam="http://example.com/fabrikam"
xmlns:wsdli="http://www.w3.org/2005/08/wsdl-instance"
wsdli:wsdlLocation="http://example.com/fabrikam
http://example.com/fabrikam/fabrikam.wsdl">
<wsa:Address>http://example.com/fabrikam/acct</wsa:Address>
<wsa:Metadata>
<wsaw:InterfaceName>fabrikam:Inventory</wsaw:InterfaceName>
</wsa:Metadata>
<wsa:ReferenceParameters>
<fabrikam:CustomerKey>123456789</fabrikam:CustomerKey>
<fabrikam:ShoppingCart>ABCDEFG</fabrikam:ShoppingCart>
</wsa:ReferenceParameters>
</wsa:EndpointReference>