org.castor.xml

Class XMLProperties

java.lang.Object

org.castor.core.util.AbstractProperties

org.castor.xml.XMLProperties

Direct Known Subclasses:

XMLConfiguration

public class XMLProperties
extends AbstractProperties

Properties of XML module.

Since:

1.1.3

Version:

$Id: Configuration.java,v 1.8 2006/03/08 17:25:52 jens Exp $

Author:

Ralf Joachim

Field Summary

Fields

Modifier and Type	Field and Description
static String	COLLECTION_HANDLERS_FOR_JAVA_11_OR_12 Property specifying which collections handlers should be used for Java 1.1 and Java 1.2 run-times.
static String	DEBUG Property specifying whether to run in debug mode.
static String	JAVA_NAMING Property specifying the 'type' of the Java naming conventions to use.
static String	LENIENT_ID_VALIDATION Property specifying whether id/href validation should be lenient; defaults to false.
static String	LENIENT_INTEGER_VALIDATION Property that allows to specify whether the validation for <xs:integer> should accept the old 'int/Integer' members as well; default to false.
static String	LENIENT_INTROSPECTED_ELEMENT_STRICTNESS Property specifying whether element strictness for introspected classes/elements should be lenient (aka allowed); defaults to true.
static String	LENIENT_SEQUENCE_ORDER Property specifying whether sequence order validation should be lenient.
static String	LOAD_PACKAGE_MAPPING Property specifying whether the ClassDescriptorResolver should (automatically) search for and consult with package mapping files (.castor.xml) to retrieve class descriptor information; on by default.
static String	MARSHALLING_VALIDATION Property specifying whether to use validation in the marshalling framework.
static String	MEMBER_NAME_CAPITALISATION_STRICT Property that allows to override Castor's introspector conversion rules for member names; if enabled, even member names such as 'XMLMember' will be camel-cased to 'xMLMember'; defaults to false.
static String	NAMESPACE_PACKAGE_MAPPINGS Property specifying XML namespace to Java package mappings.
static String	NAMESPACES Property specifying whether to support XML namespaces by default.
static String	PARSER Property specifying the class name of the SAX 1 XML parser to use.
static String	PARSER_FEATURES Property specifying additional features for the XML parser.
static String	PARSER_FEATURES_DISABLED Property specifying features to be disabled on the underlying SAX parser.
static String	PARSER_VALIDATION Property specifying whether to perform document validation by default.
static String	PRIMITIVE_NODE_TYPE Property specifying the type of XML node to use for primitive values, either 'element' or 'attribute'.
static String	PROXY_INTERFACES Property specifying whether or not to search for an proxy interface at marshalling.
static String	REG_EXP_CLASS_NAME Property specifying the regular expression validator to use.
static String	SAVE_MAP_KEYS Property specifying whether or not to save the "keys" of a Hashtable or Map during marshalling.
static String	SERIALIZER_FACTORY Property specifying what factory to use for dealing with XML serializers.
static String	STRICT_ELEMENTS Property specifying whether to apply strictness to elements when unmarshalling.
static String	USE_INDENTATION Property specifying whether XML documents (as generated at marshalling) should use indentation or not.
static String	USE_INTROSPECTION Property specifying if introspection should be used at class resolving.
static String	WRAP_COLLECTIONS_PROPERTY The property name for enabling collection wrapping.
static String	XML_NAMING Property specifying the 'type' of the XML naming conventions to use.
static String	XML_VERSION Property that allows to specify the XML document version number to be used during marshalling; defaults to 1.0.

Constructor Summary

Constructors

Constructor and Description
XMLProperties(AbstractProperties parent) Construct properties with given parent.

Method Summary

Modifier and Type	Method and Description
static AbstractProperties	newInstance() Factory method for a default XML properties instance.
static AbstractProperties	newInstance(ClassLoader app, ClassLoader domain) Factory method for a XML properties instance that uses the specified class loaders.

Methods inherited from class org.castor.core.util.AbstractProperties

get, getApplicationClassLoader, getBoolean, getBoolean, getClass, getClassArray, getDomainClassLoader, getInteger, getInteger, getObject, getObjectArray, getString, getString, getStringArray, loadDefaultProperties, loadUserProperties, put, remove

Methods inherited from class java.lang.Object

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

Field Detail

PRIMITIVE_NODE_TYPE

public static final String PRIMITIVE_NODE_TYPE

Property specifying the type of XML node to use for primitive values, either 'element' or 'attribute'. Possible values: - 'element' - 'attribute' (default)

 org.exolab.castor.xml.introspector.primitive.nodetype
 

See Also:

Constant Field Values

PARSER

public static final String PARSER

Property specifying the class name of the SAX 1 XML parser to use.

 org.exolab.castor.parser
 

