站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JBoss RULES 4.0.0.11754MR2 API 英文版文档

PackageBuilder (Drools 4.0.0.11754MR2 API) - JBoss RULES 4.0.0.11754MR2 API 英文版文档


org.drools.compiler
Class PackageBuilder

java.lang.Object
  extended by org.drools.compiler.PackageBuilder
Direct Known Subclasses:
BRMSPackageBuilder

public class PackageBuilder
extends Object

This is the main compiler class for parsing and compiling rules and assembling or merging them into a binary Package instance. This can be done by merging into existing binary packages, or totally from source.


Nested Class Summary
static class PackageBuilder.ErrorHandler
          This is the super of the error handlers.
static class PackageBuilder.FunctionErrorHandler
           
static class PackageBuilder.MissingPackageNameException
           
static class PackageBuilder.RuleErrorHandler
           
static class PackageBuilder.RuleInvokerErrorHandler
          There isn't much point in reporting invoker errors, as they are no help.
 
Constructor Summary
PackageBuilder()
          Use this when package is starting from scratch.
PackageBuilder(Package pkg)
          This will allow you to merge rules into this pre existing package.
PackageBuilder(PackageBuilderConfiguration configuration)
           
PackageBuilder(Package pkg, PackageBuilderConfiguration configuration)
          This allows you to pass in a pre existing package, and a configuration (for instance to set the classloader).
 
Method Summary
 void addPackage(PackageDescr packageDescr)
          This adds a package from a Descr/AST This will also trigger a compile, if there are any generated classes to compile of course.
 void addPackageFromDrl(Reader reader)
          Load a rule package from DRL source.
 void addPackageFromDrl(Reader source, Reader dsl)
          Load a rule package from DRL source using the supplied DSL configuration.
 void addPackageFromXml(Reader reader)
          Load a rule package from XML source.
 PackageBuilderErrors getErrors()
           
 Package getPackage()
           
 boolean hasErrors()
          This will return true if there were errors in the package building and compiling phase
protected  void resetErrors()
          Reset the error list.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PackageBuilder

public PackageBuilder()
Use this when package is starting from scratch.


PackageBuilder

public PackageBuilder(Package pkg)
This will allow you to merge rules into this pre existing package.


PackageBuilder

public PackageBuilder(PackageBuilderConfiguration configuration)

PackageBuilder

public PackageBuilder(Package pkg,
                      PackageBuilderConfiguration configuration)
This allows you to pass in a pre existing package, and a configuration (for instance to set the classloader).

Parameters:
pkg - A pre existing package (can be null if none exists)
configuration - Optional configuration for this builder.
Method Detail

addPackageFromDrl

public void addPackageFromDrl(Reader reader)
                       throws DroolsParserException,
                              IOException
Load a rule package from DRL source.

Parameters:
reader -
Throws:
DroolsParserException
IOException

addPackageFromXml

public void addPackageFromXml(Reader reader)
                       throws DroolsParserException,
                              IOException
Load a rule package from XML source.

Parameters:
reader -
Throws:
DroolsParserException
IOException

addPackageFromDrl

public void addPackageFromDrl(Reader source,
                              Reader dsl)
                       throws DroolsParserException,
                              IOException
Load a rule package from DRL source using the supplied DSL configuration.

Parameters:
source - The source of the rules.
dsl - The source of the domain specific language configuration.
Throws:
DroolsParserException
IOException

addPackage

public void addPackage(PackageDescr packageDescr)
This adds a package from a Descr/AST This will also trigger a compile, if there are any generated classes to compile of course.


getPackage

public Package getPackage()
Returns:
The compiled package. The package may contain errors, which you can report on by calling getErrors or printErrors. If you try to add an invalid package (or rule) to a RuleBase, you will get a runtime exception. Compiled packages are serializable.

hasErrors

public boolean hasErrors()
This will return true if there were errors in the package building and compiling phase


getErrors

public PackageBuilderErrors getErrors()
Returns:
A list of Error objects that resulted from building and compiling the package.

resetErrors

protected void resetErrors()
Reset the error list. This is useful when incrementally building packages. Care should be used when building this, if you clear this when there were errors on items that a rule depends on (eg functions), then you will get spurious errors which will not be that helpful.



Copyright © 2001-2007 JBoss Inc.. All Rights Reserved.