manifold.sql.rt.api

Class BasicTxBindings

java.lang.Object

manifold.sql.rt.api.BasicTxBindings

All Implemented Interfaces:

java.util.Map<java.lang.String,java.lang.Object>, manifold.rt.api.Bindings, OperableTxBindings, TxBindings

public class BasicTxBindings
extends java.lang.Object
implements OperableTxBindings

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

java.util.Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
BasicTxBindings(TxScope txScope, TxKind txKind, manifold.rt.api.Bindings initialState) Creates a new bindings for an entity instance.

Method Summary

Modifier and Type	Method and Description
void	clear()
void	commit() Commit is called _after_ a successful commit on the TxScope.
boolean	containsKey(java.lang.Object key)
boolean	containsValue(java.lang.Object value)
void	dropHeldValues()
java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>>	entrySet()
boolean	equals(java.lang.Object o)
void	failedCommit()
java.lang.Object	get(java.lang.Object key)
java.lang.Object	getHeldValue(java.lang.String name)
manifold.rt.api.Bindings	getMetadata()
Entity	getOwner()
java.lang.Object	getPersistedStateValue(java.lang.String name)
TxScope	getTxScope()
int	hashCode()
void	holdValue(java.lang.String name, java.lang.Object value)
void	holdValues(manifold.rt.api.Bindings valuesToHold)
boolean	isEmpty()
boolean	isForDelete()
boolean	isForInsert()
boolean	isForUpdate()
java.util.Set<java.lang.String>	keySet()
java.util.Map<java.lang.String,java.lang.Object>	persistedStateEntrySet()
java.lang.Object	put(java.lang.String name, java.lang.Object value)
void	putAll(java.util.Map<? extends java.lang.String,?> toMerge)
java.lang.Object	remove(java.lang.Object key) Note, sets the key's value to null in the changes bindings, to distinguish null values from unset values.
void	reuse()
void	revert() For internal use, only to be called from TxScope.revert()
void	setDelete(boolean value)
void	setOwner(Entity owner)
int	size()
java.util.Map<java.lang.String,java.lang.Object>	uncommittedChangesEntrySet()
java.util.Collection<java.lang.Object>	values()

Methods inherited from class java.lang.Object

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

Methods inherited from interface manifold.rt.api.Bindings

displayEntries, displayValues

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Constructor Detail

BasicTxBindings

public BasicTxBindings(TxScope txScope,
                       TxKind txKind,
                       manifold.rt.api.Bindings initialState)

Creates a new bindings for an entity instance.

The txKind not only indicates the operational context of the entity, it also signals the type of initial state of the bindings. For instance, the Insert kind implies the object has no persisted state because it is entirely new, thus the initialState is a set of uncommitted changes. Similarly, the Update kind must involve an existing entity, the state of which reflects its persisted state from the data source.

Method Detail

getOwner

public Entity getOwner()

Specified by:

getOwner in interface TxBindings

setOwner

public void setOwner(Entity owner)

Specified by:

setOwner in interface OperableTxBindings

getTxScope

public TxScope getTxScope()

Specified by:

getTxScope in interface TxBindings

isForInsert

public boolean isForInsert()

Specified by:

isForInsert in interface TxBindings

isForUpdate

public boolean isForUpdate()

Specified by:

isForUpdate in interface TxBindings

isForDelete

public boolean isForDelete()

Specified by:

isForDelete in interface TxBindings

setDelete

public void setDelete(boolean value)

Specified by:

setDelete in interface OperableTxBindings

holdValues

public void holdValues(manifold.rt.api.Bindings valuesToHold)

Specified by:

holdValues in interface OperableTxBindings

holdValue

public void holdValue(java.lang.String name,
                      java.lang.Object value)

Specified by:

holdValue in interface OperableTxBindings

getHeldValue

public java.lang.Object getHeldValue(java.lang.String name)

Specified by:

getHeldValue in interface OperableTxBindings

dropHeldValues

public void dropHeldValues()

Specified by:

dropHeldValues in interface OperableTxBindings

commit

public void commit()
            throws java.sql.SQLException

Commit is called _after_ a successful commit on the TxScope.

Specified by:

commit in interface OperableTxBindings

Throws:

java.sql.SQLException

failedCommit

public void failedCommit()
                  throws java.sql.SQLException

Specified by:

failedCommit in interface OperableTxBindings

Throws:

java.sql.SQLException

reuse

public void reuse()

Specified by:

reuse in interface OperableTxBindings

revert

public void revert()
            throws java.sql.SQLException

For internal use, only to be called from TxScope.revert()

Specified by:

revert in interface OperableTxBindings

Throws:

java.sql.SQLException

getMetadata

public manifold.rt.api.Bindings getMetadata()

Specified by:

getMetadata in interface manifold.rt.api.Bindings

put

public java.lang.Object put(java.lang.String name,
                            java.lang.Object value)

Specified by:

put in interface java.util.Map<java.lang.String,java.lang.Object>

putAll

public void putAll(java.util.Map<? extends java.lang.String,?> toMerge)

Specified by:

putAll in interface java.util.Map<java.lang.String,java.lang.Object>

clear

public void clear()

Specified by:

clear in interface java.util.Map<java.lang.String,java.lang.Object>

containsKey

public boolean containsKey(java.lang.Object key)

Specified by:

containsKey in interface java.util.Map<java.lang.String,java.lang.Object>

containsValue

public boolean containsValue(java.lang.Object value)

Specified by:

containsValue in interface java.util.Map<java.lang.String,java.lang.Object>

entrySet

public java.util.Set<java.util.Map.Entry<java.lang.String,java.lang.Object>> entrySet()

Specified by:

entrySet in interface java.util.Map<java.lang.String,java.lang.Object>

uncommittedChangesEntrySet

public java.util.Map<java.lang.String,java.lang.Object> uncommittedChangesEntrySet()

Specified by:

uncommittedChangesEntrySet in interface OperableTxBindings

persistedStateEntrySet

public java.util.Map<java.lang.String,java.lang.Object> persistedStateEntrySet()

Specified by:

persistedStateEntrySet in interface OperableTxBindings

getPersistedStateValue

public java.lang.Object getPersistedStateValue(java.lang.String name)

Specified by:

getPersistedStateValue in interface OperableTxBindings

get

public java.lang.Object get(java.lang.Object key)

Specified by:

get in interface java.util.Map<java.lang.String,java.lang.Object>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface java.util.Map<java.lang.String,java.lang.Object>

keySet

public java.util.Set<java.lang.String> keySet()

Specified by:

keySet in interface java.util.Map<java.lang.String,java.lang.Object>

remove

public java.lang.Object remove(java.lang.Object key)

Note, sets the key's value to null in the changes bindings, to distinguish null values from unset values.

Specified by:

remove in interface java.util.Map<java.lang.String,java.lang.Object>

size

public int size()

Specified by:

size in interface java.util.Map<java.lang.String,java.lang.Object>

values

public java.util.Collection<java.lang.Object> values()

Specified by:

values in interface java.util.Map<java.lang.String,java.lang.Object>

equals

public boolean equals(java.lang.Object o)

Specified by:

equals in interface java.util.Map<java.lang.String,java.lang.Object>

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Specified by:

hashCode in interface java.util.Map<java.lang.String,java.lang.Object>

Overrides:

hashCode in class java.lang.Object