org.osgi.util.converter

Class AbstractSpecifying<T extends Specifying<T>>

java.lang.Object

org.osgi.util.converter.AbstractSpecifying<T>

All Implemented Interfaces:

Specifying<T>

Direct Known Subclasses:

ConvertingImpl, FunctioningImpl

abstract class AbstractSpecifying<T extends Specifying<T>>
extends java.lang.Object
implements Specifying<T>

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.Object	defaultValue
protected boolean	hasDefault
protected boolean	keysIgnoreCase
protected boolean	liveView
protected java.lang.Class<?>	sourceAsClass
protected boolean	sourceAsDTO
protected boolean	sourceAsJavaBean
protected java.lang.Class<?>	targetAsClass
protected boolean	targetAsDTO
protected boolean	targetAsJavaBean

Constructor Summary

Constructors

Constructor and Description
AbstractSpecifying()

Method Summary

Modifier and Type	Method and Description
private T	castThis()
T	defaultValue(java.lang.Object defVal) The default value to use when the object cannot be converted or in case of conversion from a null value.
T	keysIgnoreCase() When converting between map-like types use case-insensitive mapping of keys.
T	sourceAs(java.lang.Class<?> cls) Treat the source object as the specified class.
T	sourceAsBean() Treat the source object as a JavaBean.
T	sourceAsDTO() Treat the source object as a DTO even if the source object has methods or is otherwise not recognized as a DTO.
T	targetAs(java.lang.Class<?> cls) Treat the target object as the specified class.
T	targetAsBean() Treat the target object as a JavaBean.
T	targetAsDTO() Treat the target object as a DTO even if it has methods or is otherwise not recognized as a DTO.
T	view() Return a live view over the backing object that reflects any changes to the original object.

Methods inherited from class java.lang.Object

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

Field Detail

defaultValue

protected volatile java.lang.Object defaultValue

hasDefault

protected volatile boolean hasDefault

liveView

protected volatile boolean liveView

keysIgnoreCase

protected volatile boolean keysIgnoreCase

sourceAsClass

protected volatile java.lang.Class<?> sourceAsClass

sourceAsDTO

protected volatile boolean sourceAsDTO

sourceAsJavaBean

protected volatile boolean sourceAsJavaBean

targetAsClass

protected volatile java.lang.Class<?> targetAsClass

targetAsDTO

protected volatile boolean targetAsDTO

targetAsJavaBean

protected volatile boolean targetAsJavaBean

Constructor Detail

AbstractSpecifying

AbstractSpecifying()

Method Detail

castThis

private T castThis()

defaultValue

public T defaultValue(java.lang.Object defVal)

Description copied from interface: Specifying

The default value to use when the object cannot be converted or in case of conversion from a null value.

Specified by:

defaultValue in interface Specifying<T extends Specifying<T>>

Parameters:

defVal - The default value.

Returns:

The current Converting object so that additional calls can be chained.

keysIgnoreCase

public T keysIgnoreCase()

Description copied from interface: Specifying

When converting between map-like types use case-insensitive mapping of keys.

Specified by:

keysIgnoreCase in interface Specifying<T extends Specifying<T>>

Returns:

The current Converting object so that additional calls can be chained.

sourceAs

public T sourceAs(java.lang.Class<?> cls)

Description copied from interface: Specifying

Treat the source object as the specified class. This can be used to disambiguate a type if it implements multiple interfaces or extends multiple classes.

Specified by:

sourceAs in interface Specifying<T extends Specifying<T>>

Parameters:

cls - The class to treat the object as.

Returns:

The current Converting object so that additional calls can be chained.

sourceAsBean

public T sourceAsBean()

Description copied from interface: Specifying

Treat the source object as a JavaBean. By default objects will not be treated as JavaBeans, this has to be specified using this method.

Specified by:

sourceAsBean in interface Specifying<T extends Specifying<T>>

Returns:

The current Converting object so that additional calls can be chained.

sourceAsDTO

public T sourceAsDTO()

Description copied from interface: Specifying

Treat the source object as a DTO even if the source object has methods or is otherwise not recognized as a DTO.

Specified by:

sourceAsDTO in interface Specifying<T extends Specifying<T>>

Returns:

The current Converting object so that additional calls can be chained.

targetAs

public T targetAs(java.lang.Class<?> cls)

Description copied from interface: Specifying

Treat the target object as the specified class. This can be used to disambiguate a type if it implements multiple interfaces or extends multiple classes.

Specified by:

targetAs in interface Specifying<T extends Specifying<T>>

Parameters:

cls - The class to treat the object as.

Returns:

The current Converting object so that additional calls can be chained.

targetAsBean

public T targetAsBean()

Description copied from interface: Specifying

Treat the target object as a JavaBean. By default objects will not be treated as JavaBeans, this has to be specified using this method.

Specified by:

targetAsBean in interface Specifying<T extends Specifying<T>>

Returns:

The current Converting object so that additional calls can be chained.

targetAsDTO

public T targetAsDTO()

Description copied from interface: Specifying

Treat the target object as a DTO even if it has methods or is otherwise not recognized as a DTO.

Specified by:

targetAsDTO in interface Specifying<T extends Specifying<T>>

Returns:

The current Converting object so that additional calls can be chained.

view

public T view()

Description copied from interface: Specifying

Return a live view over the backing object that reflects any changes to the original object. This is only possible with conversions to Map, Collection, List and Set. The live view object will cease to be live as soon as modifications are made to it. Note that conversions to an interface or annotation will always produce a live view that cannot be modified. This modifier has no effect with conversions to other types.

Specified by:

view in interface Specifying<T extends Specifying<T>>

Returns:

The current Converting object so that additional calls can be chained.