org.dspace.handle

Class HandleServiceImpl

java.lang.Object

org.dspace.handle.HandleServiceImpl

All Implemented Interfaces:

HandleService

public class HandleServiceImpl
extends Object
implements HandleService

Interface to the CNRI Handle System .

Currently, this class simply maps handles to local facilities; handles which are owned by other sites (including other DSpaces) are treated as non-existent.

Version:

$Revision$

Author:

Peter Breton

Field Summary

Fields

Modifier and Type	Field and Description
protected HandleDAO	handleDAO
protected SiteService	siteService

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HandleServiceImpl() Public Constructor

Method Summary

Methods

Modifier and Type	Method and Description
long	countHandlesByPrefix(Context context, String prefix)
int	countTotal(Context context)
String	createHandle(Context context, DSpaceObject dso) Creates a new handle in the database.
String	createHandle(Context context, DSpaceObject dso, String suppliedHandle) Creates a handle entry, but with a handle supplied by the caller (new Handle not generated)
String	createHandle(Context context, DSpaceObject dso, String suppliedHandle, boolean force) Creates a handle entry, but with a handle supplied by the caller (new Handle not generated)
protected String	createId(int id) Create a new handle id.
String	findHandle(Context context, DSpaceObject dso) Return the handle for an Object, or null if the Object has no handle.
protected Handle	findHandleInternal(Context context, String handle) Find the database row corresponding to handle.
String	getCanonicalForm(String handle) Transforms handle into a URI using http://hdl.handle.net if not overridden by the configuration property handle.canonical.prefix.
List<String>	getHandlesForPrefix(Context context, String prefix) Return all the handles which start with prefix.
protected List<Handle>	getInternalHandles(Context context, DSpaceObject dso) Return the handle for an Object, or null if the Object has no handle.
String	getPrefix() Get the configured Handle prefix string, or a default
void	modifyHandleDSpaceObject(Context context, String handle, DSpaceObject newOwner)
DSpaceObject	resolveToObject(Context context, String handle) Return the object which handle maps to, or null.
String	resolveToURL(Context context, String handle) Return the local URL for handle, or null if handle cannot be found.
String	resolveUrlToHandle(Context context, String url) Try to detect a handle in a URL.
void	unbindHandle(Context context, DSpaceObject dso) Removes binding of Handle to a DSpace object, while leaving the Handle in the table so it doesn't get reallocated.
int	updateHandlesWithNewPrefix(Context context, String newPrefix, String oldPrefix)

Methods inherited from class java.lang.Object

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

Field Detail

handleDAO

@Autowired(required=true)
protected HandleDAO handleDAO

siteService

@Autowired
protected SiteService siteService

Constructor Detail

HandleServiceImpl

protected HandleServiceImpl()

Public Constructor

Method Detail

resolveToURL

public String resolveToURL(Context context,
                  String handle)
                    throws SQLException

Description copied from interface: HandleService

Return the local URL for handle, or null if handle cannot be found. The returned URL is a (non-handle-based) location where a dissemination of the object referred to by handle can be obtained.

Specified by:

resolveToURL in interface HandleService

Parameters:

context - DSpace context

handle - The handle

Returns:

The local URL

Throws:

SQLException - If a database error occurs

resolveUrlToHandle

public String resolveUrlToHandle(Context context,
                        String url)
                          throws SQLException

Description copied from interface: HandleService

Try to detect a handle in a URL.

Specified by:

resolveUrlToHandle in interface HandleService

Parameters:

context - DSpace context

url - The URL

Returns:

The handle or null if the handle couldn't be extracted of a URL or if the extracted handle couldn't be found.

Throws:

SQLException - If a database error occurs

getCanonicalForm

public String getCanonicalForm(String handle)

Description copied from interface: HandleService

Transforms handle into a URI using http://hdl.handle.net if not overridden by the configuration property handle.canonical.prefix. No attempt is made to verify that handle is in fact valid.

Specified by:

getCanonicalForm in interface HandleService

Parameters:

handle - The handle

Returns:

The canonical form

createHandle

public String createHandle(Context context,
                  DSpaceObject dso)
                    throws SQLException

Description copied from interface: HandleService

Creates a new handle in the database.

Specified by:

createHandle in interface HandleService

Parameters:

context - DSpace context

dso - The DSpaceObject to create a handle for

Returns:

The newly created handle

Throws:

SQLException - If a database error occurs

createHandle

public String createHandle(Context context,
                  DSpaceObject dso,
                  String suppliedHandle)
                    throws SQLException,
                           IllegalStateException

Description copied from interface: HandleService

