Skip navigation links

oracle.ifs.fdk
Class FileManager

public interface class FileManager

The file management interface.

Method Summary

boolean	checkNameValidity(long parentId, java.lang.String name) Checks to see if the proposed name is a valid object name in the target folder.
Item[]	copy(long[] items, NamedValue[] workflowParams, NamedValueSet[] attrs) Copies items.
Item	createDocument(NamedValue[] docDef, NamedValue[] workflowParams, AttributeRequest[] attributes) Creates a new Document.
Item	createDocumentDefinition(NamedValue[] def, AttributeRequest[] attributes) Creates a new DocumentDefinition, which can be used later to create an actual Document.
Item[]	createDocumentDefinitions(NamedValueSet[] def, AttributeRequest[] attributes) Creates set of new DocumentDefinitions, which can be used later to create actual Documents.
Item[]	createDocuments(NamedValueSet[] docDefs, NamedValue[] workflowParams, AttributeRequest[] attributes) Creates a set of new Documents.
Item	createFolder(long destFolderId, NamedValue[] attributes, AttributeRequest[] attrrequest) Creates a new folder.
Item[]	createFolders(long[] destFolders, NamedValueSet[] attributes, AttributeRequest[] attrrequest) Creates a set of folders.
Item[]	createLinks(long folderId, NamedValueSet[] linkDefs, AttributeRequest[] attributes) Creates a set of new Links.
void	delete(long[] items, NamedValue[] workflowParams, NamedValueSet[] attrs) Deletes items.
boolean	exists(java.lang.String absolutePath) Checks to see if an object exists at the given absolute path.
boolean	existsRelative(long folderId, java.lang.String relativePath) Checks to see if an object exists at the given relative path, relative to the given Folder.
boolean	folderLinksExist(java.lang.String path) Returns true if the given absolute path contains any LINK items.
Item[]	getMostRecentDocuments(NamedValue[] options, AttributeRequest[] attributes) Returns the most recent documents for the current user
NamedValueSet[]	getNameConflictResolutionOptions(long[] sourceItems, long[] conflictItems, NamedValueSet[] defs) Deprecated. the conflict resolution options are now returned along with the exception thrown in case of operation like move or copy. The info is present on the information of exception FDK_ITEM_ALREADY_EXISTS mapped to key EXCEPTION_INFO_CONFLICT_RESOLUTION_OPTIONS.
NamedValue[]	getSupportedCharsetNames() Returns a list of supported character sets.
java.lang.String[]	getSupportedCharsets() Returns the list of supported character sets
NamedValue[]	getSupportedLanguageNames() Returns a list of supported languages.
java.lang.String[]	getSupportedLanguages() Returns the list of supported languages
Item[]	listFolder(long folderId, NamedValue[] options, AttributeRequest[] attributes) Returns the items of a folder and returns the requested attributes that apply to each item.
Item[]	move(long[] items, NamedValue[] workflowParams, NamedValueSet[] attrs) Moves items.
Item	resolvePath(java.lang.String path, AttributeRequest[] attributes) Resolves a path, returning an Item that represents a PublicObject.
Item	resolveRelativePath(long folderId, java.lang.String path, AttributeRequest[] attributes) Resolves a relative path from a Folder, returning an Item that represents a PublicObject.
Item[]	uncompress(long[] items, AttributeRequest[] attributes) Uncompresses the items refered to by items.
Item	updateDocument(long docId, NamedValue[] docDef, AttributeRequest[] attributes) Updates a Document.
Item[]	updateDocuments(long[] docIds, NamedValueSet[] docDefs, AttributeRequest[] attributes) Updates multiple Documents.
Item	updateFolder(long folderId, NamedValue[] attrs, AttributeRequest[] attributes) Updates a Folder.
Item	updateLink(long linkId, NamedValue[] attrs, AttributeRequest[] attributes) Updates a Link.

Method Detail

checkNameValidity

boolean checkNameValidity(long parentId,
                          java.lang.String name)
                          throws FdkException

Description copied from interface: FileManager

Checks to see if the proposed name is a valid object name in the target folder.

