com.google.gwt.dev.cfg

Class DynamicPropertyOracle

java.lang.Object

com.google.gwt.dev.cfg.DynamicPropertyOracle

All Implemented Interfaces:

PropertyOracle

public class DynamicPropertyOracle
extends Object
implements PropertyOracle

An implementation of PropertyOracle that helps discover the property values associated with specific rebind results for generators.
It does so by recording the properties that are queried, providing a first legal answer for properties not previously queried and allowing an external driver to prescribe values for properties that have been discovered as dependencies.

Constructor Summary

Constructors

Constructor and Description
DynamicPropertyOracle(Properties properties)

Method Summary

Modifier and Type	Method and Description
Set<BindingProperty>	getAccessedProperties()
ConfigurationProperty	getConfigurationProperty(String propertyName) Attempts to get a named configuration property.
Map<String,String>	getPrescribedPropertyValuesByName() Returns the mapping from property names to its currently prescribed value.
SelectionProperty	getSelectionProperty(TreeLogger logger, String propertyName) Attempts to get a named deferred binding property.
boolean	haveAccessedPropertiesChanged()
void	prescribePropertyValue(String propertyName, String propertyValue)
void	reset() Clears state in preparation for another round of rebind analysis on the same generator.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, toString

Constructor Detail

DynamicPropertyOracle

public DynamicPropertyOracle(Properties properties)

Method Detail

haveAccessedPropertiesChanged

public boolean haveAccessedPropertiesChanged()

getAccessedProperties

public Set<BindingProperty> getAccessedProperties()

getConfigurationProperty

public ConfigurationProperty getConfigurationProperty(String propertyName)
                                               throws BadPropertyValueException

Description copied from interface: PropertyOracle

Attempts to get a named configuration property. Throws BadPropertyValueException if the property is undefined. The result of invoking this method with the same propertyName must be stable.

Specified by:

getConfigurationProperty in interface PropertyOracle

Returns:

the configuration property instance (never null)

Throws:

BadPropertyValueException - if the property is unknown or not a configuration property

getPrescribedPropertyValuesByName

public Map<String,String> getPrescribedPropertyValuesByName()

Returns the mapping from property names to its currently prescribed value. The internal mapping changes between runs so the returned value is a stable copy.

getSelectionProperty

public SelectionProperty getSelectionProperty(TreeLogger logger,
                                              String propertyName)
                                       throws BadPropertyValueException

Description copied from interface: PropertyOracle

Attempts to get a named deferred binding property. Throws BadPropertyValueException if the property is either undefined or has a value that is unsupported. The result of invoking this method with the same propertyName must be stable.

Specified by:

getSelectionProperty in interface PropertyOracle

Returns:

the selection property instance (never null)

Throws:

BadPropertyValueException - if the property is unknown or not a selection property

prescribePropertyValue

public void prescribePropertyValue(String propertyName,
                                   String propertyValue)

reset

public void reset()

Clears state in preparation for another round of rebind analysis on the same generator. Since some per generator state is not cleared it is necessary to create a new instance per generator.