Toolkit Dojo - fonctionnalités ajoutées par IBM

Bibliothèque, magasin de données et widgets Atom

Référence AppStore Atom :

AppStore implémente trois API des données dojo : Read, Write et Identity. Lisez attentivement la documentation de référence suivante à propos de chacune de ces API :


dojo.data.api.Read

Il s'agit d'une API abstraite à laquelle les implémentations de fournisseur de données doivent se conformer. Pour plus d'informations sur les API de données dojo, visitez le site http://www.dojotoolkit.org/node/98.

Résumé des fonctions
Objet getValue(Object item, String attribute, String defaultValue)
Permet d'extraire la valeur de l'attribut spécifié au niveau de l'élément
Array getValues(Object item, String attribute)
Permet d'extraire la valeur de l'attribut spécifié au niveau de l'élément
Array getAttributes(Object item)
Renvoie un tableau comportant tous les attributs de cet élément
Booléen hasAttribute(Object item, String attribute)
Renvoie true si *item* indiqué possède une valeur pour *attribute* indiqué
Booléen containsValue(Object item, String attribute, Object value)
Renvoie true si *value* indiquée est l'une des valeurs renvoyées par la méthode getValues
Booléen isItem(Object something)
Renvoie si *something* est un élément et s'il provient de cette instance de magasin
Booléen isItemLoaded(Object something)
Renvoie si *something* est chargé dans la mémoire locale
void loadItem(Object keywordArgs)
Cette méthode permet de charger un élément donné pour qu'un appel à store.isItemLoaded(item) renvoie true
Objet fetch(Object keywordArgs)
Si vous spécifiez une requête et définissez un ensemble d'options (par exemple, une option de démarrage (start) ou le nombre (count) d'éléments à renvoyer), cette méthode exécute la requête et les résultats sont disponibles sous forme d'éléments de données
Objet getFeatures()
Renvoie un objet contenant un mot clé simple et indiquant les fonctionnalités d'interface implémentées par le magasin de données
void close(Object request)
Indique au magasin qu'il doit supprimer les informations associées à une demande particulière
String (chaîne) getLabel(Object item)
Méthode permettant d'inspecter l'élément et de renvoyer un intitulé lisible par l'utilisateur qui décrit l'élément de façon générale ou correcte
Array getLabelAttributes(Object item)
Méthode permettant d'inspecter l'élément et de renvoyer un tableau récapitulatif des attributs éventuels, utilisés pour générer l'intitulé de l'élément

Détails des fonctions
getValue

getValues

getAttributes

hasAttribute

containsValue

isItem

isItemLoaded

loadItem

fetch

getFeatures

close

getLabel

getLabelAttributes

dojo.data.api.Write

Il s'agit d'une API abstraite à laquelle les implémentations de fournisseur de données doivent se conformer. Cette API spécifie les fonctions requises pour écrire dans un magasin de données.

Résumé des fonctions
Objet getFeatures()
Voir dojo.data.api.Read.getFeatures
Objet newItem(Object keywordArgs)
Renvoie un élément nouvellement créé
Booléen deleteItem(Object item)
Permet de supprimer un élément à partir du magasin
Booléen setValue(Object item, String attribute, Object value)
Permet de définir la valeur d'un attribut sur un élément, remplaçant la ou les valeurs précédentes
Booléen setValues(Object item, String attribute, Array values)
Permet d'ajouter chaque valeur dans le tableau *values* en tant que valeur de l'attribut de l'élément indiqué, remplaçant la ou les valeurs précédentes
Booléen unsetAttribute(Object item, String attribute)
Permet de supprimer toutes les valeurs de l'attribut d'un élément
Booléen save(keywordArgs)
Permet de sauvegarder toutes les modifications apportées localement au serveur
Booléen revert()
Permet d'annuler les modifications non sauvegardées
Booléen isDirty(item)
La fonction isDirty() renvoie true, pour un élément donné, si l'élément a été modifié depuis la dernière réalisation d'une méthode de sauvegarde

Détails des fonctions
getFeatures

newItem

deleteItem

setValue

setValues

unsetAttribute

save

revert

isDirty

dojo.data.api.Identity

Il s'agit d'une API abstraite à laquelle les implémentations de fournisseur de données doivent se conformer. Les fonctions définies extraient l'identité d'un individu pour un élément ainsi que les attributs ayant fourni l'identité.

Résumé des fonctions
Objet getFeatures()
Voir dojo.data.api.Read.getFeatures
Objet getIdentity(Object item)
Renvoie un identificateur unique pour un élément
Array getIdentityAttributes(Object item)
Renvoie un tableau de noms d'attribut utilisés pour générer l'identité
Objet fetchItemByIdentity(Object keywordArgs)
L'identité d'un élément étant fournie, cette méthode renvoie l'élément disposant de cette identité via le rappel onItem

Détails des fonctions
getFeatures

getIdentity

getIdentityAttributes

fetchItemByIdentity