红帽全球峰会此内容没有您所选择的语言版本。
6.3. The Knowledge Agent
6.3.1. Knowledge Agent
复制链接链接已复制到粘贴板!
The Knowledge Agent provides automatic loading, caching and re-loading of resources and is configured from a Knowledge Base properties files. The Knowledge Agent can update or rebuild a Knowledge Base as the resources it uses are changed. The strategy for this is determined by the configuration given to the factory, but it is typically pull-based using regular polling.
Below is a Knowledge Agent example:
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();
The code below is responsible for making a new KnowledgeAgent:
KnowledgeAgent kagent = KnowledgeAgentFactory.newKnowledgeAgent( "MyAgent" );
KnowledgeAgent kagent = KnowledgeAgentFactory.newKnowledgeAgent( "MyAgent" );
6.3.2. KnowledgeAgent Objects
复制链接链接已复制到粘贴板!
A
KnowledgeAgent object will continuously scan all resources using a default polling interval of 60 seconds. When a modification date is updated, it will applied the changes into the cached Knowledge Base using the new resources. The previous KnowledgeBase reference will still exist and you'll have to call getKnowledgeBase() to access the newly built KnowledgeBase. If a directory is specified as part of the change set, the entire contents of that directory will be scanned for changes. The way modifications are applied depends on drools.agent.newInstance property present in the KnowledgeAgentConfiguration object passed to the agent.
6.3.3. Writing the KnowledgePackage to an OutputStream
复制链接链接已复制到粘贴板!
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();
6.3.4. ClassLoaders
复制链接链接已复制到粘贴板!
6.3.4.1. Custom ClassLoaders for KnowledgeBuilder
复制链接链接已复制到粘贴板!
The Knowledge Agent could end up failing during the compiling or executing process while using classes outside the agent's classloader. If this occurs, use a custom classloader for the Knowledge Agent's kbuilder or force the Knowledge Agent to use the same classloader that its kbase uses.
Procedure 6.4. Custom Classloaders for KnowledgeBuilder
- Open a KnowledgeBuilderConfiguration and specify a custom classloader.
- If you need to pass custom configuration to these compilers, sends a KnowledgeBuilderConfiguration object to KnowledgeAgentFactory.newKnowledgeAgent().
This object will be used in every builder the agent creates.
Procedure 6.5. Reusing the KnowledgeBase ClassLoader
- Determine if the classloader you want to use in the compilation process of remote resources is the same needed in the Knowledge Agent's kbase, so the rules can be executed.
- Set up the desired ClassLoader to the agent kbase and use the
drools.agent.useKBaseClassLoaderForCompilingproperty of KnowledgeAgentConfiguration object. - Modify the agent's kbuilder classloader in runtime by modifying the agent's kbase classloader.
The following is an example of the KnowledgeAgentConfiguration property:
6.3.5. newInstance
复制链接链接已复制到粘贴板!
6.3.5.1. The newInstance Property
复制链接链接已复制到粘贴板!
The newInstance property assists in processing change sets.
A Knowledge Agent can process change sets in two different ways: recreating the knowledge base every time a new change set is processed or applying the change set in the cached knowledge base without destroying it. This behavior is controlled by the KnowledgeAgentConfiguration object's newInstance property when it is passed to the Agent's constructor.
6.3.6. Resource Scanning
复制链接链接已复制到粘贴板!
6.3.6.1. Starting the Scanning and Notification Services
复制链接链接已复制到粘贴板!
This is the code for starting scanning and notification services:
ResourceFactory.getResourceChangeNotifierService().start(); ResourceFactory.getResourceChangeScannerService().start();
ResourceFactory.getResourceChangeNotifierService().start();
ResourceFactory.getResourceChangeScannerService().start();
Note
Resource scanning is not on by default. It must be started. This also applies to notification. Both can be done via the ResourceFactory.
6.3.6.2. The ResourceChangeScanner
复制链接链接已复制到粘贴板!
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.
6.3.6.3. Changing the Scanning Intervals
复制链接链接已复制到粘贴板!
This is the code to use to change scanning intervals:
6.3.6.4. The KnowledgeAgentConfiguration Property
复制链接链接已复制到粘贴板!
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.
6.3.6.5. Change the Scanning Behavior
复制链接链接已复制到粘贴板!
Use this code to change the scanning behavior:
6.3.7. Knowledge Bases and applyChangeSet()
复制链接链接已复制到粘贴板!
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.
6.3.7.2. Using an Existing KnowledgeBase
复制链接链接已复制到粘贴板!
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.
6.3.7.3. The applyChangeSet() Method
复制链接链接已复制到粘贴板!
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.
6.3.7.4. ChangeSet XML to Add Directory Contents
复制链接链接已复制到粘贴板!
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.
6.3.8. Resource Caching
复制链接链接已复制到粘贴板!
6.3.8.1. Restoring Resource Caching After a Restart
复制链接链接已复制到粘贴板!
If your knowledge agent is pulling resources from an http(s) URL, the resource from the remote web server may suddenly disappear.
Procedure 6.6. Resource Restart
- To survive a restart when a resource is no longer available remotely (for example, the remote server is being restarted), set a System Property:
drools.resource.urlcache. - Make sure that System Property is set to a directory that has write permissions for the application. The Knowledge Agent will cache copies of the remote resources in that directory.
- Using the java command line
-Ddrools.resource.urlcache=/users/someone/KnowledgeCache- will keep local copies of the resources (rules, packages etc) in that directory for the agent to use should it be restarted. (When a remote resource becomes available, and is updated, it will automatically update the local cache copy.)
'%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}