See Also:

Constant Field Values

PARSER_VALIDATION

public static final String PARSER_VALIDATION

Property specifying whether to perform document validation by default. Possible values: - false (default) - true

 org.exolab.castor.SAXParser.validation
 

See Also:

Constant Field Values

NAMESPACES

public static final String NAMESPACES

Property specifying whether to support XML namespaces by default. Possible values: - false (default) - true

 org.exolab.castor.SAXParser.namespaces
 

See Also:

Constant Field Values

NAMESPACE_PACKAGE_MAPPINGS

public static final String NAMESPACE_PACKAGE_MAPPINGS

Property specifying XML namespace to Java package mappings.

 org.exolab.castor.xml.nspackages
 

See Also:

Constant Field Values

XML_NAMING

public static final String XML_NAMING

Property specifying the 'type' of the XML naming conventions to use. Values of this property must be either "mixed", "lower", or the name of a class which extends AbstractXMLNaming. Possible values: - 'mixed' - 'lower' - A class name (which extends AbstractXMLNaming).

 org.exolab.castor.xml.naming
 

See Also:

Constant Field Values

JAVA_NAMING

public static final String JAVA_NAMING

Property specifying the 'type' of the Java naming conventions to use. Values of this property must be either null or the name of a class which extends JavaNaming. Possible values: - null - A class name (which extends JavaNaming).

 org.castor.xml.java_naming
 

See Also:

Constant Field Values

MARSHALLING_VALIDATION

public static final String MARSHALLING_VALIDATION

Property specifying whether to use validation in the marshalling framework. Possible values: - false - true (default)

 org.exolab.castor.marshalling.validation
 

See Also:

Constant Field Values

USE_INDENTATION

public static final String USE_INDENTATION

Property specifying whether XML documents (as generated at marshalling) should use indentation or not. Possible values: - false (default) - true

 org.exolab.castor.indent
 

See Also:

Constant Field Values

PARSER_FEATURES

public static final String PARSER_FEATURES

Property specifying additional features for the XML parser. This value contains a comma separated list of features that might or might not be supported by the specified SAX parser.

 org.exolab.castor.sax.features
 

See Also:

Constant Field Values

PARSER_FEATURES_DISABLED

public static final String PARSER_FEATURES_DISABLED

Property specifying features to be disabled on the underlying SAX parser. This value contains a comma separated list of features to be disabled.

 org.exolab.castor.sax.features-to-disable
 

See Also:

Constant Field Values

REG_EXP_CLASS_NAME

public static final String REG_EXP_CLASS_NAME

Property specifying the regular expression validator to use. The specified class must implement org.exolab.castor.xml.validators.RegExpValidator Possible values: - A class name.

 org.exolab.castor.regexp
 

See Also:

Constant Field Values

DEBUG

public static final String DEBUG

Property specifying whether to run in debug mode. Possible values: - false (default) - true

 org.exolab.castor.debug
 

See Also:

Constant Field Values

STRICT_ELEMENTS

public static final String STRICT_ELEMENTS

Property specifying whether to apply strictness to elements when unmarshalling. Default is true which means that elements appearing in the XML document, which cannot be mapped to a class, cause a SAXException to be thrown. If set to false, these 'unknown' elements are ignored. Possible values: - false - true (default)

 org.exolab.castor.strictelements
 

See Also:

Constant Field Values

SAVE_MAP_KEYS

public static final String SAVE_MAP_KEYS

Property specifying whether or not to save the "keys" of a Hashtable or Map during marshalling. By default this is true. Backwards compatibility switch (for 0.9.5.2 users and earlier) Possible values: - false - true (default)

 org.exolab.castor.xml.saveMapKeys
 

Since:

0.9.5.3

See Also:

Constant Field Values

LOAD_PACKAGE_MAPPING

public static final String LOAD_PACKAGE_MAPPING

Property specifying whether the ClassDescriptorResolver should (automatically) search for and consult with package mapping files (.castor.xml) to retrieve class descriptor information; on by default. Possible values: - false - true (default)

 org.exolab.castor.xml.loadPackageMappings
 

Since:

1.0

See Also:

Constant Field Values

SERIALIZER_FACTORY

public static final String SERIALIZER_FACTORY

Property specifying what factory to use for dealing with XML serializers. Possible value: - A class name

 org.exolab.castor.xml.serializer.factory
 

Since:

1.0

See Also:

Constant Field Values

LENIENT_SEQUENCE_ORDER

public static final String LENIENT_SEQUENCE_ORDER

Property specifying whether sequence order validation should be lenient. Possible values - false (default) - true

 org.exolab.castor.xml.lenient.sequence.order=false
 

since 1.1

See Also:

Constant Field Values

LENIENT_ID_VALIDATION

