BroadleafFileServiceImpl (BroadleafCommerce Common Libraries 4.0.24-GA API)

java.lang.Object
- org.broadleafcommerce.common.file.service.BroadleafFileServiceImpl

All Implemented Interfaces:

BroadleafFileService
```
@Service(value="blFileService")
public class BroadleafFileServiceImpl
extends Object
implements BroadleafFileService
```
Many components in the Broadleaf Framework can benefit from creating and manipulating temporary files as well as storing and accessing files in a remote repository (such as AmazonS3). This service provides a pluggable way to provide those services via FileServiceProvider implementations. This service can be used by any component that needs to write files to an area shared by multiple application servers. For example usage, see SiteMapGenerator. The Broadleaf CMS module also uses this component to load, store, and manipulate images for the file-system. Generally, the process to create a new asset in the shared file system is ... 1. Call initializeWorkArea() to get a temporary directory 2. Create files, directories, etc. using the FileWorkArea.filePathLocation as the root directory. 3. Once your file processing is complete, call #addOrUpdateResources(FileWorkArea, FileApplicationType) to 4. Call #closeWorkArea() to clear out the temporary files

Author:

bpolster

Field Summary

Fields
Modifier and Type	Field and Description
`protected FileServiceProvider`	`defaultFileServiceProvider`
`protected BroadleafFileServiceExtensionManager`	`extensionManager`
`protected String`	`fileServiceClasspathDirectory`
`protected List<FileServiceProvider>`	`fileServiceProviders`
`protected int`	`maxGeneratedDirectoryDepth`
`protected String`	`tempFileSystemBaseDirectory`

Constructor Summary

Constructors
Constructor and Description

BroadleafFileServiceImpl()

Constructors
Constructor and Description
`BroadleafFileServiceImpl()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addOrUpdateResource(FileWorkArea workArea, File file, boolean removeFilesFromWorkArea)` Takes in a temporary work area and a single File and copies that files to the configured FileProvider's permanent storage.
`String`	`addOrUpdateResourceForPath(FileWorkArea workArea, File file, boolean removeFilesFromWorkArea)` Takes in a temporary work area and a single File and copies that files to the configured FileProvider's permanent storage.
`void`	`addOrUpdateResources(FileWorkArea workArea, boolean removeFilesFromWorkArea)` Takes in a temporary work area and copies all of the files to the configured FileProvider's permanent storage.
`void`	`addOrUpdateResources(FileWorkArea workArea, List<File> files, boolean removeFilesFromWorkArea)` Takes in a temporary work area and a list of Files and copies them to the configured FileProvider's permanent storage.
`List<String>`	`addOrUpdateResourcesForPaths(FileWorkArea workArea, boolean removeFilesFromWorkArea)` Takes in a temporary work area and copies all of the files to the configured FileProvider's permanent storage.
`List<String>`	`addOrUpdateResourcesForPaths(FileWorkArea workArea, List<File> files, boolean removeFilesFromWorkArea)` Takes in a temporary work area and a list of Files and copies them to the configured FileProvider's permanent storage.
`protected void`	`buildFileList(File file, Collection<File> fileList)` Adds the file to the passed in Collection.
`protected String`	`buildThreadIdString()`
`protected void`	`checkFiles(FileWorkArea workArea, List<File> fileList)`
`boolean`	`checkForResourceOnClassPath(String name)` Returns true if the resource is available on the classpath.
`void`	`closeWorkArea(FileWorkArea fwArea)` Closes the passed in work area.
`protected String`	`getBaseDirectory(boolean skipSite)` Returns the baseDirectory for writing and reading files as the property assetFileSystemPath if it exists or java.tmp.io if that property has not been set.
`InputStream`	`getClasspathResource(String name)` Allows assets to be included in the Java classpath.
`FileServiceProvider`	`getDefaultFileServiceProvider()`
`List<FileServiceProvider>`	`getFileServiceProviders()`
`File`	`getLocalResource(String resourceName)` Checks for a resource in the temporary directory of the file-system.
`protected File`	`getLocalResource(String resourceName, boolean skipSite)`
`int`	`getMaxGeneratedDirectoryDepth()`
`File`	`getResource(String name)` Returns a File representing the passed in name.
`File`	`getResource(String name, Long localTimeout)` Returns a File representing the resource.
`File`	`getSharedLocalResource(String resourceName)` Checks for a resource in the temporary directory of the file-system.
`protected String`	`getTempDirectory(String baseDirectory)` Returns a directory that is unique for this work area.
`String`	`getTempFileSystemBaseDirectory()`
`FileWorkArea`	`initializeWorkArea()` Create a file work area that can be used for further operations.
`protected org.springframework.core.io.ClassPathResource`	`lookupResourceOnClassPath(String name)`
`protected void`	`removeLocalCacheFiles(String resourceName, String baseDirectory)`
`boolean`	`removeResource(String resourceName)` Removes the resource matching the passed in file name from the FileProvider
`protected FileServiceProvider`	`selectFileServiceProvider()` Returns the FileServiceProvider that can handle the passed in application type.
`void`	`setDefaultFileServiceProvider(FileServiceProvider defaultFileServiceProvider)`
`void`	`setFileServiceProviders(List<FileServiceProvider> fileServiceProviders)`
`void`	`setMaxGeneratedDirectoryDepth(int maxGeneratedDirectoryDepth)`
`void`	`setTempFileSystemBaseDirectory(String tempFileSystemBaseDirectory)`

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

