ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
coldfusion.air 

Session  - AS3 CF

Paketcoldfusion.air
Klassepublic class Session
VererbungSession Inheritance Object
Implementiert IEventDispatcher

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Manages all interactions between the AIR client and the offline sqlite database.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
Öffentliche Methoden
 MethodeDefiniert von
  
Session(dbfile:File, syncManager:SyncManager, id:uint, cacheDirectory:File, encryptionKey:ByteArray)
Creates an instance of the Session class.
Session
  
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with the Session object so that the listener receives notification of an event.
Session
  
Begins a transaction on the session.
Session
  
Closes the session by clearing the internal cache and closing the SqlConnection.
Session
  
Commits the changes that have happened to the local database since the last fetch.
Session
  
Commits the changes in the transaction.
Session
  
Dispatches an event into the event flow.
Session
  
Returns the SQLConnection being used by the session.
Session
  
Returns the database file the session is operating on.
Session
  
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
Session
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
  
Determines whether a commit must be called on the session to commit any pending operations to the server.
Session
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
Retains the object in the local database and ignores the server object for each element in the ArrayCollection of conflict instances.
Session
  
Replaces the object in the local database with the corresponding server object for each element in the ArrayCollection of conflict instances.
Session
  
Retains the client object instance with the server object instance even if they are in conflict.
Session
  
Replaces the client object instance with the server object instance if they are in conflict.
Session
  
Loads the object with the specified lazy field name.
Session
  
load(cls:Class, obj:Object, ignoreLazyLoad:Boolean = false):coldfusion.air:SessionToken
Takes objects of key-value pairs as criteria and returns an arraycollection matching the specified criteria.
Session
  
loadAll(cls:Class, ignoreLazyLoad:Boolean = false):coldfusion.air:SessionToken
Loads all the instances of a particular Class from the database.
Session
  
loadByPK(cls:Class, obj:Object, ignoreLazyLoad:Boolean = false):coldfusion.air:SessionToken
Loads a specific instance specified by the primary key-value pairs passed in the second parameter.
Session
  
loadByQuery(cls:Class, sqlCondition:String, ignoreLazyLoad:Boolean = false):coldfusion.air:SessionToken
Loads instances of the type cls by taking the SQL condition for the WHERE clause to filter the instances.
Session
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
Removes the object instance passed to the fucntion from the database.
Session
  
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
Session
  
Resets all the changes tracked in the offline AIR application.
Session
  
Rolls the changes in the transaction back to the state before the transaction.
Session
  
Saves an instance of the object in the local database.
Session
  
Saves in the local database an ArrayCollection of data instances returned by the server CFC fetch method.
Session
  
Saves a single object instance in the local database.
Session
  
Checks if the object specified in the parameter exists in the database.
Session
  
Saves or updates in the local database tan ArrayCollection of data instances returned by the server CFC fetch method.
Session
  
Saves or updates in the local database a data instance returned by the server CFC fetch method.
Session
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
  
Updates the instance passed to it in the database.
Session
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
  
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
Session
Konstruktordetails

Session

()Konstruktor
public function Session(dbfile:File, syncManager:SyncManager, id:uint, cacheDirectory:File, encryptionKey:ByteArray)

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Creates an instance of the Session class.

Parameter
dbfile:File — File handler for the offline sqlite database file.
 
syncManager:SyncManager — Instance of the SyncManager class.
 
id:uint — Integer ID to create a unique session for the offline sqlite database. Use this ID to ensure that the correct sqlite database is used for each client-side transaction.
 
cacheDirectory:File
 
encryptionKey:ByteArray
Methodendetails

addEventListener

()Methode
public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Registers an event listener object with the Session object so that the listener receives notification of an event.

Parameter

type:String — String that specifies the type of the event.
 
listener:Function — The listener function that processes the event.
 
useCapture:Boolean (default = false) — Determines whether the listener works in the capture phase or the target and bubbling phases.
 
priority:int (default = 0) — The priority level of the event listener.
 
useWeakReference:Boolean (default = false) — Determines whether the reference to the listener is strong or weak.

beginTransaction

()Methode 
public function beginTransaction(option:String = null):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Begins a transaction on the session.

Parameter

option:String (default = null) — Indicates the locking strategy that is used by the transaction. The value can be one of the constants defined in the SQLTransactionLockType class: DEFERRED (the default) indicates that a lock is not acquired until the first read or write operation. EXCLUSIVE indicates that a lock is acquired as soon as possible, and no other SQLConnection instance can read from or write to the database. IMMEDIATE indicates that a lock is acquired as soon as possible, in which other SQLConnection instances can read from but can't write to the database.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call

close

()Methode 
public function close():coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Closes the session by clearing the internal cache and closing the SqlConnection. Match each openSession call on the syncManager with a corresponding close call on the session.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

commit

