Red Hat SummitEste contenido no está disponible en el idioma seleccionado.
Chapter 9. Building
9.1. Build Result Severity
Copiar enlaceEnlace copiado en el portapapeles!
You can change the default severity of a type of build result. This can be useful if, for example, a new rule with a duplicate name of an existing rule is added to a package. (In this case, the default behavior is to replace the old rule with the new rule and report it as an INFO.) In some deployments the user might want to prevent the rule update and report it as an error.
9.2. Setting the Default Build Result Severity
Copiar enlaceEnlace copiado en el portapapeles!
Procedure 9.1. Task
- To configure it using system properties or configuration files, insert the following properties:
// sets the severity of rule updates drools.kbuilder.severity.duplicateRule = <INFO|WARNING|ERROR> // sets the severity of function updates drools.kbuilder.severity.duplicateFunction = <INFO|WARNING|ERROR>
// sets the severity of rule updates drools.kbuilder.severity.duplicateRule = <INFO|WARNING|ERROR> // sets the severity of function updates drools.kbuilder.severity.duplicateFunction = <INFO|WARNING|ERROR>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - To use the API to change the severities, use this code:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
9.3. KnowledgePackage
Copiar enlaceEnlace copiado en el portapapeles!
A Knowledge Package is a collection of Knowledge Definitions, such as rules and processes. It is created by the Knowledge Builder. Knowledge Packages are self-contained and serializable, and they currently form the basic deployment unit.
Note
A Knowledge Package instance cannot be reused once it's added to the Knowledge Base. If you need to add it to another Knowledge Base, serialize it and use the "cloned" result.
9.4. Creating a new KnowledgeBase
Copiar enlaceEnlace copiado en el portapapeles!
Procedure 9.2. Task
- Use this default configuration to create a new KnowledgeBase:
KnowledgeBase kbase = KnowledgeBaseFactory.newKnowledgeBase();
KnowledgeBase kbase = KnowledgeBaseFactory.newKnowledgeBase();Copy to Clipboard Copied! Toggle word wrap Toggle overflow - If a custom class loader was used with the
KnowledgeBuilderto resolve types not in the default class loader, then that must also be set on theKnowledgeBase. The technique for this is the same as with theKnowledgeBuilderand is shown below:KnowledgeBaseConfiguration kbaseConf = KnowledgeBaseFactory.createKnowledgeBaseConfiguration( null, cl ); KnowledgeBase kbase = KnowledgeBaseFactory.newKnowledgeBase( kbaseConf );KnowledgeBaseConfiguration kbaseConf = KnowledgeBaseFactory.createKnowledgeBaseConfiguration( null, cl ); KnowledgeBase kbase = KnowledgeBaseFactory.newKnowledgeBase( kbaseConf );Copy to Clipboard Copied! Toggle word wrap Toggle overflow
9.5. In-Process Building and Deployment
Copiar enlaceEnlace copiado en el portapapeles!
In-process building is the simplest form of deployment. It compiles the knowledge definitions and adds them to the Knowledge Base in the same JVM. This approach requires
drools-core.jar and drools-compiler.jar to be on the classpath.
9.6. Add KnowledgePackages to a KnowledgeBase
Copiar enlaceEnlace copiado en el portapapeles!
Procedure 9.3. Task
- To add KnowledgePackages to a KnowledgeBase, use this code:
Collection<KnowledgePackage> kpkgs = kbuilder.getKnowledgePackages(); KnowledgeBase kbase = KnowledgeBaseFactory.newKnowledgeBase(); kbase.addKnowledgePackages( kpkgs );
Collection<KnowledgePackage> kpkgs = kbuilder.getKnowledgePackages(); KnowledgeBase kbase = KnowledgeBaseFactory.newKnowledgeBase(); kbase.addKnowledgePackages( kpkgs );Copy to Clipboard Copied! Toggle word wrap Toggle overflow TheaddKnowledgePackages(kpkgs)method can be called iteratively to add additional knowledge.
9.7. Building and Deployment in Separate Processes
Copiar enlaceEnlace copiado en el portapapeles!
Both the
KnowledgeBase and the KnowledgePackage are units of deployment and serializable. This means you can have one machine do any necessary building, requiring drools-compiler.jar, and have another machine deploy and execute everything, needing only drools-core.jar.
9.8. Writing the KnowledgePackage to an OutputStream
Copiar enlaceEnlace copiado en el portapapeles!
This is the code for writing the KnowledgePackage to an OutputStream:
ObjectOutputStream out = new ObjectOutputStream( new FileOutputStream( fileName ) ); out.writeObject( kpkgs ); out.close();
ObjectOutputStream out = new ObjectOutputStream( new FileOutputStream( fileName ) );
out.writeObject( kpkgs );
out.close();
9.9. Reading the KnowledgePackage from an InputStream
Copiar enlaceEnlace copiado en el portapapeles!
Use this code for reading the KnowledgePackage from an InputStream:
9.10. The JBoss Rules Management System
Copiar enlaceEnlace copiado en el portapapeles!
The JBoss Rules Management system is a repository for KnowledgeBases. It helps to maintain large sets of rules.
Additionally, the system compiles and publishes serialized Knowledge Packages to a URL which is then used to load the packages.
9.11. StatefulknowledgeSessions and KnowledgeBase Modifications
Copiar enlaceEnlace copiado en el portapapeles!
The
KnowledgeBase creates and returns StatefulKnowledgeSession objects and can optionally keep references to them.
When
KnowledgeBase modifications occur, they are applied against the data in the sessions. This reference is a weak reference and it is also optional. It is controlled by a boolean flag.
9.12. New KnowledgeAgents
Copiar enlaceEnlace copiado en el portapapeles!
This is the code for making a new KnowledgeAgent:
KnowledgeAgent kagent = KnowledgeAgentFactory.newKnowledgeAgent( "MyAgent" );
KnowledgeAgent kagent = KnowledgeAgentFactory.newKnowledgeAgent( "MyAgent" );
9.13. Writing the KnowledgePackage to an OutputStream
Copiar enlaceEnlace copiado en el portapapeles!
This is how to write the KnowledgePackage to an OutputStream:
KnowledgeAgent kagent = KnowledgeAgentFactory.newKnowledgeAgent( "MyAgent" ); kagent.applyChangeSet( ResourceFactory.newUrlResource( url ) ); KnowledgeBase kbase = kagent.getKnowledgeBase();
KnowledgeAgent kagent = KnowledgeAgentFactory.newKnowledgeAgent( "MyAgent" );
kagent.applyChangeSet( ResourceFactory.newUrlResource( url ) );
KnowledgeBase kbase = kagent.getKnowledgeBase();
Note
Resource scanning is not on by default. It must be started. This also applies to notification. Both can be done via the ResourceFactory.
9.14. Starting the Scanning and Notification Services
Copiar enlaceEnlace copiado en el portapapeles!
This is the code for starting scanning and notification services:
ResourceFactory.getResourceChangeNotifierService().start(); ResourceFactory.getResourceChangeScannerService().start();
ResourceFactory.getResourceChangeNotifierService().start();
ResourceFactory.getResourceChangeScannerService().start();
9.15. The ResourceChangeScanner
Copiar enlaceEnlace copiado en el portapapeles!
The ResourceChangeScanner is used to scan for services. The default resource scanning period may be changed via the
ResourceChangeScannerService. A suitably updated ResourceChangeScannerConfiguration object is passed to the service's configure() method, which allows for the service to be reconfigured on demand.
9.16. Changing the Scanning Intervals
Copiar enlaceEnlace copiado en el portapapeles!
This is the code to use to change scanning intervals:
9.17. Interactions Between Knowledge Agents and Knowledge Bases
Copiar enlaceEnlace copiado en el portapapeles!
Knowledge Agents can process both an empty Knowledge Base or a populated one. If a populated Knowledge Base is provided, the Knowledge Agent will run an iterator from Knowledge Base and subscribe to the resources that it finds. While it is possible for the Knowledge Builder to build all resources found in a directory, that information is lost by the Knowledge Builder so that those directories will not be continuously scanned. Only directories specified as part of the
applyChangeSet(Resource) method are monitored.
One of the advantages of providing
KnowledgeBase as the starting point is that you can provide it with a KnowledgeBaseConfiguration. When resource changes are detected and a new KnowledgeBase object is instantiated, it will use the KnowledgeBaseConfiguration of the previous KnowledgeBase object.
9.18. Using an Existing KnowledgeBase
Copiar enlaceEnlace copiado en el portapapeles!
This is the code for utilizing an existing KnowledgeBase:
In the above example
getKnowledgeBase() will return the same provided kbase instance until resource changes are detected and a new Knowledge Base is built. When the new Knowledge Base is built, it will be done with the KnowledgeBaseConfiguration that was provided to the previous KnowledgeBase.
9.19. The applyChangeSet() Method
Copiar enlaceEnlace copiado en el portapapeles!
If a ChangeSet XML is used with the
applyChangeSet() method it will add any directories to the scanning process. When the directory scan detects an additional file, it will be added to the Knowledge Base. Any removed file is removed from the Knowledge Base, and modified files will be removed from the Knowledge Base.
9.20. ChangeSet XML to Add Directory Contents
Copiar enlaceEnlace copiado en el portapapeles!
Use this XML to add the contents of a directory to a ChangeSet:
Note
Note that for the resource type PKG, the drools-compiler dependency is not needed. The Knowledge Agent is able to handle those with just drools-core.
9.21. The KnowledgeAgentConfiguration Property
Copiar enlaceEnlace copiado en el portapapeles!
The
KnowledgeAgentConfiguration can be used to modify a Knowledge Agent's default behavior. You can use this to load the resources from a directory while inhibiting the continuous scan for changes of that directory.
9.22. Change the Scanning Behavior
Copiar enlaceEnlace copiado en el portapapeles!
Use this code to change the scanning behavior:
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}