org.apache.commons.betwixt
Class IntrospectionConfiguration

java.lang.Object
  org.apache.commons.betwixt.IntrospectionConfiguration

public class IntrospectionConfiguration
extends java.lang.Object

Stores introspection phase binding configuration.

There are two phase in Betwixt's processing. The first phase is the introspection of the bean. Strutural configuration settings effect this phase. The second phase comes when Betwixt dynamically uses reflection to execute the mapping. This object stores configuration settings pertaining to the first phase.

These common settings have been collected into one class so that they can be more easily shared not only between the objects that execute the introspection but also (by a user) between different XMLIntrospectors.

Version:

$Revision: 561314 $

Author:

Apache Commons Team

Constructor Summary

IntrospectionConfiguration()

Method Summary

protected NameMapper	createNameMapper() A Factory method to lazily create a strategy used to convert bean type names into element names.
protected PluralStemmer	createPluralStemmer() A Factory method to lazily create a new strategy to detect matching singular and plural properties.
NameMapper	getAttributeNameMapper() Gets the name mapping strategy used to convert bean names into attributes.
AttributeSuppressionStrategy	getAttributeSuppressionStrategy() Returns the AttributeSuppressionStrategy.
ClassNormalizer	getClassNormalizer() Gets the ClassNormalizer strategy.
CollectiveTypeStrategy	getCollectiveTypeStrategy() Gets the strategy used to determine which types are collective.
NameMapper	getElementNameMapper() Gets the name mapping strategy used to convert bean names into elements.
ElementSuppressionStrategy	getElementSuppressionStrategy() Returns the ElementSuppressionStrategy.
org.apache.commons.logging.Log	getIntrospectionLog() Gets the common Log used for introspection.
MappingDerivationStrategy	getMappingDerivationStrategy() Gets the MappingDerivationStrategy used to determine whether the bind or introspection time type should determine the mapping.
PluralStemmer	getPluralStemmer() Get singular and plural matching strategy.
NamespacePrefixMapper	getPrefixMapper() Gets the NamespacePrefixMapper used to convert namespace URIs into prefixes.
PropertySuppressionStrategy	getPropertySuppressionStrategy() Gets the strategy which determines the properties to be ignored.
SimpleTypeMapper	getSimpleTypeMapper() Gets the simple type binding strategy.
TypeBindingStrategy	getTypeBindingStrategy() Gets the TypeBindingStrategy to be used to determine the binding for Java types.
boolean	ignoreAllBeanInfo() Should existing BeanInfo classes be ignored by java.reflect.Introspector.
boolean	isAttributesForPrimitives() Should attributes (or elements) be used for primitive types.
boolean	isLoopType(java.lang.Class type) Is this a loop type class?
boolean	isUseContextClassLoader() Should be context classloader be used when loading classes?
boolean	isWrapCollectionsInElement() Should collections be wrapped in an extra element?
void	setAttributeNameMapper(NameMapper nameMapper) Sets the strategy used to convert bean type names into attribute names
void	setAttributesForPrimitives(boolean attributesForPrimitives) Set whether attributes (or elements) should be used for primitive types.
void	setAttributeSuppressionStrategy(AttributeSuppressionStrategy attributeSuppressionStrategy) Sets the AttributeSuppressionStrategy.
void	setClassNormalizer(ClassNormalizer classNormalizer) Sets the ClassNormalizer strategy.
void	setCollectiveTypeStrategy(CollectiveTypeStrategy collectiveTypeStrategy) Sets the strategy used to determine which types are collective.
void	setElementNameMapper(NameMapper nameMapper) Sets the strategy used to convert bean type names into element names
void	setElementSuppressionStrategy(ElementSuppressionStrategy elementSuppressionStrategy) Sets the ElementSuppressionStrategy.
void	setIgnoreAllBeanInfo(boolean ignoreAllBeanInfo) Specifies if you want to ignore existing BeanInfo classes at all for introspection
void	setIntrospectionLog(org.apache.commons.logging.Log log) Sets the common Log used by introspection.
void	setMappingDerivationStrategy(MappingDerivationStrategy mappingDerivationStrategy) Sets the MappingDerivationStrategy used to determine whether the bind or introspection time type should determine the mapping.
void	setPluralStemmer(PluralStemmer pluralStemmer) Sets the strategy used to detect matching singular and plural properties
void	setPrefixMapper(NamespacePrefixMapper mapper) Sets the NamespacePrefixMapper used to convert namespave URIs into prefixes.
void	setPropertySuppressionStrategy(PropertySuppressionStrategy propertySuppressionStrategy) Sets the strategy which determines the properties to be ignored.
void	setSimpleTypeMapper(SimpleTypeMapper mapper) Sets the simple type binding strategy.
void	setTypeBindingStrategy(TypeBindingStrategy typeBindingStrategy) Sets the TypeBindingStrategy to be used to determine the binding for Java types.
void	setUseBeanInfoSearchPath(boolean useBeanInfoSearchPath) Specifies if you want to use the beanInfoSearchPath
void	setUseContextClassLoader(boolean useContextClassLoader) Specify whether the context classloader should be used to load classes during introspection; the default value is true.
void	setWrapCollectionsInElement(boolean wrapCollectionsInElement) Sets whether we should we wrap collections in an extra element.
boolean	useBeanInfoSearchPath() Should the original java.reflect.Introspector bean info search path be used?

