org.ujorm.implementation.orm

Class OrmTableSynchronized<U extends OrmTableSynchronized>

java.lang.Object

org.ujorm.extensions.SuperAbstractUjo

org.ujorm.extensions.AbstractUjo

org.ujorm.implementation.quick.QuickUjo

org.ujorm.implementation.orm.OrmTableSynchronized<U>

All Implemented Interfaces:

Serializable, UjoCloneable, UjoTextable, ExtendedOrmUjo<U>, OrmUjo, Ujo

public abstract class OrmTableSynchronized<U extends OrmTableSynchronized>
extends QuickUjo
implements ExtendedOrmUjo<U>

It is an thread safe implementation of the OrmUjo for the multi-thread use. The special feature are:

• some critical method are synchronized
• Session is saved to the ThreadLocal instance so object in different thread must assign a new Session

See the OrmTable javadoc for basic information.

See Also:

OrmTable, Serialized Form

Constructor Summary

Constructors

Constructor and Description
OrmTableSynchronized()

Method Summary

Modifier and Type	Method and Description
void	clearModificationFlags() Clear all modification flags
U	cloneUjo() Clone the first level
<UJO extends U,VALUE> VALUE	get(Key<UJO,VALUE> key) Getter based on Key implemented by a pattern UjoExt
boolean	checkModificationFlag(Key key) Check the attribute modification flag
<UJO extends U,VALUE> boolean	checkModificationFlagSafe(Key<UJO,VALUE> key) Type safe checking the modification flag
protected static <UJO extends Ujo,FACTORY extends KeyFactory<UJO>> FACTORY	newCamelFactory(Class<? extends UJO> ujoClass) Create a factory with a camel-case Key name generator.
protected static <UJO extends Ujo,FACTORY extends KeyFactory<UJO>> FACTORY	newFactory(Class<? extends UJO> ujoClass) Create a base factory Key name generator where key name is the same as its field name.
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newKey() A Property Factory creates new key and assigns a next key index.
static <UJO extends QuickUjo,VALUE> Property<UJO,VALUE>	newKey(Key<UJO,VALUE> p) Returns a new instance of key where the default value is null.
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newKey(String name) A Property Factory creates new key and assigns a next key index.
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newKey(String name, Class<VALUE> type, VALUE defaultValue, int index, boolean lock) A Property Factory creates new key and assigns a next key index.
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newKey(String name, VALUE defaultValue) A Property Factory creates new key and assigns a next key index.
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newKey(VALUE value) A Property Factory creates new key and assigns a next key index.
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newKeyDefault(VALUE defaultValue) A Property Factory creates new key and assigns a next key index.
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newProperty() Deprecated. Use the method newKey(...)
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newProperty(Class<VALUE> type) Deprecated. Use rather a method QuickUjo.newProperty() instead of this,
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newProperty(String name) Deprecated. Use the method newKey(...)
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newProperty(String name, Class<VALUE> type) Deprecated. Use rather a method QuickUjo.newProperty(java.lang.String) instead of this.
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newProperty(String name, Class<VALUE> type, VALUE defaultValue, int index, boolean lock) Deprecated.
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newProperty(String name, VALUE value) Deprecated. Use the method newKey(...)
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE>	newProperty(VALUE value) Deprecated. Use the method newKey(...)
protected static <UJO extends ExtendedOrmUjo,ITEM extends ExtendedOrmUjo> RelationToMany<UJO,ITEM>	newRelation() A PropertyIterator Factory creates an new key and assign a next index.
protected static <UJO extends ExtendedOrmUjo,ITEM extends ExtendedOrmUjo> RelationToMany<UJO,ITEM>	newRelation(Class<ITEM> type) Deprecated. use the newRelation() instead of this.
protected static <UJO extends ExtendedOrmUjo,ITEM extends ExtendedOrmUjo> RelationToMany<UJO,ITEM>	newRelation(String name) A PropertyIterator Factory creates an new key and assign a next index.
protected static <UJO extends ExtendedOrmUjo,ITEM extends ExtendedOrmUjo> RelationToMany<UJO,ITEM>	newRelation(String name, Class<ITEM> type) Deprecated. use the newRelation(java.lang.String) instead of this.
boolean	readAuthorization(UjoAction action, Key key, Object value) Test an authorization of the action.
<UJO extends U> ForeignKey	readFK(Key<UJO,? extends OrmUjo> key) Read the foreign key.
Key[]	readChangedProperties(boolean clear) Returns keys of changed values in a time when any session is assigned.
Session	readSession() Read a session
Object	readValue(Key key) A method for an internal use only.
<UJO extends U,VALUE> U	set(Key<UJO,VALUE> key, VALUE value) Setter based on Key.
void	writeSession(Session session) Write a session
void	writeValue(Key key, Object value) A method for an internal use only.

