org.apache.sling.distribution.packaging.impl

Class AbstractDistributionPackageBuilder

java.lang.Object

org.apache.sling.distribution.packaging.impl.AbstractDistributionPackageBuilder

All Implemented Interfaces:

DistributionPackageBuilder

Direct Known Subclasses:

FileDistributionPackageBuilder, ResourceDistributionPackageBuilder

public abstract class AbstractDistributionPackageBuilder
extends Object
implements DistributionPackageBuilder

base abstract implementation of a JCR based DistributionPackageBuilder

Method Summary

Modifier and Type	Method and Description
DistributionPackage	createPackage(org.apache.sling.api.resource.ResourceResolver resourceResolver, org.apache.sling.distribution.DistributionRequest request) creates a DistributionPackage for a specific DistributionRequest
protected abstract DistributionPackage	createPackageForAdd(org.apache.sling.api.resource.ResourceResolver resourceResolver, org.apache.sling.distribution.DistributionRequest request)
DistributionPackage	getPackage(org.apache.sling.api.resource.ResourceResolver resourceResolver, String id) get an already created (and saved into the repository) DistributionPackage by its id
protected abstract DistributionPackage	getPackageInternal(org.apache.sling.api.resource.ResourceResolver resourceResolver, String id)
String	getType() returns the type of a package.
boolean	installPackage(org.apache.sling.api.resource.ResourceResolver resourceResolver, DistributionPackage distributionPackage) Installs the given distributionPackage into the repository
DistributionPackageInfo	installPackage(org.apache.sling.api.resource.ResourceResolver resourceResolver, InputStream stream) install a stream and returns the associated to a DistributionPackageInfo this provider can read and install
protected abstract boolean	installPackageInternal(org.apache.sling.api.resource.ResourceResolver resourceResolver, InputStream stream)
DistributionPackage	readPackage(org.apache.sling.api.resource.ResourceResolver resourceResolver, InputStream stream) reads a stream and tries to convert it to a DistributionPackage this provider can read and install
protected abstract DistributionPackage	readPackageInternal(org.apache.sling.api.resource.ResourceResolver resourceResolver, InputStream stream)

Methods inherited from class java.lang.Object

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

Method Detail

getType

public String getType()

Description copied from interface: DistributionPackageBuilder

returns the type of a package. Only packages of this type will be accepted by the package builder.

Specified by:

getType in interface DistributionPackageBuilder

Returns:

the package type.

createPackage

@Nonnull
public DistributionPackage createPackage(@Nonnull
                                                  org.apache.sling.api.resource.ResourceResolver resourceResolver,
                                                  @Nonnull
                                                  org.apache.sling.distribution.DistributionRequest request)
                                           throws DistributionException

Description copied from interface: DistributionPackageBuilder

creates a DistributionPackage for a specific DistributionRequest

Specified by:

createPackage in interface DistributionPackageBuilder

Parameters:

resourceResolver - the resource resolver used to access the resources to be packaged

request - the DistributionRequest to create the package for

Returns:

a DistributionPackage or null if it could not be created

Throws:

DistributionException - if any error occurs while creating the package, or if the resource resolver is not authorized to do that

readPackage

@Nonnull
public DistributionPackage readPackage(@Nonnull
                                                org.apache.sling.api.resource.ResourceResolver resourceResolver,
                                                @Nonnull
                                                InputStream stream)
                                         throws DistributionException

Description copied from interface: DistributionPackageBuilder

reads a stream and tries to convert it to a DistributionPackage this provider can read and install

Specified by:

readPackage in interface DistributionPackageBuilder

Parameters:

resourceResolver - resource resolver used to store the eventually created package

stream - the InputStream of the package to read

Returns:

a DistributionPackage if it can read it from the stream

Throws:

DistributionException - when the stream cannot be read as a DistributionPackage

installPackage

public boolean installPackage(@Nonnull
                              org.apache.sling.api.resource.ResourceResolver resourceResolver,
                              @Nonnull
                              DistributionPackage distributionPackage)
                       throws DistributionException

Description copied from interface: DistributionPackageBuilder

Installs the given distributionPackage into the repository

Specified by:

installPackage in interface DistributionPackageBuilder

Parameters:

resourceResolver - the resource resolver used to install the packaged resources

distributionPackage - the distribution package to install

Returns:

true if the package was installed successfully

Throws:

DistributionException

installPackage

@Nonnull
public DistributionPackageInfo installPackage(@Nonnull
                                                       org.apache.sling.api.resource.ResourceResolver resourceResolver,
                                                       @Nonnull
                                                       InputStream stream)
                                                throws DistributionException

Description copied from interface: DistributionPackageBuilder

install a stream and returns the associated to a DistributionPackageInfo this provider can read and install

Specified by:

installPackage in interface DistributionPackageBuilder

Parameters:

resourceResolver - resource resolver used to store the eventually created package

stream - the InputStream of the package to read

Returns:

a DistributionPackage if it can read it from the stream

Throws:

DistributionException - when the stream cannot be read as a DistributionPackage

getPackage

@CheckForNull
public DistributionPackage getPackage(@Nonnull
                                                    org.apache.sling.api.resource.ResourceResolver resourceResolver,
                                                    @Nonnull
                                                    String id)

Description copied from interface: DistributionPackageBuilder

get an already created (and saved into the repository) DistributionPackage by its id

Specified by:

getPackage in interface DistributionPackageBuilder

Parameters:

resourceResolver - resource resolver used to access the package with the given id

id - the unique identifier of an already created DistributionPackage

Returns:

a DistributionPackage if one with such an id exists, null otherwise

createPackageForAdd

@CheckForNull
protected abstract DistributionPackage createPackageForAdd(@Nonnull
                                                                         org.apache.sling.api.resource.ResourceResolver resourceResolver,
                                                                         @Nonnull
                                                                         org.apache.sling.distribution.DistributionRequest request)
                                                                  throws DistributionException

Throws:

DistributionException

readPackageInternal

@CheckForNull
protected abstract DistributionPackage readPackageInternal(@Nonnull
                                                                         org.apache.sling.api.resource.ResourceResolver resourceResolver,
                                                                         @Nonnull
                                                                         InputStream stream)
                                                                  throws DistributionException

Throws:

DistributionException

installPackageInternal

protected abstract boolean installPackageInternal(@Nonnull
                                                  org.apache.sling.api.resource.ResourceResolver resourceResolver,
                                                  @Nonnull
                                                  InputStream stream)
                                           throws DistributionException

Throws:

DistributionException

getPackageInternal

@CheckForNull
protected abstract DistributionPackage getPackageInternal(@Nonnull
                                                                        org.apache.sling.api.resource.ResourceResolver resourceResolver,
                                                                        @Nonnull
                                                                        String id)