org.dspace.content

Class InstallItem

java.lang.Object

org.dspace.content.InstallItem

public class InstallItem
extends Object

Support to install an Item in the archive.

Version:

$Revision$

Author:

dstuve

Constructor Summary

Constructors

Constructor and Description
InstallItem()

Method Summary

Methods

Modifier and Type	Method and Description
static String	getBitstreamProvenanceMessage(Item myitem) Generate provenance-worthy description of the bitstreams contained in an item.
static Item	installItem(Context c, InProgressSubmission is) Take an InProgressSubmission and turn it into a fully-archived Item, creating a new Handle.
static Item	installItem(Context c, InProgressSubmission is, String suppliedHandle) Take an InProgressSubmission and turn it into a fully-archived Item.
static Item	restoreItem(Context c, InProgressSubmission is, String suppliedHandle) Turn an InProgressSubmission into a fully-archived Item, for a "restore" operation such as ingestion of an AIP to recreate an archive.

Methods inherited from class java.lang.Object

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

Constructor Detail

InstallItem

public InstallItem()

Method Detail

installItem

public static Item installItem(Context c,
               InProgressSubmission is)
                        throws SQLException,
                               IOException,
                               AuthorizeException

Take an InProgressSubmission and turn it into a fully-archived Item, creating a new Handle.

Parameters:

c - DSpace Context

is - submission to install

Returns:

the fully archived Item

Throws:

SQLException

IOException

AuthorizeException

installItem

public static Item installItem(Context c,
               InProgressSubmission is,
               String suppliedHandle)
                        throws SQLException,
                               IOException,
                               AuthorizeException

Take an InProgressSubmission and turn it into a fully-archived Item.

Parameters:

c - current context

is - submission to install

suppliedHandle - the existing Handle to give to the installed item

Returns:

the fully archived Item

Throws:

SQLException

IOException

AuthorizeException

restoreItem

public static Item restoreItem(Context c,
               InProgressSubmission is,
               String suppliedHandle)
                        throws SQLException,
                               IOException,
                               AuthorizeException

Turn an InProgressSubmission into a fully-archived Item, for a "restore" operation such as ingestion of an AIP to recreate an archive. This does NOT add any descriptive metadata (e.g. for provenance) to preserve the transparency of the ingest. The ingest mechanism is assumed to have set all relevant technical and administrative metadata fields.

Parameters:

c - current context

is - submission to install

suppliedHandle - the existing Handle to give the installed item, or null to create a new one.

Returns:

the fully archived Item

Throws:

SQLException

IOException

AuthorizeException

getBitstreamProvenanceMessage

public static String getBitstreamProvenanceMessage(Item myitem)
                                            throws SQLException

Generate provenance-worthy description of the bitstreams contained in an item.

Parameters:

myitem - the item to generate description for

Returns:

provenance description

Throws:

SQLException