- Field Detail
  - fileServiceProviders
```
protected List<FileServiceProvider> fileServiceProviders
```
  - defaultFileServiceProvider
```
protected FileServiceProvider defaultFileServiceProvider
```
  - tempFileSystemBaseDirectory
```
@Value(value="${file.service.temp.file.base.directory}")
protected String tempFileSystemBaseDirectory
```
  - maxGeneratedDirectoryDepth
```
@Value(value="${asset.server.max.generated.file.system.directories}")
protected int maxGeneratedDirectoryDepth
```
  - fileServiceClasspathDirectory
```
@Value(value="${asset.server.file.classpath.directory}")
protected String fileServiceClasspathDirectory
```
  - extensionManager
```
protected BroadleafFileServiceExtensionManager extensionManager
```
- Constructor Detail
  - BroadleafFileServiceImpl
```
public BroadleafFileServiceImpl()
```
- Method Detail
  - initializeWorkArea
```
public FileWorkArea initializeWorkArea()
```
    Create a file work area that can be used for further operations.
    
    Specified by:
    
    initializeWorkArea in interface BroadleafFileService
    
    Returns:
  - closeWorkArea
```
public void closeWorkArea(FileWorkArea fwArea)
```
    Closes the passed in work area. This method will delete the work area (typically a directory on the file system and all items it encloses).
    
    Specified by:
    
    closeWorkArea in interface BroadleafFileService
    
    Parameters:
    
    Work - Area
  - getResource
```
public File getResource(String name)
```
    Description copied from interface: BroadleafFileService
    
    Returns a File representing the passed in name. This method will always access the file via the FileProvider which might be a remote operation.
    
    Specified by:
    
    getResource in interface BroadleafFileService
    
    Parameters:
    
    name - - fully qualified path to the resource
    
    Returns:
  - getLocalResource
```
protected File getLocalResource(String resourceName,
                                boolean skipSite)
```
  - getLocalResource
```
public File getLocalResource(String resourceName)
```
    Description copied from interface: BroadleafFileService
    
    Checks for a resource in the temporary directory of the file-system. Will check for a site-specific file.
    
    Specified by:
    
    getLocalResource in interface BroadleafFileService
    
    Returns:
  - getSharedLocalResource
```
public File getSharedLocalResource(String resourceName)
```
    Description copied from interface: BroadleafFileService
    
    Checks for a resource in the temporary directory of the file-system. Will check for a global (e.g. not site specific file).
    
    Specified by:
    
    getSharedLocalResource in interface BroadleafFileService
    
    Returns:
  - getResource
```
public File getResource(String name,
                        Long localTimeout)
```
    Description copied from interface: BroadleafFileService
    
    Returns a File representing the resource. This method first checks the local temporary directory for the file. If it exists and has been modified within the timeout parameter, it will be returned. Otherwise, this method will make a call to BroadleafFileService.getResource(String). If the timeout parameter is null then if the resource exists locally, it will be returned.
    
    Specified by:
    
    getResource in interface BroadleafFileService
    
    Parameters:
    
    name - - fully qualified path to the resource
    
    localTimeout - - timeframe that the temporary file is considered valid
    
    Returns:
  - checkForResourceOnClassPath
