Package org.mycore.pi.doi.client.datacite

Class MCRDataciteClient

java.lang.Object

org.mycore.pi.doi.client.datacite.MCRDataciteClient

public class MCRDataciteClient
extends Object

Used for DOI registration.

1. use storeMetadata(Document) to store a datacite document (should include a MCRDigitalObjectIdentifier)
2. use mintDOI(MCRDigitalObjectIdentifier, URI) to "register" the MCRDigitalObjectIdentifier with a URI
3. use setMediaList(MCRDigitalObjectIdentifier, List) to add a list of mime-type URI pairs to a DOI

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DOI_REGISTER_REQUEST_TEMPLATE

Constructor Summary

Constructors

Constructor	Description
MCRDataciteClient(String host, String userName, String password)

Method Summary

Modifier and Type	Method	Description
void	deleteMetadata(MCRDigitalObjectIdentifier doi)
List<MCRDigitalObjectIdentifier>	getDOIList()
List<Map.Entry<String,URI>>	getMediaList(MCRDigitalObjectIdentifier doi)
void	mintDOI(MCRDigitalObjectIdentifier doi, URI url)
URI	resolveDOI(MCRDigitalObjectIdentifier doiParam)
Document	resolveMetadata(MCRDigitalObjectIdentifier doi)
void	setMediaList(MCRDigitalObjectIdentifier doi, List<Map.Entry<String,URI>> mediaList)
URI	storeMetadata(Document metadata)

Methods inherited from class java.lang.Object

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

Field Details

DOI_REGISTER_REQUEST_TEMPLATE

public static final String DOI_REGISTER_REQUEST_TEMPLATE

See Also:

• Constant Field Values

Constructor Details

MCRDataciteClient

public MCRDataciteClient(String host,
 String userName,
 String password)

Parameters:

host - the host (in most cases mds.datacite.org)

userName - the login username will be used in every method or null if no login should be used

password - the password

Method Details

getMediaList

public List<Map.Entry<String,URI>> getMediaList(MCRDigitalObjectIdentifier doi)
                                         throws MCRPersistentIdentifierException

Throws:

MCRPersistentIdentifierException

setMediaList

public void setMediaList(MCRDigitalObjectIdentifier doi,
 List<Map.Entry<String,URI>> mediaList)
                  throws MCRPersistentIdentifierException

Throws:

MCRPersistentIdentifierException

mintDOI

public void mintDOI(MCRDigitalObjectIdentifier doi,
 URI url)
             throws MCRPersistentIdentifierException

Throws:

MCRPersistentIdentifierException

getDOIList

public List<MCRDigitalObjectIdentifier> getDOIList()
                                            throws MCRPersistentIdentifierException

Throws:

MCRPersistentIdentifierException

resolveDOI

public URI resolveDOI(MCRDigitalObjectIdentifier doiParam)
               throws MCRPersistentIdentifierException

Throws:

MCRPersistentIdentifierException

resolveMetadata

public Document resolveMetadata(MCRDigitalObjectIdentifier doi)
                         throws MCRDatacenterAuthenticationException,
MCRIdentifierUnresolvableException,
JDOMException,
MCRDatacenterException

Parameters:

doi - the doi

Returns:

the resolved metadata of the doi

Throws:

MCRDatacenterAuthenticationException - if the authentication is wrong

MCRIdentifierUnresolvableException - if the doi is not valid or can not be resolved

JDOMException - if the metadata is empty or not a valid xml document

MCRDatacenterException - if there is something wrong with the communication with the datacenter

storeMetadata

public URI storeMetadata(Document metadata)
                  throws MCRPersistentIdentifierException

Throws:

MCRPersistentIdentifierException

deleteMetadata

public void deleteMetadata(MCRDigitalObjectIdentifier doi)
                    throws MCRPersistentIdentifierException

Throws:

MCRPersistentIdentifierException