org.ujorm.implementation.orm
Class OrmTableSynchronized<UJO_IMPL extends Ujo>

java.lang.Object
  org.ujorm.extensions.SuperAbstractUjo
      org.ujorm.extensions.AbstractUjo
          org.ujorm.implementation.quick.QuickUjo
              org.ujorm.implementation.orm.OrmTableSynchronized<UJO_IMPL>

All Implemented Interfaces:

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

public abstract class OrmTableSynchronized<UJO_IMPL extends Ujo>
extends QuickUjo
implements ExtendedOrmUjo<UJO_IMPL>

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

OrmTableSynchronized()


Method Summary

<UJO extends UJO_IMPL,VALUE> VALUE	get(Key<UJO,VALUE> key) Getter based on Key implemeted by a pattern UjoExt
protected static <UJO extends Ujo,FACTORY extends KeyFactory<UJO>> FACTORY	newCamelFactory(Class<? extends UJO> ujoClass) Create a factory with a cammel-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 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.
Key[]	readChangedProperties(boolean clear) Returns keys of changed values in a time when any session is assigned.
<UJO extends UJO_IMPL> ForeignKey	readFK(Key<UJO,? extends OrmUjo> key) Read the foreign key.
Session	readSession() Read a session
Object	readValue(Key key) A method for an internal use only.
<UJO extends UJO_IMPL,VALUE> UJO_IMPL	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.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.

get

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

Getter based on Key implemeted by a pattern UjoExt

set

public final <UJO extends UJO_IMPL,VALUE> UJO_IMPL 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 UJO_IMPL> 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<UJO_IMPL extends Ujo>

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.

newCamelFactory

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

Create a factory with a cammel-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 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!