org.apache.maven.project
Class DefaultProjectBuilder

java.lang.Object
  org.apache.maven.project.DefaultProjectBuilder

All Implemented Interfaces:

ProjectBuilder

@Component(role=ProjectBuilder.class)
public class DefaultProjectBuilder
extends Object
implements ProjectBuilder

Version:

$Id: DefaultProjectBuilder.java 1002852 2010-09-29 21:31:34Z bentmann $

Constructor Summary

DefaultProjectBuilder()

Method Summary

ProjectBuildingResult	build(Artifact artifact, boolean allowStubModel, ProjectBuildingRequest configuration) Builds a project descriptor for the specified artifact.
ProjectBuildingResult	build(Artifact artifact, ProjectBuildingRequest configuration) Builds a project descriptor for the specified artifact.
ProjectBuildingResult	build(File pomFile, ProjectBuildingRequest configuration) Builds a project descriptor from the specified POM file.
List<ProjectBuildingResult>	build(List<File> pomFiles, boolean recursive, ProjectBuildingRequest config) Builds the projects for the specified POM files and optionally their children.
ProjectBuildingResult	build(ModelSource modelSource, ProjectBuildingRequest configuration) Builds a project descriptor for the specified model source.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultProjectBuilder

public DefaultProjectBuilder()

Method Detail

build

public ProjectBuildingResult build(File pomFile,
                                   ProjectBuildingRequest configuration)
                            throws ProjectBuildingException

Description copied from interface: ProjectBuilder

Builds a project descriptor from the specified POM file.

Specified by:

build in interface ProjectBuilder

Parameters:

pomFile - The POM file to build the project from, must not be null.

configuration - The project building request that holds further parameters, must not be null.

Returns:

The result of the project building, never null.

Throws:

ProjectBuildingException - If the project descriptor could not be successfully built.

build

public ProjectBuildingResult build(ModelSource modelSource,
                                   ProjectBuildingRequest configuration)
                            throws ProjectBuildingException

Description copied from interface: ProjectBuilder

Builds a project descriptor for the specified model source.

Specified by:

build in interface ProjectBuilder

Parameters:

modelSource - The source of the model to built the project descriptor from, must not be null.

configuration - The project building request that holds further parameters, must not be null.

Returns:

The result of the project building, never null.

Throws:

ProjectBuildingException - If the project descriptor could not be successfully built.

build

public ProjectBuildingResult build(Artifact artifact,
                                   ProjectBuildingRequest configuration)
                            throws ProjectBuildingException

Description copied from interface: ProjectBuilder

Builds a project descriptor for the specified artifact.

Specified by:

build in interface ProjectBuilder

Parameters:

artifact - The POM artifact to build the project from, must not be null.

configuration - The project building request that holds further parameters, must not be null.

Returns:

The result of the project building, never null.

Throws:

ProjectBuildingException - If the project descriptor could not be successfully built.

build

public ProjectBuildingResult build(Artifact artifact,
                                   boolean allowStubModel,
                                   ProjectBuildingRequest configuration)
                            throws ProjectBuildingException

Description copied from interface: ProjectBuilder

Builds a project descriptor for the specified artifact.

Specified by:

build in interface ProjectBuilder

Parameters:

artifact - The POM artifact to build the project from, must not be null.

allowStubModel - A flag controlling the case of a missing POM artifact. If true and the specified POM artifact does not exist, a simple stub model will be returned. If false, an exception will be thrown.

configuration - The project building request that holds further parameters, must not be null.

Returns:

The result of the project building, never null.

Throws:

ProjectBuildingException - If the project descriptor could not be successfully built.

build

public List<ProjectBuildingResult> build(List<File> pomFiles,
                                         boolean recursive,
                                         ProjectBuildingRequest config)
                                  throws ProjectBuildingException

Description copied from interface: ProjectBuilder

Builds the projects for the specified POM files and optionally their children.

Specified by:

build in interface ProjectBuilder

Parameters:

pomFiles - The POM files to build, must not be null.

recursive - true to recursively build sub modules referenced by the POM files, false to build only the specified POM files.

config - The project builder configuration that provides further parameters, must not be null.

Returns:

The results of the project builder where each result corresponds to one project that was built, never null.

Throws:

ProjectBuildingException - If an error was encountered during building of any project. ProjectBuildingException.getResults() provides access to the details of the problems.