org.freecompany.brimstone.core
Interface ResolverService.I2Ls

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

public static interface ResolverService.I2Ls
extends ResolverService


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.util.List<java.net.URI> getURLs(java.net.URI uri)
          Translate the given URI to a list of locators for the resource.
 
Methods inherited from interface org.freecompany.brimstone.core.ResolverService
local, resolvable
 

Method Detail

getURLs

java.util.List<java.net.URI> getURLs(java.net.URI uri)
                                     throws URIResolutionException
Translate the given URI to a list of locators for the resource.

Note that not all of the returned locators need work. If a resolver knows a list of locations that, if they exist would have the resource, it may return the corresponding locators. This differs from ResolverService.I2L, which shouldn't return a locator that "might" refer to the resource.

Parameters:
uri - the URI to resolve.
Returns:
a list of locators for the resource identified by the URI, or null if no locators are known.
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.