org.drools.jsr94.rules.admin

Class RuleAdministratorImpl

java.lang.Object

org.drools.jsr94.rules.admin.RuleAdministratorImpl

All Implemented Interfaces:

Serializable, javax.rules.admin.RuleAdministrator

public class RuleAdministratorImpl
extends Object
implements javax.rules.admin.RuleAdministrator, Serializable

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, Serialized Form

Constructor Summary

Constructors

Constructor and Description
RuleAdministratorImpl(RuleExecutionSetRepository repository) Default constructor.

Method Summary

Modifier and Type	Method and Description
void	deregisterRuleExecutionSet(String bindUri, Map properties) Unregisters a previously registered RuleExecutionSet from a URI.
javax.rules.admin.LocalRuleExecutionSetProvider	getLocalRuleExecutionSetProvider(Map properties) Returns a LocalRuleExecutionSetProvider implementation.
javax.rules.admin.RuleExecutionSetProvider	getRuleExecutionSetProvider(Map properties) Returns a RuleExecutionSetProvider implementation.
void	registerRuleExecutionSet(String bindUri, javax.rules.admin.RuleExecutionSet set, 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 javax.rules.admin.RuleExecutionSetProvider getRuleExecutionSetProvider(Map properties)

Returns a RuleExecutionSetProvider implementation.

Specified by:

getRuleExecutionSetProvider in interface javax.rules.admin.RuleAdministrator

Parameters:

properties - additional properties

Returns:

The created RuleExecutionSetProvider.

getLocalRuleExecutionSetProvider

public javax.rules.admin.LocalRuleExecutionSetProvider getLocalRuleExecutionSetProvider(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.

Specified by:

getLocalRuleExecutionSetProvider in interface javax.rules.admin.RuleAdministrator

Parameters:

properties - additional properties

Returns:

The created LocalRuleExecutionSetProvider.

registerRuleExecutionSet

public void registerRuleExecutionSet(String bindUri,
                                     javax.rules.admin.RuleExecutionSet set,
                                     Map properties)
                              throws javax.rules.admin.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.

Specified by:

registerRuleExecutionSet in interface javax.rules.admin.RuleAdministrator

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:

javax.rules.admin.RuleExecutionSetRegisterException - if an error occurred that prevented registration

deregisterRuleExecutionSet

public void deregisterRuleExecutionSet(String bindUri,
                                       Map properties)
                                throws javax.rules.admin.RuleExecutionSetDeregistrationException

Unregisters a previously registered RuleExecutionSet from a URI.

Specified by:

deregisterRuleExecutionSet in interface javax.rules.admin.RuleAdministrator

Parameters:

bindUri - the URI to disassociate with the RuleExecutionSet.

properties - additional properties used to perform the deregistration

Throws:

javax.rules.admin.RuleExecutionSetDeregistrationException - if an error occurred that prevented unregistration