org.apache.jackrabbit.vault.packaging.registry

Interface ExecutionPlanBuilder

public interface ExecutionPlanBuilder

Helps to construct an execution plan that can be serialized and given to the packaging backend for execution.

Method Summary

Modifier and Type	Method and Description
PackageTaskBuilder	addTask() Adds a new task to this builder.
ExecutionPlan	execute() builds an executes the plan synchronously.
ExecutionPlanBuilder	load(java.io.InputStream in) Loads the tasks from a serialized plan and replaces the plans already in this builder.
java.util.Set<PackageId>	preview() Triggers Validation and returns PackageIds of all packages to be installed by this builder
ExecutionPlanBuilder	save(java.io.OutputStream out) Serializes the tasks of this plan.
ExecutionPlanBuilder	validate() Validates this plan.
ExecutionPlanBuilder	with(Session session) Sets the JCR session for this execution plan.

Method Detail

load

ExecutionPlanBuilder load(java.io.InputStream in)
                   throws java.io.IOException

Loads the tasks from a serialized plan and replaces the plans already in this builder.

Parameters:

in - input stream to the data.

Returns:

this

Throws:

java.io.IOException - if an I/O error occurrs.

save

ExecutionPlanBuilder save(java.io.OutputStream out)
                   throws java.io.IOException,
                          PackageException

Serializes the tasks of this plan.

Parameters:

out - the output stream

Returns:

this

Throws:

java.io.IOException - if an I/O error occurrs.

PackageException - if this builder does not have valid tasks.

addTask

PackageTaskBuilder addTask()

Adds a new task to this builder.

Returns:

an package task builder that helps to assemble the task.

validate

ExecutionPlanBuilder validate()
                       throws java.io.IOException,
                              PackageException

Validates this plan.

Returns:

this.

Throws:

java.io.IOException - if an I/O error occurrs.

PackageException - if the plan is not valid.

with

ExecutionPlanBuilder with(Session session)

Sets the JCR session for this execution plan.

Parameters:

session - the session

Returns:

this.

preview

java.util.Set<PackageId> preview()
                          throws java.io.IOException,
                                 PackageException

Triggers Validation and returns PackageIds of all packages to be installed by this builder

Returns:

Set of packages to be installed by this builder.

Throws:

java.io.IOException - if an I/O error occurrs.

PackageException - if the plan is not valid.

execute

ExecutionPlan execute()
               throws java.io.IOException,
                      PackageException

builds an executes the plan synchronously.

Returns:

the execution plan.

Throws:

java.io.IOException - if an I/O error occurrs.

PackageException - if a package operation fails.