Methods inherited from class org.ujorm.implementation.quick.QuickUjo

newListKey, newListKey, newListProperty, newListProperty, newListProperty, newListProperty

Methods inherited from class org.ujorm.extensions.AbstractUjo

newNoCheckFactory, newSnakeCaseFactory

Methods inherited from class org.ujorm.extensions.SuperAbstractUjo

clone, equals, init, init, readKeys, readUjoManager, readValueString, toString, writeValueString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.ujorm.Ujo

readKeys

Constructor Detail

OrmTableSynchronized

public OrmTableSynchronized()

Method Detail

readSession

public Session readSession()

Read a session

Specified by:

readSession in interface OrmUjo

writeSession

public void writeSession(Session session)

Write a session

Specified by:

writeSession in interface OrmUjo

writeValue

public void writeValue(Key key,
                       Object value)

A method for an internal use only.

Specified by:

writeValue in interface Ujo

Overrides:

writeValue in class AbstractUjo

readValue

public Object readValue(Key key)

A method for an internal use only.

Specified by:

readValue in interface Ujo

Overrides:

readValue in class AbstractUjo

readChangedProperties

public Key[] readChangedProperties(boolean clear)

Returns keys of changed values in a time when any session is assigned. The method is used by a SQL UPDATE statement to update assigned values only. Implementation tip: create a new key type of Set and in the method writeValue assign the current Key always.

Specified by:

readChangedProperties in interface OrmUjo

Parameters:

clear - True value clears all the key changes.

Returns:

Key array of the modified values.

See Also:

the {@link #checkModificatinFlag(org.ujorm.Key) } rather

checkModificationFlag

public boolean checkModificationFlag(@Nonnull
                                     Key key)

Check the attribute modification flag

Specified by:

checkModificationFlag in interface OrmUjo

checkModificationFlagSafe

public final <UJO extends U,VALUE> boolean checkModificationFlagSafe(@Nonnull
                                                                     Key<UJO,VALUE> key)

Type safe checking the modification flag

clearModificationFlags

public void clearModificationFlags()

Description copied from interface: OrmUjo

Clear all modification flags

Specified by:

clearModificationFlags in interface OrmUjo

get

public final <UJO extends U,VALUE> VALUE get(Key<UJO,VALUE> key)

Getter based on Key implemented by a pattern UjoExt

set

public final <UJO extends U,VALUE> U set(Key<UJO,VALUE> key,
                                         VALUE value)

Setter based on Key. Type of value is checked in the runtime. The method was implemented by a pattern UjoExt.

readAuthorization

public boolean readAuthorization(UjoAction action,
                                 Key key,
                                 Object value)

Test an authorization of the action.

Specified by:

readAuthorization in interface Ujo

Overrides:

readAuthorization in class SuperAbstractUjo

readFK

public <UJO extends U> ForeignKey readFK(Key<UJO,? extends OrmUjo> key)
                                  throws IllegalStateException

Read the foreign key. This is useful to obtain the foreign key value without (lazy) loading the entire object. If the lazy object is loaded, the method will need the Session to build the ForeignKey instance.
NOTE: The method is designed for developers only, the Ujorm doesn't call it newer.

Specified by:

readFK in interface ExtendedOrmUjo<U extends OrmTableSynchronized>

Parameters:

key - Must be direct key only (Key.isDirect()==true)

Returns:

If no related object is available, then the result has the NULL value.

Throws:

IllegalStateException - Method throws an exception for a wrong key type.

NullPointerException - Method throws an exception if a Session is missing after a lazy initialization of the key.

cloneUjo

@Nonnull
public U cloneUjo()

Clone the first level

Specified by:

cloneUjo in interface OrmUjo

newCamelFactory

protected static <UJO extends Ujo,FACTORY extends KeyFactory<UJO>> FACTORY newCamelFactory(Class<? extends UJO> ujoClass)

Create a factory with a camel-case Key name generator.
Note: after declarations of all properties is recommend to call method KeyFactory.close();

newFactory

protected static <UJO extends Ujo,FACTORY extends KeyFactory<UJO>> FACTORY newFactory(Class<? extends UJO> ujoClass)

Create a base factory Key name generator where key name is the same as its field name.
Note: after declarations of all properties is recommend to call method KeyFactory.close();
In case of OrmUjo the method is called by a Ujorm framework, so the newCamelFactory

newRelation

@Deprecated
protected static <UJO extends ExtendedOrmUjo,ITEM extends ExtendedOrmUjo> RelationToMany<UJO,ITEM> newRelation(String name,
                                                                                                                           Class<ITEM> type)

Deprecated. use the newRelation(java.lang.String) instead of this.

A PropertyIterator Factory creates an new key and assign a next index.

newRelation

protected static <UJO extends ExtendedOrmUjo,ITEM extends ExtendedOrmUjo> RelationToMany<UJO,ITEM> newRelation(String name)

A PropertyIterator Factory creates an new key and assign a next index.

newRelation

@Deprecated
protected static <UJO extends ExtendedOrmUjo,ITEM extends ExtendedOrmUjo> RelationToMany<UJO,ITEM> newRelation(Class<ITEM> type)

Deprecated. use the newRelation() instead of this.

A PropertyIterator Factory creates an new key and assign a next index.

newRelation

protected static <UJO extends ExtendedOrmUjo,ITEM extends ExtendedOrmUjo> RelationToMany<UJO,ITEM> newRelation()

A PropertyIterator Factory creates an new key and assign a next index.

newKey

protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newKey()

A Property Factory creates new key and assigns a next key index.

newKey

protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newKey(String name)

A Property Factory creates new key and assigns a next key index.

newKey

protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newKey(String name,
                                                                    VALUE defaultValue)

A Property Factory creates new key and assigns a next key index.

newKeyDefault

protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newKeyDefault(VALUE defaultValue)

A Property Factory creates new key and assigns a next key index.

newKey

protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newKey(String name,
                                                                    Class<VALUE> type,
                                                                    VALUE defaultValue,
                                                                    int index,
                                                                    boolean lock)

A Property Factory creates new key and assigns a next key index.

newKey

protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newKey(VALUE value)

A Property Factory creates new key and assigns a next key index.
Warning: Method does not lock the key so you must call AbstractUjo.init(..) method after initialization!

newKey

public static <UJO extends QuickUjo,VALUE> Property<UJO,VALUE> newKey(Key<UJO,VALUE> p)

Returns a new instance of key where the default value is null.
Warning: Method does not lock the key so you must call AbstractUjo.init(..) method after initialization!

newProperty

@Deprecated
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newProperty(String name,
                                                                                     Class<VALUE> type)

Deprecated. Use rather a method QuickUjo.newProperty(java.lang.String) instead of this.

A Property Factory creates new key and assigns a next key index.
Warning: Method does not lock the key so you must call AbstractUjo.init(..) method after initialization!

newProperty

@Deprecated
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newProperty(String name)

Deprecated. Use the method newKey(...)

A Property Factory creates new key and assigns a next key index.
Warning: Method does not lock the key so you must call AbstractUjo.init(..) method after initialization!

newProperty

@Deprecated
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newProperty(String name,
                                                                                     VALUE value)

Deprecated. Use the method newKey(...)

A Property Factory creates new key and assigns a next key index.
Warning: Method does not lock the key so you must call AbstractUjo.init(..) method after initialization!

newProperty

@Deprecated
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newProperty(Class<VALUE> type)

Deprecated. Use rather a method QuickUjo.newProperty() instead of this,

A Property Factory creates new key and assigns a next key index.
Warning: Method does not lock the key so you must call AbstractUjo.init(..) method after initialization!

newProperty

@Deprecated
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newProperty(String name,
                                                                                     Class<VALUE> type,
                                                                                     VALUE defaultValue,
                                                                                     int index,
                                                                                     boolean lock)

Deprecated.

newProperty

@Deprecated
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newProperty(VALUE value)

Deprecated. Use the method newKey(...)

A Property Factory creates new key and assigns a next key index.
Warning: Method does not lock the key so you must call AbstractUjo.init(..) method after initialization!

newProperty

@Deprecated
protected static <UJO extends Ujo,VALUE> Property<UJO,VALUE> newProperty()

Deprecated. Use the method newKey(...)

A Property Factory creates new key and assigns a next key index.
Warning: Method does not lock the key so you must call AbstractUjo.init(..) method after initialization!