This checks only for any invalid characters present in the proposed name.

Parameters:

name - The proposed name of the new object

parentId - The parent folder's ID.

Returns:

true if the name is valid

Throws:

FdkException - if the operation fails.

exists

boolean exists(java.lang.String absolutePath)
               throws FdkException

Description copied from interface: FileManager

Checks to see if an object exists at the given absolute path.

Parameters:

absolutePath - the absolute path to check.

Returns:

true if an object exists at the given path.

Throws:

FdkException - if the operation fails.

existsRelative

boolean existsRelative(long folderId,
                       java.lang.String relativePath)
                       throws FdkException

Description copied from interface: FileManager

Checks to see if an object exists at the given relative path, relative to the given Folder.

Parameters:

folderId - the Folder that the path is relative to.

relativePath - the relative path to check.

Returns:

true if an object exists at the given path, relative to the given Folder.

Throws:

FdkException - if the operation fails.

resolvePath

Item resolvePath(java.lang.String path,
                 AttributeRequest[] attributes)
                 throws FdkException

Description copied from interface: FileManager

Resolves a path, returning an Item that represents a PublicObject.

The returned Item will be one of the following types: Document, Link, Folder.

Parameters:

path - the fully-qualified absolute path to resolve.

attributes - requested attributes for the resolved object, or null.

Returns:

an Item with the requested attributes, or null if no item matching the path is found.

Throws:

FdkException - if the operation fails

resolveRelativePath

Item resolveRelativePath(long folderId,
                         java.lang.String path,
                         AttributeRequest[] attributes)
                         throws FdkException

Description copied from interface: FileManager

Resolves a relative path from a Folder, returning an Item that represents a PublicObject.

The returned Item will be one of the following types: Document, Link, Folder.

Parameters:

folderId - the ID of the folder from which to resolve the path.

path - the relative path; it must not start with "/".

attributes - requested attributes for the resolved object, or null.

Returns:

an Item with the requested attributes.

Throws:

FdkException - if the operation fails.

listFolder

Item[] listFolder(long folderId,
                  NamedValue[] options,
                  AttributeRequest[] attributes)
                  throws FdkException

Description copied from interface: FileManager

Returns the items of a folder and returns the requested attributes that apply to each item.

Each Item in the returned Item array will be of one of the following types: Document, Link, Folder. If the primary or secondary sort attributes are specified but the corresponding sort directions are not specified, the sorting defaults to ascending order. The sorting order is ascending if the sort direction is explicitly set to TRUE and descending if the sort direction is set to FALSE.

Parameters:

folderId - the ID of the folder to list.

options - Options on the retrieved list. Valid options are:

• notation: {Attribute name, Attribute type}
• {Options.PRIMARY_SORT_ATTRIBUTE, String}
• {Options.PRIMARY_SORT_DIRECTION, Boolean}
• {Options.SECONDARY_SORT_ATTRIBUTE, String}
• {Options.SECONDARY_SORT_DIRECTION, Boolean}

Attribute names must be valid atributes in Attributes.java and must return values that implement Comparable.

attributes - requested attributes for each item, or null.

Returns:

an Item array representing the items in the folder and their attributes.

Throws:

FdkException - if the operation fails.

createFolders

Item[] createFolders(long[] destFolders,
                     NamedValueSet[] attributes,
                     AttributeRequest[] attrrequest)
                     throws FdkException

Description copied from interface: FileManager

Creates a set of folders. The destinationFolders parameter may have a size of 1 in which case all the folders will be created in that folder; otherwise its size must match the size of the folderNames parameter.

Parameters:

destFolders - the destination folder IDs.

attributes - the attributes to set for each new folder. must include one or more of the following Attributes:

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Attributes.DESCRIPTION, String}
• {Options.RESPECT_NULL_RESOURCE_LOCKS, Boolean}
• {Attributes.CREATED_BY, Long} - requires ADMIN Privileges
• {Attributes.CREATE_DATE, Date} - requires ADMIN Privileges
• {Attributes.LAST_MODIFIED_BY, Long} - requires ADMIN Privileges
• {Attributes.LAST_MODIFIED_DATE, Date} - requires ADMIN Privileges

