org.apache.maven.model.building
Class ModelBuildingException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          org.apache.maven.model.building.ModelBuildingException

All Implemented Interfaces:

Serializable

public class ModelBuildingException
extends Exception

Signals one ore more errors during model building. The model builder tries to collect as many problems as possible before eventually failing to provide callers with rich error information. Use getProblems() to query the details of the failure.

Author:

Benjamin Bentmann

See Also:

Serialized Form

Constructor Summary

ModelBuildingException(ModelBuildingResult result)
Creates a new exception from the specified interim result and its associated problems.

ModelBuildingException(Model model, String modelId, List<ModelProblem> problems)
Deprecated. Use ModelBuildingException(ModelBuildingResult) instead.

Method Summary

Model	getModel() Gets the model that could not be built properly.
String	getModelId() Gets the identifier of the POM whose effective model could not be built.
List<ModelProblem>	getProblems() Gets the problems that caused this exception.
ModelBuildingResult	getResult() Gets the interim result of the model building up to the point where it failed.

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ModelBuildingException

@Deprecated
public ModelBuildingException(Model model,
                                         String modelId,
                                         List<ModelProblem> problems)

Deprecated. Use ModelBuildingException(ModelBuildingResult) instead.

Creates a new exception with the specified problems.

Parameters:

model - The model that could not be built, may be null.

modelId - The identifier of the model that could not be built, may be null.

problems - The problems that causes this exception, may be null.

ModelBuildingException

public ModelBuildingException(ModelBuildingResult result)

Creates a new exception from the specified interim result and its associated problems.

Parameters:

result - The interim result, may be null.

Method Detail

getResult

public ModelBuildingResult getResult()

Gets the interim result of the model building up to the point where it failed.

Returns:

The interim model building result or null if not available.

getModel

public Model getModel()

Gets the model that could not be built properly.

Returns:

The erroneous model or null if not available.

getModelId

public String getModelId()

Gets the identifier of the POM whose effective model could not be built. The general format of the identifier is <groupId>:<artifactId>:<version> but some of these coordinates may still be unknown at the point the exception is thrown so this information is merely meant to assist the user.

Returns:

The identifier of the POM or an empty string if not known, never null.

getProblems

public List<ModelProblem> getProblems()

Gets the problems that caused this exception.

Returns:

The problems that caused this exception, never null.