org.dspace.identifier

Class DOI

java.lang.Object

org.dspace.identifier.DOI

All Implemented Interfaces:

Identifier

public class DOI
extends java.lang.Object
implements Identifier

DOI identifiers.

Author:

Pascal-Nicolas Becker

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	RESOLVER
static java.lang.String	SCHEME

Constructor Summary

Constructors

Constructor and Description
DOI()

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	DOIFromExternalFormat(java.lang.String identifier)
static java.lang.String	DOIToExternalForm(java.lang.String identifier) This method helps to convert a DOI into a URL.
static java.lang.String	formatIdentifier(java.lang.String identifier) Recognize format of DOI and return it with leading doi-Scheme.

Methods inherited from class java.lang.Object

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

Field Detail

SCHEME

public static final java.lang.String SCHEME

See Also:

Constant Field Values

RESOLVER

public static final java.lang.String RESOLVER

See Also:

Constant Field Values

Constructor Detail

DOI

public DOI()

Method Detail

DOIToExternalForm

public static java.lang.String DOIToExternalForm(java.lang.String identifier)
                                          throws IdentifierException

This method helps to convert a DOI into a URL. It takes DOIs in one of the following formats and returns it as URL (f.e. http://dx.doi.org/10.123/456). Allowed formats are:

• doi:10.123/456
• 10.123/456
• http://dx.doi.org/10.123/456

Parameters:

identifier - A DOI that should be returned in external form.

Returns:

A String containing a URL to the official DOI resolver.

Throws:

java.lang.IllegalArgumentException - If identifier is null or an empty String.

IdentifierException - If identifier could not be recognized as valid DOI.

DOIFromExternalFormat

public static java.lang.String DOIFromExternalFormat(java.lang.String identifier)
                                              throws DOIIdentifierException

Throws:

DOIIdentifierException

formatIdentifier

public static java.lang.String formatIdentifier(java.lang.String identifier)
                                         throws DOIIdentifierException

Recognize format of DOI and return it with leading doi-Scheme.

Parameters:

identifier - Identifier to format, following format are accepted: f.e. 10.123/456, doi:10.123/456, http://dx.doi.org/10.123/456.

Returns:

Given Identifier with DOI-Scheme, f.e. doi:10.123/456.

Throws:

java.lang.IllegalArgumentException - If identifier is empty or null.

DOIIdentifierException - If DOI could not be recognized.