Package org.craftercms.studio.impl.v2.repository.blob.s3

Class StudioAwsS3BlobStore

java.lang.Object

org.craftercms.commons.file.blob.impl.AbstractBlobStore<org.craftercms.commons.config.profiles.aws.S3Profile>

org.craftercms.commons.file.blob.impl.s3.AwsS3BlobStore

org.craftercms.studio.impl.v2.repository.blob.s3.StudioAwsS3BlobStore

All Implemented Interfaces:

org.craftercms.commons.file.blob.BlobStore, ContentRepository, StudioBlobStore, StudioBlobStoreAdapter, ContentRepository

public class StudioAwsS3BlobStore
extends org.craftercms.commons.file.blob.impl.s3.AwsS3BlobStore
implements StudioBlobStoreAdapter

Implementation of StudioBlobStore for AWS S3

Since:

3.1.6

Author:

joseross

Nested Class Summary

Nested classes/interfaces inherited from class org.craftercms.commons.file.blob.impl.AbstractBlobStore

org.craftercms.commons.file.blob.impl.AbstractBlobStore.Mapping

Field Summary

Fields

Modifier and Type	Field	Description
static String	OK
protected ServicesConfig	servicesConfig

Fields inherited from class org.craftercms.commons.file.blob.impl.s3.AwsS3BlobStore

clientFactory

Fields inherited from class org.craftercms.commons.file.blob.impl.AbstractBlobStore

id, mappings, pattern, profile, profileMapper, publishingTargetResolver

Fields inherited from interface org.craftercms.commons.file.blob.BlobStore

CONFIG_KEY_CONFIGURATION, CONFIG_KEY_ID, CONFIG_KEY_MAPPING, CONFIG_KEY_MAPPING_PREFIX, CONFIG_KEY_MAPPING_PUBLISHING_TARGET, CONFIG_KEY_MAPPING_STORE_TARGET, CONFIG_KEY_PATTERN

Constructor Summary

Constructors

Constructor	Description
StudioAwsS3BlobStore(ServicesConfig servicesConfig)

Method Summary

Modifier and Type	Method	Description
void	cancelPublishAll(String siteId, String publishingTarget)	Performs the cleanup after a failed publish all operation for the given site & target
void	checkContentExists(String site, String path)	Checks if a content exists at a given path and throw an exception if it does not.
void	completePublishAll(String siteId, String publishingTarget, RepositoryChanges changes, String comment)	Performs the actual publish of all changes for the given site & target
boolean	contentExists(String site, String path)	Determine if content exists in the repository at a given path
String	copyContent(String site, String fromPath, String toPath)	copy content from PathA to pathB
String	createFolder(String site, String path, String name)	create a folder
String	deleteContent(String site, String path, String approver)	delete content
InputStream	getContent(String site, String path)	get document from wcm content
long	getContentSize(String site, String path)	get file size
protected String	getFullKey(org.craftercms.commons.file.blob.impl.AbstractBlobStore.Mapping mapping, String path)
org.craftercms.commons.file.blob.Blob	getReference(String path)	Return a reference to a file in the store
void	initialPublish(String siteId)	Execute initial publish for given site
protected boolean	isFolder(String path)
Map<String,String>	moveContent(String site, String fromPath, String toPath, String newName)	move content from PathA to pathB
void	populateGitLog(String siteId)	Populates the full git log of the sandbox repository into the database
RepositoryChanges	preparePublishAll(String siteId, String publishingTarget)	Prepares the repository to publish all changes for the given site & target
void	publish(String site, String sandboxBranch, List<DeploymentItemTO> deploymentItems, String environment, String author, String comment)	Publish content to specified environment.
RepositoryChanges	publishAll(String siteId, String publishingTarget, String comment)	Publishes all changes for the given site & target
boolean	shallowContentExists(String site, String path)	This is a faster, but less accurate, version of contentExists.
String	writeContent(String site, String path, InputStream content)	write content

Methods inherited from class org.craftercms.commons.file.blob.impl.s3.AwsS3BlobStore