```
public boolean checkForResourceOnClassPath(String name)
```
    Description copied from interface: BroadleafFileService
    
    Returns true if the resource is available on the classpath.
    
    Specified by:
    
    checkForResourceOnClassPath in interface BroadleafFileService
    
    Returns:
  - lookupResourceOnClassPath
```
protected org.springframework.core.io.ClassPathResource lookupResourceOnClassPath(String name)
```
  - getClasspathResource
```
public InputStream getClasspathResource(String name)
```
    Description copied from interface: BroadleafFileService
    
    Allows assets to be included in the Java classpath. This method was designed to support an internal Broadleaf use case and may not have general applicability beyond that. For Broadleaf demo sites, many of the product images are shared across the demo sites. Rather than copy those images, they are stored in a Jar file and shared by all of the sites.
    
    Specified by:
    
    getClasspathResource in interface BroadleafFileService
    
    Parameters:
    
    name - - fully qualified path to the resource
    
    Returns:
  - removeResource
```
public boolean removeResource(String resourceName)
```
    Removes the resource matching the passed in file name from the FileProvider
    
    Specified by:
    
    removeResource in interface BroadleafFileService
    
    Parameters:
    
    resourceName - - fully qualified path to the resource
  - addOrUpdateResource
```
public void addOrUpdateResource(FileWorkArea workArea,
                                File file,
                                boolean removeFilesFromWorkArea)
```
    Takes in a temporary work area and a single File and copies that files to the configured FileProvider's permanent storage.
    Passing in removeFilesFromWorkArea to true allows for more efficient file processing when using a local file system as it performs a move operation instead of a copy.
    
    Specified by:
    
    addOrUpdateResource in interface BroadleafFileService
  - addOrUpdateResourceForPath
```
public String addOrUpdateResourceForPath(FileWorkArea workArea,
                                         File file,
                                         boolean removeFilesFromWorkArea)
```
    Takes in a temporary work area and a single File and copies that files to the configured FileProvider's permanent storage.
    Passing in removeFilesFromWorkArea to true allows for more efficient file processing when using a local file system as it performs a move operation instead of a copy.
    
    Specified by:
    
    addOrUpdateResourceForPath in interface BroadleafFileService
    
    Parameters:
    
    workArea - the work area from the given file
    
    file - the file to upload
    
    removeFilesFromWorkArea - whether or not the given file should be removed from workArea when it has been copied
  - addOrUpdateResources
```
public void addOrUpdateResources(FileWorkArea workArea,
                                 boolean removeFilesFromWorkArea)
```
    Takes in a temporary work area and copies all of the files to the configured FileProvider's permanent storage.
    Passing in removeFilesFromWorkArea to true allows for more efficient file processing when using a local file system as it performs a move operation instead of a copy.
    
    Specified by:
    
    addOrUpdateResources in interface BroadleafFileService
  - addOrUpdateResourcesForPaths
```
public List<String> addOrUpdateResourcesForPaths(FileWorkArea workArea,
                                                 boolean removeFilesFromWorkArea)
```
    Description copied from interface: BroadleafFileService
    
    Takes in a temporary work area and copies all of the files to the configured FileProvider's permanent storage.
    Passing in removeFilesFromWorkArea to true allows for more efficient file processing when using a local file system as it performs a move operation instead of a copy.
    
    Specified by:
    
    addOrUpdateResourcesForPaths in interface BroadleafFileService
  - addOrUpdateResources
```
public void addOrUpdateResources(FileWorkArea workArea,
                                 List<File> files,
                                 boolean removeFilesFromWorkArea)
```
    Description copied from interface: BroadleafFileService
    
    Takes in a temporary work area and a list of Files and copies them to the configured FileProvider's permanent storage.
    Passing in removeFilesFromWorkArea to true allows for more efficient file processing when using a local file system as it performs a move operation instead of a copy.
    
    Specified by:
    
    addOrUpdateResources in interface BroadleafFileService
  - addOrUpdateResourcesForPaths
