OrikaSystemProperties (Orika

java.lang.Object
- ma.glasnost.orika.OrikaSystemProperties

```
public final class OrikaSystemProperties
extends Object
```
A hook for the various system properties which may be used to configure Orika's runtime behavior.

Author:

matt.deboer@gmail.com

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`CAPTURE_FIELD_CONTEXT` Specifies a default value for the 'captureFieldContext' option on the DefaultMapperFactory; if `true`, the result is that the following calls will return a meaningful value, relative to the currently mapped source and destination fields: `MappingContext.getFullyQualifiedSourcePath()` `MappingContext.getFullyQualifiedDestinationPath()` `MappingContext.getSourceExpressionPaths()` `MappingContext.getDestinationExpressionPaths()` `MappingContext.getSourceTypePaths()` `MappingContext.getDestinationTypePaths()`
`static String`	`CLASSMAP_BUILDER_FACTORY` Specifies the fully-qualified class name of the classmap builder factory be used by the default mapper factory to generate new ClassMapBuilder instances.
`static String`	`COMPILER_STRATEGY` Specifies the fully-qualified class name of the compiler strategy to use when creating generated objects; default value is determined by the MapperFactory implementation.
`static String`	`CONSTRUCTOR_RESOLVER_STRATEGY` Specifies the fully-qualified class name of the constructor-resolver strategy to use when resolving constructors for instantiation of target types; default value is determined by the MapperFactory implementation.
`static String`	`CONVERTER_FACTORY` Specifies the fully-qualified class name of the converter factory to use when generating converters for target types; default value is determined by the MapperFactory implementation.
`static String`	`DUMP_STATE_ON_EXCEPTION` Specifies whether the current state of the core mapping objects should be printed to the log upon an exception.
`static String`	`FAVOR_EXTENSION` Specifies a default value for the 'favorExtension' option on registered class-maps when a value has not been specified.
`static String`	`MAP_NULLS` Specifies whether null values should be mapped.
`static String`	`MAPPING_CONTEXT_FACTORY` Specifies the fully-qualified class name of the MappingContextFactory to be used by the default mapper factory to generate new MappingContext instances.
`static String`	`PROPERTY_RESOLVER_STRATEGY` Specifies the fully-qualified class name of the property-resolver strategy to use when resolving mappable properties of target types; default value is `IntrospectorPropertyResolver`
`static String`	`UNENHANCE_STRATEGY` Specifies the fully-qualified class name of the un-enhancement strategy to use when performing type lookup in order to map objects; default value is determined by the MapperFactory implementation.
`static String`	`USE_AUTO_MAPPING` Specifies whether Mapper and ObjectFactory instances for registered ClassMap instances
`static String`	`USE_BUILTIN_CONVERTERS` Specifies whether to use built-in converters default value is `true`
`static String`	`USE_STRATEGY_CACHE` Specifies that the new mapping strategy cache should be used to cache mapping strategies; default value is `false`
`static String`	`WRITE_CLASS_FILES` Specifies whether class files should be written for generated objects; valid choices are "true" or "false".
`static String`	`WRITE_CLASS_FILES_TO_PATH` Specifies the output location where class files should be written (if writing class files is enabled).
`static String`	`WRITE_SOURCE_FILES` Specifies whether .java source files should be written for generated objects; valid choices are "true" or "false".
`static String`	`WRITE_SOURCE_FILES_TO_PATH` Specifies the output location where source files should be written (if writing source files is enabled).

Method Summary
- Methods inherited from class java.lang.Object
  clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - WRITE_SOURCE_FILES
```
public static final String WRITE_SOURCE_FILES
```
    Specifies whether .java source files should be written for generated objects; valid choices are "true" or "false".
    Any non-null value will be evaluated to "false"; if this property is not specified, default behavior is determined by the compiler strategy.
    
    Note that Orika makes no effort to delete such generated files.
    
    See Also:
    
    Constant Field Values
  - WRITE_SOURCE_FILES_TO_PATH
```
public static final String WRITE_SOURCE_FILES_TO_PATH
```
    Specifies the output location where source files should be written (if writing source files is enabled). This defaults to the value "classpath:/ma/glasnost/orika/generated/", which signals to write the files to the location "/ma/glasnost/orika/generated/" relative to the root of the class-path.
    An absolute file location may also be specified, such as: "/Users/me/orikaGeneratedFiles/src/".
    
    See Also:
    
    Constant Field Values
  - WRITE_CLASS_FILES
```
public static final String WRITE_CLASS_FILES
```
    Specifies whether class files should be written for generated objects; valid choices are "true" or "false".
    Any non-null value will be evaluated to "false"; if this property is not specified, default behavior is determined by the compiler strategy.
    
    Note that Orika makes no effort to delete such generated files.
    
    See Also:
    
    Constant Field Values
  - WRITE_CLASS_FILES_TO_PATH
```
public static final String WRITE_CLASS_FILES_TO_PATH
```
    Specifies the output location where class files should be written (if writing class files is enabled). This defaults to the value "classpath:/ma/glasnost/orika/generated/", which signals to write the files to the location "/ma/glasnost/orika/generated/" relative to the root of the class-path.
    An absolute file location may also be specified, such as: "/Users/me/orikaGeneratedFiles/bin/".
    
    See Also:
    
    Constant Field Values
  - COMPILER_STRATEGY
```
public static final String COMPILER_STRATEGY
```
    Specifies the fully-qualified class name of the compiler strategy to use when creating generated objects; default value is determined by the MapperFactory implementation.
    
    See Also:
    
    Constant Field Values
  - UNENHANCE_STRATEGY
```
public static final String UNENHANCE_STRATEGY
```
    Specifies the fully-qualified class name of the un-enhancement strategy to use when performing type lookup in order to map objects;
    default value is determined by the MapperFactory implementation.
    
    See Also:
    
    Constant Field Values
  - CONSTRUCTOR_RESOLVER_STRATEGY
```
public static final String CONSTRUCTOR_RESOLVER_STRATEGY
```
    Specifies the fully-qualified class name of the constructor-resolver strategy to use when resolving constructors for instantiation of target types;
    
    default value is determined by the MapperFactory implementation.
    
    See Also:
    
    Constant Field Values
  - PROPERTY_RESOLVER_STRATEGY
```
public static final String PROPERTY_RESOLVER_STRATEGY
```
    Specifies the fully-qualified class name of the property-resolver strategy to use when resolving mappable properties of target types;
    
    default value is IntrospectorPropertyResolver
    
    See Also:
    
    Constant Field Values
  - CLASSMAP_BUILDER_FACTORY
```
public static final String CLASSMAP_BUILDER_FACTORY
```
    Specifies the fully-qualified class name of the classmap builder factory be used by the default mapper factory to generate new ClassMapBuilder instances.
    
    default value is ClassMapBuilderFactory
    
    See Also:
    
    Constant Field Values
  - MAPPING_CONTEXT_FACTORY
```
public static final String MAPPING_CONTEXT_FACTORY
```
    Specifies the fully-qualified class name of the MappingContextFactory to be used by the default mapper factory to generate new MappingContext instances.
    
    default value is MappingContext.Factory
    
    See Also:
    
    Constant Field Values
  - CONVERTER_FACTORY
```
public static final String CONVERTER_FACTORY
```
    Specifies the fully-qualified class name of the converter factory to use when generating converters for target types;
    
    default value is determined by the MapperFactory implementation.
    
    See Also:
    
    Constant Field Values
  - USE_STRATEGY_CACHE
```
public static final String USE_STRATEGY_CACHE
```
    Specifies that the new mapping strategy cache should be used to cache mapping strategies;
    
    default value is false
    
    See Also:
    
    Constant Field Values
  - MAP_NULLS
```
public static final String MAP_NULLS
```
    Specifies whether null values should be mapped. default value is true
    
    See Also:
    
    Constant Field Values
  - USE_BUILTIN_CONVERTERS
```
public static final String USE_BUILTIN_CONVERTERS
```
    Specifies whether to use built-in converters default value is true
    
    See Also:
    
    Constant Field Values
  - USE_AUTO_MAPPING
```
public static final String USE_AUTO_MAPPING
```
    Specifies whether Mapper and ObjectFactory instances for registered ClassMap instances
    Default value is false
    
    See Also:
    
    Constant Field Values
  - DUMP_STATE_ON_EXCEPTION
```
public static final String DUMP_STATE_ON_EXCEPTION
```
    Specifies whether the current state of the core mapping objects should be printed to the log upon an exception.
    Default value is true
    
    See Also:
    
    Constant Field Values
  - FAVOR_EXTENSION
```
public static final String FAVOR_EXTENSION
```
    Specifies a default value for the 'favorExtension' option on registered class-maps when a value has not been specified.
    Default value is false
    
    See Also:
    
    Constant Field Values
  - CAPTURE_FIELD_CONTEXT
```
public static final String CAPTURE_FIELD_CONTEXT
```
    Specifies a default value for the 'captureFieldContext' option on the DefaultMapperFactory; if true, the result is that the following calls will return a meaningful value, relative to the currently mapped source and destination fields:
    If false, these methods will return null.
    Default value is false
    See Also:
    
    Constant Field Values

Class OrikaSystemProperties

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

WRITE_SOURCE_FILES

WRITE_SOURCE_FILES_TO_PATH

WRITE_CLASS_FILES

WRITE_CLASS_FILES_TO_PATH

COMPILER_STRATEGY

UNENHANCE_STRATEGY

CONSTRUCTOR_RESOLVER_STRATEGY

PROPERTY_RESOLVER_STRATEGY

CLASSMAP_BUILDER_FACTORY

MAPPING_CONTEXT_FACTORY

CONVERTER_FACTORY

USE_STRATEGY_CACHE

MAP_NULLS

USE_BUILTIN_CONVERTERS

USE_AUTO_MAPPING

DUMP_STATE_ON_EXCEPTION

FAVOR_EXTENSION

CAPTURE_FIELD_CONTEXT