org.archive.uid

Interface RecordIDGenerator

All Known Implementing Classes:

UUIDGenerator

public interface RecordIDGenerator

A record-id generator.

Version:

$Revision$ $Date$

Method Summary

Modifier and Type	Method and Description
java.net.URI	getQualifiedRecordID(java.util.Map<java.lang.String,java.lang.String> qualifiers)
java.net.URI	getQualifiedRecordID(java.lang.String key, java.lang.String value)
java.net.URI	getRecordID()
java.net.URI	qualifyRecordID(java.net.URI recordId, java.util.Map<java.lang.String,java.lang.String> qualifiers) Append (or if already present, update) qualifiers to passed recordId.

Method Detail

getRecordID

java.net.URI getRecordID()

Returns:

A URI that can serve as a record-id.

Throws:

java.net.URISyntaxException

getQualifiedRecordID

java.net.URI getQualifiedRecordID(java.util.Map<java.lang.String,java.lang.String> qualifiers)

Parameters:

qualifiers - Qualifiers to add.

Returns:

A URI qualified with passed qualifiers that can serve as a record-id, or, a new, unique record-id without qualifiers (if qualifiers not easily implemented using passed URI scheme).

getQualifiedRecordID

java.net.URI getQualifiedRecordID(java.lang.String key,
                                  java.lang.String value)

Parameters:

key - Name of qualifier

value - Value of qualifier

Returns:

A URI qualified with passed qualifiers that can serve as a record-id, or, a new, unique record-id without qualifiers (if qualifiers not easily implemented using passed URI scheme).

qualifyRecordID

java.net.URI qualifyRecordID(java.net.URI recordId,
                             java.util.Map<java.lang.String,java.lang.String> qualifiers)

Append (or if already present, update) qualifiers to passed recordId. Use with caution. Guard against turning up a result that already exists. Use when writing a group of records inside a single transaction. How qualifiers are appended/updated varies with URI scheme. Its allowed that an invocation of this method does nought but call getRecordID(), returning a new URI unrelated to the passed recordId and passed qualifier.

Parameters:

recordId - URI to append qualifier to.

qualifiers - Map of qualifier values keyed by qualifier name.

Returns:

New URI based off passed uri and passed qualifier.