Package org.alfresco.service.cmr.transfer

Interface TransferReceiver

All Known Implementing Classes:

RepoTransferReceiverImpl

public interface TransferReceiver

Author:

brian The server side Transfer Receiver.

Method Summary

Modifier and Type	Method	Description
void	cancel(String transferId)	Abort
void	commit(String transferId)	Commit
void	commitAsync(String transferId)	Commit asynchronously
void	end(String transferId)	Asks the receiver to end (and clean up) the specified transfer
void	generateRequsite(String transferId, OutputStream requsiteStream)	Write the requsite (the bits required to support the Manifest) to the output stream.
TransferProgressMonitor	getProgressMonitor()
File	getStagingFolder(String transferId)
TransferProgress	getStatus(String transferId)
NodeRef	getTempFolder(String transferId)
InputStream	getTransferReport(String transferId)	get the transfer report for the specified transfer
TransferVersion	getVersion()	Get the version that we are transfering to.
void	prepare(String transferId)	Prepare
void	saveContent(String transferId, String contentId, InputStream contentStream)	Save a content item
void	saveSnapshot(String transferId, InputStream snapshotStream)	Store the specified snapshot file into the transfer staging area.
void	setTransferRootNode(String rootFileSystem)	set the root node for the file system receiver
String	start(String fromRepositoryId, boolean allowTransferToSelf, TransferVersion fromVersion)	Asks the receiver to setup a new transfer.

Method Detail

getStagingFolder

File getStagingFolder(String transferId)

Parameters:

transferId - String

Returns:

File

getTempFolder

NodeRef getTempFolder(String transferId)

Parameters:

transferId - String

Returns:

NodeRef

start

String start(String fromRepositoryId,
             boolean allowTransferToSelf,
             TransferVersion fromVersion)
      throws TransferException

Asks the receiver to setup a new transfer.

Parameters:

fromRepositoryId - the repositoryId of the sending system

allowTransferToSelf - are transfers to the same repository allowed?

fromVersion - the version sending

Returns:

The identifier of the new transfer

Throws:

TransferException - if an error occurred while setting up the transfer

end

void end(String transferId)
  throws TransferException

Asks the receiver to end (and clean up) the specified transfer

Parameters:

transferId - The transfer to end

Throws:

TransferException - If the process of ending the transfer fails

saveSnapshot

void saveSnapshot(String transferId,
                  InputStream snapshotStream)
           throws TransferException

Store the specified snapshot file into the transfer staging area. The specified transfer must currently be the holder of the transfer lock, otherwise an exception is thrown. This operation does not close the supplied stream, so the caller must do it as appropriate. The caller should assume that the supplied stream has been fully read when this operation returns.

Parameters:

transferId - The identifier of the transfer with which this snapshot is associated

snapshotStream - The open stream that holds the snapshot file.

Throws:

TransferException - If an error occurs while saving the snapshot file.

saveContent

void saveContent(String transferId,
                 String contentId,
                 InputStream contentStream)
          throws TransferException

Save a content item

Parameters:

transferId - String

contentId - String

contentStream - InputStream

Throws:

TransferException

generateRequsite

void generateRequsite(String transferId,
                      OutputStream requsiteStream)
               throws TransferException

Write the requsite (the bits required to support the Manifest) to the output stream.

Parameters:

requsiteStream - an open stream to receive the requisite

Throws:

TransferException

prepare

void prepare(String transferId)
      throws TransferException

Prepare

Parameters:

transferId - String

Throws:

TransferException

cancel

void cancel(String transferId)
     throws TransferException

Abort

Parameters:

transferId - String

Throws:

TransferException

commitAsync

void commitAsync(String transferId)
          throws TransferException

Commit asynchronously

Parameters:

transferId - String

Throws:

TransferException

commit

void commit(String transferId)
     throws TransferException

Commit

Parameters:

transferId - String

Throws:

TransferException

getStatus

TransferProgress getStatus(String transferId)
                    throws TransferException

Parameters:

transferId - String

Returns:

the trabsfer progress

Throws:

TransferException

getVersion

TransferVersion getVersion()

Get the version that we are transfering to.

getProgressMonitor

TransferProgressMonitor getProgressMonitor()

Returns:

TransferProgressMonitor

getTransferReport

InputStream getTransferReport(String transferId)

get the transfer report for the specified transfer

Parameters:

transferId - String

setTransferRootNode

void setTransferRootNode(String rootFileSystem)

set the root node for the file system receiver

Parameters:

rootFileSystem - String