org.nuxeo.ecm.platform.io.api
Interface IOManager

All Superinterfaces:

Serializable

All Known Subinterfaces:

IOManagerLocal, IOManagerRemote

All Known Implementing Classes:

IOManagerBean, IOManagerImpl

public interface IOManager
extends Serializable

Service handling complex import/export of documents and associated resources.

Author:

Anahide Tchertchian

Field Summary

static String

DOCUMENTS_ADAPTER_NAME

Method Summary

void	addAdapter(String name, IOResourceAdapter adapter) Adds an adapter with given name and definition.
Collection<DocumentRef>	copyDocumentsAndResources(String repo, Collection<DocumentRef> sources, DocumentLocation targetLocation, Collection<String> ioAdapters) Copy documents and resources to another location (on a same machine).
void	copyDocumentsAndResources(String repo, Collection<DocumentRef> sources, IOManager remoteIOManager, DocumentLocation targetLocation, Collection<String> ioAdapters) Remote copy.
void	copyDocumentsAndResources(String repo, Collection<DocumentRef> sources, String serverAddress, int jndiPort, DocumentLocation targetLocation, Collection<String> ioAdapters) Remote copy.
void	copyDocumentsAndResources(String repo, Collection<DocumentRef> sources, String serverAddress, int jndiPort, DocumentLocation targetLocation, String docReaderFactoryClassName, Map<String,Object> rFactoryParams, String docWriterFactoryClassName, Map<String,Object> wFactoryParams, Collection<String> ioAdapters) Copy documents and resources associated with the given sources from the local repository to a remote repository instance (available on a machine with the given serverAddress).
void	disposeExport(String uri)
void	exportDocumentsAndResources(OutputStream out, String repo, Collection<DocumentRef> sources, boolean recurse, String format, Collection<String> ioAdapters) Export documents and resources.
String	externalizeExport(String repo, Collection<DocumentRef> sources, String docReaderFactoryName, Map<String,Object> readerFactoryParams, Collection<String> ioAdapters)
IOResourceAdapter	getAdapter(String name) Returns the adapter with given name.
void	importDocumentsAndResources(InputStream in, String repo, DocumentRef root) Import document and resources described by given input stream at given document location.
void	importExportedFile(String uri, DocumentLocation targetLocation) Will be called after a successful export to import data from the file.
void	importExportedFile(String uri, DocumentLocation targetLocation, String docWriterFactoryClassName, Map<String,Object> wFactoryParams) Will be called after a successful export to import data from the file.
void	removeAdapter(String name) Removes adapter with given name.

Field Detail

DOCUMENTS_ADAPTER_NAME

static final String DOCUMENTS_ADAPTER_NAME

See Also:

Constant Field Values

Method Detail

getAdapter

IOResourceAdapter getAdapter(String name)
                             throws ClientException

Returns the adapter with given name.

Throws:

ClientException

addAdapter

void addAdapter(String name,
                IOResourceAdapter adapter)
                throws ClientException

Adds an adapter with given name and definition.

Throws:

ClientException

removeAdapter

void removeAdapter(String name)
                   throws ClientException

Removes adapter with given name.

Throws:

ClientException

importDocumentsAndResources

void importDocumentsAndResources(InputStream in,
                                 String repo,
                                 DocumentRef root)
                                 throws IOException,
                                        ClientException,
                                        ImportDocumentException

Import document and resources described by given input stream at given document location.

Parameters:

in - stream representing the documents and resources to import. Can be a zip file of a group of export files. The service is responsible for unzipping and redirecting import to specific import services.

repo - the repository name.

root - Optional location of document that must be taken as root of the import (can be null).

Throws:

IOException

ClientException

ImportDocumentException - TODO

exportDocumentsAndResources

void exportDocumentsAndResources(OutputStream out,
                                 String repo,
                                 Collection<DocumentRef> sources,
                                 boolean recurse,
                                 String format,
                                 Collection<String> ioAdapters)
                                 throws IOException,
                                        ClientException,
                                        ExportDocumentException

