org.dspace.identifier.ezid

Class EZIDRequest

java.lang.Object

org.dspace.identifier.ezid.EZIDRequest

public class EZIDRequest
extends Object

A request to EZID concerning a given (or expected) identifier.

Author:

Mark H. Wood

Method Summary

Modifier and Type	Method and Description
EZIDResponse	create(String name, Map<String,String> metadata) Create an identifier with a given name.
EZIDResponse	delete(String name) Destroy a reserved identifier.
EZIDResponse	lookup(String name) Fetch the metadata bound to an identifier.
EZIDResponse	mint(Map<String,String> metadata) Ask EZID to create a unique identifier and return its name.
EZIDResponse	modify(String name, Map<String,String> metadata) Alter the metadata bound to an identifier.
EZIDResponse	withdraw(String name) Remove a public identifier from view.
EZIDResponse	withdraw(String name, String reason) Remove a public identifier from view, with a reason.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

lookup

public EZIDResponse lookup(String name)
                    throws IdentifierException,
                           IOException,
                           URISyntaxException

Fetch the metadata bound to an identifier.

Throws:

IdentifierException - if the response is error or body malformed.

IOException - if the HTTP request fails.

URISyntaxException

create

public EZIDResponse create(String name,
                           Map<String,String> metadata)
                    throws IOException,
                           IdentifierException,
                           URISyntaxException

Create an identifier with a given name. The name is the end of the request path. Note: to "reserve" a given identifier, include "_status = reserved" in metadata.

Parameters:

metadata - ANVL-encoded key/value pairs.

Returns:

Decoded response data evoked by a request made to EZID.

Throws:

IOException

IdentifierException

URISyntaxException

mint

public EZIDResponse mint(Map<String,String> metadata)
                  throws IOException,
                         IdentifierException,
                         URISyntaxException

Ask EZID to create a unique identifier and return its name. NOTE: to "reserve" a unique identifier, include "_status = reserved" in metadata.

Parameters:

metadata - ANVL-encoded key/value pairs.

Returns:

Decoded response data evoked by a request made to EZID.

Throws:

IOException

IdentifierException

URISyntaxException

modify

public EZIDResponse modify(String name,
                           Map<String,String> metadata)
                    throws IOException,
                           IdentifierException,
                           URISyntaxException

Alter the metadata bound to an identifier.

Parameters:

metadata - fields to be altered. Leave the value of a field's empty to delete the field.

Returns:

Decoded response data evoked by a request made to EZID.

Throws:

IOException

IdentifierException

URISyntaxException

delete

public EZIDResponse delete(String name)
                    throws IOException,
                           IdentifierException,
                           URISyntaxException

Destroy a reserved identifier. Fails if ID was ever public.

Throws:

IOException

IdentifierException

URISyntaxException

withdraw

public EZIDResponse withdraw(String name)
                      throws IOException,
                             IdentifierException,
                             URISyntaxException

Remove a public identifier from view.

Throws:

IOException

IdentifierException

URISyntaxException

withdraw

public EZIDResponse withdraw(String name,
                             String reason)
                      throws IOException,
                             IdentifierException,
                             URISyntaxException

Remove a public identifier from view, with a reason.

Parameters:

reason - annotation for the item's unavailability.

Throws:

IOException

IdentifierException

URISyntaxException