org.dspace.administer

Class DCType

java.lang.Object

org.dspace.administer.DCType

Deprecated.

public class DCType
extends java.lang.Object

Class representing a particular Dublin Core metadata type, with various utility methods. In general, only used for manipulating the registry of Dublin Core types in the system, so most users will not need this.

The DCType implementation has been deprecated, please use MetadataManager, MetadataSchema and MetadataField instead. For backward compatibility the this implementation has been updated to transparently call the new classes.

Version:

$Revision$

Author:

Robert Tansley, Martin Hald

Constructor Summary

Constructors

Constructor and Description
DCType(Context context) Deprecated.
DCType(Context context, MetadataField field) Deprecated.

Method Summary

Methods

Modifier and Type	Method and Description
static DCType	create(Context context) Deprecated.
void	delete() Deprecated.
static DCType	find(Context context, int id) Deprecated.
static DCType[]	findAll(Context context) Deprecated.
static DCType	findByElement(Context context, java.lang.String element, java.lang.String qualifier) Deprecated.
java.lang.String	getElement() Deprecated. Get the DC element
int	getID() Deprecated. Get the internal identifier of this metadata field
java.lang.String	getQualifier() Deprecated. Get the DC qualifier, if any.
java.lang.String	getScopeNote() Deprecated. Get the scope note - information about the DC type and its use
static java.lang.String[]	quickFind(Context context, int id) Deprecated.
void	setElement(java.lang.String s) Deprecated. Set the DC element
void	setQualifier(java.lang.String s) Deprecated. Set the DC qualifier
void	setScopeNote(java.lang.String s) Deprecated. Set the scope note
void	update() Deprecated.

Methods inherited from class java.lang.Object

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

Constructor Detail

DCType

public DCType(Context context,
      MetadataField field)

Deprecated.

Create a DCType from an existing metadata field.

Parameters:

context -

field -

DCType

public DCType(Context context)

Deprecated.

Default constructor.

Parameters:

context -

Method Detail

quickFind

public static java.lang.String[] quickFind(Context context,
                           int id)
                                    throws java.sql.SQLException

Deprecated.

Utility method for quick access to an element and qualifier given the type ID.

Parameters:

context - context, in case DC types need to be read in from DB

id - the DC type ID

Returns:

a two-String array, string 0 is the element, string 1 is the qualifier

Throws:

java.sql.SQLException

find

public static DCType find(Context context,
          int id)
                   throws java.sql.SQLException

Deprecated.

Get a metadata field from the database.

Parameters:

context - DSpace context object

id - ID of the dublin core type

Returns:

the metadata field, or null if the ID is invalid.

Throws:

java.sql.SQLException

findByElement

public static DCType findByElement(Context context,
                   java.lang.String element,
                   java.lang.String qualifier)
                            throws java.sql.SQLException,
                                   AuthorizeException

Deprecated.

Find a given Dublin Core type. Returns null if the Dublin Core type doesn't exist.

Parameters:

context - the DSpace context to use

element - the element to find

qualifier - the qualifier, or null to find an unqualified type

Returns:

the Dublin Core type, or null if there isn't a corresponding type in the registry

Throws:

AuthorizeException

java.sql.SQLException

findAll

public static DCType[] findAll(Context context)
                        throws java.sql.SQLException

Deprecated.

Retrieve all Dublin Core types from the registry

Returns:

an array of all the Dublin Core types

Throws:

java.sql.SQLException

create

public static DCType create(Context context)
                     throws java.sql.SQLException,
                            AuthorizeException,
                            java.io.IOException,
                            NonUniqueMetadataException

Deprecated.

Create a new Dublin Core type

Parameters:

context - DSpace context object

Returns:

the newly created DCType

Throws:

NonUniqueMetadataException

java.io.IOException

java.sql.SQLException

AuthorizeException

delete

public void delete()
            throws java.sql.SQLException,
                   AuthorizeException

Deprecated.

Delete this DC type. This won't work if there are any DC values in the database of this type - they need to be updated first. An SQLException (referential integrity violation) will be thrown in this case.

Throws:

java.sql.SQLException

AuthorizeException

getID

public int getID()

Deprecated.

Get the internal identifier of this metadata field

Returns:

the internal identifier

getElement

public java.lang.String getElement()

Deprecated.

Get the DC element

Returns:

the element

setElement

public void setElement(java.lang.String s)

Deprecated.

Set the DC element

Parameters:

s - the new element

getQualifier

public java.lang.String getQualifier()

Deprecated.

Get the DC qualifier, if any.

Returns:

the DC qualifier, or null if this is an unqualified element

setQualifier

public void setQualifier(java.lang.String s)

Deprecated.

Set the DC qualifier

Parameters:

s - the DC qualifier, or null if this is an unqualified element

getScopeNote

public java.lang.String getScopeNote()

Deprecated.

Get the scope note - information about the DC type and its use

Returns:

the scope note

setScopeNote

public void setScopeNote(java.lang.String s)

Deprecated.

Set the scope note

Parameters:

s - the new scope note

update

public void update()
            throws java.sql.SQLException,
                   AuthorizeException,
                   NonUniqueMetadataException,
                   java.io.IOException

Deprecated.

Update the dublin core registry

Throws:

java.io.IOException

NonUniqueMetadataException

java.sql.SQLException

AuthorizeException