public static final String LENIENT_ID_VALIDATION

Property specifying whether id/href validation should be lenient; defaults to false. Possible values: - false (default) - true

 org.exolab.castor.xml.lenient.id.validation=false
 

since 1.1

See Also:

Constant Field Values

PROXY_INTERFACES

public static final String PROXY_INTERFACES

Property specifying whether or not to search for an proxy interface at marshalling. If property is not empty the objects to be marshalled will be searched if they implement one of the given interface names. If the interface is implemented the superclass will be marshalled instead of the class itself.

 org.exolab.castor.xml.proxyInterfaces
 

Since:

1.1.3

See Also:

Constant Field Values

LENIENT_INTROSPECTED_ELEMENT_STRICTNESS

public static final String LENIENT_INTROSPECTED_ELEMENT_STRICTNESS

Property specifying whether element strictness for introspected classes/elements should be lenient (aka allowed); defaults to true. Possible values: - false - true (default)

 org.exolab.castor.xml.lenient.introspected.element.strictness=true
 

Since:

1.1.3

See Also:

Constant Field Values

COLLECTION_HANDLERS_FOR_JAVA_11_OR_12

public static final String COLLECTION_HANDLERS_FOR_JAVA_11_OR_12

Property specifying which collections handlers should be used for Java 1.1 and Java 1.2 run-times.

 org.exolab.castor.mapping.collections
 

See Also:

Constant Field Values

USE_INTROSPECTION

public static final String USE_INTROSPECTION

Property specifying if introspection should be used at class resolving.

 org.castor.xml.class-resolver.use-introspection
 

See Also:

Constant Field Values

WRAP_COLLECTIONS_PROPERTY

public static final String WRAP_COLLECTIONS_PROPERTY

The property name for enabling collection wrapping. The property controls whether or not collections (arrays, vectors, etc) should be wrapped in a container element. For example:

    <foos>
       <foo>foo1</foo>
       <foo>foo2</foo>
    </foos>

   instead of the default:

    <foos>foo1<foos>
    <foos>foo2</foos>

 

Use this property with a value of true or false in the castor.properties file org.exolab.castor.xml.introspector.wrapCollections=true -or- org.exolab.castor.xml.introspector.wrapCollections=false This property is false by default.

See Also:

Constant Field Values

LENIENT_INTEGER_VALIDATION

public static final String LENIENT_INTEGER_VALIDATION

Property that allows to specify whether the validation for <xs:integer> should accept the old 'int/Integer' members as well; default to false. Possible values: - false (default) - true

 org.exolab.castor.xml.lenient.integer.validation=false
 

See Also:

Constant Field Values

XML_VERSION

public static final String XML_VERSION

Property that allows to specify the XML document version number to be used during marshalling; defaults to 1.0. Possible values: - 1.0 (default) - 1.1

 org.exolab.castor.xml.version=1.0
 

See Also:

Constant Field Values

MEMBER_NAME_CAPITALISATION_STRICT

public static final String MEMBER_NAME_CAPITALISATION_STRICT

Property that allows to override Castor's introspector conversion rules for member names; if enabled, even member names such as 'XMLMember' will be camel-cased to 'xMLMember'; defaults to false. Possible values: - false (default) - true

 org.exolab.castor.xml.member.naming.capitalisation.strict=false
 

See Also:

Constant Field Values

Constructor Detail

XMLProperties

public XMLProperties(AbstractProperties parent)

Construct properties with given parent. Application and domain class loaders will be initialized to the ones of the parent.
Note: This constructor is not intended for public use. Use one of the newInstance() methods instead.

Parameters:

parent - Parent properties.

Method Detail

newInstance

public static AbstractProperties newInstance()

Factory method for a default XML properties instance. Application and domain class loaders will be initialised to the one used to load this class. The properties instance returned will be a CastorProperties with a XMLProperties and a CoreProperties instance as parents. The CastorProperties holding user specific properties is the only one that can be modified by put() and remove() methods. XMLProperties and CoreProperties are responsible to deliver Castor's default values if they have not been overwritten by the user.

Returns:

Properties instance for Castor XML module.

newInstance

public static AbstractProperties newInstance(ClassLoader app,
                                             ClassLoader domain)

Factory method for a XML properties instance that uses the specified class loaders. The properties instance returned will be a CastorProperties with a XMLProperties and a CoreProperties instance as parents. The CastorProperties holding user specific properties is the only one that can be modified by put() and remove() methods. XMLProperties and CoreProperties are responsible to deliver Castor's default values if they have not been overwritten by the user.

Parameters:

app - ClassLoader to be used for all classes of Castor and its required libraries.

domain - ClassLoader to be used for all domain objects.

Returns:

Properties instance for Castor XML module.