Methods inherited from class java.lang.Object

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

Constructor Detail

IntrospectionConfiguration

public IntrospectionConfiguration()

Method Detail

getClassNormalizer

public ClassNormalizer getClassNormalizer()

Gets the ClassNormalizer strategy. This is used to determine the Class to be introspected (the normalized Class).

Returns:

the ClassNormalizer used to determine the Class to be introspected for a given Object.

setClassNormalizer

public void setClassNormalizer(ClassNormalizer classNormalizer)

Sets the ClassNormalizer strategy. This is used to determine the Class to be introspected (the normalized Class).

Parameters:

classNormalizer - the ClassNormalizer to be used to determine the Class to be introspected for a given Object.

isAttributesForPrimitives

public boolean isAttributesForPrimitives()

Should attributes (or elements) be used for primitive types.

Returns:

true if primitive types will be mapped to attributes in the introspection

setAttributesForPrimitives

public void setAttributesForPrimitives(boolean attributesForPrimitives)

Set whether attributes (or elements) should be used for primitive types.

Parameters:

attributesForPrimitives - pass trus to map primitives to attributes, pass false to map primitives to elements

isWrapCollectionsInElement

public boolean isWrapCollectionsInElement()

Should collections be wrapped in an extra element?

Returns:

whether we should we wrap collections in an extra element?

setWrapCollectionsInElement

public void setWrapCollectionsInElement(boolean wrapCollectionsInElement)

Sets whether we should we wrap collections in an extra element.

Parameters:

wrapCollectionsInElement - pass true if collections should be wrapped in a parent element

getPluralStemmer

public PluralStemmer getPluralStemmer()

Get singular and plural matching strategy.

Returns:

the strategy used to detect matching singular and plural properties

setPluralStemmer

public void setPluralStemmer(PluralStemmer pluralStemmer)

Sets the strategy used to detect matching singular and plural properties

Parameters:

pluralStemmer - the PluralStemmer used to match singular and plural

getElementNameMapper

public NameMapper getElementNameMapper()

Gets the name mapping strategy used to convert bean names into elements.

Returns:

the strategy used to convert bean type names into element names. If no element mapper is currently defined then a default one is created.

setElementNameMapper

public void setElementNameMapper(NameMapper nameMapper)

Sets the strategy used to convert bean type names into element names

Parameters:

nameMapper - the NameMapper to use for the conversion

getAttributeNameMapper

public NameMapper getAttributeNameMapper()

Gets the name mapping strategy used to convert bean names into attributes.

Returns:

the strategy used to convert bean type names into attribute names. If no attributeNamemapper is known, it will default to the ElementNameMapper

setAttributeNameMapper

public void setAttributeNameMapper(NameMapper nameMapper)

Sets the strategy used to convert bean type names into attribute names

Parameters:

nameMapper - the NameMapper to use for the convertion

useBeanInfoSearchPath

public boolean useBeanInfoSearchPath()

Should the original java.reflect.Introspector bean info search path be used?

Default is false.

Returns:

boolean if the beanInfoSearchPath should be used.

setUseBeanInfoSearchPath

public void setUseBeanInfoSearchPath(boolean useBeanInfoSearchPath)

Specifies if you want to use the beanInfoSearchPath

Parameters:

useBeanInfoSearchPath -

See Also:

for more details

ignoreAllBeanInfo

public boolean ignoreAllBeanInfo()

Should existing BeanInfo classes be ignored by java.reflect.Introspector.

Default is false.

Returns:

boolean if the BeanInfo classes should be used.

setIgnoreAllBeanInfo

public void setIgnoreAllBeanInfo(boolean ignoreAllBeanInfo)

Specifies if you want to ignore existing BeanInfo classes at all for introspection

Parameters:

ignoreAllBeanInfo - set to true to ignore all BeanInfo classes

Since:

0.8

See Also:

for more details

createPluralStemmer

protected PluralStemmer createPluralStemmer()

A Factory method to lazily create a new strategy to detect matching singular and plural properties.

Returns:

new defualt PluralStemmer implementation

createNameMapper

protected NameMapper createNameMapper()

A Factory method to lazily create a strategy used to convert bean type names into element names.

Returns:

new default NameMapper implementation

getIntrospectionLog

public org.apache.commons.logging.Log getIntrospectionLog()

Gets the common Log used for introspection. It is more convenient to use a single Log that can be easily configured.

Returns:

Log, not null

setIntrospectionLog

public void setIntrospectionLog(org.apache.commons.logging.Log log)

Sets the common Log used by introspection. It is more convenient to use a single Log that can be easily configured.

Parameters:

log - Log, not null

getPrefixMapper

public NamespacePrefixMapper getPrefixMapper()

