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
MetadataRevisionNoteDescriptors. |
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
MetadataRevisionNoteDescriptors. 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 MetadataRevisionNoteDescriptors can resolve
the given URI, a default ResourceDescription whose subject
is the String representation of the URI is returned.iterator - the list of MetadataRevisionNoteDescriptorsuri - 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)