Package org.apache.maven.model.building
Class DefaultModelProblem
- java.lang.Object
-
- org.apache.maven.model.building.DefaultModelProblem
-
- All Implemented Interfaces:
ModelProblem
public class DefaultModelProblem extends Object implements ModelProblem
Describes a problem that was encountered during model 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 POM file that exhibits the problem.- Author:
- Benjamin Bentmann
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface org.apache.maven.model.building.ModelProblem
ModelProblem.Severity, ModelProblem.Version
-
-
Constructor Summary
Constructors Constructor Description DefaultModelProblem(String message, ModelProblem.Severity severity, ModelProblem.Version version, String source, int lineNumber, int columnNumber, String modelId, Exception exception)
Creates a new problem with the specified message and exception.DefaultModelProblem(String message, ModelProblem.Severity severity, ModelProblem.Version version, Model source, int lineNumber, int columnNumber, Exception exception)
Creates a new problem with the specified message and exception.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description int
getColumnNumber()
Gets the one-based index of the column containing the problem.Exception
getException()
Gets the exception that caused this problem (if any).int
getLineNumber()
Gets the one-based index of the line containing the problem.String
getMessage()
Gets the message that describes this problem.String
getModelId()
Gets the identifier of the model from which the problem originated.ModelProblem.Severity
getSeverity()
Gets the severity level of this problem.String
getSource()
Gets the hint about the source of the problem.ModelProblem.Version
getVersion()
Gets the applicable maven version/validation level of this problemString
toString()
-
-
-
Constructor Detail
-
DefaultModelProblem
public DefaultModelProblem(String message, ModelProblem.Severity severity, ModelProblem.Version version, Model source, int lineNumber, int columnNumber, Exception exception)
Creates a new problem with the specified message and exception.- Parameters:
message
- The message describing the problem, may benull
.severity
- The severity level of the problem, may benull
to default toModelProblem.Severity.ERROR
.source
- The source of the problem, may benull
.lineNumber
- The one-based index of the line containing the error or-1
if unknown.columnNumber
- The one-based index of the column containing the error or-1
if unknown.exception
- The exception that caused this problem, may benull
.
-
DefaultModelProblem
public DefaultModelProblem(String message, ModelProblem.Severity severity, ModelProblem.Version version, String source, int lineNumber, int columnNumber, String modelId, Exception exception)
Creates a new problem with the specified message and exception.- Parameters:
message
- The message describing the problem, may benull
.severity
- The severity level of the problem, may benull
to default toModelProblem.Severity.ERROR
.version
- The version since the problem is relevantsource
- A hint about the source of the problem like a file path, may benull
.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.modelId
- The identifier of the model that exhibits the problem, may benull
.exception
- The exception that caused this problem, may benull
.
-
-
Method Detail
-
getSource
public String getSource()
Description copied from interface:ModelProblem
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 a POM was read.- Specified by:
getSource
in interfaceModelProblem
- 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:ModelProblem
Gets the one-based index of the line containing the problem. The line number should refer to some text file that is given byModelProblem.getSource()
.- Specified by:
getLineNumber
in interfaceModelProblem
- 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:ModelProblem
Gets the one-based index of the column containing the problem. The column number should refer to some text file that is given byModelProblem.getSource()
.- Specified by:
getColumnNumber
in interfaceModelProblem
- Returns:
- The one-based index of the column containing the problem or non-positive value if unknown.
-
getModelId
public String getModelId()
Description copied from interface:ModelProblem
Gets the identifier of the model from which the problem originated. While the general form of this identifier isgroupId:artifactId:version
the returned identifier need not be complete. The identifier is derived from the information that is available at the point the problem occurs and as such merely serves as a best effort to provide information to the user to track the problem back to its origin.- Specified by:
getModelId
in interfaceModelProblem
- Returns:
- The identifier of the model from which the problem originated or an empty string if unknown, never
null
.
-
getException
public Exception getException()
Description copied from interface:ModelProblem
Gets the exception that caused this problem (if any).- Specified by:
getException
in interfaceModelProblem
- Returns:
- The exception that caused this problem or
null
if not applicable.
-
getMessage
public String getMessage()
Description copied from interface:ModelProblem
Gets the message that describes this problem.- Specified by:
getMessage
in interfaceModelProblem
- Returns:
- The message describing this problem, never
null
.
-
getSeverity
public ModelProblem.Severity getSeverity()
Description copied from interface:ModelProblem
Gets the severity level of this problem.- Specified by:
getSeverity
in interfaceModelProblem
- Returns:
- The severity level of this problem, never
null
.
-
getVersion
public ModelProblem.Version getVersion()
Description copied from interface:ModelProblem
Gets the applicable maven version/validation level of this problem- Specified by:
getVersion
in interfaceModelProblem
- Returns:
- The version, never
null
.
-
-