org.freecompany.brimstone.core
Interface ResolverService.I2L

All Superinterfaces:
ResolverService
All Known Subinterfaces:
Resolver
All Known Implementing Classes:
DefaultResolver
Enclosing interface:
ResolverService

public static interface ResolverService.I2L
extends ResolverService

Identifier to Locator service.


Nested Class Summary
 
Nested classes/interfaces inherited from interface org.freecompany.brimstone.core.ResolverService
ResolverService.I2C, ResolverService.I2Cs, ResolverService.I2L, ResolverService.I2Ls, ResolverService.I2N, ResolverService.I2Ns, ResolverService.I2R, ResolverService.I2Rs, ResolverService.IeqI
 
Method Summary
 java.net.URI getURL(java.net.URI uri)
          Translate the given URI to a locator (URL) for the resource.
 
Methods inherited from interface org.freecompany.brimstone.core.ResolverService
local, resolvable
 

Method Detail

getURL

java.net.URI getURL(java.net.URI uri)
                    throws URIResolutionException
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.