Session (GORM 7.3.4)

org.grails.datastore.mapping.query.QueryCreator

All Superinterfaces:

QueryCreator

The Session represents the active interaction with a datastore.
Authors:
Graeme Rocher
Guillaume Laforge
Since:
1.0

Methods Summary

Methods
Type Params	Return Type	Name and description
	`void`	`attach(java.lang.Object o)` Attaches an object the current session
	`Transaction`	`beginTransaction()` Starts a transaction
	`Transaction`	`beginTransaction(org.springframework.transaction.TransactionDefinition definition)` Starts a transaction
	`void`	`clear()` Clears any pending changes to the datastore
	`void`	`clear(java.lang.Object o)` Clear a specific object
	`java.lang.Object`	`clearSessionProperty(java.lang.String property)` Clear a property in a session.
	`boolean`	`contains(java.lang.Object o)` Whether the object is contained within the first level cache
	`Query`	`createQuery(java.lang.Class type)` Creates a query instance for the give type
	`void`	`delete(java.lang.Iterable objects)` Deletes one or many objects
	`void`	`delete(java.lang.Object obj)` Deletes a single object
	`long`	`deleteAll(QueryableCriteria criteria)` Deletes all objects matching the given criteria
	`void`	`disconnect()` Disconnects from the datastore.
	`void`	`flush()` Flushes any pending changes to the datastore
	`java.lang.Object`	`getAttribute(java.lang.Object entity, java.lang.String attributeName)` Obtains an attribute for the given entity
	`Datastore`	`getDatastore()` The Datastore that created this Session
	`javax.persistence.FlushModeType`	`getFlushMode()` Obtains the current FlushModeType
	`MappingContext`	`getMappingContext()` Obtains the MappingContext instance
	`java.lang.Object`	`getNativeInterface()` @return The native interface to the datastore
	`java.io.Serializable`	`getObjectIdentifier(java.lang.Object instance)` Obtains the identifier for the instance
	`Persister`	`getPersister(java.lang.Object o)` The persister for the given object
	`java.lang.Object`	`getSessionProperty(java.lang.String property)` Get the value of a property of the session.
	`Transaction`	`getTransaction()` Obtains the current transaction instance
	`boolean`	`hasTransaction()` @return Whether the current session has an active transaction
	`java.io.Serializable`	`insert(java.lang.Object o)` Forces an insert
	`boolean`	`isConnected()` @return `true` if connected to the datastore
	`boolean`	`isDirty(java.lang.Object instance)` Check if the instance has been modified since loading.
	`void`	`lock(java.lang.Object o)` Obtains a write lock on the given object
`<T>`	`T`	`lock(java.lang.Class<T> type, java.io.Serializable key)` Retrieves an individual object, using a write lock to prevent loss of updates
	`java.io.Serializable`	`persist(java.lang.Object o)` Stores and object and returns its key
	`java.util.List<java.io.Serializable>`	`persist(java.lang.Iterable objects)` Persists several objects returning their identifiers in the order specified by the Iterable
`<T>`	`T`	`proxy(java.lang.Class<T> type, java.io.Serializable key)` Retrieves a proxy for the given key
	`void`	`refresh(java.lang.Object o)` Refreshes the given objects state
`<T>`	`T`	`retrieve(java.lang.Class<T> type, java.io.Serializable key)` Retrieves an individual object
	`java.util.List`	`retrieveAll(java.lang.Class type, java.lang.Iterable keys)` Retrieves several objects for the specified keys
	`java.util.List`	`retrieveAll(java.lang.Class type, java.io.Serializable... keys)` Retrieves several objects for the specified keys
	`void`	`setAttribute(java.lang.Object entity, java.lang.String attributeName, java.lang.Object value)` Associates an attribute with the given persistent entity.
	`void`	`setFlushMode(javax.persistence.FlushModeType flushMode)` The flush mode, defaults to FlushModeType.AUTO
	`java.lang.Object`	`setSessionProperty(java.lang.String property, java.lang.Object value)` Set a property on this session.
	`void`	`setSynchronizedWithTransaction(boolean synchronizedWithTransaction)` Whether the session is synchronized with a transaction
	`void`	`unlock(java.lang.Object o)` Releases a lock, if not called all locked objects should be released by disconnect()
	`long`	`updateAll(QueryableCriteria criteria, java.util.Map<java.lang.String, java.lang.Object> properties)` Updates all objects matching the given criteria and property values

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`interface QueryCreator`	`createQuery, isSchemaless`

