org.dcm4che3.conf.core.olock

Class HashBasedOptimisticLockingConfiguration

java.lang.Object

org.dcm4che3.conf.core.DelegatingConfiguration

org.dcm4che3.conf.core.olock.HashBasedOptimisticLockingConfiguration

All Implemented Interfaces:

BatchRunner, Configuration

public class HashBasedOptimisticLockingConfiguration
extends DelegatingConfiguration

Caution: persistNode should be called in a transaction to ensure consistent comparison between data from backend/data being persisted, otherwise it's possible that another writer modifies something before this class obtains a lock and the changes by that writer will be lost Edge cases:

• If one deletes a node that is a root of olock, and another changes that node, it is NOT considered a conflict, regardless of operation order the node will be just deleted. this holds for case of a subnode, a map entry, or a collection element that has a uuid.
• For any collections whose elements don't have uuids, a collection is always fully overwritten without trying to merge in any modified contents from the backend.

Author:

Roman K

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HashBasedOptimisticLockingConfiguration.HashMarkingTypesafeNodeFilter Inserts #hash props into node according to @ConfigurableProperty annotations

Nested classes/interfaces inherited from interface org.dcm4che3.conf.core.api.Configuration

Configuration.ConfigStorageType, Configuration.NodeFactory

Nested classes/interfaces inherited from interface org.dcm4che3.conf.core.api.BatchRunner

BatchRunner.Batch

Field Summary

Fields

Modifier and Type	Field and Description
private List<Class>	allExtensionClasses
private static Logger	log
static String	NOT_CALCULATED_YET
static String	OLD_OLOCK_HASH_KEY

Fields inherited from class org.dcm4che3.conf.core.DelegatingConfiguration

delegate

Fields inherited from interface org.dcm4che3.conf.core.api.Configuration

CONF_STORAGE_SYSTEM_PROP, OLOCK_HASH_KEY, REFERENCE_BY_UUID_PATTERN, REFERENCE_KEY, UUID_KEY, WEAK_REFERENCE_KEY

Constructor Summary

Constructors

Constructor and Description
HashBasedOptimisticLockingConfiguration(Configuration delegate, List<Class> allExtensionClasses)

Method Summary

Modifier and Type	Method and Description
Object	getConfigurationNode(Path path, Class configurableClass) Loads a configuration node under the specified path.
void	persistNode(Path path, Map<String,Object> configNode, Class configurableClass) Persists the configuration node to the specified path.

Methods inherited from class org.dcm4che3.conf.core.DelegatingConfiguration

getConfigurationRoot, getPathByUUID, lock, nodeExists, refreshNode, removeNode, runBatch, search

Methods inherited from class java.lang.Object

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

Field Detail

log

private static final Logger log

NOT_CALCULATED_YET

public static final String NOT_CALCULATED_YET

See Also:

Constant Field Values

OLD_OLOCK_HASH_KEY

public static final String OLD_OLOCK_HASH_KEY

See Also:

Constant Field Values

allExtensionClasses

private List<Class> allExtensionClasses

Constructor Detail

HashBasedOptimisticLockingConfiguration

public HashBasedOptimisticLockingConfiguration(Configuration delegate,
                                               List<Class> allExtensionClasses)

Parameters:

delegate -

allExtensionClasses -

Method Detail

persistNode

public void persistNode(Path path,
                        Map<String,Object> configNode,
                        Class configurableClass)
                 throws ConfigurationException

Description copied from interface: Configuration

Persists the configuration node to the specified path. The path must exist (or at least all nodes but the last one). The property is created/fully overwritten, i.e. if there were any child nodes in the old root that are not present in the new node root, they will be deleted in the new tree.

Specified by:

persistNode in interface Configuration

Overrides:

persistNode in class DelegatingConfiguration

Parameters:

path - path to the node

configNode - configuration node to persist

configurableClass - class annotated with ConfigurableClass, ConfigurableProperty annotations that corresponds to this node.

Throws:

ConfigurationException

getConfigurationNode

public Object getConfigurationNode(Path path,
                                   Class configurableClass)
                            throws ConfigurationException

Description copied from interface: Configuration

Loads a configuration node under the specified path.

Specified by:

getConfigurationNode in interface Configuration

Overrides:

getConfigurationNode in class DelegatingConfiguration

Parameters:

path - A reference to a node

Returns:

configuration node or null, if not found

Throws:

ConfigurationException