jBPM Designer - Backend 6.0.3-SNAPSHOT

org.jbpm.designer.repository
Interface Repository

All Known Implementing Classes:
GuvnorRepository, VFSRepository

public interface Repository

Repository is responsible for managing its components that are as follows:


Method Summary
 boolean assetExists(String assetUniqueId)
          Examines repository if asset given by the assetUniqueId exists
 boolean copyAsset(String uniqueId, String location)
          Copy asset given by uniqueId into destination given by location
 boolean copyDirectory(String sourceDirectory, String location)
          Copy directory given by uniqueId into destination given by location
 String createAsset(Asset asset)
          Stores given asset in the repository.
 Directory createDirectory(String location)
          Stores new directory in given location, in case of sub folders existence in the location all sub folders are created as well.
 boolean deleteAsset(String assetUniqueId)
          Deletes asset from repository identified by assetUniqueId if exists
 boolean deleteAssetFromPath(String path)
          Deletes asset from repository given by the path if exists
 boolean deleteDirectory(String directory, boolean failIfNotEmpty)
          Deletes directory from repository including its content NOTE: Directory should be always relative to the repository root
 boolean directoryExists(String directory)
          Examines repository if given directory exists in the repository NOTE: Directory should be always relative to the repository root
 String getName()
          Returns name used to identify this repository.
 Collection<Asset> listAssets(String location)
          Retrieves all assets stored in the given location.
 Collection<Asset> listAssets(String location, Filter filter)
          Retrieves all assets stored in the given location.
 Collection<Asset> listAssetsRecursively(String startAt, Filter filter)
          Retrieves all directories stored under startAt location including all sub folders.
 Collection<Directory> listDirectories(String startAt)
          Retrieves all directories stored under startAt location.
 Asset loadAsset(String assetUniqueId)
          Loads an asset given by the assetUniqueId including actual content of the asset.
 Asset loadAssetFromPath(String path)
          Loads an asset given by the path including actual content of the asset.
 boolean moveAsset(String uniqueId, String location, String name)
          Moves asset given by uniqueId into destination given by location and renames it with given name
 boolean moveDirectory(String sourceDirectory, String location, String name)
          Moves directory given by uniqueId into destination given by location and renames it with given name
 String updateAsset(Asset asset, String commitMessage)
          Updates content of the asset
 

Method Detail

getName

String getName()
Returns name used to identify this repository.

Returns:

listDirectories

Collection<Directory> listDirectories(String startAt)
Retrieves all directories stored under startAt location. NOTE: Directory should be always relative to the repository root

Parameters:
startAt - - location where directories should be fetched from
Returns:
- list of directories

listAssetsRecursively

Collection<Asset> listAssetsRecursively(String startAt,
                                        Filter filter)
Retrieves all directories stored under startAt location including all sub folders. NOTE: Directory should be always relative to the repository root

Parameters:
startAt - - location where directories should be fetched from
filter - - filter that allows to narrow the results
Returns:
- list of assets found

createDirectory

Directory createDirectory(String location)
Stores new directory in given location, in case of sub folders existence in the location all sub folders are created as well.

Parameters:
location - - location in the repository to be created
Returns:
- returns identifier of the new directory

directoryExists

boolean directoryExists(String directory)
Examines repository if given directory exists in the repository NOTE: Directory should be always relative to the repository root

Parameters:
directory - - directory to check
Returns:
- true if and only if given directory exists

deleteDirectory

boolean deleteDirectory(String directory,
                        boolean failIfNotEmpty)
Deletes directory from repository including its content NOTE: Directory should be always relative to the repository root

Parameters:
directory - - directory to be deleted
failIfNotEmpty - - indicates if delete operation should fail in case given directory is not empty
Returns:

copyDirectory

boolean copyDirectory(String sourceDirectory,
                      String location)
Copy directory given by uniqueId into destination given by location

Parameters:
sourceDirectory - - source directory path relative to repository root
location - - destination where directory will be copied to
Returns:
- true when copy operation was successful otherwise false

moveDirectory

boolean moveDirectory(String sourceDirectory,
                      String location,
                      String name)
Moves directory given by uniqueId into destination given by location and renames it with given name

Parameters:
sourceDirectory - - source directory path relative to repository root
location - - final destination where directory should be moved to
name - - name of the directory after move, if null is given name is not changed
Returns:
- returns true if move operation was successful otherwise false

listAssets

Collection<Asset> listAssets(String location)
Retrieves all assets stored in the given location. NOTE: This will not load the actual content of the asset but only its meta data

Parameters:
location - - location that assets should be collected from
Returns:
- list of available assets

listAssets

Collection<Asset> listAssets(String location,
                             Filter filter)
Retrieves all assets stored in the given location. NOTE: This will not load the actual content of the asset but only its meta data

Parameters:
location - - location that assets should be collected from
filter - - allows to defined filter criteria to fetch only assets of interest
Returns:
- list of available assets

loadAsset

Asset loadAsset(String assetUniqueId)
                throws AssetNotFoundException
Loads an asset given by the assetUniqueId including actual content of the asset.

Parameters:
assetUniqueId - - unique identifier of the asset to load
Returns:
return loaded asset including content
Throws:
AssetNotFoundException - - throws in case of asset given by id does not exist

loadAssetFromPath

Asset loadAssetFromPath(String path)
                        throws AssetNotFoundException
Loads an asset given by the path including actual content of the asset.

Parameters:
path - - complete path of the asset to load (relative to the repository root)
Returns:
return loaded asset including content
Throws:
AssetNotFoundException - - throws in case of asset given by id does not exist

createAsset

String createAsset(Asset asset)
Stores given asset in the repository. asset need to have all meta data and content available for the operation to successfully complete.

Parameters:
asset - - asset to be stored
Returns:
returns asset unique identifier that can be used to locate it

updateAsset

String updateAsset(Asset asset,
                   String commitMessage)
                   throws AssetNotFoundException
Updates content of the asset

Parameters:
asset - - asset to be stored with new content in it, all other data (like name, location) should be same
Returns:
- returns uniqueId of the asset
Throws:
AssetNotFoundException - - throws in case of asset given by id does not exist

deleteAsset

boolean deleteAsset(String assetUniqueId)
Deletes asset from repository identified by assetUniqueId if exists

Parameters:
assetUniqueId - - unique identifier of the asset
Returns:
return true if and only if operation completed successfully otherwise false

deleteAssetFromPath

boolean deleteAssetFromPath(String path)
Deletes asset from repository given by the path if exists

Parameters:
path - - complete path of the asset to delete
Returns:
return true if and only if operation completed successfully otherwise false

assetExists

boolean assetExists(String assetUniqueId)
Examines repository if asset given by the assetUniqueId exists

Parameters:
assetUniqueId - - unique identifier of the asset
Returns:
true if and only if asset exists otherwise false

copyAsset

boolean copyAsset(String uniqueId,
                  String location)
Copy asset given by uniqueId into destination given by location

Parameters:
uniqueId - - source asset unique id
location - - destination where asset will be copied to
Returns:
- true when copy operation was successful otherwise false

moveAsset

boolean moveAsset(String uniqueId,
                  String location,
                  String name)
Moves asset given by uniqueId into destination given by location and renames it with given name

Parameters:
uniqueId - - source asset unique id
location - - final destination where asset should be moved to
name - - name of the asset after move, if null is given name is not changed
Returns:
- returns true if move operation was successful otherwise false

jBPM Designer - Backend 6.0.3-SNAPSHOT

Copyright © 2001-2015 JBoss by Red Hat. All Rights Reserved.