Package 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

Modifier and Type	Method	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 - if database error

AuthorizeException - if authorization error

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:

IOException - if IO error

SQLException - if database error

AuthorizeException - if authorization error

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:

IOException - if IO error

SQLException - if database error

AuthorizeException - if authorization error

getBitstreamProvenanceMessage

String getBitstreamProvenanceMessage(Context context,
                                     Item myitem)
                              throws SQLException

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

Parameters:

context - context

myitem - the item to generate description for

Returns:

provenance description

Throws:

SQLException - if database error