Package oracle.rules.sdk2.dictionary

Class AbstractDictionaryFinder

java.lang.Object
oracle.rules.sdk2.dictionary.AbstractDictionaryFinder
All Implemented Interfaces:
Serializable, DictionaryFinder
Direct Known Subclasses:
DecisionPointDictionaryFinder
public abstract class AbstractDictionaryFinder extends Object implements DictionaryFinder
The base implementation of the DictionaryFinder interface. Concrete DictionaryFinder implementations should extend this class and implement the findDictionaryWithThisFinder method.

A concrete implementation should also override the canDetectChanges, mustPollForChanges, getModificationTime methods as necessary to reflect the behavior of the finder. These methods define how the finder interacts with the DictionaryLoader class when that class is used to load dictionaries. If the finder can not detect changes in the dictionaries it finds, then DictionaryLoader ignores it when determining if a dictionary needs to be reloaded. If mustPollForChanges returns true, then DictionaryFinder will synchronously poll the finder to see if a dictionary it found has been updated by invoking getModificationTime. Such a finder must override the getModificationTime method. Otherwise, DictionaryLoader expects asynchronous notification of changes from the finder. The finder invokes the DictionaryLoader.setReloadNeeded(DictionaryFQN fqn) method to notify that a dictionary was updated (a reference to the DictionaryLoader instance is available in this class).

It is recommended that DictionaryFinder implementations cache dictionaries that have been loaded. Caching can be enabled by invoking the enableCache method in the constructor of the implementation class. If the DictionaryFinder can detect changes to dictionaries, then it should invoke the invalidateCacheEntry method when a change is detected.

See Also:

  • Method Details

    • getParent

      public AbstractDictionaryFinder getParent()
      Returns the parent finder or null if this finder does not have a parent.
      Returns:
      the parent finder or null if this finder does not have a parent.

    • getChild

      public AbstractDictionaryFinder getChild()
      Returns the child finder or null if this finder does not have a child.
      Returns:
      the child finder or null if this finder does not have a child.

    • getLastChild

      public AbstractDictionaryFinder getLastChild()
      Returns the last (leaf) child finder or this finder if this finder does not have a child.
      Returns:
      the last (leaf) child finder or this finder if this finder does not have a child.

    • findDictionary

      public RuleDictionary findDictionary(String pkg, String name)
      Finds a rule dictionary specified by the package and name.
      Specified by:
      findDictionary in interface DictionaryFinder
      Parameters:
      pkg - fully qualified package name, e.g. foo.bar
      name - unqualified name, e.g. MyDic
      Returns:
      the rule dictionary or null if the dictionary can not be found.

    • findDictionary

      public RuleDictionary findDictionary(String pkg, String name, RuleDictionary linkedFrom)

    • findDictionary

      public RuleDictionary findDictionary(DictionaryFQN fqn)
      Finds a rule dictionary specified by its fully qualified name.
      Specified by:
      findDictionary in interface DictionaryFinder
      Parameters:
      fqn - DictionaryFQN
      Returns:
      the rule dictionary or null if the dictionary can not be found.

    • findDictionary

      public RuleDictionary findDictionary(DictionaryFQN fqn, RuleDictionary linkedFrom)

    • findDictionaryWithThisFinder

      public RuleDictionary findDictionaryWithThisFinder(DictionaryFQN fqn)
      Finds a rule dictionary with this finder. Returns the dictionary identified by the specified fully qualified name or null if the dictionary can not be found.

      This method is implemented by each concrete DictionaryFinder implementation. This method should always return a new handle for the dictionary it finds.

      Parameters:
      fqn - the fully qualified name of the dictionary to find.
      See Also:

    • setChild

      public void setChild(AbstractDictionaryFinder child)

    • setParent

      public void setParent(AbstractDictionaryFinder parent)

    • getDictionaryLoader

      public DictionaryLoader getDictionaryLoader()

    • setDictionaryLoader

      public void setDictionaryLoader(DictionaryLoader loader)

    • canDetectChanges

      public boolean canDetectChanges()
      Indicates whether this finder is able to detect changes in the dictionaries that are found by this finder. The default is true, indicating that changes can be detected. This method should be overridden by if the finder is unable to detect changes. This method is invoked from DictionaryLoader.
      Returns:
      true if changes to dictionaries found by this finder can be detected.
      See Also:

    • mustPollForChanges

      public boolean mustPollForChanges()
      Indicates whether this finder must be polled to determine if a dictionary has been updated. The default is true, indicating that polling is required. This method should be overridden by a finder that can asynchronously notify that a dictionary has been updated. This method is invoked from DictionaryLoader.
      Returns:
      true if polling for dictionary updates is required.
      See Also:

    • getModificationTime

      public long getModificationTime(DictionaryFQN fqn)
      Returns a time in milliseconds indicating when the dictionary indentified by the DictionaryFQN was last modified. The default value of 0 is returned. This method should be overridden by a finder that must be polled for changes. This method is invoked from DictionaryLoader.
      Returns:
      the time in milliseconds of the last update to the dictionary.
      See Also:

    • findDictionary

      public RuleDictionary findDictionary(String path)
      Find a dictionary given a logical, system independent path.
      Specified by:
      findDictionary in interface DictionaryFinder
      Parameters:
      path - the path used to find the dictionary
      Returns:
      RuleDictionary

    • findDictionary

      public RuleDictionary findDictionary(String path, RuleDictionary linkedFrom)

    • findDictionaryWithThisFinder

      public RuleDictionary findDictionaryWithThisFinder(String path)
      Finds a rule dictionary with this finder. Returns the dictionary located by the path or null if the dictionary can not be found.

      This method is overridden by each concrete DictionaryFinder implementation. This method should always return a new handle for the dictionary it finds.

      Parameters:
      path - the path for the dictionary to find.
      See Also:

    • getModificationTime

      public long getModificationTime(String path)
      Returns a time in milliseconds indicating when the dictionary located by the path was last modified. The default value of 0 is returned. This method should be overridden by a finder that must be polled for changes. This method is invoked from DictionaryLoader.
      Returns:
      the time in milliseconds of the last update to the dictionary.
      See Also:

    • close

      public void close()
      Close this finder to release held resources. This method should be overridden. A default implementation included for backwards compability.
      Specified by:
      close in interface DictionaryFinder

    • getParentFinder

      public AbstractDictionaryFinder getParentFinder()

    • invalidateCacheEntry

      public void invalidateCacheEntry(DictionaryFQN fqn)

    • invalidateCacheEntry

      public void invalidateCacheEntry(String path)