```
public List<String> addOrUpdateResourcesForPaths(FileWorkArea workArea,
                                                 List<File> files,
                                                 boolean removeFilesFromWorkArea)
```
    Description copied from interface: BroadleafFileService
    
    Takes in a temporary work area and a list of Files and copies them to the configured FileProvider's permanent storage.
    Passing in removeFilesFromWorkArea to true allows for more efficient file processing when using a local file system as it performs a move operation instead of a copy.
    
    Specified by:
    
    addOrUpdateResourcesForPaths in interface BroadleafFileService
    
    Parameters:
    
    workArea - the work area for the given files
    
    files - the files to copy to the provider's permanent storage
    
    removeFilesFromWorkArea - whether or not the given files hsould be removed from the given workArea after they are uploaded
  - removeLocalCacheFiles
```
protected void removeLocalCacheFiles(String resourceName,
                                     String baseDirectory)
```
  - selectFileServiceProvider
```
protected FileServiceProvider selectFileServiceProvider()
```
    Returns the FileServiceProvider that can handle the passed in application type. By default, this method returns the component configured at blFileServiceProvider
    
    Parameters:
    
    applicationType -
    
    Returns:
  - checkFiles
```
protected void checkFiles(FileWorkArea workArea,
                          List<File> fileList)
```
  - getBaseDirectory
```
protected String getBaseDirectory(boolean skipSite)
```
    Returns the baseDirectory for writing and reading files as the property assetFileSystemPath if it exists or java.tmp.io if that property has not been set.
  - getTempDirectory
```
protected String getTempDirectory(String baseDirectory)
```
    Returns a directory that is unique for this work area.
  - buildThreadIdString
```
protected String buildThreadIdString()
```
  - buildFileList
```
protected void buildFileList(File file,
                             Collection<File> fileList)
```
    Adds the file to the passed in Collection. If the file is a directory, adds its children recursively. Otherwise, just adds the file to the list.
    
    Parameters:
    
    file -
    
    fileList -
  - getTempFileSystemBaseDirectory
```
public String getTempFileSystemBaseDirectory()
```
  - setTempFileSystemBaseDirectory
```
public void setTempFileSystemBaseDirectory(String tempFileSystemBaseDirectory)
```
  - getFileServiceProviders
```
public List<FileServiceProvider> getFileServiceProviders()
```
  - setFileServiceProviders
```
public void setFileServiceProviders(List<FileServiceProvider> fileServiceProviders)
```
  - getMaxGeneratedDirectoryDepth
```
public int getMaxGeneratedDirectoryDepth()
```
  - setMaxGeneratedDirectoryDepth
```
public void setMaxGeneratedDirectoryDepth(int maxGeneratedDirectoryDepth)
```
  - getDefaultFileServiceProvider
```
public FileServiceProvider getDefaultFileServiceProvider()
```
  - setDefaultFileServiceProvider
```
public void setDefaultFileServiceProvider(FileServiceProvider defaultFileServiceProvider)
```

Class BroadleafFileServiceImpl

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

fileServiceProviders

defaultFileServiceProvider

tempFileSystemBaseDirectory

maxGeneratedDirectoryDepth

fileServiceClasspathDirectory

extensionManager

Constructor Detail

BroadleafFileServiceImpl

Method Detail

initializeWorkArea

closeWorkArea

getResource

getLocalResource

getLocalResource

getSharedLocalResource

getResource

checkForResourceOnClassPath

lookupResourceOnClassPath

getClasspathResource

removeResource

addOrUpdateResource

addOrUpdateResourceForPath

addOrUpdateResources

addOrUpdateResourcesForPaths

addOrUpdateResources

addOrUpdateResourcesForPaths

removeLocalCacheFiles

selectFileServiceProvider

checkFiles

getBaseDirectory

getTempDirectory

buildThreadIdString

buildFileList

getTempFileSystemBaseDirectory

setTempFileSystemBaseDirectory

getFileServiceProviders

setFileServiceProviders

getMaxGeneratedDirectoryDepth

setMaxGeneratedDirectoryDepth

getDefaultFileServiceProvider

setDefaultFileServiceProvider