net.obvj.confectory.mapper

Class PropertiesToObjectMapper<T>

java.lang.Object

net.obvj.confectory.mapper.PropertiesToObjectMapper<T>

Type Parameters:

T - the target type to be produced by this Mapper

All Implemented Interfaces:

Mapper<T>

public class PropertiesToObjectMapper<T>
extends Object
implements Mapper<T>

A specialized Mapper that loads the contents of a Source (e.g.: file, URL) in the Properties format (a sequence of key-value pairs) and converts it into a POJO (Plain-Old Java Object).

Every property will be assigned to a field in the target object in either of the following cases:

• the field name is equal to the property key (with no need to use an annotation in these cases); or
• the field is marked with the @Property annotation, defining a custom key to be mapped

Notes:

• The fields in the target object can be private (recommended)
• Fields marked transient are ignored
• If the associated property is missing in the source, the corresponding field will assume a default value, i.e.: null for object types, zero for numeric types, and false for booleans.

Since:

1.2.0

Author:

oswaldo.bapvic.jr (Oswaldo Junior)

See Also:

Property

Constructor Summary

Constructors

Constructor and Description
PropertiesToObjectMapper(Class<T> targetType) Builds a new Properties Mapper with the specified target type.

Method Summary

Modifier and Type	Method and Description
T	apply(InputStream inputStream) Applies this Mapper into the given input.
ConfigurationHelper<T>	configurationHelper(T type) Creates a new ConfigurationHelper instance recommended by this Mapper.

Methods inherited from class java.lang.Object

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

Constructor Detail

PropertiesToObjectMapper

public PropertiesToObjectMapper(Class<T> targetType)

Builds a new Properties Mapper with the specified target type.

Parameters:

targetType - the target type to be produced by this Mapper

Method Detail

apply

public T apply(InputStream inputStream)
        throws IOException

Description copied from interface: Mapper

Applies this Mapper into the given input.

Note: The input stream must be closed by the caller after the mapping operation.

Specified by:

apply in interface Mapper<T>

Parameters:

inputStream - the input stream to be mapped

Returns:

the mapped object

Throws:

IOException - if a low-level I/O problem (such and unexpected end-of-input, or network error) occurs

configurationHelper

public ConfigurationHelper<T> configurationHelper(T type)

Description copied from interface: Mapper

Creates a new ConfigurationHelper instance recommended by this Mapper.

Specified by:

configurationHelper in interface Mapper<T>

Parameters:

type - the configuration object to be used by the helper

Returns:

a new ConfigurationHelper instance