org.drools.jsr94.rules.admin
Class RuleAdministratorImpl

java.lang.Object
  org.drools.jsr94.rules.admin.RuleAdministratorImpl

public class RuleAdministratorImpl
extends java.lang.Object

The Drools implementation of the RuleAdministrator interface which is used by rule execution set administrators to load rule execution sets from external sources and create a RuleExecutionSet runtime object.

The RuleAdministrator should be accessed by calling:

RuleServiceProvider ruleServiceProvider = RuleServiceProvider.newInstance();
RuleAdministrator ruleAdministration = ruleServiceProvider.getRuleAdministrator();

In an additional step the administrator may also choose to bind the RuleExecutionSet instance to a URI so that it is globally accessible and RuleSessions can be created for the RuleExecutionSet through the RuleRuntime.

See Also:

RuleAdministrator

Constructor Summary

RuleAdministratorImpl(RuleExecutionSetRepository repository)
Default constructor.

Method Summary

void	deregisterRuleExecutionSet(java.lang.String bindUri, java.util.Map properties) Unregisters a previously registered RuleExecutionSet from a URI.
LocalRuleExecutionSetProvider	getLocalRuleExecutionSetProvider(java.util.Map properties) Returns a LocalRuleExecutionSetProvider implementation.
RuleExecutionSetProvider	getRuleExecutionSetProvider(java.util.Map properties) Returns a RuleExecutionSetProvider implementation.
void	registerRuleExecutionSet(java.lang.String bindUri, RuleExecutionSet set, java.util.Map properties) Registers a RuleExecutionSet and associates it with a given URI.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RuleAdministratorImpl

public RuleAdministratorImpl(RuleExecutionSetRepository repository)

Default constructor.

Method Detail

getRuleExecutionSetProvider

public RuleExecutionSetProvider getRuleExecutionSetProvider(java.util.Map properties)

Returns a RuleExecutionSetProvider implementation.

Parameters:

properties - additional properties

Returns:

The created RuleExecutionSetProvider.

getLocalRuleExecutionSetProvider

public LocalRuleExecutionSetProvider getLocalRuleExecutionSetProvider(java.util.Map properties)

Returns a LocalRuleExecutionSetProvider implementation. Returns a LocalRuleExecutionSetProvider implementation or null if this implementation does not support creating a RuleExecutionSet from non-serializable resources.

Parameters:

properties - additional properties

Returns:

The created LocalRuleExecutionSetProvider.

registerRuleExecutionSet

public void registerRuleExecutionSet(java.lang.String bindUri,
                                     RuleExecutionSet set,
                                     java.util.Map properties)
                              throws RuleExecutionSetRegisterException

Registers a RuleExecutionSet and associates it with a given URI. Once a RuleExecutionSet has been registered it is accessible to runtime clients through the RuleRuntime. If a RuleExecutionSet has already been associated with the URI it should be deregistered (as if deregisterRuleExecutionSet/ had been called) and the URI should be associated with the new RuleExecutionSet.

Parameters:

bindUri - the URI to associate with the RuleExecutionSet.

set - the RuleExecutionSet to associate with the URI

properties - additional properties used to perform the registration

Throws:

RuleExecutionSetRegisterException - if an error occurred that prevented registration

deregisterRuleExecutionSet

public void deregisterRuleExecutionSet(java.lang.String bindUri,
                                       java.util.Map properties)
                                throws RuleExecutionSetDeregistrationException

Unregisters a previously registered RuleExecutionSet from a URI.

Parameters:

bindUri - the URI to disassociate with the RuleExecutionSet.

properties - additional properties used to perform the deregistration

Throws:

RuleExecutionSetDeregistrationException - if an error occurred that prevented unregistration