Export documents and resources.

Parameters:

repo - TODO

sources - locations of documents to export.

recurse - recurse into sources children

format - export format. XXX see what format is actually accepted.

ioAdapters - list of adapters to use for additional resources.

stream - that can be turned into a zip holding a group of file for each additional resources types.

Throws:

IOException

ClientException

ExportDocumentException - TODO

copyDocumentsAndResources

Collection<DocumentRef> copyDocumentsAndResources(String repo,
                                                  Collection<DocumentRef> sources,
                                                  DocumentLocation targetLocation,
                                                  Collection<String> ioAdapters)
                                                  throws ClientException

Copy documents and resources to another location (on a same machine).

Parameters:

repo - the initial repository name.

sources - locations of documents to export.

targetLocation - location of the document where copies must be placed.

ioAdapters - list of adapters to use for additional resources.

Returns:

the list of copied documents references.

Throws:

ClientException

copyDocumentsAndResources

void copyDocumentsAndResources(String repo,
                               Collection<DocumentRef> sources,
                               String serverAddress,
                               int jndiPort,
                               DocumentLocation targetLocation,
                               Collection<String> ioAdapters)
                               throws ClientException

Remote copy. Copy documents and resources to another location.

Parameters:

sourceLocation -

uri -

targetLocation -

Throws:

ClientException

copyDocumentsAndResources

void copyDocumentsAndResources(String repo,
                               Collection<DocumentRef> sources,
                               IOManager remoteIOManager,
                               DocumentLocation targetLocation,
                               Collection<String> ioAdapters)
                               throws ClientException

Remote copy. Copy documents and resources to another location.

Parameters:

sourceLocation -

uri -

targetLocation -

Throws:

ClientException

copyDocumentsAndResources

void copyDocumentsAndResources(String repo,
                               Collection<DocumentRef> sources,
                               String serverAddress,
                               int jndiPort,
                               DocumentLocation targetLocation,
                               String docReaderFactoryClassName,
                               Map<String,Object> rFactoryParams,
                               String docWriterFactoryClassName,
                               Map<String,Object> wFactoryParams,
                               Collection<String> ioAdapters)
                               throws ClientException

Copy documents and resources associated with the given sources from the local repository to a remote repository instance (available on a machine with the given serverAddress). Also if there are custom DocumentReader and DocumentWriter classes that should be used when externalizing documents and/or when re-creating them at the remote location, they could be created through specific factory classes (specified as class names). These factory classes are instantiated and provided with the given factoryParams in order to build custom DocumentReader or DocumentWriter objects.

Parameters:

repo -

sources -

serverAddress -

jndiPort -

targetLocation -

docReaderFactoryName - classname for a DocumentReaderFactory custom implementation

rFactoryParams - params to be given to custom DocumentReaderFactory to create DocumentReader

docWriterFactoryName - classname for a DocumentWriterFactory custom implementation

wFactoryParams - params to be given to custom DocumentWriterFactory to create DocumentWriter

ioAdapters -

Throws:

ClientException

externalizeExport

String externalizeExport(String repo,
                         Collection<DocumentRef> sources,
                         String docReaderFactoryName,
                         Map<String,Object> readerFactoryParams,
                         Collection<String> ioAdapters)
                         throws ClientException

Throws:

ClientException

disposeExport

void disposeExport(String uri)
                   throws ClientException

Throws:

ClientException

importExportedFile

void importExportedFile(String uri,
                        DocumentLocation targetLocation)
                        throws ClientException

Will be called after a successful export to import data from the file.

Parameters:

uri -

targetLocation -

Throws:

ClientException

importExportedFile

void importExportedFile(String uri,
                        DocumentLocation targetLocation,
                        String docWriterFactoryClassName,
                        Map<String,Object> wFactoryParams)
                        throws ClientException

Will be called after a successful export to import data from the file.

Parameters:

uri -

targetLocation -

docWriterFactoryName -

wFactoryParams -

Throws:

ClientException