Creates a handle entry, but with a handle supplied by the caller (new Handle not generated)

Specified by:

createHandle in interface HandleService

Parameters:

context - DSpace context

dso - DSpaceObject

suppliedHandle - existing handle value

Returns:

the Handle

Throws:

IllegalStateException - if specified handle is already in use by another object

SQLException

createHandle

public String createHandle(Context context,
                  DSpaceObject dso,
                  String suppliedHandle,
                  boolean force)
                    throws SQLException,
                           IllegalStateException

Description copied from interface: HandleService

Creates a handle entry, but with a handle supplied by the caller (new Handle not generated)

Specified by:

createHandle in interface HandleService

Parameters:

context - DSpace context

dso - DSpaceObject

suppliedHandle - existing handle value

Returns:

the Handle

Throws:

IllegalStateException - if specified handle is already in use by another object

SQLException

unbindHandle

public void unbindHandle(Context context,
                DSpaceObject dso)
                  throws SQLException

Description copied from interface: HandleService

Removes binding of Handle to a DSpace object, while leaving the Handle in the table so it doesn't get reallocated. The AIP implementation also needs it there for foreign key references.

Specified by:

unbindHandle in interface HandleService

Parameters:

context - DSpace context

dso - DSpaceObject whose Handle to unbind.

Throws:

SQLException

resolveToObject

public DSpaceObject resolveToObject(Context context,
                           String handle)
                             throws IllegalStateException,
                                    SQLException

Description copied from interface: HandleService

Return the object which handle maps to, or null. This is the object itself, not a URL which points to it.

Specified by:

resolveToObject in interface HandleService

Parameters:

context - DSpace context

handle - The handle to resolve

Returns:

The object which handle maps to, or null if handle is not mapped to any object.

Throws:

IllegalStateException - If handle was found but is not bound to an object

SQLException - If a database error occurs

findHandle

public String findHandle(Context context,
                DSpaceObject dso)
                  throws SQLException

Description copied from interface: HandleService

Return the handle for an Object, or null if the Object has no handle.

Specified by:

findHandle in interface HandleService

Parameters:

context - DSpace context

dso - The object to obtain a handle for

Returns:

The handle for object, or null if the object has no handle.

Throws:

SQLException - If a database error occurs

getHandlesForPrefix

public List<String> getHandlesForPrefix(Context context,
                               String prefix)
                                 throws SQLException

Description copied from interface: HandleService

Return all the handles which start with prefix.

Specified by:

getHandlesForPrefix in interface HandleService

Parameters:

context - DSpace context

prefix - The handle prefix

Returns:

A list of the handles starting with prefix. The list is guaranteed to be non-null. Each element of the list is a String.

Throws:

SQLException - If a database error occurs

getPrefix

public String getPrefix()

Description copied from interface: HandleService

Get the configured Handle prefix string, or a default

Specified by:

getPrefix in interface HandleService

Returns:

configured prefix or "123456789"

countHandlesByPrefix

public long countHandlesByPrefix(Context context,
                        String prefix)
                          throws SQLException

Specified by:

countHandlesByPrefix in interface HandleService

Throws:

SQLException

updateHandlesWithNewPrefix

public int updateHandlesWithNewPrefix(Context context,
                             String newPrefix,
                             String oldPrefix)
                               throws SQLException

Specified by:

updateHandlesWithNewPrefix in interface HandleService

Throws:

SQLException

modifyHandleDSpaceObject

public void modifyHandleDSpaceObject(Context context,
                            String handle,
                            DSpaceObject newOwner)
                              throws SQLException

Specified by:

modifyHandleDSpaceObject in interface HandleService

Throws:

SQLException

getInternalHandles

protected List<Handle> getInternalHandles(Context context,
                              DSpaceObject dso)
                                   throws SQLException

Return the handle for an Object, or null if the Object has no handle.

Parameters:

context - DSpace context

dso - DSpaceObject for which we require our handles

Returns:

The handle for object, or null if the object has no handle.

Throws:

SQLException - If a database error occurs

findHandleInternal

protected Handle findHandleInternal(Context context,
                        String handle)
                             throws SQLException

Find the database row corresponding to handle.

Parameters:

context - DSpace context

handle - The handle to resolve

Returns:

The database row corresponding to the handle

Throws:

SQLException - If a database error occurs

createId

protected String createId(int id)
                   throws SQLException

Create a new handle id. The implementation uses the PK of the RDBMS Handle table.

Returns:

A new handle id

Throws:

SQLException - If a database error occurs

countTotal

public int countTotal(Context context)
               throws SQLException

Specified by:

countTotal in interface HandleService

Throws:

SQLException