Interface ArchiveClient

  • All Known Implementing Classes:
    InfoArchiveRestClient

    public interface ArchiveClient
    Client that interacts with an Archive.
    • Method Detail

      • ingest

        java.lang.String ingest​(java.io.InputStream sip)
                         throws java.io.IOException
        Ingest a Submission Information Package (SIP) into the Archive.
        Parameters:
        sip - The SIP to add to the Archive
        Returns:
        The ID of the Archival Information Package (AIP) that was generated from the SIP
        Throws:
        java.io.IOException - When an I/O error occurs
      • ingestDirect

        java.lang.String ingestDirect​(java.io.InputStream sip)
                               throws java.io.IOException
        Ingest a Submission Information Package (SIP) into the Archive. Will take advantage of the ingestDirect resource if present, otherwise will revert to receive + ingest. Note: only works if synchronous commit is enabled on the holding and the SIP being ingested is NOT part of a multi-SIP DSS.
        Parameters:
        sip - The SIP to add to the Archive
        Returns:
        The ID of the Archival Information Package (AIP) that was generated from the SIP
        Throws:
        java.io.IOException - When an I/O error occurs
      • fetchContent

        @Deprecated
        ContentResult fetchContent​(java.lang.String contentId)
                            throws java.io.IOException
        Deprecated.
        Will be removed without replacement in a future version
        Fetch the content for the specified content id.
        Parameters:
        contentId - The id of the content to fetch.
        Returns:
        A ContentResult
        Throws:
        java.io.IOException - When an I/O error occurs
      • fetchOrderContent

        @Deprecated
        ContentResult fetchOrderContent​(OrderItem orderItem)
                                 throws java.io.IOException
        Deprecated.
        Will be removed without replacement in a future version
        Fetch the content for the specified order item.
        Parameters:
        orderItem - The order item.
        Returns:
        A ContentResult
        Throws:
        java.io.IOException - When an I/O error occurs
      • search

        SearchResults search​(SearchQuery searchQuery,
                             SearchComposition searchComposition)
                      throws java.io.IOException
        Get the search results for the specified search query and composition.
        Parameters:
        searchQuery - The search query.
        searchComposition - The search composition.
        Returns:
        A SearchResults
        Throws:
        java.io.IOException - When an I/O error occurs
      • export

        OrderItem export​(SearchResults searchResults,
                         ExportConfiguration exportConfiguration,
                         java.lang.String outputName)
                  throws java.io.IOException
        Start the export of the search results for the specified export configuration.
        Parameters:
        searchResults - The search results.
        exportConfiguration - The export configuration.
        outputName - The output name of result package.
        Returns:
        An OrderItem object that contains information about exported package without link to download it
        Throws:
        java.io.IOException - When an I/O error occurs
      • exportAndWaitForDownloadLink

        OrderItem exportAndWaitForDownloadLink​(SearchResults searchResults,
                                               ExportConfiguration exportConfiguration,
                                               java.lang.String outputName,
                                               java.util.concurrent.TimeUnit timeUnit,
                                               long timeOut)
                                        throws java.io.IOException
        Start and wait the export of the search results for the specified export configuration.
        Parameters:
        searchResults - The search results.
        exportConfiguration - The export configuration.
        outputName - The output name of result package.
        timeUnit - The unit of the timeOut value
        timeOut - The time out of export process
        Returns:
        An OrderItem object that contains information about exported package and link to download it
        Throws:
        java.io.IOException - When an I/O error occurs
      • uploadTransformation

        @Deprecated
        LinkContainer uploadTransformation​(ExportTransformation exportTransformation,
                                           java.io.InputStream zip)
                                    throws java.io.IOException
        Deprecated.
        Use declarative configuration to define transformations
        Upload the transformation zip with the stylesheet into Archive.
        Parameters:
        exportTransformation - The export transformation.
        zip - The input stream of zip with stylesheet.
        Returns:
        The uploaded transformation
        Throws:
        java.io.IOException - When an I/O error occurs