org.onehippo.cms7.services.webfiles

Interface WebFilesService

public interface WebFilesService

Field Summary

Fields

Modifier and Type	Field and Description
static String	JCR_ROOT_PATH

Method Summary

Modifier and Type	Method and Description
WebFileBundle	getJcrWebFileBundle(javax.jcr.Session session, String bundleName) Creates a web files implementation based on JCR.
void	importJcrWebFileBundle(javax.jcr.Session session, File directory, boolean bootstrapPhase) Imports a web file bundle from a directory.
void	importJcrWebFileBundle(javax.jcr.Session session, ZipFile zip, boolean bootstrapPhase) Imports a web file bundle from the given zip file.
void	importJcrWebFiles(javax.jcr.Session session, String bundleName, String bundleSubPath, File fileOrDirectory) Imports a sub-tree of a web file bundle from a directory.

Field Detail

JCR_ROOT_PATH

static final String JCR_ROOT_PATH

See Also:

Constant Field Values

Method Detail

getJcrWebFileBundle

WebFileBundle getJcrWebFileBundle(javax.jcr.Session session,
                                  String bundleName)
                           throws WebFileException

Creates a web files implementation based on JCR.

Parameters:

session - the JCR session used to access web files.

bundleName - the name of the web files bundle.

Returns:

a JCR-based web files implementation for bundleName.

Throws:

WebFileException - if the WebFileBundle for bundleName cannot be found

importJcrWebFileBundle

void importJcrWebFileBundle(javax.jcr.Session session,
                            File directory,
                            boolean bootstrapPhase)
                     throws IOException,
                            WebFileException

Imports a web file bundle from a directory. The name of the directory is used as the name of the bundle. Existing web files in JCR are replaced by the new ones. Missing web files are deleted from JCR. The caller of this method is responsible for saving the changes made in the session.

Parameters:

session - the JCR session used to access web files.

directory - the directory containing the web files to import.

bootstrapPhase - true if this method is invoked during repository bootstrap phase or as part of a PostStartupTask

Throws:

IOException - if an I/O error occurs while reading web files from file system

WebFileException - if another error occurs while importing web files

importJcrWebFileBundle

void importJcrWebFileBundle(javax.jcr.Session session,
                            ZipFile zip,
                            boolean bootstrapPhase)
                     throws IOException,
                            WebFileException

Imports a web file bundle from the given zip file. The zip file should contain a single root directory entry that contains all web files. The name of the root directory entry is used as the name of the bundle. Existing web files in JCR are replaced by the new ones. Missing web files are deleted from JCR. The caller of this method is responsible for saving the changes made in the session.

Parameters:

session - the JCR session used to access web files.

zip - the ZIP file containing the web files to import.

bootstrapPhase - true if this method is invoked during repository bootstrap phase or as part of a PostStartupTask

Throws:

IOException - if an I/O error occurs while reading web files from the ZIP file

WebFileException - if another error occurs while importing web files

importJcrWebFiles

void importJcrWebFiles(javax.jcr.Session session,
                       String bundleName,
                       String bundleSubPath,
                       File fileOrDirectory)
                throws IOException,
                       WebFileException

Imports a sub-tree of a web file bundle from a directory. The sub-tree can consist of a directory or a single file. The caller of this method is responsible for saving the changes made in the session.

Parameters:

session - the JCR session used to access web files.

bundleName - the name of the web file bundle

bundleSubPath - the relative sub-path in the web file bundle to import the resources into.

fileOrDirectory - the file or directory to import web files from.

Throws:

IOException - if an I/O error occurs while reading web files from the fileOrDirectory

WebFileException - if an error occurs while importing web files