org.freecompany.brimstone.core
Interface ResolverService.IeqI

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

public static interface ResolverService.IeqI
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.lang.Boolean equal(java.net.URI u1, java.net.URI u2)
          Test whether two URIs identify the same resource.
 
Methods inherited from interface org.freecompany.brimstone.core.ResolverService
local, resolvable
 

Method Detail

equal

java.lang.Boolean equal(java.net.URI u1,
                        java.net.URI u2)
                        throws URIResolutionException
Test whether two URIs identify the same resource.

Note that this is a more extensive test than URI#equals(). If the service reports two URIs to be equal, then they are definitively known to refer to the same resource - even if they differ syntactically. If the operation returns null, then the service cannot definitively test the equality of the URIs.

Parameters:
u1 - a URI to compare
u2 - another URI to compare
Returns:
Boolean.TRUE if the two URIs are definitively known to refer to the same resource. Boolean.FALSE if the two URIs are known to refer to different resources. null if the URIs cannot be compared by the service.
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.