oracle.rules.sdk2.repository

Interface DictionaryUpdater

All Known Implementing Classes:

MDSUpdater

public interface DictionaryUpdater

DictionaryUpdater is the interface to use in updating a rule dictionary that is located by a path. An instance is obtained from MDSRepository. A dictionary must be loaded with loadForUpdate before saving saving the updates with updateDictionary. The best practice is to invoke loadForUpdate prior to any changes are made to the dictionary.

Method Summary

Modifier and Type	Method and Description
void	abortUpdate(java.lang.String path) Abort the edit of a dictionary previously loaded with loadForEdit.
void	close() Close this DictionaryUpdater and release resources it holds.
RuleDictionary	loadForUpdate(java.lang.String path, DictionaryFinder finder) Load a dictionary from the repository for the purpose of updating it.
void	updateDictionary(java.lang.String path, RuleDictionary dictionary) Update a dictionary previously loaded for update.

Method Detail

loadForUpdate

RuleDictionary loadForUpdate(java.lang.String path,
                             DictionaryFinder finder)
                      throws RepositoryException,
                             SDKException

Load a dictionary from the repository for the purpose of updating it. If any error occurs after a dictionary is loaded and prior to a successful update of the dictionary via updateDictionary, the dictionary must be reloaded since an error results in the discard of the pending update.

Parameters:

path - the path to the dictionary

finder - the DictionaryFinder used to resolve dictionary links.

Returns:

the RuleDictionary.

Throws:

RepositoryException - if an error occurred during the load of the dictionary

SDKException

updateDictionary

void updateDictionary(java.lang.String path,
                      RuleDictionary dictionary)
               throws RepositoryException,
                      SDKException

Update a dictionary previously loaded for update.

Parameters:

path - the path to the dictionary

dictionary - the rule dictionary to save

Throws:

RepositoryException - an error occured during the save of dictionary.

SDKException - if an error occured serializing the dictionary to XML.

abortUpdate

void abortUpdate(java.lang.String path)
          throws RepositoryException

Abort the edit of a dictionary previously loaded with loadForEdit.

Parameters:

path - the path to the dictionary

Throws:

RepositoryException - if an error occurred during the abort

close

void close()
    throws RepositoryException

Close this DictionaryUpdater and release resources it holds.

Throws:

RepositoryException - an exception occured during closing the repository