Gets the NamespacePrefixMapper used to convert namespace URIs into prefixes.

Returns:

NamespacePrefixMapper, not null

setPrefixMapper

public void setPrefixMapper(NamespacePrefixMapper mapper)

Sets the NamespacePrefixMapper used to convert namespave URIs into prefixes.

Parameters:

mapper - NamespacePrefixMapper, not null

getSimpleTypeMapper

public SimpleTypeMapper getSimpleTypeMapper()

Gets the simple type binding strategy.

Returns:

SimpleTypeMapper, not null

setSimpleTypeMapper

public void setSimpleTypeMapper(SimpleTypeMapper mapper)

Sets the simple type binding strategy.

Parameters:

mapper - SimpleTypeMapper, not null

getTypeBindingStrategy

public TypeBindingStrategy getTypeBindingStrategy()

Gets the TypeBindingStrategy to be used to determine the binding for Java types.

Returns:

the TypeBindingStrategy to be used, not null

setTypeBindingStrategy

public void setTypeBindingStrategy(TypeBindingStrategy typeBindingStrategy)

Sets the TypeBindingStrategy to be used to determine the binding for Java types.

Parameters:

typeBindingStrategy - the TypeBindingStrategy to be used, not null

getMappingDerivationStrategy

public MappingDerivationStrategy getMappingDerivationStrategy()

Gets the MappingDerivationStrategy used to determine whether the bind or introspection time type should determine the mapping.

Returns:

MappingDerivationStrategy, not null

Since:

0.7

setMappingDerivationStrategy

public void setMappingDerivationStrategy(MappingDerivationStrategy mappingDerivationStrategy)

Sets the MappingDerivationStrategy used to determine whether the bind or introspection time type should determine the mapping.

Parameters:

mappingDerivationStrategy - MappingDerivationStrategy, not null

Since:

0.7

getPropertySuppressionStrategy

public PropertySuppressionStrategy getPropertySuppressionStrategy()

Gets the strategy which determines the properties to be ignored.

Returns:

the PropertySuppressionStrategy to be used for introspection, not null

Since:

0.7

setPropertySuppressionStrategy

public void setPropertySuppressionStrategy(PropertySuppressionStrategy propertySuppressionStrategy)

Sets the strategy which determines the properties to be ignored.

Parameters:

propertySuppressionStrategy - the PropertySuppressionStrategy to be used for introspection, not null

Since:

0.7

getCollectiveTypeStrategy

public CollectiveTypeStrategy getCollectiveTypeStrategy()

Gets the strategy used to determine which types are collective.

Returns:

CollectiveTypeStrategy, not null

Since:

0.8

setCollectiveTypeStrategy

public void setCollectiveTypeStrategy(CollectiveTypeStrategy collectiveTypeStrategy)

Sets the strategy used to determine which types are collective.

Parameters:

collectiveTypeStrategy - CollectiveTypeStrategy, not null

Since:

0.8

isLoopType

public boolean isLoopType(java.lang.Class type)

Is this a loop type class?

Parameters:

type - is this Class a loop type?

Returns:

true if the type is a loop type, or if type is null

Since:

0.7

getAttributeSuppressionStrategy

public AttributeSuppressionStrategy getAttributeSuppressionStrategy()

Returns the AttributeSuppressionStrategy. This is used to suppress attributes, e.g. for versioning.

Returns:

the strategy

Since:

0.8

setAttributeSuppressionStrategy

public void setAttributeSuppressionStrategy(AttributeSuppressionStrategy attributeSuppressionStrategy)

Sets the AttributeSuppressionStrategy. This is used to suppress attributes, e.g. for versioning.

Parameters:

attributeSuppressionStrategy - the strategy

Since:

0.8

getElementSuppressionStrategy

public ElementSuppressionStrategy getElementSuppressionStrategy()

Returns the ElementSuppressionStrategy. This is used to suppress elements, e.g. for versioning.

Returns:

the strategy

Since:

0.8

setElementSuppressionStrategy

public void setElementSuppressionStrategy(ElementSuppressionStrategy elementSuppressionStrategy)

Sets the ElementSuppressionStrategy. This is used to suppress elements, e.g. for versioning.

Parameters:

elementSuppressionStrategy - the strategy

Since:

0.8

isUseContextClassLoader

public boolean isUseContextClassLoader()

Should be context classloader be used when loading classes?

Returns:

true if the context classloader is to be used during introspection, false otherwise.

setUseContextClassLoader

public void setUseContextClassLoader(boolean useContextClassLoader)

Specify whether the context classloader should be used to load classes during introspection; the default value is true.

When running code that is not in a container (ie where the context classloader is the same as the system classloader), this setting has no effect. When running code in containers that do define a context classloader for loaded "components" (eg webapps), a true value will allow classes in the loaded "component" to be accessable even when Betwixt is deployed via a "higher level" classloader.

If code is running in a container that uses a context classloader in unusual ways then it may be necessary to set this value to false. In this case, classes are always loaded using the same classloader that loaded the betwixt library.