Holder

Les bases – Création d’attributs, de propriétés et d’holders

En reprenant notre exemple de l’article Les bases – Création de types, de sous-types et d’instances nous allons voir comment ajouter des attributs et des propriétés sur notre type Vehicle.

Introduction

Generic System permet de poser des attributs et des propriétés sur un type :

un attribut peut avoir plusieurs valeurs ;
une propriété ne peut avoir qu’une seule valeur.

Attribut

Dans Generic System, la valeur d’un attribut est représentée par un holder : c’est un nœud qui encapsule la valeur de l’attribut.
Reprenons notre exemple, et ajoutons l’attribut Options au type Vehicle :

// Get the type Vehicle and its instance myVehicle from the Engine
Generic vehicle = engine.getInstance("Vehicle");
Generic myVehicle = vehicle.getInstance("myVehicle");

// Add an attribute on our vehicle
Generic options = vehicle.addAttribute("Options");

// Get the type Vehicle and its instance myVehicle from the Engine

Generic vehicle = engine.getInstance("Vehicle");

Generic myVehicle = vehicle.getInstance("myVehicle");

// Add an attribute on our vehicle

Generic options = vehicle.addAttribute("Options");

Continue reading Les bases – Création d’attributs, de propriétés et d’holders

Attribute, Holder, property, PropertyConstraint

Les bases – Rechercher une information

Comme dans tout moteur de persistance, il est possible de rechercher des informations stockées dans Generic System. On distingue deux types de recherche :

les recherches simples, pour lesquelles un seul résultat est attendu ;
les recherches avancées, qui peuvent conduire à un ensemble de résultats.

Nous allons détailler dans cet article comment réaliser une recherche simple, les recherches avancées seront abordées dans l’article Les bases – Rechercher plusieurs informations.

Introduction

Generic System permet de créer des types, des instances, des relations, etc. Nous avons également vu que la valeur d’un Generic est unique : par exemple, il est impossible de créer deux types avec le même nom. Une recherche simple renverra donc un résultat unique.

Si pour ajouter un Generic on fait appel à la méthode addGeneric, il existe donc une méthode getGeneric pour retourner le Generic correspondant à la recherche. Il existe également une méthode setGeneric, dont le comportement diffère selon si le Generic existe ou non dans le moteur : s’il existe, la méthode renvoie le Generic en question, sinon elle le crée.

Continue reading Les bases – Rechercher une information

Attribute, Holder, instance, Link, Relation, result, search, Type

Les bases – Rechercher plusieurs informations

Dans Generic System, il est possible de rechercher spécifiquement un Generic (recherche simple), ou bien un ensemble de Generic (recherche avancée). Quand un ensemble de résultats doit être retourné, Generic System ne renvoie pas de liste de Generic, mais un Snapshot.

Introduction

Qu’est-ce qu’un Snapshot ?

D’un point de vue fonctionnel, un Snapshot est un ensemble de résultats qui est conscient de son contexte. Le Snapshot est directement en relation avec le modèle de persistence des données, contrairement aux Collections Java qui possèdent un cache en interne contenant les informations.

D’un point de vue technique, un Snapshot est d’une part un fournisseur de Stream et d’autre part un aware Iterable. Comme nous allons le voir par la suite, un Snapshot peut être requêté directement en utilisant des filtres de Stream.

Comparaison Snapshot / Collection

Pour prendre un exemple simple, nous allons créer une instance de Vehicle puis la stocker soit dans une Collection, soit dans un Snapshot. Nous allons ensuite vérifier que notre Collection et notre Snapshot contiennent bien cette instance. Puis nous ajoutons une nouvelle instance de Vehicle, et nous vérifions que notre Collection et notre Snapshot contiennent bien les deux instances.

Continue reading Les bases – Rechercher plusieurs informations

Attribute, Filter, Holder, instance, Link, Relation, result, search, Snapshot, Stream, Type

Avancé – Utiliser les contraintes de Generic System

Toute base de données qui se respecte permet de poser des contraintes.
Generic System le permet également. Abordons dans un premier temps comment les utiliser.

Utilisation des contraintes

Prenons trois contraintes utilisateur et voyons comment les appliquer avec notre exemple maintenant bien connu de Vehicle.

PropertyConstraint

La première contrainte est PropertyConstraint.
Une nouvelle gamme de voiture est récemment apparue sur le marché et ne peut avoir qu’une seule options à la fois. Par chance, c’est justement la contrainte que nous voulons tester !

Engine engine = new Engine();

// Create a type Vehicle
Generic vehicle = engine.addInstance("Vehicle");
// Create the attribute Options for the type Vehicle
Generic options = vehicle.addAttribute("Options");
// Only one value for Options : enable property constraint
options.enablePropertyConstraint();

// Create an instance of Vehicle
Generic myVehicle = vehicle.addInstance("myVehicle");
// Add values for Options
myVehicle.addHolder(options, "music player"); // OK

// Persist changes
engine.getCurrentCache().flush();

try {
	myVehicle.addHolder(options, "air conditioning");
} catch (RollbackException e) {
	assert e.getCause() instanceof PropertyConstraintViolationException;
}

Engine engine = new Engine();

// Create a type Vehicle

Generic vehicle = engine.addInstance("Vehicle");

// Create the attribute Options for the type Vehicle

Generic options = vehicle.addAttribute("Options");

// Only one value for Options : enable property constraint

options.enablePropertyConstraint();

// Create an instance of Vehicle

Generic myVehicle = vehicle.addInstance("myVehicle");

// Add values for Options

myVehicle.addHolder(options, "music player"); // OK

// Persist changes

engine.getCurrentCache().flush();

try {

myVehicle.addHolder(options, "air conditioning");

} catch (RollbackException e) {

assert e.getCause() instanceof PropertyConstraintViolationException;

}

Continue reading Avancé – Utiliser les contraintes de Generic System

Constraint, Holder, instance

Avancé – Supprimer un generic

Depuis le début de l’utilisation de Generic System, nous avons créé des types, des instances, des attributs… et nous avons vu comment les supprimer en utilisant la fonctionnalité remove().
Ah, au fait, il y a un terme générique pour désigner un type, une instance, un attribut, un holder, une relation ou encore un link : il s’agit tout simplement d’un Generic.

Suppression d’un generic

Un generic peut être supprimé en utilisant la méthode remove().

Nous avions utilisé cet exemple pour supprimer un type :

Engine engine = new Engine();

Generic vehicle = engine.addInstance("Vehicle");

// Remove the type Vehicle
vehicle.remove();

// Persist changes
engine.getCurrentCache().flush();

Engine engine = new Engine();

Generic vehicle = engine.addInstance("Vehicle");

// Remove the type Vehicle

vehicle.remove();

// Persist changes

engine.getCurrentCache().flush();

Suppressions et dépendances

Comme dans toute base de données, il faut faire attention lors des modifications et particulièrement lors des suppressions.
Vous ne pouvez pas supprimer un Generic si d’autres en dépendent : c’est la fameuse contrainte d’intégrité référentielle des bases de données relationnelles, qui existe également sur Generic System.
Le meilleur exemple pour comprendre est la suppression d’un type qui est relié à un autre. Continue reading Avancé – Supprimer un generic

Attribute, cascade remove, Constraint, Generic, Holder, instance, Link, referential integrity, Relation, Remove, Type

Tag: Holder

Introduction

Attribut

Introduction

Introduction

Qu’est-ce qu’un Snapshot ?

Comparaison Snapshot / Collection

Utilisation des contraintes

PropertyConstraint

Suppression d’un generic

Suppressions et dépendances