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.