KIE :: Public API 9.44.0.Final API
KIE provides a knowledge-centric API, where rules and processes are first class citizens. The majority of KIE API is considered stable and should not change, experimental classes and APIs will be marked as such.
The most common interfaces you will use are:
org.kie.api.KieBaseorg.kie.api.runtime.KieSessionorg.kie.api.runtime.StatelessKieSessionorg.kie.api.runtime.KieContainerorg.kie.api.builder.ReleaseIdorg.kie.api.builder.KieScanner
Factory classes, with static methods, provide instances of the above interfaces. A pluggable provider approach is used to allow provider implementations to be wired up to the factories at runtime. The Factories you will most commonly use are:
org.kie.api.KieServicesorg.kie.api.command.KieCommandsorg.kie.api.io.KieResources
Typical example of loading and using knowledge resources (rules, processes, etc) found on classpath. By convention the
KIE API expects file META-INF/kmodule.xml which is a marker file and also enables additional configuration.
For very basic usage the file can just contain <kmodule xmlns="http://www.drools.org/xsd/kmodule"/>:
KieServices kieServices = KieServices.Factory.get();
KieContainer kieContainer = kieServices.getKieClasspathContainer();
KieSession kieSession = kieContainer.newKieSession();
try {
kieSession.insert(new Fibonacci(10));
kieSession.fireAllRules();
} finally {
kieSession.dispose();
}
Drools 8 introduced Rule Unit API as a recommended style which provides an atomic module defining a set of rules and a set of strongly typed data sources:
MeasurementUnit measurementUnit = new MeasurementUnit();
RuleUnitInstance<MeasurementUnit> instance = RuleUnitProvider.get().createRuleUnitInstance(measurementUnit);
try {
measurementUnit.getMeasurements().add(new Measurement("color", "red"));
List<Measurement> queryResult = instance.executeQuery("FindColor").stream().map(tuple -> (Measurement) tuple.get("$m")).collect(toList());
} finally {
instance.dispose();
}
This information can later be used to build a KIE resource and execute the process .