| Resolves relative references among
SDDocument s.
This interface is implemented by the caller of
SDDocument.writeTo method so
that the
SDDocument can correctly produce references
to other documents.
This mechanism allows the user of
WSEndpoint to
assign logical URLs to each
SDDocument (which is often
necessarily done in a transport-dependent way), and then
serve description documents.
Usage Example 1
HTTP servlet transport chose to expose those metadata documents
to HTTP GET requests where each
SDDocument is identified
by a simple query string "?ID". (HTTP servlet transport
assigns such IDs by itself.)
In this nameing scheme, when
SDDocument X refers to
SDDocument Y, it can put a reference as "?IDofY".
By implementing
DocumentAddressResolver it can do so.
author:
Kohsuke Kawaguchi |