Class StorageFactoryService

java.lang.Object

org.apache.derby.impl.services.monitor.StorageFactoryService

All Implemented Interfaces:

PersistentService

final class StorageFactoryService
extends Object
implements PersistentService

This class implements the PersistentService interface using a StorageFactory class. It handles all subSubProtocols except for cache.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) final class	StorageFactoryService.DirectoryList
private static class	StorageFactoryService.FileOperationHelper	Helper class for common file operations on the service properties files.

Field Summary

Fields

Modifier and Type	Field	Description
private String	canonicalHome
private String	home
private StorageFactory	rootStorageFactory
private char	separatorChar
private static final String	SERVICE_PROPERTIES_EOF_TOKEN	Marker printed as the last line of the service properties file.
private final Class<?>	storageFactoryClass
private final String	subSubProtocol

Fields inherited from interface PersistentService

CLASSPATH, DB_README_FILE_NAME, DIRECTORY, HTTP, HTTPS, INMEMORY, JAR, PROPERTIES_NAME, ROOT, TYPE

Constructor Summary

Constructors

Constructor	Description
StorageFactoryService(String subSubProtocol, Class storageFactoryClass)

Method Summary

Modifier and Type	Method	Description
void	createDataWarningFile(StorageFactory sf)	Put a readme file in database directory which will caution users against touching any files in the directory.
String	createServiceRoot(String name, boolean deleteExisting)	Properties cannot be saved
private final boolean	fileExists(File file)	Checks if the specified file exists.
Enumeration	getBootTimeServices()	Return a list of all the directoies in the system directory.
String	getCanonicalServiceName(String name)	Convert a service name into its canonical form.
private String	getDirectoryPath(String name)
private static ModuleFactory	getMonitor()	Privileged Monitor lookup.
private static String	getMostAccuratePath(StorageFile file)	Helper method returning the "best-effort-most-accurate" path.
private String	getProtocolLeadIn()	Returns the protocol lead in for this service.
Properties	getServiceProperties(String serviceName, Properties defaultProperties)	Open the service properties in the directory identified by the service name.
Class	getStorageFactoryClass()	Get the StorageFactory implementation for this PersistentService
StorageFactory	getStorageFactoryInstance(boolean useHome, String databaseName, String tempDirName, String uniqueName)	Get an initialized StorageFactoryInstance
String	getType()	The type of the service is 'directory'
String	getUserServiceName(String serviceName)	Return the user form of a service name.
boolean	hasStorageFactory()
boolean	isSameService(String serviceName1, String serviceName2)
private StorageFactory	privGetStorageFactoryInstance(boolean useHome, String databaseName, String tempDirName, String uniqueName)
protected String	recreateServiceRoot(String serviceName, Properties properties)
boolean	removeServiceRoot(String serviceName)	Remove a service's root and its contents.
private void	resolveServicePropertiesFiles(StorageFactory sf, StorageFile spf)	Resolves situations where a failure condition left the service properties file, and/or the service properties file backup, in an inconsistent state.
void	saveServiceProperties(String serviceName, Properties properties)	Save service.properties during backup
void	saveServiceProperties(String serviceName, StorageFactory sf, Properties properties, boolean replace)
private void	vetService(StorageFactory storageFactory, String serviceName)	Verify that the service directory looks ok before objecting that the database already exists.

Methods inherited from class Object

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

Field Details

SERVICE_PROPERTIES_EOF_TOKEN

private static final String SERVICE_PROPERTIES_EOF_TOKEN

Marker printed as the last line of the service properties file.

See Also:

• Constant Field Values

home

private String home

canonicalHome

private String canonicalHome

subSubProtocol

private final String subSubProtocol

storageFactoryClass

private final Class<?> storageFactoryClass

rootStorageFactory

private StorageFactory rootStorageFactory

separatorChar

private char separatorChar

Constructor Details

StorageFactoryService

StorageFactoryService(String subSubProtocol,
 Class storageFactoryClass)
               throws StandardException

Throws:

StandardException

Method Details

hasStorageFactory

public boolean hasStorageFactory()

Specified by:

hasStorageFactory in interface PersistentService

Returns:

true if the PersistentService has a StorageFactory, false if not.

getStorageFactoryInstance

public StorageFactory getStorageFactoryInstance(boolean useHome,
 String databaseName,
 String tempDirName,
 String uniqueName)
                                         throws StandardException,
IOException

Get an initialized StorageFactoryInstance

Specified by:

getStorageFactoryInstance in interface PersistentService

Parameters:

useHome - If true and the database name is not absolute then the database directory will be relative to the home directory, if one is defined in the properties file.

databaseName - The name of the database (directory). The name does not include the subSubProtocol. If null then the storage factory will only be used to deal with the directory containing the databases.

tempDirName - The name of the temporary file directory set in properties. If null then a default directory should be used. Each database should get a separate temporary file directory within this one to avoid collisions.

uniqueName - A unique name that can be used to create the temporary file directory for this database. If null then temporary files will not be created in this StorageFactory instance.

Returns:

An initialized StorageFactory.

Throws:

IOException - if create, the database directory does not exist, and it cannot be created; if !create and the database does not exist as a directory.

