org.dspace.content.service

Interface InstallItemService

All Known Implementing Classes:

InstallItemServiceImpl

public interface InstallItemService

Support to install an Item in the archive.

Version:

$Revision$

Author:

dstuve

Method Summary

Methods

Modifier and Type	Method and Description
String	getBitstreamProvenanceMessage(Context context, Item myitem) Generate provenance-worthy description of the bitstreams contained in an item.
Item	installItem(Context context, InProgressSubmission is) Take an InProgressSubmission and turn it into a fully-archived Item, creating a new Handle.
Item	installItem(Context c, InProgressSubmission is, String suppliedHandle) Take an InProgressSubmission and turn it into a fully-archived Item.
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.

Method Detail

installItem

Item installItem(Context context,
               InProgressSubmission is)
                 throws SQLException,
                        AuthorizeException

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

Parameters:

context - DSpace Context

is - submission to install

Returns:

the fully archived Item

Throws:

SQLException

AuthorizeException

installItem

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

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

String getBitstreamProvenanceMessage(Context context,
                                   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