Package org.apache.sis.internal.converter


package org.apache.sis.internal.converter
Default set of ObjectConverter implementations. Converter for a given pair of source and target classes can be obtained with ConverterRegistry. A system-wide instance of ConverterRegistry with a default set of conversions is available as SystemRegistry.INSTANCE.

Adding system-wide converters

Applications can add system-wide custom converters either by explicit calls to the SystemRegistry.INSTANCE.register(ObjectConverter) method, or by listing the fully qualified classnames of their ObjectConverter instances in a file having exactly the following name: Applications deployed in a modularization framework like OSGi shall use only the META-INF approach, because system converters are discarded every time the classpath changes. Having the converters declared in META-INF ensure that they will be reloaded when needed.

Alternatively, applications can also use their own ConverterRegistry instance. Non-system instances do not scan for META-INF and do not discard their content on classpath changes.

Since:
0.3
Version:
1.0