Interface InstallItemService

All Known Implementing Classes:
InstallItemServiceImpl

public interface InstallItemService
Support to install an Item in the archive.
Version:
$Revision$
Author:
dstuve
  • Method Details

    • installItem

      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
    • getSubmittedByProvenanceMessage

      String getSubmittedByProvenanceMessage(Context context, Item item) throws SQLException
      Generate provenance description of direct item submission (not through workflow).
      Parameters:
      context - context
      item - the item to generate description for
      Returns:
      provenance description
      Throws:
      SQLException - if database error