FilesystemStorageStrategyImpl (Apache jclouds 1.9.3 API)

java.lang.Object
- org.jclouds.filesystem.strategy.internal.FilesystemStorageStrategyImpl

All Implemented Interfaces:

LocalStorageStrategy
```
public class FilesystemStorageStrategyImpl
extends Object
implements LocalStorageStrategy
```
FilesystemStorageStrategyImpl implements a blob store that stores objects on the file system. Content metadata and user attributes are stored in extended attributes if the file system supports them. Directory blobs (blobs that end with a /) cannot have content, but otherwise appear in LIST like normal blobs.

Field Summary

Fields
Modifier and Type	Field and Description
`protected String`	`baseDirectory`
`protected javax.inject.Provider<BlobBuilder>`	`blobBuilders`
`protected FilesystemBlobKeyValidator`	`filesystemBlobKeyValidator`
`protected FilesystemContainerNameValidator`	`filesystemContainerNameValidator`
`protected Logger`	`logger`

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`FilesystemStorageStrategyImpl(javax.inject.Provider<BlobBuilder> blobBuilders, String baseDir, FilesystemContainerNameValidator filesystemContainerNameValidator, FilesystemBlobKeyValidator filesystemBlobKeyValidator)`

Method Summary

Methods
Modifier and Type	Method and Description
`boolean`	`blobExists(String container, String key)` Return true if a blob named by key exists
`protected String`	`buildPathStartingFromBaseDir(String... pathTokens)` Facility method used to concatenate path tokens normalizing separators
`void`	`clearContainer(String container)` Empty the container of its content (files and subdirectories), but doesn't delete the container itself
`void`	`clearContainer(String container, ListContainerOptions options)` Like `LocalStorageStrategy.clearContainer(String)` except you can use options to do things like recursive deletes, or clear at a different path than root.
`boolean`	`containerExists(String container)` Checks if a container exists
`long`	`countBlobs(String container, ListContainerOptions options)`
`boolean`	`createContainer(String container)`
`boolean`	`createContainerInLocation(String container, Location location, CreateContainerOptions options)` Creates a new container
`void`	`createDirectory(String container, String directory)`
`protected boolean`	`createDirectoryWithResult(String container, String directory)` Creates a directory and returns the result
`void`	`deleteContainer(String container)` Deletes a container and all its content
`void`	`deleteDirectory(String container, String directory)`
`boolean`	`directoryExists(String container, String directory)`
`Iterable<String>`	`getAllContainerNames()` Return an iterator that reports all the containers under base path
`Blob`	`getBlob(String container, String key)` Load the blob with the given key belonging to the container with the given name.
`BlobAccess`	`getBlobAccess(String containerName, String blobName)`
`Iterable<String>`	`getBlobKeysInsideContainer(String container)` Returns all the blobs key inside a container
`ContainerAccess`	`getContainerAccess(String container)`
`StorageMetadata`	`getContainerMetadata(String container)`
`File`	`getFileForBlobKey(String container, String blobKey)` Returns a `File` object that links to the blob
`Location`	`getLocation(String containerName)`
`String`	`getSeparator()`
`Blob`	`newBlob(String name)`
`String`	`putBlob(String containerName, Blob blob)` Write a `Blob` into a file
`void`	`removeBlob(String container, String blobKey)` Remove blob named by the given key
`void`	`setBlobAccess(String container, String name, BlobAccess access)`
`void`	`setContainerAccess(String container, ContainerAccess access)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - logger
```
protected Logger logger
```
  - blobBuilders
```
protected final javax.inject.Provider<BlobBuilder> blobBuilders
```
  - baseDirectory
```
protected final String baseDirectory
```
  - filesystemContainerNameValidator
```
protected final FilesystemContainerNameValidator filesystemContainerNameValidator
```
  - filesystemBlobKeyValidator
```
protected final FilesystemBlobKeyValidator filesystemBlobKeyValidator
```
- Constructor Detail
  - FilesystemStorageStrategyImpl
```
@Inject
protected FilesystemStorageStrategyImpl(javax.inject.Provider<BlobBuilder> blobBuilders,
                                    @Named(value="jclouds.filesystem.basedir")
                                    String baseDir,
                                    FilesystemContainerNameValidator filesystemContainerNameValidator,
                                    FilesystemBlobKeyValidator filesystemBlobKeyValidator)
```
- Method Detail
  - containerExists
```
public boolean containerExists(String container)
```
    Description copied from interface: LocalStorageStrategy
    
    Checks if a container exists
    
    Specified by:
    
    containerExists in interface LocalStorageStrategy
    
    Returns:
  - getAllContainerNames
```
public Iterable<String> getAllContainerNames()
```
    Description copied from interface: LocalStorageStrategy
    
    Return an iterator that reports all the containers under base path
    
    Specified by:
    
    getAllContainerNames in interface LocalStorageStrategy
    
    Returns:
  - createContainerInLocation
```
public boolean createContainerInLocation(String container,
                                Location location,
                                CreateContainerOptions options)
```
    Description copied from interface: LocalStorageStrategy
    
    Creates a new container
    
    Specified by:
    
    createContainerInLocation in interface LocalStorageStrategy
    
    Returns:
  - getContainerAccess
```
public ContainerAccess getContainerAccess(String container)
```
    Specified by:
    
    getContainerAccess in interface LocalStorageStrategy
  - setContainerAccess
```
public void setContainerAccess(String container,
                      ContainerAccess access)
