Package org.somda.sdc.biceps.common.access

Class CopyManager

java.lang.Object

org.somda.sdc.biceps.common.access.CopyManager

public class CopyManager
extends Object

A utility class to deep copy any input and output if configured.

Problem description:

Any JAXB converted classes come with getters and setters, hence it is not possible to create read only entities as one can always access a descriptor or state of an entity and change it if desired. By copying incoming and outgoing data the MDIB entities are protected against inadvertent or deliberate modification at the cost of performance. If performance plays a role and it can be guaranteed that MDIB data will not be modified at all, then CommonConfig.COPY_MDIB_INPUT and CommonConfig.COPY_MDIB_OUTPUT can be configured such that no copies of descriptors and states are made throughout the MDIB.

Default configuration is yes, copy input and output data.

Method Summary

Modifier and Type	Method	Description
<T> T	processInput(T input)	Copies input data if configured.
<T> T	processOutput(T output)	Copies output data if configured.

Methods inherited from class java.lang.Object

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

Method Detail

processInput

public <T> T processInput(T input)

Copies input data if configured.

Data is copied if CommonConfig.COPY_MDIB_INPUT is configured true. Data is forwarded otherwise.

Type Parameters:

T - any type that is supposed to be deep-copied.

Parameters:

input - data to be copied.

Returns:

a copy of input if configured, otherwise a forwarded reference.

processOutput

public <T> T processOutput(T output)

Copies output data if configured.

Data is copied if CommonConfig.COPY_MDIB_OUTPUT is configured true. Data is forwarded otherwise.

Type Parameters:

T - any type that is supposed to be deep-copied.

Parameters:

output - data to be copied.

Returns:

a copy of output if configured, otherwise a forwarded reference.