com.sun.jbi.management.repository

Class ArchiveDownload

java.lang.Object

com.sun.jbi.management.repository.ArchiveDownload

All Implemented Interfaces:

ArchiveDownloadMBean

public class ArchiveDownload
extends Object
implements ArchiveDownloadMBean

Downloads archive bytes from the ESB repository.

Constructor Summary

Constructors

Constructor and Description
ArchiveDownload(ManagementContext ctx)

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	downloadBytes(Object id, int length) Download length bytes from an existing download session.
Object	getComponentArchiveId(String componentName) Returns the archive id of a component in the repository.
Object	getServiceAssemblyArchiveId(String saName) Returns the archive id of a service assembly in the repository.
Object	getSharedLibraryArchiveId(String sharedLibrayName) Returns the archive id of a shared library in the repository.
Object	initiateDownload(Object archiveId) Initiates the download of an archive identified by 'archiveId'.
Object	initiateRegistryDownload() Initiates the download of the DAS registry.
void	terminateAllDownloads()
void	terminateDownload(Object id) Used to indicate that a download session is complete.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ArchiveDownload

public ArchiveDownload(ManagementContext ctx)

Method Detail

getServiceAssemblyArchiveId

public Object getServiceAssemblyArchiveId(String saName)

Returns the archive id of a service assembly in the repository.

Specified by:

getServiceAssemblyArchiveId in interface ArchiveDownloadMBean

Parameters:

saName - name of the service assembly

Returns:

archive ID, or null if the service assembly does not exist in the repository.

getComponentArchiveId

public Object getComponentArchiveId(String componentName)

Returns the archive id of a component in the repository.

Specified by:

getComponentArchiveId in interface ArchiveDownloadMBean

Parameters:

componentName - name of the component

Returns:

archive ID, or null if the component does not exist in the repository.

getSharedLibraryArchiveId

public Object getSharedLibraryArchiveId(String sharedLibrayName)

Returns the archive id of a shared library in the repository.

Specified by:

getSharedLibraryArchiveId in interface ArchiveDownloadMBean

Parameters:

sharedLibrayName - name of the shared library

Returns:

archive ID, or null if the shared library does not exist in the repository.

initiateRegistryDownload

public Object initiateRegistryDownload()
                                throws IOException

Initiates the download of the DAS registry. This is a special purpose method due to the need to synchronize copying the registry while others may be writing to it.

Specified by:

initiateRegistryDownload in interface ArchiveDownloadMBean

Returns:

download session id

Throws:

IOException

initiateDownload

public Object initiateDownload(Object archiveId)
                        throws IOException

Initiates the download of an archive identified by 'archiveId'. In most situations, the archiveId will simply be the CAS-local path to the archive in the ESB repository. The path is checked to ensure that only files contains in the jbi install root can be copied. A relative path is prepended with the jbi install root. The returned Object is used as a session id for downloading the archive bytes with downloadBytes().

Specified by:

initiateDownload in interface ArchiveDownloadMBean

Returns:

download session id

Throws:

IOException

downloadBytes

public byte[] downloadBytes(Object id,
                   int length)
                     throws IOException

Download length bytes from an existing download session.

Specified by:

downloadBytes in interface ArchiveDownloadMBean

Returns:

a byte array of the specified length. If the remaining bytes in the session <= length, the byte array is sized appropriately. If all bytes have been downloaded, the returned array length is 0.

Throws:

IOException

terminateDownload

public void terminateDownload(Object id)
                       throws IOException

Used to indicate that a download session is complete.

Specified by:

terminateDownload in interface ArchiveDownloadMBean

Throws:

IOException

terminateAllDownloads

public void terminateAllDownloads()