Package org.apache.maven.building

Class DefaultProblem

java.lang.Object
org.apache.maven.building.DefaultProblem
All Implemented Interfaces:
Problem
class DefaultProblem extends Object implements Problem
Describes a problem that was encountered during settings building. A problem can either be an exception that was thrown or a simple string message. In addition, a problem carries a hint about its source, e.g. the settings file that exhibits the problem.

  • Field Details

    • source

      private final String source

    • lineNumber

      private final int lineNumber

    • columnNumber

      private final int columnNumber

    • message

      private final String message

    • exception

      private final Exception exception

    • severity

      private final Problem.Severity severity

  • Constructor Details

    • DefaultProblem

      DefaultProblem(String message, Problem.Severity severity, String source, int lineNumber, int columnNumber, Exception exception)
      Creates a new problem with the specified message and exception. Either message or exception is required
      Parameters:
      message - The message describing the problem, may be null.
      severity - The severity level of the problem, may be null to default to
      invalid reference 
      SettingsProblem.Severity#ERROR
      .
      source - A hint about the source of the problem like a file path, may be null.
      lineNumber - The one-based index of the line containing the problem or -1 if unknown.
      columnNumber - The one-based index of the column containing the problem or -1 if unknown.
      exception - The exception that caused this problem, may be null.

  • Method Details

    • getSource

      public String getSource()
      Description copied from interface: Problem
      Gets the hint about the source of the problem. While the syntax of this hint is unspecified and depends on the creator of the problem, the general expectation is that the hint provides sufficient information to the user to track the problem back to its origin. A concrete example for such a source hint can be the file path or URL from which the settings were read.
      Specified by:
      getSource in interface Problem
      Returns:
      The hint about the source of the problem or an empty string if unknown, never null.

    • getLineNumber

      public int getLineNumber()
      Description copied from interface: Problem
      Gets the one-based index of the line containing the problem. The line number should refer to some text file that is given by Problem.getSource().
      Specified by:
      getLineNumber in interface Problem
      Returns:
      The one-based index of the line containing the problem or a non-positive value if unknown.

    • getColumnNumber

      public int getColumnNumber()
      Description copied from interface: Problem
      Gets the one-based index of the column containing the problem. The column number should refer to some text file that is given by Problem.getSource().
      Specified by:
      getColumnNumber in interface Problem
      Returns:
      The one-based index of the column containing the problem or non-positive value if unknown.

    • getLocation

      public String getLocation()
      Description copied from interface: Problem
      Gets the location of the problem. The location is a user-friendly combination of the values from Problem.getSource(), Problem.getLineNumber() and Problem.getColumnNumber(). The exact syntax of the returned value is undefined.
      Specified by:
      getLocation in interface Problem
      Returns:
      The location of the problem, never null.

    • getException

      public Exception getException()
      Description copied from interface: Problem
      Gets the exception that caused this problem (if any).
      Specified by:
      getException in interface Problem
      Returns:
      The exception that caused this problem or null if not applicable.

    • getMessage

      public String getMessage()
      Description copied from interface: Problem
      Gets the message that describes this problem.
      Specified by:
      getMessage in interface Problem
      Returns:
      The message describing this problem, never null.

    • getSeverity

      public Problem.Severity getSeverity()
      Description copied from interface: Problem
      Gets the severity level of this problem.
      Specified by:
      getSeverity in interface Problem
      Returns:
      The severity level of this problem, never null.

    • toString

      public String toString()
      Overrides:
      toString in class Object