org.apache.maven.model.building
Class ModelBuildingException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by 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.


Copyright © 2001-2012 The Apache Software Foundation. All Rights Reserved.