StandardException

privGetStorageFactoryInstance

private StorageFactory privGetStorageFactoryInstance(boolean useHome,
 String databaseName,
 String tempDirName,
 String uniqueName)
                                              throws InstantiationException,
IllegalAccessException,
IOException,
NoSuchMethodException,
InvocationTargetException

Throws:

InstantiationException

IllegalAccessException

IOException

NoSuchMethodException

InvocationTargetException

getType

public String getType()

The type of the service is 'directory'

Specified by:

getType in interface PersistentService

See Also:

• PersistentService.getType()

getBootTimeServices

public Enumeration getBootTimeServices()

Return a list of all the directoies in the system directory.

Specified by:

getBootTimeServices in interface PersistentService

See Also:

• PersistentService.getBootTimeServices()

getServiceProperties

public Properties getServiceProperties(String serviceName,
 Properties defaultProperties)
                                throws StandardException

Open the service properties in the directory identified by the service name.

Specified by:

getServiceProperties in interface PersistentService

Returns:

A Properties object or null if serviceName does not represent a valid service.

Throws:

StandardException - Service appears valid but the properties cannot be created.

saveServiceProperties

public void saveServiceProperties(String serviceName,
 StorageFactory sf,
 Properties properties,
 boolean replace)
                           throws StandardException

Specified by:

saveServiceProperties in interface PersistentService

Throws:

StandardException - Properties cannot be saved.

createDataWarningFile

public void createDataWarningFile(StorageFactory sf)
                           throws StandardException

Description copied from interface: PersistentService

Put a readme file in database directory which will caution users against touching any files in the directory. This file will be created at database creation time.

Specified by:

createDataWarningFile in interface PersistentService

Parameters:

sf - StorageFactory will be used to create the file

Throws:

StandardException - File can't be created

See Also:

• PersistentService.createDataWarningFile(StorageFactory)

saveServiceProperties

public void saveServiceProperties(String serviceName,
 Properties properties)
                           throws StandardException

Save service.properties during backup

Specified by:

saveServiceProperties in interface PersistentService

Parameters:

serviceName - backup location of the service

properties - the properties to save

Throws:

StandardException - Properties cannot be saved.

resolveServicePropertiesFiles

private void resolveServicePropertiesFiles(StorageFactory sf,
 StorageFile spf)
                                    throws StandardException

Resolves situations where a failure condition left the service properties file, and/or the service properties file backup, in an inconsistent state.

Note that this method doesn't resolve the situation where both the current service properties file and the backup file are missing.

Parameters:

sf - the storage factory for the service

spf - the service properties file

Throws:

StandardException - if a file operation on a service properties file fails

recreateServiceRoot

protected String recreateServiceRoot(String serviceName,
 Properties properties)
                              throws StandardException

Throws:

StandardException

createServiceRoot

public String createServiceRoot(String name,
 boolean deleteExisting)
                         throws StandardException

Properties cannot be saved

Specified by:

createServiceRoot in interface PersistentService

Throws:

StandardException - Service root cannot be created.

vetService

private void vetService(StorageFactory storageFactory,
 String serviceName)
                 throws StandardException

Verify that the service directory looks ok before objecting that the database already exists.

Throws:

StandardException

getDirectoryPath

private String getDirectoryPath(String name)

removeServiceRoot

public boolean removeServiceRoot(String serviceName)

Description copied from interface: PersistentService

Remove a service's root and its contents.

Specified by:

removeServiceRoot in interface PersistentService

getCanonicalServiceName

public String getCanonicalServiceName(String name)
                               throws StandardException

Description copied from interface: PersistentService

Convert a service name into its canonical form. Returns null if the name cannot be converted into a canonical form.

Specified by:

getCanonicalServiceName in interface PersistentService

Throws:

StandardException - if an error happens when converting the name (name probably invalid)

getUserServiceName

public String getUserServiceName(String serviceName)

Description copied from interface: PersistentService

Return the user form of a service name. This name is only valid within this system. The separator character used must be '/'

Specified by:

getUserServiceName in interface PersistentService

isSameService

public boolean isSameService(String serviceName1,
 String serviceName2)

Specified by:

isSameService in interface PersistentService

fileExists

private final boolean fileExists(File file)

Checks if the specified file exists.

Parameters:

file - the file to check

Returns:

true if the file exists, false if not.

Throws:

SecurityException - if the required privileges are missing

getStorageFactoryClass

public Class getStorageFactoryClass()

Get the StorageFactory implementation for this PersistentService

Returns:

the StorageFactory class.

getProtocolLeadIn

private String getProtocolLeadIn()

Returns the protocol lead in for this service.

Returns:

An empty string if the protocol is the default one (PersistentService.DIRECTORY), the subsub protocol name followed by colon otherwise.

getMonitor

private static ModuleFactory getMonitor()

Privileged Monitor lookup. Must be private so that user code can't call this entry point.

getMostAccuratePath

private static String getMostAccuratePath(StorageFile file)

Helper method returning the "best-effort-most-accurate" path.

Parameters:

file - the file to get the path to

Returns:

The file path, either ala File.getCanonicalPath or File.getPath.