Interface ProjectBuilder

All Known Implementing Classes:
DefaultProjectBuilder

public interface ProjectBuilder
Builds in-memory descriptions of projects.
  • Method Details

    • build

      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

      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

      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.
      See Also:
    • build

      List<ProjectBuildingResult> build(List<File> pomFiles, boolean recursive, ProjectBuildingRequest request) 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.
      request - 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.