Translate the given URI to a locator (URL) for the resource.
The returned locator should be one that "works" for the resoure - that is,
aside from authorization issues or network problems, one that can be used to
retrieve the resource.
Note that this returns a URI, not a URL
. While the return value is
intended to be a locator, the resolver system works exclusively with the URI class
to avoid issues associated with missing protocol implementations.
- Parameters:
uri
- the URI to resolve.
- Returns:
- a locator for the resource identified by the URI, or
null
if no locator can be found.
- Throws:
NoSuchURIException
- if the URI is definitively known not to represent a resource.
URIGoneException
- if the URI existed in the past but nothing is currently known about it.
URINotFoundException
- URI exists but there is no available output from this operation.
URIResolutionException
- If another problem prevents resolution of the URI.