attrrequest - requested attributes for each item, or null.

Returns:

The list of the folders that were created.

Throws:

FdkException - if the operation fails.

createFolder

Item createFolder(long destFolderId,
                  NamedValue[] attributes,
                  AttributeRequest[] attrrequest)
                  throws FdkException

Description copied from interface: FileManager

Creates a new folder.

Parameters:

destFolderId - the destination folder ID.

attributes - the attributes to set on the new folder. must include one or more of the following Attributes:

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Attributes.DESCRIPTION, String}
• {Options.RESPECT_NULL_RESOURCE_LOCKS, Boolean}
• {Attributes.CREATED_BY, Long} - requires ADMIN Privileges
• {Attributes.CREATE_DATE, Date} - requires ADMIN Privileges
• {Attributes.LAST_MODIFIED_BY, Long} - requires ADMIN Privileges
• {Attributes.LAST_MODIFIED_DATE, Date} - requires ADMIN Privileges

attrrequest - requested attributes for each item, or null.

Returns:

The folder that was created.

Throws:

FdkException - if the operation fails.

copy

Item[] copy(long[] items,
            NamedValue[] workflowParams,
            NamedValueSet[] attrs)
            throws FdkException

Description copied from interface: FileManager

Copies items.

Note: if workflow is enabled and the copy operation is workflow enabled, then a CopyRequest is created.

Use RequestManager.listRequests to find any created Requests.

Parameters:

items - The IDs of the items to be copied.

workflowParams - The parameters(name/value) used to start workflow

attrs - The attributes specified for each item.

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Options.DESTFOLDER, Long}
• {Options.OVERWRITE, Boolean}
• {Options.UNIQUENAME, Boolean}
• {Options.NEWVERSION, Boolean}
• {Options.RESPECT_NULL_RESOURCE_LOCKS, Boolean}
• {Options.CATEGORY_DEFINITION, NamedValue[]}
• {Options.RECORD_DEFINITION, NamedValue[]}

Returns:

If the operation is workflow enabled, null; otherwise the copied items.

Throws:

FdkException - if the operation fails.

move

Item[] move(long[] items,
            NamedValue[] workflowParams,
            NamedValueSet[] attrs)
            throws FdkException

Description copied from interface: FileManager

Moves items.

Note: If the operation is workflow-enabled, then a Request representing this move operation is created.

Parameters:

items - The IDs of the items to be moved.

workflowParams - The parameters(name/value) used to start workflow

attrs - The attributes specified for each item.

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Options.DESTFOLDER, Long}
• {Options.OVERWRITE, Boolean}
• {Options.UNIQUENAME, Boolean}
• {Options.NEWVERSION, Boolean}
• {Options.CATEGORY_DEFINITION, NamedValue[]}
• {Options.RECORD_DEFINITION, NamedValue[]}
• {Options.RESPECT_NULL_RESOURCE_LOCKS, Boolean}

Returns:

The moved items.

Throws:

FdkException - if the operation fails.

delete

void delete(long[] items,
            NamedValue[] workflowParams,
            NamedValueSet[] attrs)
            throws FdkException

Description copied from interface: FileManager

Deletes items.

If workflow is enabled and the delete operation is workflow enabled, then a DeleteRequest is created.

Parameters:

items - the item IDs to be deleted.

workflowParams - The parameters(name/value) used to start workflow

attrs - The attributes specified for each item.

Throws:

FdkException - if the operation fails.

createDocumentDefinition

Item createDocumentDefinition(NamedValue[] def,
                              AttributeRequest[] attributes)
                              throws FdkException

Description copied from interface: FileManager

Creates a new DocumentDefinition, which can be used later to create an actual Document.

Parameters:

def - the attributes to set.

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Attributes.DESCRIPTION, String}
• {Attributes.DOCUMENT_CHARACTER_SET, String}
• {Attributes.DOCUMENT_LANGUAGE, String}
• {Options.CONTENTSTREAM, InputStream}

attributes - requested attributes for each item, or null.

Returns:

