A.2. Environment Properties
As opposed to system properties, environment properties are passed to an individual KieSession, allowing you to control its behaviour independently on the rest of the deployment.
The properties available to you are the constants of the class org.kie.api.runtime.EnvironmentName.
A.2.1. Configuration
To set the environment properties on a KieSession, you can create a new session with an instance of the Environment or RuntimeEnvironment interface:
Setting Environment Property using Environment interface
Environment env = EnvironmentFactory.newEnvironment(); env.set(EnvironmentName.SAMPLE_PROPERTY, true); kbase.newKieSession(null, env);
Setting Environment Property using RuntimeEnvironment interface
RuntimeEnvironment environment = RuntimeEnvironmentBuilder.Factory.get() .newDefaultBuilder() .... environment.getEnvironment().set(EnvironmentName.SAMPLE_PROPERTY, true); singletonManager = RuntimeManagerFactory.Factory.get().newSingletonRuntimeManager(environment);
A.2.2. List of Environment Properties
This section contains the alphabetically sorted list of all recognized environment properties in Red Hat JBoss BRMS 6.3.
Red Hat JBoss BRMS Environment Properties
- CALENDARS
- This property is not used.
- DATE_FORMATS
- This property is not used.
- GLOBALS
Values Default Any object declared in DRL or BPMN
N/A
- OBJECT_MARSHALLING_STRATEGIES
Enable use of pluggable variable persistence strategies. Allows storing variables in different data stores.
Values Default An instance of
org.kie.api.marshalling.ObjectMarshallingStrategyDependent on the engine configuration. If no other strategy is available,
org.drools.core.marshalling.impl.SerializablePlaceholderResolvingStrategyis used.- PERSISTENCE_CONTEXT_MANAGER
The
ProcessPersistenceContextManagerinstance used for process persistence.Values Default An instance of
org.jbpm.persistence.ProcessPersistenceContextManagerAn instance of
org.jbpm.persistence.JpaProcessPersistenceContextManager- TRANSACTION
Optional property if
UserTransactioncan not be obtained using JNDI lookup.Values Default An instance of
UserTransactionnull- TRANSACTION_MANAGER
Get the
TransactionManagerinstance from the environment or context. For example:info = context.get(EnvironmentName.TRANSACTION_MANAGER)
Values Default An instance of
TransactionManagerDepends on your configuration
- TRANSACTION_SYNCHRONIZATION_REGISTRY
Allows access to and control of the active transaction. Used by Red Hat JBoss BRMS to efficiently manage persistence.
Values Default An instance of
TransactionSynchronizationRegistryTaken from the environment—usually JNDI lookup in JTA environments
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.