- Method Detail
  - public void attach(java.lang.Object o)
    
    Attaches an object the current session
    Parameters:
    o - The object to attach
  - public Transaction beginTransaction()
    
    Starts a transaction
    Returns:
    The transaction
  - public Transaction beginTransaction(org.springframework.transaction.TransactionDefinition definition)
    
    Starts a transaction
    Returns:
    The transaction
  - public void clear()
    
    Clears any pending changes to the datastore
  - public void clear(java.lang.Object o)
    
    Clear a specific object
    Parameters:
    o - The object to clear
  - public java.lang.Object clearSessionProperty(java.lang.String property)
    
    Clear a property in a session.
    Returns:
    The property value, if there was one (or null).
    Parameters:
    property - The property name.
  - public boolean contains(java.lang.Object o)
    
    Whether the object is contained within the first level cache
    Returns:
    true if it is
    Parameters:
    o - The object to check
  - public Query createQuery(java.lang.Class type)
    
    Creates a query instance for the give type
    Returns:
    The query
    Parameters:
    type - The type
  - public void delete(java.lang.Iterable objects)
    
    Deletes one or many objects
    Parameters:
    objects - The objects to delete
  - public void delete(java.lang.Object obj)
    
    Deletes a single object
    Parameters:
    obj - The object to delete
  - public long deleteAll(QueryableCriteria criteria)
    
    Deletes all objects matching the given criteria
    Returns:
    The total number of records deleted
    Parameters:
    criteria - The criteria
  - public void disconnect()
    
    Disconnects from the datastore.
  - public void flush()
    
    Flushes any pending changes to the datastore
  - public java.lang.Object getAttribute(java.lang.Object entity, java.lang.String attributeName)
    
    Obtains an attribute for the given entity
    Returns:
    The attribute value
    Parameters:
    entity - The entity
    attributeName - The attribute
  - public Datastore getDatastore()
    
    The Datastore that created this Session
    Returns:
    The Datastore instance
  - public javax.persistence.FlushModeType getFlushMode()
    
    Obtains the current FlushModeType
    Returns:
    The FlushModeType instance
  - public MappingContext getMappingContext()
    
    Obtains the MappingContext instance
    Returns:
    The MappingContext
  - public java.lang.Object getNativeInterface()
    
    Returns:
    The native interface to the datastore
  - public java.io.Serializable getObjectIdentifier(java.lang.Object instance)
    
    Obtains the identifier for the instance
    Returns:
    The identifier or null if it cannot be established
    Parameters:
    instance - The instance
  - public Persister getPersister(java.lang.Object o)
    
    The persister for the given object
    Returns:
    The persister
    Parameters:
    o - The object
  - public java.lang.Object getSessionProperty(java.lang.String property)
    
    Get the value of a property of the session.
    Returns:
    The value.
    Parameters:
    property - The name of the property.
  - public Transaction getTransaction()
    
    Obtains the current transaction instance
    Returns:
    The Transaction instance
  - public boolean hasTransaction()
    
    Returns:
    Whether the current session has an active transaction
  - public java.io.Serializable insert(java.lang.Object o)
    
    Forces an insert
    Returns:
    The id
    Parameters:
    o - The object
  - public boolean isConnected()
    
    Returns:
    true if connected to the datastore
  - public boolean isDirty(java.lang.Object instance)
    
    Check if the instance has been modified since loading.
    Returns:
    true if one or more fields have changed
    Parameters:
    instance - the instance
  - public void lock(java.lang.Object o)
    
    Obtains a write lock on the given object
    Parameters:
    o - The object to lock
  - <T> public T lock(java.lang.Class<T> type, java.io.Serializable key)
    
    Retrieves an individual object, using a write lock to prevent loss of updates
    Returns:
    The object
    Parameters:
    type - The type
    key - The key
  - public java.io.Serializable persist(java.lang.Object o)
    
    Stores and object and returns its key
    Returns:
    The the generated key
    Parameters:
    o - The object
  - public java.util.List<java.io.Serializable> persist(java.lang.Iterable objects)
    
    Persists several objects returning their identifiers in the order specified by the Iterable
    Returns:
    The identifiers
    Parameters:
    objects - The Objects
  - <T> public T proxy(java.lang.Class<T> type, java.io.Serializable key)
    
    Retrieves a proxy for the given key
    Returns:
    The object
    Parameters:
    type - The type
    key - The key
  - public void refresh(java.lang.Object o)
    
    Refreshes the given objects state
    Parameters:
    o - The object to refresh
  - <T> public T retrieve(java.lang.Class<T> type, java.io.Serializable key)
    
    Retrieves an individual object
    Returns:
    The object
    Parameters:
    type - The type
    key - The key
  - public java.util.List retrieveAll(java.lang.Class type, java.lang.Iterable keys)
    
    Retrieves several objects for the specified keys
    Returns:
    A list of objects
    Parameters:
    type - The type
    keys - The keys
  - public java.util.List retrieveAll(java.lang.Class type, java.io.Serializable... keys)
    
    Retrieves several objects for the specified keys
    Returns:
    A list of objects
    Parameters:
    type - The type
    keys - The keys
  - public void setAttribute(java.lang.Object entity, java.lang.String attributeName, java.lang.Object value)
    
    Associates an attribute with the given persistent entity. Attributes will be cleared out when the Session is closed or cleared.
    Parameters:
    entity - The persistent instance (must be associated with this Session)
    attributeName - The attribute name
    value - The value
  - public void setFlushMode(javax.persistence.FlushModeType flushMode)
    
    The flush mode, defaults to FlushModeType.AUTO
    Parameters:
    flushMode - The FlushModeType
  - public java.lang.Object setSessionProperty(java.lang.String property, java.lang.Object value)
    
    Set a property on this session. Note that properties are not cleared out when a session is cleared.
    Returns:
    The previous property value, if there was one (or null).
    Parameters:
    property - The property name.
    value - The property value.
  - public void setSynchronizedWithTransaction(boolean synchronizedWithTransaction)
    
    Whether the session is synchronized with a transaction
    Parameters:
    synchronizedWithTransaction - True if it is
  - public void unlock(java.lang.Object o)
    
    Releases a lock, if not called all locked objects should be released by disconnect()
    Parameters:
    o - The object to unlock
  - public long updateAll(QueryableCriteria criteria, java.util.Map<java.lang.String, java.lang.Object> properties)
    
    Updates all objects matching the given criteria and property values
    Returns:
    The total number of records updated
    Parameters:
    criteria - The criteria
    properties - The properties

