Package oracle.rules.rl.exceptions

Class RLException

java.lang.Object
java.lang.Throwable
java.lang.Exception
oracle.rules.rl.exceptions.RLException
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
FactClassException, MultipleInheritanceException, ParseException, RLRuntimeException, TypeCheckException
public class RLException extends Exception
Base RL exception.
See Also:

  • Method Details

    • getSteExtraCtx

      public List<String> getSteExtraCtx()
      Function to generate the list of extra error context from the StackTraceElement
      Returns:
      list of error stack string

    • getMessage

      public String getMessage()
      Get the detailed message for this RLException.
      Overrides:
      getMessage in class Throwable
      Returns:
      the detailed message.

    • getDescription

      public String getDescription()
      Get the description of this exception
      Returns:
      the description

    • getSource

      public String getSource()
      Get the input source of this exception
      Returns:
      the input source

    • setSource

      public void setSource(String source)
      Set the input source of this exception. This should only be used internally by the RL parser.
      Parameters:
      source - the input source

    • getLine

      public int getLine()
      Get the line number where this exception occurred
      Returns:
      the line number

    • setLine

      public void setLine(int line)
      Deprecated.
      Set the line number where this exception occurred
      Parameters:
      line - number

    • getColumn

      public int getColumn()
      Get the column number
      Returns:
      the column number

    • setColumn

      public void setColumn(int column)
      Deprecated.
      Set the column number
      Parameters:
      column - number

    • getMsgID

      public String getMsgID()
      Get the message ID for this localized exception message. The message ID is the key in the message ResourceBundle.
      Returns:
      the message ID

    • getArgs

      public Object[] getArgs()
      Get the message arguments for this localized exception message.
      Returns:
      the message arguments

    • printRLStackTrace

      public void printRLStackTrace()
      Prints this RLException and an RL stack trace to System.err. The first line contains the name of the RL exception followed by the detail message. Subsequent lines a stack trace of RL location identification and possibly Java stack trace if a root cause exception is a Java exception. The RL location consists of a line, column and source. The source is typically the ruleset name though it may contain a file name if the RL include statement is used. The following is a typical example.

      RLNullPointerException: object cannot be null at line 12 in stackTraceContext /Rule(porsche)/Pattern(car)/Test[1]

      It was produced by the following RL code. ruleset stackTraceContext { class Car { String make; String model; } rule porsche { if (fact Car car && car.make.startsWith("Porsche")) { println(car.make + " " + car.model); } } assert(new Car()); } The first line of stack trace contains some extra context after the location message. This extra context is present for rule conditions, rule actions, functions, variables, and RL class definitions. It is there to assist with identifying the offending code in situations when RL is generated from a rule dictionary.

      The XPath-ish format consists of an RL construct. If the construct is named, the name appears enclosed in parentheses. If a number, n, appears in brackets after a construct it indicates the nth line following the previous construct. Careful RL generation by the Rule SDK will place each so referenced construct on a separate line.

      In the example RL stack trace, this indicates that the exception occurred in the first test following the pattern car in the rule porsche.

    • printRLStackTrace

      public void printRLStackTrace(PrintStream ps)
      Prints this RLException and an RL stack trace to specified PrintStream.
      Parameters:
      ps - the PrintStream to print to.

    • printRLStackTrace

      public void printRLStackTrace(PrintWriter pw)
      Prints this RLException and an RL stack trace to specified PrintWriter.
      Parameters:
      pw - the PrintWriter to print to.

    • addSrcTrace

      public void addSrcTrace(oracle.rules.rl.engine.shrt.Funcall f, oracle.rules.rl.exceptions.RLStackTraceElement ste, oracle.rules.rl.engine.shrt.RTCtx ctx)
      Internal use only.