Interface PropertyFactory

All Known Implementing Classes:

PropertyValidation

public interface PropertyFactory

Module interface for an Property validation.

An PropertyFactory is typically obtained from the Monitor:

// Get the current validation factory.
PropertyFactory af;
af = (PropertyFactory) Monitor.findServiceModule(this, org.apache.derby.iapi.reference.Module.PropertyFactory);
 

Method Summary

Modifier and Type	Method	Description
void	addPropertySetNotification(PropertySetCallback who)	Add a callback for a change in any property value.
Serializable	doMap(String key, Serializable value, Dictionary set)	Call the property set callbacks to map a proposed property value to a value to save.
Serializable	doValidateApplyAndMap(TransactionController tc, String key, Serializable value, Dictionary d, boolean dbOnlyProperty)
void	validateSingleProperty(String key, Serializable value, Dictionary set)	validation a single property
void	verifyPropertySet(Properties p, Properties ignore)	Validate a Property set.

Method Details

addPropertySetNotification

void addPropertySetNotification(PropertySetCallback who)

Add a callback for a change in any property value.
The callback is made in the context of the transaction making the change.

Parameters:

who - which object is called

verifyPropertySet

void verifyPropertySet(Properties p,
 Properties ignore)
                throws StandardException

Validate a Property set.

Validate a Property set by calling all the registered property set notification functions with .

Parameters:

p - Properties to validate.

ignore - Properties to not validate in p. Usefull for properties that may not be set after boot.

Throws:

StandardException - Throws if p fails a check.

validateSingleProperty

void validateSingleProperty(String key,
 Serializable value,
 Dictionary set)
                     throws StandardException

validation a single property

Throws:

StandardException

doValidateApplyAndMap

Serializable doValidateApplyAndMap(TransactionController tc,
 String key,
 Serializable value,
 Dictionary d,
 boolean dbOnlyProperty)
                            throws StandardException

Throws:

StandardException

doMap

Serializable doMap(String key,
 Serializable value,
 Dictionary set)
            throws StandardException

Call the property set callbacks to map a proposed property value to a value to save.

The caller must run this in a block synchronized on this to serialize validations with changes to the set of property callbacks

Throws:

StandardException