io.jenkins.plugins.artifact_manager_jclouds

Class BlobStoreProvider

java.lang.Object

hudson.model.AbstractDescribableImpl<BlobStoreProvider>

io.jenkins.plugins.artifact_manager_jclouds.BlobStoreProvider

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.Describable<BlobStoreProvider>, Serializable

Direct Known Subclasses:

S3BlobStore

@Restricted(value=org.kohsuke.accmod.restrictions.Beta.class)
public abstract class BlobStoreProvider
extends hudson.model.AbstractDescribableImpl<BlobStoreProvider>
implements hudson.ExtensionPoint, Serializable

Provider for jclouds-based blob stores usable for artifact storage. An instance will be copied into a build record together with any fields it defines.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BlobStoreProvider.HttpMethod

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor and Description
BlobStoreProvider()

Method Summary

Modifier and Type	Method and Description
abstract String	getContainer() A constant for the blob container name to use.
abstract org.jclouds.blobstore.BlobStoreContext	getContext() Creates the jclouds handle for working with blob.
BlobStoreProviderDescriptor	getDescriptor()
abstract String	getPrefix() A constant for the blob path prefix to use.
abstract boolean	isDeleteArtifacts() A constant to define whether we should delete artifacts or leave them to be managed on the blob service side.
abstract boolean	isDeleteStashes() A constant to define whether we should delete stashes or leave them to be managed on the blob service side.
abstract URL	toExternalURL(org.jclouds.blobstore.domain.Blob blob, BlobStoreProvider.HttpMethod httpMethod) Generate a URL valid for downloading OR uploading the blob for a limited period of time
abstract URI	toURI(String container, String key) Get a provider-specific URI.

Methods inherited from class java.lang.Object

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

Constructor Detail

BlobStoreProvider

public BlobStoreProvider()

Method Detail

getPrefix

@NonNull
public abstract String getPrefix()

A constant for the blob path prefix to use.

getContainer

@NonNull
public abstract String getContainer()

A constant for the blob container name to use.

isDeleteArtifacts

public abstract boolean isDeleteArtifacts()

A constant to define whether we should delete artifacts or leave them to be managed on the blob service side.

isDeleteStashes

public abstract boolean isDeleteStashes()

A constant to define whether we should delete stashes or leave them to be managed on the blob service side.

getContext

@NonNull
public abstract org.jclouds.blobstore.BlobStoreContext getContext()
                                                                    throws IOException

Creates the jclouds handle for working with blob.

Throws:

IOException

toURI

@NonNull
public abstract URI toURI(@NonNull
                                   String container,
                                   @NonNull
                                   String key)

Get a provider-specific URI.

Parameters:

container - container where this exists.

key - fully qualified name relative to the container.

Returns:

the URI

toExternalURL

@NonNull
public abstract URL toExternalURL(@NonNull
                                           org.jclouds.blobstore.domain.Blob blob,
                                           @NonNull
                                           BlobStoreProvider.HttpMethod httpMethod)
                                    throws IOException

Generate a URL valid for downloading OR uploading the blob for a limited period of time

Parameters:

blob - blob to generate the URL for

httpMethod - HTTP method to create a URL for (downloads or uploads)

Returns:

the URL

Throws:

IOException

getDescriptor

public BlobStoreProviderDescriptor getDescriptor()

Specified by:

getDescriptor in interface hudson.model.Describable<BlobStoreProvider>

Overrides:

getDescriptor in class hudson.model.AbstractDescribableImpl<BlobStoreProvider>