com.bea.wli.config.task.impl

Class ExportTask

java.lang.Object

com.bea.wli.config.task.impl.SessionedTask<byte[]>

com.bea.wli.config.task.impl.ExportTask

All Implemented Interfaces:

java.util.concurrent.Callable<byte[]>

public class ExportTask
extends SessionedTask<byte[]>

Exports resources in the form of a jar file. Raw contents of the jar is returned.

Export can be done either at the resource level, or at the project level with different implications at import time.

Exportable references

• Resource-level: Project, Folder, Resource or Domain Reference can be specified. Projects, folders, and Domain Reference are expanded to include their resources in the export
• Project-level: Only Project references can be specified

Project/Folder properties

• Resource-level: Project and Folder properties (such as project description) are only exported for projects/folders if either them or their parents are explicitly specified in the export set
• Project-level: project and Folder properties are automatically exported for projects that are specified in the export set

Including depenencies

• Resource-level: Dependencies can be included in the exported jar file via a flag
• Project-level: dependencies cannot be automatically exported

Import behavior

• Resource-level: Import only causes updates or creations
• Project-level: Import can cause updates, creations, and deletions. A resource is deleted as a side effect of import if that resource exists in the domain, but not in the jar file

Import behavior

Method Summary

Modifier and Type	Method and Description
protected byte[]	_execute() Subclasses implement this method
static byte[]	exportProjectLevel(ConfigService configService, java.lang.String session, java.util.Collection<Ref> refs, EncryptionScope escope, char[] passphrase) export configuration at the project level
static byte[]	exportResourceLevel(ConfigService configService, java.lang.String session, java.util.Collection<Ref> refs, boolean includeDependencies, EncryptionScope escope, char[] passphrase) exports configuration at the resource level

Methods inherited from class com.bea.wli.config.task.impl.SessionedTask

assertExists, assertLocation, assertNONResource, assertNotExists, assertNotLocationData, assertNotNull, assertNotNullElement, assertResource, assertSimple, call, doExecute, doExecute, doExecute, doExecute, expand, getConfigContext, getConfigMBean, getConfigService, getDescription, getSession, isLocation, isReadOnlyTransaction, requiresSystemTransaction

Methods inherited from class java.lang.Object

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

Method Detail

exportProjectLevel

public static byte[] exportProjectLevel(ConfigService configService,
                                        java.lang.String session,
                                        java.util.Collection<Ref> refs,
                                        EncryptionScope escope,
                                        char[] passphrase)
                                 throws java.lang.Exception

export configuration at the project level

Parameters:

configService -

session - the session to export from

refs - set of project references to export

escope - the encryption scope. If null or EncryptionScope.NoEncryption no encryption is performed

passphrase - the passphrase

Throws:

java.lang.Exception

exportResourceLevel

public static byte[] exportResourceLevel(ConfigService configService,
                                         java.lang.String session,
                                         java.util.Collection<Ref> refs,
                                         boolean includeDependencies,
                                         EncryptionScope escope,
                                         char[] passphrase)
                                  throws java.lang.Exception

exports configuration at the resource level

Parameters:

configService -

session - the session to export from

refs - references to resources, folders, projects and/or Domain reference (See Ref.DOMAIN). If a folder, project or Domain reference is specified, all the resources under that location are exported, along with project and folder properties (e.g., project/folder description). The project and folder properties can also be exported directly by specifying the reference to the LocationData resource that contains these properties (See Ref.makeLocationDataRef(Ref)) Using a project reference in this collection does not indicate that the project is exported at the project level. But rather, it serves as a convenient way to export all resources under a particular project using the resource-level export

includeDependencies - whether to include dependencies when exporting the given set of references.

escope - the encryption scope. If null or EncryptionScope.NoEncryption no encryption is performed

passphrase - the passphrase

Throws:

java.lang.Exception

_execute

protected byte[] _execute()
                   throws java.lang.Exception

Description copied from class: SessionedTask

Subclasses implement this method

Specified by:

_execute in class SessionedTask<byte[]>

Returns:

the result of the execution

Throws:

java.lang.Exception