Dans cet article nous allons explorer l’api du PersistentObjectManager. Nous verrons comment créer, mettre à jour, effacer* un objet, comment consulter la base de donnée afin de récupérer un objet ou une collection d’objets et vous découvrirez la gestion des objets persistants par l’outil d’administration.

La classe PersistentObject

PersistentObject est une classe abstraite que vous pouvez étendre afin de personnaliser vos objets persistants:

public class User extends PersistentObject {
public function User() {
}
}

Vous pouvez créer votre objet persistant coté client ou bien coté serveur. Chaque objet persistant reçoit un GUID affecté à sa propriété publique _id lors de son insertion dans la base de donnée.

3 méthodes sont possibles sur un objet persistant.

public function insert() : void;
public function remove() : void;*
public function update() : void;

3 callbacks correspondant sont prévus, respectivement:

public function insertComplete() : void;
public function removeComplete() : void;
public function updateComplete() : void;

* La méthode remove() génère actuellement une erreur interne. Vous devrez passer par l’outil d’administration (voir plus bas) pour effacer un objet.

Il vous appartient de surcharger (ou pas) ces méthodes et callbacks.

Dans l’exemple fourni vous remarquerez mon choix en faveur d’un gestionnaire événementiel personnalisé (nineveh-responder) bien plus performant que l’api native en particulier concernant la gestion de mémoire d’occupation (par instance), la vitesse de dispatch et l’optimisation de garbage collection pour ne citer que ces aspects majeurs.

Extrait:

public class PersistentServer extends Sprite {
public function PersistentServer() {
_init();
}
/** */
private function _init() : void {
NResponder.add(User.onInsertCompleteEVENT, onAddUser);
NResponder.add(User.onRemoveCompleteEVENT, onDeleteUser);
NResponder.add(User.onUpdateCompleteEVENT, onUpdateUser);

ServerAS3SX.setRequestHandler(UserRequest, handleUserRequest);
}
/** */
public class User extends PersistentObject {
public static const onInsertCompleteEVENT : String = "onInsertComplete";
public static const onRemoveCompleteEVENT : String = "onRemoveComplete";
public static const onUpdateCompleteEVENT : String = "onUpdateComplete";

override public function insertComplete() : void {
// here some stuff (or not) ...
NResponder.dispatch(onInsertCompleteEVENT, [this]);
}


Opérations Update et Delete

Dès qu’un nouvel objet a été stocké en base (méthode insert()) vous devez comprendre que vous travaillez alors avec son GUID (propriété publique _id). Les actions update et delete fonctionnent avec cette référence peu importe l’origine de l’instance (client ou serveur).

private function handleUserRequest(request : UserRequest = null) : void {
// request.user.update();
// request.user.remove();


isRunningOnAS3SX

Si votre objet persistant possède des méthodes vous pouvez poser une condition à l’exécution afin de vérifier selon le contexte (client ou serveur) si celles-ci sont autorisées ou pas.

override public function insert() : void {
if (ServerAS3SX.isRunningOnAS3SX()) {
super.insert();
} else {
var msg : String = this + ".insert() failed, insert only available on server";
PXDebug.DEBUG(msg, this);
throw( new PXUnsupportedOperationException(msg) );
}
}


Sélection de la base de donnée

Sélection du type d’objet persistant

Collection d’objets persistants

Query sur un objet persistant

Update d’objet persistant

Leave Comment

Name (required)

E-mail (required)

URI

Your Comment