```
    Specified by:
    
    setContainerAccess in interface LocalStorageStrategy
  - deleteContainer
```
public void deleteContainer(String container)
```
    Description copied from interface: LocalStorageStrategy
    
    Deletes a container and all its content
    
    Specified by:
    
    deleteContainer in interface LocalStorageStrategy
  - clearContainer
```
public void clearContainer(String container)
```
    Description copied from interface: LocalStorageStrategy
    
    Empty the container of its content (files and subdirectories), but doesn't delete the container itself
    
    Specified by:
    
    clearContainer in interface LocalStorageStrategy
  - clearContainer
```
public void clearContainer(String container,
                  ListContainerOptions options)
```
    Description copied from interface: LocalStorageStrategy
    
    Like LocalStorageStrategy.clearContainer(String) except you can use options to do things like recursive deletes, or clear at a different path than root.
    
    Specified by:
    
    clearContainer in interface LocalStorageStrategy
    
    Parameters:
    container - what to clear
    options - recursion and path to clear
  - getContainerMetadata
```
public StorageMetadata getContainerMetadata(String container)
```
    Specified by:
    
    getContainerMetadata in interface LocalStorageStrategy
    
    Returns:
    StorageMetadata associated with a container name, e.g., creation date and location
  - blobExists
```
public boolean blobExists(String container,
                 String key)
```
    Description copied from interface: LocalStorageStrategy
    
    Return true if a blob named by key exists
    
    Specified by:
    
    blobExists in interface LocalStorageStrategy
    
    Returns:
  - getBlobKeysInsideContainer
```
public Iterable<String> getBlobKeysInsideContainer(String container)
                                            throws IOException
```
    Returns all the blobs key inside a container
    
    Specified by:
    
    getBlobKeysInsideContainer in interface LocalStorageStrategy
    
    Parameters:
    container -
    
    Returns:
    
    Throws:
    
    IOException
  - getBlob
```
public Blob getBlob(String container,
           String key)
```
    Description copied from interface: LocalStorageStrategy
    
    Load the blob with the given key belonging to the container with the given name. There must exist a resource on the file system whose complete name is given concatenating the container name and the key
    
    Specified by:
    
    getBlob in interface LocalStorageStrategy
    
    Returns:
    the blob belonging to the given container with the given key
  - putBlob
```
public String putBlob(String containerName,
             Blob blob)
               throws IOException
```
    Description copied from interface: LocalStorageStrategy
    
    Write a Blob into a file
    
    Specified by:
    
    putBlob in interface LocalStorageStrategy
    
    Returns:
    etag of blob
    
    Throws:
    
    IOException
  - removeBlob
```
public void removeBlob(String container,
              String blobKey)
```
    Description copied from interface: LocalStorageStrategy
    
    Remove blob named by the given key
    
    Specified by:
    
    removeBlob in interface LocalStorageStrategy
  - getBlobAccess
```
public BlobAccess getBlobAccess(String containerName,
                       String blobName)
```
    Specified by:
    
    getBlobAccess in interface LocalStorageStrategy
  - setBlobAccess
```
public void setBlobAccess(String container,
                 String name,
                 BlobAccess access)
```
    Specified by:
    
    setBlobAccess in interface LocalStorageStrategy
  - getLocation
```
public Location getLocation(String containerName)
```
    Specified by:
    
    getLocation in interface LocalStorageStrategy
    
    Parameters:
    containerName - name of container
    
    Returns:
    Location of container or null
  - getSeparator
```
public String getSeparator()
```
    Specified by:
    
    getSeparator in interface LocalStorageStrategy
    
    Returns:
    path separator, either / or \
  - createContainer
```
public boolean createContainer(String container)
```
  - newBlob
```
public Blob newBlob(String name)
```
  - getFileForBlobKey
```
public File getFileForBlobKey(String container,
                     String blobKey)
```
    Returns a File object that links to the blob
    
    Parameters:
    container -
    blobKey -
    
    Returns:
  - directoryExists
```
public boolean directoryExists(String container,
                      String directory)
```
  - createDirectory
```
public void createDirectory(String container,
                   String directory)
```
  - deleteDirectory
```
public void deleteDirectory(String container,
                   String directory)
```
  - countBlobs
```
public long countBlobs(String container,
              ListContainerOptions options)
```
  - buildPathStartingFromBaseDir
```
protected String buildPathStartingFromBaseDir(String... pathTokens)
```
    Facility method used to concatenate path tokens normalizing separators
    
    Parameters:
    pathTokens - all the string in the proper order that must be concatenated in order to obtain the filename
    
    Returns:
    the resulting string
  - createDirectoryWithResult
```
protected boolean createDirectoryWithResult(String container,
                                String directory)
```
    Creates a directory and returns the result
    
    Parameters:
    container -
    directory -
    
    Returns:
    true if the directory was created, otherwise false

Class FilesystemStorageStrategyImpl

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

logger

blobBuilders

baseDirectory

filesystemContainerNameValidator

filesystemBlobKeyValidator

Constructor Detail

FilesystemStorageStrategyImpl

Method Detail

containerExists

getAllContainerNames

createContainerInLocation

getContainerAccess

setContainerAccess

deleteContainer

clearContainer

clearContainer

getContainerMetadata

blobExists

getBlobKeysInsideContainer

getBlob

putBlob

removeBlob

getBlobAccess

setBlobAccess

getLocation

getSeparator

createContainer

newBlob

getFileForBlobKey

directoryExists

createDirectory

deleteDirectory

countBlobs

buildPathStartingFromBaseDir

createDirectoryWithResult