Skip navigation links

oracle.as.scheduler.request
Interface OutputContentHelper

public interface OutputContentHelper

Helper for output content.

Since:

release specific (what release of product did this appear in)

Version:

$Header: ess/src/oracle/as/scheduler/request/OutputContentHelper.java /main/4 2010/10/26 13:46:46 ddavison Exp $

Author:

ddavison

Nested Class Summary

static class

OutputContentHelper.CommitSemantics Transactional semantics for importing output files.

Method Summary

void	deleteOutputContent(java.util.List<java.lang.String> 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(java.util.List<java.lang.String> contentNames) Exports the specified previously imported output content to files in the request output directory.
java.lang.String	getResolvedOutputDirectory() Gets the request output directory, resolved to the current server.
java.lang.String	getResolvedWorkDirectory() Gets the request work directory as resolved to the current server.
ImportExportResult	importOutputFiles(java.util.List<java.lang.String> 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() Returns an indication of whether the request file directory is shared.
boolean	outputContentExists(java.lang.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.
java.util.List<ContentDetail>	queryOutputContent() Gets the detailed information for all existing output content in the content store.
ContentDetail	queryOutputContent(java.lang.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()

Returns an indication of whether the request file directory is shared.

If it is, 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

java.lang.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

java.lang.String getResolvedOutputDirectory()

Gets the request output directory, 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(java.util.List<java.lang.String> 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 - list of output files to be imported, where the name is the simple name of the file name.

semantics - commit semantics for the import. CommitSemantics.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. CommitSemantics.Transactional is not valid for a user-provided handle.

Returns:

result of the operation.

exportOutputContent

ImportExportResult exportOutputContent(java.util.List<java.lang.String> 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.

Note that output content created using the API can not be exported.

Parameters:

contentNames - list 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.

Note that output content created using the API can not be exported.

Returns:

result of the operation.

queryOutputContent

java.util.List<ContentDetail> queryOutputContent()
                                                 throws RuntimeServiceException

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

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

Returns:

List of content details.

Throws:

RuntimeServiceException - if error accessing runtime store.

queryOutputContent

ContentDetail queryOutputContent(java.lang.String contentName)
                                 throws RuntimeServiceException

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

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 error accessing runtime store.

outputContentExists

boolean outputContentExists(java.lang.String contentName)
                            throws RuntimeServiceException

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

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; else false.

Throws:

RuntimeServiceException - if error accessing runtime store.

deleteOutputContent

void deleteOutputContent(java.util.List<java.lang.String> contentNames)
                         throws RuntimeServiceException

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

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

Parameters:

contentNames - list of names of output content to delete.

Throws:

RuntimeServiceException - if error accessing runtime store.

Skip navigation links