the new document definition.

Throws:

FdkException - if the operation fails.

createDocumentDefinitions

Item[] createDocumentDefinitions(NamedValueSet[] def,
                                 AttributeRequest[] attributes)
                                 throws FdkException

Description copied from interface: FileManager

Creates set of new DocumentDefinitions, which can be used later to create actual Documents. The bulk version of createDocumentDefinition.

Parameters:

defs - attributes to set. Each row represents one definition.

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Attributes.DESCRIPTION, String}
• {Attributes.DOCUMENT_CHARACTER_SET, String}
• {Attributes.DOCUMENT_LANGUAGE, String}
• {Options.CONTENTSTREAM, InputStream}

attributes - requested attributes for each item, or null.

Returns:

the new document definitions.

Throws:

FdkException - if the operation fails.

createDocument

Item createDocument(NamedValue[] docDef,
                    NamedValue[] workflowParams,
                    AttributeRequest[] attributes)
                    throws FdkException

Description copied from interface: FileManager

Creates a new Document.

If workflow is enabled and the createDocument operation is workflow enabled then a CreateDocumentRequest is created.

Use RequestManager.listRequests to find any created requests.

Parameters:

docDefs - the attributes to set.

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Attributes.DESCRIPTION, String}
• {Attributes.DOCUMENT_CHARACTER_SET, String}
• {Attributes.DOCUMENT_LANGUAGE, String}
• {Options.DESTFOLDER, Long}
• {Options.CATEGORY_DEFINITION, NamedValue[]}
• {Options.RECORD_DEFINITION, NamedValue[]}
• {Options.CONTENTSTREAM, InputStream}
• {Options.OVERWRITE, Boolean}
• {Options.UNIQUENAME, Boolean}
• {Options.NEWVERSION, Boolean}
• {Options.USE_SAVED_DEFINITION, Long}
• {Options.RESPECT_NULL_RESOURCE_LOCKS, Boolean}
• {Attributes.CREATED_BY, Long} - requires ADMIN Privileges
• {Attributes.CREATE_DATE, Date} - requires ADMIN Privileges
• {Attributes.LAST_MODIFIED_BY, Long} - requires ADMIN Privileges
• {Attributes.LAST_MODIFIED_DATE, Date} - requires ADMIN Privileges

workflowParams - The parameters(name/value) used to start workflow

attributes - requested attributes for each item, or null.

Returns:

If the operation is workflow enabled, null; otherwise the new document.

Throws:

FdkException - if the operation fails.

createDocuments

Item[] createDocuments(NamedValueSet[] docDefs,
                       NamedValue[] workflowParams,
                       AttributeRequest[] attributes)
                       throws FdkException

Description copied from interface: FileManager

Creates a set of new Documents.

If workflow is enabled and the createDocument operation is workflow enabled then a CreateDocumentRequest is created.

Use RequestManager.listRequests to find any created requests.

Parameters:

docDefs - the attributes to set.

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Attributes.DESCRIPTION, String}
• {Attributes.DOCUMENT_CHARACTER_SET, String}
• {Attributes.DOCUMENT_LANGUAGE, String}
• {Options.DESTFOLDER, Long}
• {Options.CATEGORY_DEFINITION, NamedValue[]}
• {Options.RECORD_DEFINITION, NamedValue[]}
• {Options.CONTENTSTREAM, InputStream}
• {Options.OVERWRITE, Boolean}
• {Options.UNIQUENAME, Boolean}
• {Options.NEWVERSION, Boolean}
• {Options.USE_SAVED_DEFINITION, Long}
• {Options.RESPECT_NULL_RESOURCE_LOCKS, Boolean}
• {Attributes.CREATED_BY, Long} - requires ADMIN Privileges
• {Attributes.CREATE_DATE, Date} - requires ADMIN Privileges
• {Attributes.LAST_MODIFIED_BY, Long} - requires ADMIN Privileges
• {Attributes.LAST_MODIFIED_DATE, Date} - requires ADMIN Privileges

workflowParams - The parameters(name/value) used to start workflow

attributes - requested attributes for each item, or null.

