Specifications

Mappers life-cycle

A mapper object (ie. isntance of {@link fr.norsys.mapper.core.Mapper} interface) may be either acquired through method {@link fr.norsys.mapper.manager.Manage#getMapper(String)} invoked in a manager or by creating user-defined mappers (ie. composite mappers). The basic life-cycle contract of mapper objects is that:

• A Manage-acquired Mapper object must be returned to the manager by call to {@link fr.norsys.mapper.manager.Manage#release(Mapper)} method. A released Mapper object may no longer be used directly or indirectly (eg. through the use of a {@link fr.norsys.mapper.core.JoinMapper}),
• A user-defined Mapper object must not be returned to the manager. Disposal should be left to the garbage collector.

A mapper is associated with a single source object ({@link fr.norsys.mapper.spi.Source}) within the context of a single manager. This association is fixed at configuration time by method {@link fr.norsys.mapper.manager.Manager#link(String,String)}.

Documentation

• see the architecture document