org.apache.maven.project
Interface ProjectBuilder

All Known Implementing Classes:
DefaultProjectBuilder

public interface ProjectBuilder

Builds in-memory descriptions of projects.


Method Summary
 ProjectBuildingResult build(Artifact projectArtifact, boolean allowStubModel, ProjectBuildingRequest request)
          Builds a project descriptor for the specified artifact.
 ProjectBuildingResult build(Artifact projectArtifact, ProjectBuildingRequest request)
          Builds a project descriptor for the specified artifact.
 ProjectBuildingResult build(File projectFile, ProjectBuildingRequest request)
          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 request)
          Builds a project descriptor for the specified model source.
 

Method Detail

build

ProjectBuildingResult build(File projectFile,
                            ProjectBuildingRequest request)
                            throws ProjectBuildingException
Builds a project descriptor from the specified POM file.

Parameters:
projectFile - The POM file to build the project from, must not be null.
request - 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

ProjectBuildingResult build(Artifact projectArtifact,
                            ProjectBuildingRequest request)
                            throws ProjectBuildingException
Builds a project descriptor for the specified artifact.

Parameters:
projectArtifact - The POM artifact to build the project from, must not be null.
request - 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

ProjectBuildingResult build(Artifact projectArtifact,
                            boolean allowStubModel,
                            ProjectBuildingRequest request)
                            throws ProjectBuildingException
Builds a project descriptor for the specified artifact.

Parameters:
projectArtifact - 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.
request - 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

ProjectBuildingResult build(ModelSource modelSource,
                            ProjectBuildingRequest request)
                            throws ProjectBuildingException
Builds a project descriptor for the specified model source.

Parameters:
modelSource - The source of the model to built the project descriptor from, must not be null.
request - 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

List<ProjectBuildingResult> build(List<File> pomFiles,
                                  boolean recursive,
                                  ProjectBuildingRequest config)
                                  throws ProjectBuildingException
Builds the projects for the specified POM files and optionally their children.

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.


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