()Methode 
public function commit(ignoreLazyLoad:Boolean = false):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Commits the changes that have happened to the local database since the last fetch.

Parameter

ignoreLazyLoad:Boolean (default = false) — Loads complete instances plus the chain of related objects by ignoring any fetchType of lazyload defined in the metadata.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

commitTransaction

()Methode 
public function commitTransaction():coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Commits the changes in the transaction.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

dispatchEvent

()Methode 
public function dispatchEvent(evt:Event):Boolean

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Dispatches an event into the event flow. The event target is the EventDispatcher object upon which the dispatchEvent() method is called.

Parameter

evt:Event — The Event object that is dispatched into the event flow. If the event is being redispatched, a clone of the event is created automatically. After an event is dispatched, its target property cannot be changed, so you must create a new copy of the event for redispatching to work.

Rückgabewerte
Boolean — A value of true if the event was successfully dispatched. A value of false indicates failure or that preventDefault() was called on the event.

dispatchSessionResultEvent

()Methode 
cfair_internal function dispatchSessionResultEvent(result:Object, token:coldfusion.air:SessionToken, autoGeneratedId:Object = null):void

Parameter

result:Object
 
token:coldfusion.air:SessionToken
 
autoGeneratedId:Object (default = null)

executeStatement

()Methode 
cfair_internal function executeStatement(stmt:SQLStatement, responder:Responder, doLog:Boolean = true):void

Parameter

stmt:SQLStatement
 
responder:Responder
 
doLog:Boolean (default = true)

getConnection

()Methode 
public function getConnection():SQLConnection

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Returns the SQLConnection being used by the session.

Rückgabewerte
SQLConnection

getDatabaseFile

()Methode 
public function getDatabaseFile():File

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9.0.1
Laufzeitversionen: Flash Player 9, AIR 1.0

Returns the database file the session is operating on.

Rückgabewerte
File

hasEventListener

()Methode 
public function hasEventListener(type:String):Boolean

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Checks whether the EventDispatcher object has any listeners registered for a specific type of event.

Parameter

type:String — The type of event.

Rückgabewerte
Boolean — A value of true if a listener of the specified type is registered; false otherwise.

isCommitRequired

()Methode 
public function isCommitRequired():coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Determines whether a commit must be called on the session to commit any pending operations to the server. The result received by a SessionResultEvent event is a Boolean value specifying if the commit is needed.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

keepAllClientObjects

()Methode 
public function keepAllClientObjects(coll:ArrayCollection):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9.0.1
Laufzeitversionen: Flash Player 9, AIR 1.0

Retains the object in the local database and ignores the server object for each element in the ArrayCollection of conflict instances.

Parameter

coll:ArrayCollection — ArrayCollection of conflict objects returned by the ColdFusion server.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

keepAllServerObjects

()Methode 
public function keepAllServerObjects(coll:ArrayCollection):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Replaces the object in the local database with the corresponding server object for each element in the ArrayCollection of conflict instances.

Parameter

coll:ArrayCollection — Array collection of Conflict objects returned by the ColdFusion server.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

keepClientObject

()Methode 
public function keepClientObject(conflict:Conflict):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9.0.1
Laufzeitversionen: Flash Player 9, AIR 1.0

Retains the client object instance with the server object instance even if they are in conflict.

Parameter

conflict:Conflict — Conflict object returned by the ColdFusion server.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

keepServerObject

()Methode 
public function keepServerObject(conflict:Conflict):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Replaces the client object instance with the server object instance if they are in conflict.

Parameter

conflict:Conflict — Conflict object returned by the ColdFusion server.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

lazyLoad

()Methode 
public function lazyLoad(obj:Object, lazyFieldName:String):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Loads the object with the specified lazy field name.

Parameter

obj:Object — The object to be loaded.
 
lazyFieldName:String — Property name of the nested object that needs to be loaded.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

load

()Methode 
public function load(cls:Class, obj:Object, ignoreLazyLoad:Boolean = false):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Takes objects of key-value pairs as criteria and returns an arraycollection matching the specified criteria.

Parameter

cls:Class — Class object of the ActionScript type.
 
obj:Object — Specifies the key-value pairs for which to find matching instances.
 
ignoreLazyLoad:Boolean (default = false) — Loads complete instances plus the chain of related objects by ignoring any fetchType of lazyload defined in the metadata.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

loadAll

()Methode 
public function loadAll(cls:Class, ignoreLazyLoad:Boolean = false):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Loads all the instances of a particular Class from the database.

Parameter

cls:Class — Class object of the ActionScript type.
 
ignoreLazyLoad:Boolean (default = false) — Loads complete instances plus the chain of related objects by ignoring any fetchType of lazyload defined in the metadata.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

loadByPK

()Methode 
public function loadByPK(cls:Class, obj:Object, ignoreLazyLoad:Boolean = false):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Loads a specific instance specified by the primary key-value pairs passed in the second parameter.

