Class RuleContext


  • public class RuleContext
    extends Object
    The RuleContext provides access to Rule processing state. This information includes the following global information:
    • The Report to which Rule Violations are sent.
    • Named attributes.
    As well as the following source file specific information:
    • A File for the source file.
    • The Language Version of the source file.
    It is required that all source file specific options be set between calls to difference source files. Failure to do so, may result in undefined behavior.
    • Constructor Detail

      • RuleContext

        public RuleContext()
        Default constructor.
      • RuleContext

        public RuleContext​(RuleContext ruleContext)
        Constructor which shares attributes and report listeners with the given RuleContext.
        Parameters:
        ruleContext - the context from which the values are shared
    • Method Detail

      • getReport

        public Report getReport()
        Get the Report to which Rule Violations are sent.
        Returns:
        The Report.
      • setReport

        public void setReport​(Report report)
        Set the Report to which Rule Violations are sent.
        Parameters:
        report - The Report.
      • getSourceCodeFile

        public File getSourceCodeFile()
        Get the File associated with the current source file.
        Returns:
        The File.
      • setSourceCodeFile

        public void setSourceCodeFile​(File sourceCodeFile)
        Set the File associated with the current source file. While this may be set to null, the exclude/include facilities will not work properly without a File.
        Parameters:
        sourceCodeFile - The File.
      • getSourceCodeFilename

        public String getSourceCodeFilename()
        Get the file name associated with the current source file. If there is no source file, then an empty string is returned.
        Returns:
        The file name.
      • setSourceCodeFilename

        @Deprecated
        public void setSourceCodeFilename​(String filename)
        Deprecated.
        This method will be removed. The file should only be set with setSourceCodeFile(File). Setting the filename here has no effect.
        Set the file name associated with the current source file.
        Parameters:
        filename - The file name.
      • getLanguageVersion

        public LanguageVersion getLanguageVersion()
        Get the LanguageVersion associated with the current source file.
        Returns:
        The LanguageVersion, null if unknown.
      • setLanguageVersion

        public void setLanguageVersion​(LanguageVersion languageVersion)
        Set the LanguageVersion associated with the current source file. This may be set to null to indicate the version is unknown and should be automatically determined.
        Parameters:
        languageVersion - The LanguageVersion.
      • setAttribute

        @Deprecated
        public boolean setAttribute​(String name,
                                    Object value)
        Deprecated.
        Stateful methods of the rule context will be removed. Their interaction with incremental analysis are unspecified.
        Set an attribute value on the RuleContext, if it does not already exist.

        Attributes can be shared between RuleContext instances. This operation is thread-safe.

        Attribute values should be modified directly via the reference provided. It is not necessary to call setAttribute(String, Object) to update an attribute value. Modifications made to the attribute value will automatically be seen by other threads. Because of this, you must ensure the attribute values are themselves thread safe.

        Parameters:
        name - The attribute name.
        value - The attribute value.
        Returns:
        true if the attribute was set, false otherwise.
        Throws:
        IllegalArgumentException - if name or value are null
      • getAttribute

        @Deprecated
        public Object getAttribute​(String name)
        Deprecated.
        Stateful methods of the rule context will be removed. Their interaction with incremental analysis are unspecified.
        Get an attribute value on the RuleContext.

        Attributes can be shared between RuleContext instances. This operation is thread-safe.

        Attribute values should be modified directly via the reference provided. It is not necessary to call setAttribute(String, Object) to update an attribute value. Modifications made to the attribute value will automatically be seen by other threads. Because of this, you must ensure the attribute values are themselves thread safe.

        Parameters:
        name - The attribute name.
        Returns:
        The current attribute value, or null if the attribute does not exist.
      • removeAttribute

        @Deprecated
        public Object removeAttribute​(String name)
        Deprecated.
        Stateful methods of the rule context will be removed. Their interaction with incremental analysis are unspecified.
        Remove an attribute value on the RuleContext.

        Attributes can be shared between RuleContext instances. This operation is thread-safe.

        Attribute values should be modified directly via the reference provided. It is not necessary to call setAttribute(String, Object) to update an attribute value. Modifications made to the attribute value will automatically be seen by other threads. Because of this, you must ensure the attribute values are themselves thread safe.

        Parameters:
        name - The attribute name.
        Returns:
        The current attribute value, or null if the attribute does not exist.
      • setIgnoreExceptions

        public void setIgnoreExceptions​(boolean ignoreExceptions)
        Configure whether exceptions during applying a rule should be ignored or not. If set to true then such exceptions are logged as warnings and the processing is continued with the next rule - the failing rule is simply skipped. This is the default behavior.
        If set to false then the processing will be aborted with the exception. This is especially useful during unit tests, in order to not oversee any exceptions.
        Parameters:
        ignoreExceptions - if true simply skip failing rules (default).
      • isIgnoreExceptions

        public boolean isIgnoreExceptions()
        Gets the configuration whether to skip failing rules (true) or whether to throw a a RuntimeException and abort the processing for the first failing rule.
        Returns:
        true when failing rules are skipped, false otherwise.