doGetContent, doInit, getClient, getKey, setClientFactory

Methods inherited from class org.craftercms.commons.file.blob.impl.AbstractBlobStore

getId, getMapping, getResource, init, isCompatible, setId, setPattern, setProfileMapper, setPublishingTargetResolver

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.craftercms.commons.file.blob.BlobStore

getId, getResource, init, isCompatible

Methods inherited from interface org.craftercms.studio.api.v1.repository.ContentRepository

moveContent

Methods inherited from interface org.craftercms.studio.api.v2.repository.blob.StudioBlobStoreAdapter

addRemote, cleanupRepositories, commitIdExists, commitIdExists, countUnprocessedCommits, createSiteCloneRemote, createSiteFromBlueprint, createVersion, createVersion, deleteGitLogForSite, deleteSite, getChangeSetPathsFromDelta, getContentByCommitId, getContentChildren, getContentVersionHistory, getEditCommitIds, getGitLog, getItem, getItemEnvironmentProperties, getLastEditCommitId, getOperations, getOperationsFromDelta, getPreviousCommitId, getPublishingHistory, getRepoFirstCommitId, getRepoLastCommitId, getSubtreeItems, getUnauditedCommits, getUnprocessedCommits, initialPublish, insertFullGitLog, insertGitLog, insertGitLog, isFolder, itemUnlock, listRemote, lockItem, lockItemForPublishing, markGitLogAudited, markGitLogProcessedBeforeMarker, markGitLogVerifiedProcessed, markGitLogVerifiedProcessedBulk, publishedRepositoryExists, pullFromRemote, pushToRemote, reloadRepository, removeRemote, removeRemoteRepositoriesForSite, repositoryExists, resetStagingRepository, revertContent, unLockItem, unLockItemForPublishing, updateGitlog, upsertGitLogList

Field Detail

OK

public static final String OK

See Also:

Constant Field Values

servicesConfig

protected ServicesConfig servicesConfig

Constructor Detail

StudioAwsS3BlobStore

public StudioAwsS3BlobStore(ServicesConfig servicesConfig)

Method Detail

isFolder

protected boolean isFolder(String path)

getFullKey

protected String getFullKey(org.craftercms.commons.file.blob.impl.AbstractBlobStore.Mapping mapping,
                            String path)

getReference

public org.craftercms.commons.file.blob.Blob getReference(String path)

Description copied from interface: StudioBlobStore

Return a reference to a file in the store

Specified by:

getReference in interface StudioBlobStore

Parameters:

path - the path of the file

Returns:

the blob object

contentExists

public boolean contentExists(String site,
                             String path)

Description copied from interface: ContentRepository

Determine if content exists in the repository at a given path

Specified by:

contentExists in interface ContentRepository

Specified by:

contentExists in interface ContentRepository

Parameters:

site - site id where the operation will be executed

path - path to check if content exists

Returns:

true if site has content object at path

checkContentExists

public void checkContentExists(String site,
                               String path)
                        throws ServiceLayerException

Description copied from interface: ContentRepository

Checks if a content exists at a given path and throw an exception if it does not.

Specified by:

checkContentExists in interface ContentRepository

Parameters:

site - id of the site

path - the content path

Throws:

ServiceLayerException - if no content is found at the given path

shallowContentExists

public boolean shallowContentExists(String site,
                                    String path)

Description copied from interface: ContentRepository

This is a faster, but less accurate, version of contentExists. This prioritizes performance over checking the actual underlying repository if the content is actually in the store or we simply hold a reference to the object in the actual store.

Specified by:

shallowContentExists in interface ContentRepository

Returns:

true if site has content object at path

getContent

public InputStream getContent(String site,
                              String path)

Description copied from interface: ContentRepository

get document from wcm content

Specified by:

getContent in interface ContentRepository

Parameters:

site - site id where the operation will be executed

path - path of the content

Returns:

document

getContentSize

public long getContentSize(String site,
                           String path)

Description copied from interface: ContentRepository

get file size

Specified by:

getContentSize in interface ContentRepository

Parameters:

site - site id where the operation will be executed