Returns:

If the operation is workflow enabled, null; otherwise the new documents.

Throws:

FdkException - if the operation fails.

createLinks

Item[] createLinks(long folderId,
                   NamedValueSet[] linkDefs,
                   AttributeRequest[] attributes)
                   throws FdkException

Description copied from interface: FileManager

Creates a set of new Links.

Parameters:

folderId - the id of the destination folder for the new links.

linkDefs - the attributes to set.

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Attributes.LINK_DESTINATION, Long}
• {Options.LINK_TO_LATEST, Boolean}
• {Options.USE_DEFAULT_NAME, Boolean}

attributes - requested attributes for each item, or null.

Returns:

the new document.

Throws:

FdkException - if the operation fails.

updateLink

Item updateLink(long linkId,
                NamedValue[] attrs,
                AttributeRequest[] attributes)
                throws FdkException

Description copied from interface: FileManager

Updates a Link.

Parameters:

linkId - the id of the Link to update.

attrs - the attributes to update.

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Attributes.DESCRIPTION, String}
• {Options.LINK_TO_LATEST, Boolean}

attributes - requested attributes for each item, or null.

Returns:

the updated link.

Throws:

FdkException - if the operation fails.

folderLinksExist

boolean folderLinksExist(java.lang.String path)
                         throws FdkException

Description copied from interface: FileManager

Returns true if the given absolute path contains any LINK items.

Parameters:

path - the absolute path to test.

Returns:

true if path contains any LINK items.

Throws:

FdkException - if the operation fails.

(Published)

updateFolder

Item updateFolder(long folderId,
                  NamedValue[] attrs,
                  AttributeRequest[] attributes)
                  throws FdkException

Description copied from interface: FileManager

Updates a Folder.

Parameters:

folderId - the id of the document to update.

attrs - the attributes to update.

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Attributes.DESCRIPTION, String}
• {Attributes.CREATED_BY, Long} - requires ADMIN Privileges
• {Attributes.CREATE_DATE, Date} - requires ADMIN Privileges
• {Attributes.LAST_MODIFIED_BY, Long} - requires ADMIN Privileges
• {Attributes.LAST_MODIFIED_DATE, Date} - requires ADMIN Privileges

attributes - requested attributes for each item, or null.

Returns:

the updated folder.

Throws:

FdkException - if the operation fails.

updateDocument

Item updateDocument(long docId,
                    NamedValue[] docDef,
                    AttributeRequest[] attributes)
                    throws FdkException

Description copied from interface: FileManager

Updates a Document.

Parameters:

docId - the id of the document to update.

docDef - the attributes to update.

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Attributes.DESCRIPTION, String}
• {Attributes.DOCUMENT_CHARACTER_SET, String}
• {Attributes.DOCUMENT_LANGUAGE, String}
• {Attributes.LAST_MODIFIED_DATE, Date}
• {Options.CONTENTSTREAM, InputStream}
• {Options.CATEGORY_DEFINITION, NamedValue[]}
• {Options.REMOVE_CATEGORY_ID, NamedValue[]}
• {Attributes.CREATED_BY, Long} - requires ADMIN Privileges
• {Attributes.CREATE_DATE, Date} - requires ADMIN Privileges
• {Attributes.LAST_MODIFIED_BY, Long} - requires ADMIN Privileges

attributes - requested attributes for each item, or null.

Returns:

the updated document.

Throws:

FdkException - if the operation fails.

updateDocuments

Item[] updateDocuments(long[] docIds,
                       NamedValueSet[] docDefs,
                       AttributeRequest[] attributes)
                       throws FdkException

Description copied from interface: FileManager

Updates multiple Documents.

Parameters:

docIds - the ids of the documents to update.

docDefs - the attributes to update, specified for each item.