Summary:
Method

| Detail:
Method

[Java] Interface Session

Methods Summary

Inherited Methods Summary

Method Detail

public void attach(java.lang.Object o)

public Transaction beginTransaction()

public Transaction beginTransaction(org.springframework.transaction.TransactionDefinition definition)

public void clear()

public void clear(java.lang.Object o)

public java.lang.Object clearSessionProperty(java.lang.String property)

public boolean contains(java.lang.Object o)

public Query createQuery(java.lang.Class type)

public void delete(java.lang.Iterable objects)

public void delete(java.lang.Object obj)

public long deleteAll(QueryableCriteria criteria)

public void disconnect()

public void flush()

public java.lang.Object getAttribute(java.lang.Object entity, java.lang.String attributeName)

public Datastore getDatastore()

public javax.persistence.FlushModeType getFlushMode()

public MappingContext getMappingContext()

public java.lang.Object getNativeInterface()

public java.io.Serializable getObjectIdentifier(java.lang.Object instance)

public Persister getPersister(java.lang.Object o)

public java.lang.Object getSessionProperty(java.lang.String property)

public Transaction getTransaction()

public boolean hasTransaction()

public java.io.Serializable insert(java.lang.Object o)

public boolean isConnected()

public boolean isDirty(java.lang.Object instance)

public void lock(java.lang.Object o)

<T> public T lock(java.lang.Class<T> type, java.io.Serializable key)

public java.io.Serializable persist(java.lang.Object o)

public java.util.List<java.io.Serializable> persist(java.lang.Iterable objects)

<T> public T proxy(java.lang.Class<T> type, java.io.Serializable key)

public void refresh(java.lang.Object o)

<T> public T retrieve(java.lang.Class<T> type, java.io.Serializable key)

public java.util.List retrieveAll(java.lang.Class type, java.lang.Iterable keys)

public java.util.List retrieveAll(java.lang.Class type, java.io.Serializable... keys)

public void setAttribute(java.lang.Object entity, java.lang.String attributeName, java.lang.Object value)

public void setFlushMode(javax.persistence.FlushModeType flushMode)

public java.lang.Object setSessionProperty(java.lang.String property, java.lang.Object value)

public void setSynchronizedWithTransaction(boolean synchronizedWithTransaction)

public void unlock(java.lang.Object o)

public long updateAll(QueryableCriteria criteria, java.util.Map<java.lang.String, java.lang.Object> properties)