path - path to content

Returns:

Size in bytes

writeContent

public String writeContent(String site,
                           String path,
                           InputStream content)

Description copied from interface: ContentRepository

write content

Specified by:

writeContent in interface ContentRepository

Parameters:

site - site id where the operation will be executed

path - path to content

content - stream of content to write

Returns:

Commit Id if successful, null otherwise

createFolder

public String createFolder(String site,
                           String path,
                           String name)

Description copied from interface: ContentRepository

create a folder

Specified by:

createFolder in interface ContentRepository

Parameters:

site - site id where the operation will be executed

path - path to create a folder in

name - a folder name to create

Returns:

Commit Id if successful, null otherwise

deleteContent

public String deleteContent(String site,
                            String path,
                            String approver)

Description copied from interface: ContentRepository

delete content

Specified by:

deleteContent in interface ContentRepository

Parameters:

site - site id where the operation will be executed

path - path to content

approver - user that approves delete content

Returns:

Commit ID if successful, null otherwise

moveContent

public Map<String,String> moveContent(String site,
                                            String fromPath,
                                            String toPath,
                                            String newName)

Description copied from interface: ContentRepository

move content from PathA to pathB

Specified by:

moveContent in interface ContentRepository

Parameters:

site - site id where the operation will be executed

fromPath - source content

toPath - target path

newName - new file name for rename

Returns:

Commit ID if successful, empty string otherwise

copyContent

public String copyContent(String site,
                          String fromPath,
                          String toPath)

Description copied from interface: ContentRepository

copy content from PathA to pathB

Specified by:

copyContent in interface ContentRepository

Parameters:

site - site id where the operation will be executed

fromPath - paths to content

toPath - target path

Returns:

Commit ID if successful, empty string otherwise

publish

public void publish(String site,
                    String sandboxBranch,
                    List<DeploymentItemTO> deploymentItems,
                    String environment,
                    String author,
                    String comment)

Description copied from interface: ContentRepository

Publish content to specified environment.

Specified by:

publish in interface ContentRepository

Parameters:

site - site identifier

sandboxBranch - sandbox branch name

deploymentItems - items to be published

environment - environment to publish to

author - author

comment - submission comment

initialPublish

public void initialPublish(String siteId)

Description copied from interface: ContentRepository

Execute initial publish for given site

Specified by:

initialPublish in interface ContentRepository

Parameters:

siteId - site identifier

publishAll

public RepositoryChanges publishAll(String siteId,
                                    String publishingTarget,
                                    String comment)

Description copied from interface: ContentRepository

Publishes all changes for the given site & target

Specified by:

publishAll in interface ContentRepository

Parameters:

siteId - the id of the site

publishingTarget - the publishing target

comment - submission comment

preparePublishAll

public RepositoryChanges preparePublishAll(String siteId,
                                           String publishingTarget)

Description copied from interface: ContentRepository

Prepares the repository to publish all changes for the given site & target

Specified by:

preparePublishAll in interface ContentRepository

Parameters:

siteId - the id of the site

publishingTarget - the publishing target

Returns:

the set of changed files

completePublishAll

public void completePublishAll(String siteId,
                               String publishingTarget,
                               RepositoryChanges changes,
                               String comment)

Description copied from interface: ContentRepository

Performs the actual publish of all changes for the given site & target

Specified by:

completePublishAll in interface ContentRepository

Parameters:

siteId - the id of the site

publishingTarget - the publishing target

changes - the set of changed files

comment - submission comment

cancelPublishAll

public void cancelPublishAll(String siteId,
                             String publishingTarget)

Description copied from interface: ContentRepository

Performs the cleanup after a failed publish all operation for the given site & target

Specified by:

cancelPublishAll in interface ContentRepository

Parameters:

siteId - the id of the site

publishingTarget - the publishing target

populateGitLog

public void populateGitLog(String siteId)

Description copied from interface: ContentRepository

Populates the full git log of the sandbox repository into the database

Specified by:

populateGitLog in interface ContentRepository

Parameters:

siteId - the id of the site