public abstract class MetadataRevisionNoteDescriptor
extends java.lang.Object
MetadataRevisionNoteURI
.Modifier and Type | Class and Description |
---|---|
static class |
MetadataRevisionNoteDescriptor.ResourceDescription
The description of a resource identified by a
MetadataRevisionNoteURI . |
Constructor and Description |
---|
MetadataRevisionNoteDescriptor() |
Modifier and Type | Method and Description |
---|---|
abstract MetadataRevisionNoteDescriptor.ResourceDescription |
getResourceDescription(MetadataRevisionNoteURI uri)
Returns the description of the resource identified by a
MetadataRevisionNoteURI or null if this service
cannot resolve the URI. |
static java.util.ServiceLoader<MetadataRevisionNoteDescriptor> |
newServiceLoader()
Creates a new loader for iterating through all available providers found
by the context classloader.
|
static MetadataRevisionNoteDescriptor.ResourceDescription |
resolve(java.util.Iterator<MetadataRevisionNoteDescriptor> iterator,
MetadataRevisionNoteURI uri)
Resolves a
MetadataRevisionNoteURI object using a list of
MetadataRevisionNoteDescriptor s. |
static MetadataRevisionNoteDescriptor.ResourceDescription |
resolve(MetadataRevisionNoteURI uri)
Resolves a
MetadataRevisionNoteURI URI using a new
ServiceLoader object. |
public abstract MetadataRevisionNoteDescriptor.ResourceDescription getResourceDescription(MetadataRevisionNoteURI uri)
MetadataRevisionNoteURI
or null
if this service
cannot resolve the URI.uri
- the URI that identifies a resource associated with a metadata
revisionnull
if this service cannot resolve the give URIpublic static java.util.ServiceLoader<MetadataRevisionNoteDescriptor> newServiceLoader()
java.util.ServiceLoader
instance for this class. Clients
that need to resolve a list of MetadataRevisionNoteURI
objects are recommended to create a loader only once and call
resolve(Iterator, MetadataRevisionNoteURI)
with a new
iterator each time to improve performance.public static MetadataRevisionNoteDescriptor.ResourceDescription resolve(java.util.Iterator<MetadataRevisionNoteDescriptor> iterator, MetadataRevisionNoteURI uri)
MetadataRevisionNoteURI
object using a list of
MetadataRevisionNoteDescriptor
s. This method first consults
MetadataRevisionSupport
to see if a non-null
ResourceDescription
can be obtained; if so, the non-null
ResourceDescription
is returned immediately. If not, the
first non-null ResourceDescription
returned by a
MetadataRevisionNoteDescriptor
from the iterator is returned.
If none of the MetadataRevisionNoteDescriptor
s can resolve
the given URI, a default ResourceDescription
whose subject
is the String representation of the URI is returned.iterator
- the list of MetadataRevisionNoteDescriptor
suri
- the URI to be resolvedResourceDescription
from
MetadataRevisionSupport
, the iterator or the default
ResourceDescription
whose subject is the String
representation of the URI. This method never returns null.public static MetadataRevisionNoteDescriptor.ResourceDescription resolve(MetadataRevisionNoteURI uri)
MetadataRevisionNoteURI
URI using a new
ServiceLoader
object. Clients should avoid using this method
for resolution of multiple URIs to avoid the overhead of reloading the
service providers each time.uri
- the URI to be resolvednewServiceLoader()
,
resolve(Iterator, MetadataRevisionNoteURI)