ools-api.5.0.0.M3.source-code.overview.html Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of drools-api
There is a newer version: 5.1.1



Drools the Business Logic Integration Platform provides an knowledge centric api, where rules and processes are first class citizens.



The most common interfaces you will use are:

org.drools.builder.KnowledgeBuilder
org.drools.KnowledgeBase
org.drools.agent.KnowledgeAgent
org.drools.runtime.StatefulKnowledgeSession
org.drools.runtime.StatelessKnowledgeSession




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 used are:

org.drools.builder.KnowledgeBuilderFactory
org.drools.KnowledgeBaseFactory
org.drools.agent.KnowledgeAgentFactory




A Typical example to load a rule resource.
KnowledgeBuilder kbuilder = KnowledgeBuilderFactory.newKnowledgeBuilder();
kbuilder.addResource( url,
                      KnowledgeType.DRL );
if ( kbuilder.hasErrors() ) {
    System.err.println( builder.getErrors().toString() );
}                     

KnowledgeBase kbase = KnowledgeBaseFactory.newKnowledgeBase();
kbase.addKnowledgePackages( builder.getKnowledgePackages() );

StatefulKnowledgeSession ksession = knowledgeBase.newStatefulKnowledgeSession();
ksession.insert( new Fibonacci( 10 ) );
ksession.fireAllRules();

ksession.dispose();




A Typical example to load a process resource. Notice the KnowledgeType is changed, in accordance with the Resource type.
KnowledgeBuilder kbuilder = KnowledgeBuilderFactory.newKnowledgeBuilder();
kbuilder.addResource( url,
                      KnowledgeType.DRF );
if ( kbuilder.hasErrors() ) {
    System.err.println( builder.getErrors().toString() );
}                     

KnowledgeBase kbase = KnowledgeBaseFactory.newKnowledgeBase();
kbase.addKnowledgePackages( builder.getKnowledgePackages() );

StatefulKnowledgeSession ksession = knowledgeBase.newStatefulKnowledgeSession();
ksession.startProcess( "Buy Order Process" );

ksession.dispose();




'kbuilder', 'kbase', 'ksession' are the variable identifiers often used, the k prefix is for 'knowledge'.



The majority of Drools API is considered stable and should not change, experimental classes and apis will be marked as such.