• notation: {Attribute name, Attribute type}
• {Attributes.NAME, String}
• {Attributes.DESCRIPTION, String}
• {Attributes.DOCUMENT_CHARACTER_SET, String}
• {Attributes.DOCUMENT_LANGUAGE, String}
• {Attributes.LAST_MODIFIED_DATE, Date}
• {Options.CONTENTSTREAM, InputStream}
• {Options.CATEGORY_DEFINITION, NamedValue[]}
• {Options.REMOVE_CATEGORY_ID, NamedValue[]}
• {Attributes.CREATED_BY, Long} - requires ADMIN Privileges
• {Attributes.CREATE_DATE, Date} - requires ADMIN Privileges
• {Attributes.LAST_MODIFIED_BY, Long} - requires ADMIN Privileges

attributes - requested attributes for each item, or null.

Returns:

the updated documents.

Throws:

FdkException - if the operation fails.

getSupportedLanguages

java.lang.String[] getSupportedLanguages()
                                         throws FdkException

Description copied from interface: FileManager

Returns the list of supported languages

Returns:

all supported languages

Throws:

FdkException - if the operation fails.

getSupportedCharsets

java.lang.String[] getSupportedCharsets()
                                        throws FdkException

Description copied from interface: FileManager

Returns the list of supported character sets

Returns:

all supported character sets

Throws:

FdkException - if the operation fails.

getSupportedCharsetNames

NamedValue[] getSupportedCharsetNames()
                                      throws FdkException

Description copied from interface: FileManager

Returns a list of supported character sets. Each Namedvalue contains the {charset name, charset display name} tuple.

Returns:

all supported charsets.

Throws:

FdkException - if the operation fails.

getSupportedLanguageNames

NamedValue[] getSupportedLanguageNames()
                                       throws FdkException

Description copied from interface: FileManager

Returns a list of supported languages. Each Namedvalue contains the {language name, language display name} tuple.

Returns:

all supported languages.

Throws:

FdkException - if the operation fails.

getNameConflictResolutionOptions

NamedValueSet[] getNameConflictResolutionOptions(long[] sourceItems,
                                                 long[] conflictItems,
                                                 NamedValueSet[] defs)
                                                 throws FdkException

Deprecated. the conflict resolution options are now returned along with the exception thrown in case of operation like move or copy. The info is present on the information of exception FDK_ITEM_ALREADY_EXISTS mapped to key EXCEPTION_INFO_CONFLICT_RESOLUTION_OPTIONS.

Description copied from interface: FileManager

Returns an array of valid and applicable name conflict resolution options for each {sourceItem, conflictItem, def} tuple passed to this method.

If an operation for the set of given objs would fail because of a name conflict, this method determines which options could be passed to a subsequent call to the operation that would allow it to succeed.

Parameters:

sourceItems - the items that are being operated on.

conflictItems - the name-conflicting items for each source item.

defs - the spec for the operation on the source items. (note that the DESTFOLDER option is required.)

Returns:

a NamedValueSet array of valid and applicable conflict resolution options (one array for each {sourceItem, conflictItem, def} tuple).

Throws:

FdkException - if the operation fails

getMostRecentDocuments

Item[] getMostRecentDocuments(NamedValue[] options,
                              AttributeRequest[] attributes)
                              throws FdkException

Description copied from interface: FileManager

Returns the most recent documents for the current user

Parameters:

options - Options on the retrieved list. Valid options are:

• notation: {Attribute name, Attribute type}
• {Options.PRIMARY_SORT_ATTRIBUTE, String}
• {Options.PRIMARY_SORT_DIRECTION, Boolean}
• {Options.SECONDARY_SORT_ATTRIBUTE, String}
• {Options.SECONDARY_SORT_DIRECTION, Boolean}

If an attribute name is specified with no direction, ascending is the default. Attribute names must be valid attributes in Attributes.java and must return values that implement Comparable.

attributes - requested attributes for each item, or null.

Returns:

references to the most recently accessed documents.

Throws:

FdkException - if the operation fails.

uncompress

Item[] uncompress(long[] items,
                  AttributeRequest[] attributes)
                  throws FdkException

Description copied from interface: FileManager

Uncompresses the items refered to by items.

Parameters:

items - the item IDs to be uncompressed.

attributes - the attributes to be populated for items returned.

Returns:

An array of items which have been umcompressed.

Throws:

FdkException - if the operation fails.

Skip navigation links