oracle.as.scheduler.request

Interface OutputContentHelper

public interface OutputContentHelper

Helper for output content.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	OutputContentHelper.CommitSemantics Transactional semantics for importing output files.

Method Summary

Methods

Modifier and Type	Method and Description
void	deleteOutputContent(List contentNames) Deletes the output content from the content store for the request.
ImportExportResult	exportOutputContent() Exports all previously imported output content to files in the request output directory.
ImportExportResult	exportOutputContent(List contentNames) Exports the specified previously imported output content to files in the request output directory.
String	getResolvedOutputDirectory() Gets the request output directory as resolved to the current server.
String	getResolvedWorkDirectory() Gets the request work directory as resolved to the current server.
ImportExportResult	importOutputFiles(List fileNames, OutputContentHelper.CommitSemantics semantics) Imports the specified files from the resolved output directory.
ImportExportResult	importOutputFiles(OutputContentHelper.CommitSemantics semantics) Imports all files from the resolved output directory.
boolean	isRequestWorkDirectoryShared() Gets an indication whether the request file directory is shared.
boolean	outputContentExists(String contentName) Checks whether the specified output content exists in the content store for the request.
boolean	outputDirectoryExists() Determines if the request's output directory exists.
List	queryOutputContent() Gets the detailed information for all existing output content in the content store.
ContentDetail	queryOutputContent(String contentName) Gets the detailed information for the output content in the content store, if it exists.
boolean	workDirectoryExists() Determines if the request's work directory exists.

Method Detail

workDirectoryExists

boolean workDirectoryExists()

Determines if the request's work directory exists. Allows the job at any stage to determine if the work directory exists before it attempts to create temporary files.

The job must define a system property to cause ESS to create the work directory.

Returns:

true if the work directory exists; false if the work directory does not exist.

outputDirectoryExists

boolean outputDirectoryExists()

Determines if the request's output directory exists. Allows the job at any stage, such as update, to determine if the output directory exists before it attempts to create output files.

The job must define a system property to cause ESS to create the output directory.

Returns:

true if the output directory exists; false if the output directory does not exist.

isRequestWorkDirectoryShared

boolean isRequestWorkDirectoryShared()

Gets an indication whether the request file directory is shared. If it is shared, then any files created in the request work dir or output dir in any stage will be available to all subsequent stages of the request.

Returns:

true if the request's work directory is shared; false if the work directory is a local directory.

getResolvedWorkDirectory

String getResolvedWorkDirectory()

Gets the request work directory as resolved to the current server.

The job may create temporary files in the work directory, and ESS will automatically delete the work directory at the end of request execution if the RequestFileDirectory is shared, or at the end of each stage (pre-processing, execution, update, post-processing) if the RequestFileDirectory is local.

Returns:

request work directory, or null if the job does not define the necessary system property.

getResolvedOutputDirectory

String getResolvedOutputDirectory()

Gets the request output directory as resolved to the current server.

The job may create output files in the output directory that can be autmoatically or manually imported to the ESS content store.

Returns:

request output directory, or null if the job does not define the necessary system property.

importOutputFiles

ImportExportResult importOutputFiles(List fileNames,
                                   OutputContentHelper.CommitSemantics semantics)

Imports the specified files from the resolved output directory. Imported content overwrites existing content of the same name, unless the existing content was created using the API. In that case, the file will not be imported.

Parameters:

fileNames - a List<String> of output file names to be imported, where the name is the simple name of the file name.

semantics - commit semantics for the import. Transactional is not valid for a user-provided handle.

Returns:

result of the operation.

importOutputFiles

ImportExportResult importOutputFiles(OutputContentHelper.CommitSemantics semantics)

Imports all files from the resolved output directory. Imported content overwrites existing content of the same name, unless the existing content was created using the API. In that case, the file will not be imported.

Parameters:

semantics - commit semantics for the import. Transactional is not valid for a user-provided handle.

Returns:

result of the operation.

exportOutputContent

ImportExportResult exportOutputContent(List contentNames)

Exports the specified previously imported output content to files in the request output directory. The exported files will overwrite any existing files of the same names.

Output content created using the API can not be exported.

Parameters:

contentNames - a List<String> of names of previously imported output content.

Returns:

result of the operation.

exportOutputContent

ImportExportResult exportOutputContent()

Exports all previously imported output content to files in the request output directory. The exported files will overwrite any existing files of the same names.

Output content created using the API can not be exported.

Returns:

result of the operation.

queryOutputContent

List queryOutputContent()
                        throws RuntimeServiceException

Gets the detailed information for all existing output content in the content store.

This returns information on both output content that was imported and output content created using the API.

Returns:

a List<ContentDetail> of content details.

Throws:

RuntimeServiceException - if runtime subsystem error.

queryOutputContent

ContentDetail queryOutputContent(String contentName)
                                 throws RuntimeServiceException

Gets the detailed information for the output content in the content store, if it exists.

This returns information on both output content that was imported and output content created using the API.

Returns:

Content detail for the content, or null if the content does not exist.

Throws:

RuntimeServiceException - if runtime subsystem error.

outputContentExists

boolean outputContentExists(String contentName)
                            throws RuntimeServiceException

Checks whether the specified output content exists in the content store for the request.

This returns information on output content that was imported and output content created using the API.

Parameters:

contentName - name of the output content to check.

Returns:

true if the output content exists in the content store; false otherwise.

Throws:

RuntimeServiceException - if runtime subsystem error.

deleteOutputContent

void deleteOutputContent(List contentNames)
                         throws RuntimeServiceException

Deletes the output content from the content store for the request.

This can delete output content that was imported and output content created using the API.

Parameters:

contentNames - a List<String> of names of output content to delete.

Throws:

RuntimeServiceException - if runtime subsystem error.