Parameter

cls:Class — Class object of the ActionScript type.
 
obj:Object — Map of id fields and its values
 
ignoreLazyLoad:Boolean (default = false) — Loads complete instances plus the chain of related objects by ignoring any fetchType of lazyload defined in the metadata.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

loadByQuery

()Methode 
public function loadByQuery(cls:Class, sqlCondition:String, ignoreLazyLoad:Boolean = false):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Loads instances of the type cls by taking the SQL condition for the WHERE clause to filter the instances.

Parameter

cls:Class — Class object of the ActionScript type.
 
sqlCondition:String — The SQL condition to match.
 
ignoreLazyLoad:Boolean (default = false) — Loads complete instances plus the chain of related objects by ignoring any fetchType of lazyload defined in the metadata.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

remove

()Methode 
public function remove(obj:Object):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Removes the object instance passed to the fucntion from the database. Corresponds to a SQL DELETE operation.

Parameter

obj:Object — The object to delete in the local database.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

removeEventListener

()Methode 
public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Removes a listener from the EventDispatcher object. If there is no matching listener registered with the EventDispatcher object, a call to this method has no effect.

Parameter

type:String — The type of event.
 
listener:Function — The listener object to remove.
 
useCapture:Boolean (default = false) — Specifies whether the listener was registered for the capture phase or the target and bubbling phases. If the listener was registered for both the capture phase and the target and bubbling phases, two calls to removeEventListener() are required to remove both, one call with useCapture() set to true, and another call with useCapture() set to false.

resetTrackingChanges

()Methode 
public function resetTrackingChanges(className:String = null):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Resets all the changes tracked in the offline AIR application.

Parameter

className:String (default = null) — A fully qualified class name. When you pass this parameter, the resetTrackingChanges function resets all the changes tracked for all instances of the class name being passed.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

rollbackTransaction

()Methode 
public function rollbackTransaction():coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Rolls the changes in the transaction back to the state before the transaction.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

save

()Methode 
public function save(saveObj:Object):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Saves an instance of the object in the local database. Corresponds to a SQL INSERT operation.

Parameter

saveObj:Object — The object to save in the local database.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

saveCache

()Methode 
public function saveCache(coll:ArrayCollection):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Saves in the local database an ArrayCollection of data instances returned by the server CFC fetch method.

Parameter

coll:ArrayCollection — Array collection of the server objects.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

saveCacheObject

()Methode 
public function saveCacheObject(obj:Object):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Saves a single object instance in the local database. This is an alternative to saveCache function that you can use if the fetch method returns a single result. This function differs from Save function. The Save function inserts a new record, whereas this method copies the object from server to the local database.

Parameter

obj:Object

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

saveCacheObjectCallCache

()Methode 
cfair_internal function saveCacheObjectCallCache(obj:Object, callCache:CallCache):coldfusion.air:SessionToken

Parameter

obj:Object
 
callCache:CallCache

Rückgabewerte
coldfusion.air:SessionToken

saveUpdate

()Methode 
public function saveUpdate(saveObj:Object):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Checks if the object specified in the parameter exists in the database. If it does exists, updates the object; otherwise, it inserts the object in the database.

Parameter

saveObj:Object — The object to save or update in the local database.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

saveUpdateCache

()Methode 
public function saveUpdateCache(coll:ArrayCollection):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Saves or updates in the local database tan ArrayCollection of data instances returned by the server CFC fetch method.

Parameter

coll:ArrayCollection — Array collection of the server objects.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

saveUpdateCacheObject

()Methode 
public function saveUpdateCacheObject(obj:Object):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Saves or updates in the local database a data instance returned by the server CFC fetch method. This is an alternative to SaveUpdateCache function that you can use if the fetch method returns a single result. This function differs from SaveUpdate function. The SaveUpdate function inserts a new record or updates an existing one, whereas this method copies the object from server to the local database.

Parameter

obj:Object — Object that is passed to the function.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

update

()Methode 
public function update(obj:Object):coldfusion.air:SessionToken

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Updates the instance passed to it in the database. Corresponds to a SQL UPDATE operation.

Parameter

obj:Object — The object to update in the local database.

Rückgabewerte
coldfusion.air:SessionToken — The session token associated with the call.

willTrigger

()Methode 
public function willTrigger(type:String):Boolean

Sprachversion: ActionScript 3.0
Produktversion: ColdFusion 9
Laufzeitversionen: Flash Player 9, AIR 1.0

Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type. This method returns true if an event listener is triggered during any phase of the event flow when an event of the specified type is dispatched to this EventDispatcher object or any of its descendants.

Parameter

type:String — The type of event.

Rückgabewerte
Boolean — A value of true if a listener of the specified type will be triggered; false otherwise.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.