Ilog.rules.brl.syntaxtree

Classe IlrSyntaxTreeHelper

java.lang.Object

Ilog.rules.brl.syntaxtree.IlrSyntaxTreeHelper

Public class IlrSyntaxTreeHelper
étend java.lang.Object

Cette classe est une classe auxiliaire qui fournit une API permettant de manipuler un arbre de syntaxe. Notez que la classe IlrBRL fournit également une API d'aide pour extraire des informations sur les noeuds de l'arborescence de syntaxe.

Récapitulatif du constructeur

Constructeurs

Constructeur et description
IlrSyntaxTreeHelper()

Récapitulatif de la méthode

Modificateur et type	Méthode et description
static IlrSentence	findEnclosingSentence(IlrSyntaxTree.Node node) Cette méthode recherche, à partir du noeud indiqué, la première phrase qui ignore les opérateurs.
static IlrSyntaxTree.Node	findRoleNode(IlrSyntaxTree.Node sentenceNode, int synRoleIndex) Cette méthode renvoie le noeud syntaxique correspondant à roleIndex dans le noeud de phrase.
static IlrSyntaxTree.Node	findSubNode(IlrSyntaxTree.Node node, java.lang.String path)
static IlrVocabularyElement	findVocabularyElement(IlrSyntaxTree.Node node, IlrVocabulary vocabulary) Cette méthode d'aide permet de rechercher un élément de dictionnaire à partir du noeud de syntaxe donné.
static IlrSyntaxTree.Node	getAndNode(IlrSyntaxTree.Node node, int direction) Cette méthode renvoie le noeud 1st et le noeud trouvé dans l'arborescence de syntaxe donnée à partir du noeud donné suivant la direction donnée (spécifiée à l'aide d'IlrSyntaxTree.UP ou d'IlrSyntaxTree.DOWN
static IlrConcept	getConcept(IlrSyntaxTree.Node conceptNode, IlrVocabulary voc) Extrait un concept d'un noeud cible.
static IlrConceptInstance	getConceptInstance(IlrSyntaxTree.Node valueNode, IlrVocabulary voc) Extrait une instance de concept d'un noeud d'arborescence de syntaxe abstraite T-voc-value .
static java.lang.Object	getConstrainedRoleValue(IlrSyntaxTree.Node node) Cette méthode renvoie la valeur associée à l'arborescence de syntaxe correspondant à un rôle qui est contraint par une relation de contrainte existant sur le rôle donné comme argument.
static java.lang.String	getNodePath(IlrSyntaxTree.Node node)
static IlrSyntaxTree.Node	getOrNode(IlrSyntaxTree.Node node, int direction) Cette méthode renvoie le noeud 1st ou le noeud trouvé dans l'arborescence de syntaxe donnée à partir du noeud donné suivant la direction donnée (spécifiée à l'aide d'IlrSyntaxTree.UP ou d'IlrSyntaxTree.DOWN
static int	getRoleIndex(IlrSyntaxTree.Node roleNode) Cette méthode, appliquée sur un noeud de syntaxe représentant un rôle dans une phrase, renvoie l'index du rôle dans la phrase.
static IlrSyntaxTree.Node	getRoleNode(IlrSyntaxTree.Node roleNode) Cette méthode extrait une recherche dans l'arborescence de syntaxe d'un noeud de rôle.
static IlrSentence	getSentence(IlrSyntaxTree.Node sentenceNode, IlrVocabulary voc) Extrait une phrase d'un noeud sentence .
static java.util.List	getTemplateInfo(IlrSyntaxTree tree) Cette méthode extrait les informations de modèle stockées dans l'arborescence de syntaxe.
static IlrTypeInfo	getTypeInfo(IlrSyntaxTree.Node conceptNode, IlrVocabulary voc) Extrait les informations de type de ce noeud.
static java.util.Collection<IlrVocabularyElement>	getVocabularyElements(IlrSyntaxTree syntaxTree, java.util.Collection<IlrBRLMarker> errors) Ajoute tous les éléments de dictionnaire référencés par une arborescence de syntaxe à une collection.
static boolean	hasErrorRecovery(IlrSyntaxTree.Node node) Cette méthode renvoie la valeur true si le noeud indiqué est en cours de reprise après erreur
static boolean	hasErrorRecovery(IlrSyntaxTree ast)
static boolean	hasPlaceHolders(IlrSyntaxTree.Node node) Cette méthode renvoie true si le noeud ou l'un de ses enfants a une marque de réservation.
static boolean	isEmpty(IlrSyntaxTree tree) Teste si l'arborescence de syntaxe est vide.
static boolean	isExternalVariable(IlrSyntaxTree.Node variableNode) Teste si le noeud de variable est une variable ou un paramètre d'ensemble de règles.
static boolean	isRulesetParameter(IlrSyntaxTree.Node variableNode) Teste si le noeud de variable est un paramètre d'ensemble de règles.
static boolean	isRulesetVariable(IlrSyntaxTree.Node variableNode) Teste si le noeud de variable est une variable d'ensemble de règles.
static boolean	isRuleVariable(IlrSyntaxTree.Node node) Teste si un noeud est la variable automatique "la règle" utilisée dans le flux de règles de sélection.
static java.util.List	setTemplateInfo(java.util.List templateInfo, IlrSyntaxTree tree) Cette méthode applique les informations de modèle dans l'arborescence de syntaxe.

Méthodes héritées de la classe java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Détail du constructeur

IlrSyntaxTreeHelper

Public IlrSyntaxTreeHelper ()

Détail de la méthode

Elément findVocabularyElement

public static IlrVocabularyElement findVocabularyElement (noeudIlrSyntaxTree.Node ,
                                                         Vocabulaire IlrVocabulaire )

Cette méthode d'aide permet de rechercher un élément de dictionnaire à partir du noeud de syntaxe donné. Certains noeuds d'une arborescence de syntaxe peuvent faire référence à un élément de dictionnaire, tel qu'un concept, une phrase ou une instance de concept.

Paramètres:

node -Noeud de l'arborescence de syntaxe à partir duquel la recherche commence.

vocabulary -Vocabulaire qui doit contenir l'élément de vocabulaire trouvé, le cas échéant.

Sortie :

Un élément de vocabulaire référencé par le noeud donné, le cas échéant, ou null si aucun élément n'est trouvé.

GetSentence

public static IlrSentence getSentence (IlrSyntaxTree.Node sentenceNode,
                                      IlrVocabulaire voc)

Extrait une phrase d'un noeud sentence .

Paramètres:

sentenceNode -Noeud de type T-voc-sentence.

voc -Le vocabulaire.

Sortie :

La phrase trouvée dans le vocabulaire, ou null.

Voir aussi :

IlrTranslationHelper.isSentenceNode(IlrSyntaxTree.Node)

GetConcept

public static IlrConcept getConcept (IlrSyntaxTree.Node conceptNode,
                                    IlrVocabulaire voc)

Extrait un concept d'un noeud cible.

Paramètres:

conceptNode -Noeud Abstract Syntax Tree.

voc -Le vocabulaire.

Sortie :

Concept trouvé dans le vocabulaire ou null.

GetTypeInfo

public static IlrTypeInfo getTypeInfo (IlrSyntaxTree.Node conceptNode,
                                      IlrVocabulaire voc)

Extrait les informations de type de ce noeud.

Paramètres:

conceptNode -Noeud de type T-voc-concept.

voc -Le vocabulaire.

Sortie :

IlrTypeInfo correspondant à ce noeud de concept.

GetConceptInstance

public static IlrConceptInstance getConceptInstance (IlrSyntaxTree.Node valueNode,
                                                    IlrVocabulaire voc)

Extrait une instance de concept d'un noeud d'arborescence de syntaxe abstraite T-voc-value .

Paramètres:

valueNode -Noeud de type T-voc-value.

voc -Le vocabulaire.

Sortie :

Instance de concept trouvée dans le vocabulaire, ou null.

FindRoleNode

public static IlrSyntaxTree.Node findRoleNode (IlrSyntaxTree.Node sentenceNode,
                                              Int synRoleIndex)

Cette méthode renvoie le noeud syntaxique correspondant à roleIndex dans le noeud de phrase.

Paramètres:

sentenceNode -Noeud de phrase, contenant les noeuds de rôle.

synRoleIndex -Index du noeud de rôle recherché (rôle syntaxique).

Sortie :

Noeud syntaxique correspondant au noeud de rôle, ou null si aucun noeud n'est trouvé.

Noeud getRoleNode

public static IlrSyntaxTree.Node getRoleNode (IlrSyntaxTree.Node roleNode)

Cette méthode extrait une recherche dans l'arborescence de syntaxe d'un noeud de rôle.

Paramètres:

roleNode -Noeud à partir duquel la recherche commence.

Sortie :

Le noeud correspondant à un rôle de phrase, ou null si aucun n'est trouvé.

GetRoleIndex

public static int getRoleIndex (IlrSyntaxTree.Node roleNode)

Cette méthode, appliquée sur un noeud de syntaxe représentant un rôle dans une phrase, renvoie l'index du rôle dans la phrase. C'est l'indice du rôle syntaxique.

Paramètres:

roleNode -

Sortie :

Index du rôle syntaxique dans la phrase de -1 si le noeud ne correspond pas à un noeud de rôle, ou si les informations ne sont pas trouvées sur le noeud.

GetConstrainedRoleValue

public static java.lang.Object getConstrainedRoleValue (IlrSyntaxTree.Node )

Cette méthode renvoie la valeur associée à l'arborescence de syntaxe correspondant à un rôle qui est contraint par une relation de contrainte existant sur le rôle donné comme argument.

Paramètres:

node -Noeud d'arborescence de syntaxe correspondant à un rôle d'une phrase. Ce rôle est supposé être contraint en ayant déclaré une contrainte à l'aide de la propriété constraint=xx, où xx est l'index de paramètre du rôle cible.

Sortie :

Valeur stockée dans l'arborescence de syntaxe du noeud correspondant au rôle référencé par la contrainte. Renvoyer la valeur null si:

• Le noeud ne correspond pas au rôle d'une phrase
• Aucune contrainte n'existe sur le rôle
• Le rôle référencé n'existe pas ou n'est pas une valeur
• La valeur stockée est null

Reprise après incident

public static boolean hasErrorRecovery (IlrSyntaxTree ast)

Sortie :

true si l'arborescence de syntaxe correspond à au moins un noeud de syntaxe en cas de reprise sur incident, sinon, renvoie false.

Reprise après incident

public static boolean hasErrorRecovery (noeudIlrSyntaxTree.Node )

Cette méthode renvoie la valeur true si le noeud indiqué est en cours de reprise après erreur

Paramètres:

node -noeud de syntaxe, ne doit pas être null

Sortie :

True si le noeud est en cours de récupération d'erreurs et false dans le cas contraire

isEmpty

public static boolean isEmpty (arborescenceIlrSyntaxTree )

Teste si l'arborescence de syntaxe est vide. Une arborescence de syntaxe vide est le résultat de l'analyse d'une chaîne de texte vide.

Since:

JRules 7.0

Sortie :

Si l'arbre de syntaxe est vide, c'est-à-dire s'il contient un noeud racine unique sans contenu ou sous-noeuds, true est renvoyé.

GetTemplateInfo

public static java.util.List getTemplateInfo (arborescenceIlrSyntaxTree )

Cette méthode extrait les informations de modèle stockées dans l'arborescence de syntaxe.

Paramètres:

tree -L'arborescence de syntaxe à partir de laquelle extraire les informations de modèle.

Sortie :

Liste de IlrBRLTemplateInfoou de null si aucune information de modèle n'est stockée dans l'arborescence de syntaxe.

SetTemplateInfo

Public static java.util.List setTemplateInfo (java.util.List templateInfo,
                                             IlrSyntaxTree )

Cette méthode applique les informations de modèle dans l'arborescence de syntaxe. Il tente d'appliquer autant d'informations de modèle qu'il le peut et de renvoyer une liste d'informations de modèle qui n'a pas été appliquée.

Paramètres:

templateInfo -Liste de BRLTemplateInfo décrivant les informations du modèle.

tree -Arborescence de syntaxe sur laquelle les informations de modèle doivent être appliquées.

Sortie :

Liste des informations de modèle qui n'ont pas été appliquées, ou null si toutes les informations ont été appliquées.

HasPlaceTitulaires

public static boolean hasPlaceholder (noeudIlrSyntaxTree.Node )

Cette méthode renvoie true si le noeud ou l'un de ses enfants a une marque de réservation. Les informations sur les marques de réservation sont stockées sur chaque noeud de syntaxe incomplet. Par exemple, un noeud de valeur qui n'a pas encore été rempli.

Paramètres:

node -noeud de syntaxe racine

Sortie :

true si au moins un noeud de l'arborescence, à partir du noeud transmis à la méthode, comporte une marque de réservation.

Voir aussi :

IlrSyntaxTree.hasPlaceHolders()

Noeud getAndNode

public static IlrSyntaxTree.Node getAndNode (noeudIlrSyntaxTree.Node ,
                                            Direction int)

Cette méthode renvoie le noeud 1st et le noeud trouvé dans l'arborescence de syntaxe donnée à partir du noeud donné suivant la direction donnée (spécifiée à l'aide d'IlrSyntaxTree.UP ou d'IlrSyntaxTree.DOWN

Paramètres:

node -

direction -

Sortie :

Le noeud 1st et le noeud trouvé dans l'arborescence

GetOrNode

public static IlrSyntaxTree.Node getOrNode (noeudIlrSyntaxTree.Node ,
                                           Direction int)

Cette méthode renvoie le noeud 1st ou le noeud trouvé dans l'arborescence de syntaxe donnée à partir du noeud donné suivant la direction donnée (spécifiée à l'aide d'IlrSyntaxTree.UP ou d'IlrSyntaxTree.DOWN

Paramètres:

node -

direction -

Sortie :

Le noeud 1st et le noeud trouvé dans l'arborescence

FindEnclosingSentence

public static IlrSentence findEnclosingSentence (noeudIlrSyntaxTree.Node )

Cette méthode recherche, à partir du noeud indiqué, la première phrase qui ignore les opérateurs.

Paramètres:

node -

Sortie :

La première phrase d'enfermer ou la valeur null si aucune n'est trouvée à la racine

Paramètre isRulesetParameter

public static boolean isRulesetParameter (IlrSyntaxTree.Node variableNode)

Teste si le noeud de variable est un paramètre d'ensemble de règles.

Paramètres:

variableNode -Noeud de type T-voc-variable.

Sortie :

true si le noeud de variable est un paramètre.

IsRulesetVariable

Valeur booléenne statique publique isRulesetVariable (IlrSyntaxTree.Node variableNode)

Teste si le noeud de variable est une variable d'ensemble de règles.

Paramètres:

variableNode -Noeud de type T-voc-variable.

Sortie :

true si le noeud de variable est une variable d'ensemble de règles.

Variable isExternalVariable

Valeur booléenne statique publique isExternalVariable (IlrSyntaxTree.Node variableNode)

Teste si le noeud de variable est une variable ou un paramètre d'ensemble de règles.

Paramètres:

variableNode -Noeud de type T-voc-variable.

Sortie :

true si le noeud de variable est une variable d'ensemble de règles ou un paramètre.

IsRuleVariable

public static boolean isRuleVariable (noeudIlrSyntaxTree.Node )

Teste si un noeud est la variable automatique "la règle" utilisée dans le flux de règles de sélection.

Paramètres:

node -Noeud à vérifier.

Sortie :

Si node est la variable automatique, true est renvoyé.

GetVocabularyEléments

public static java.util.Collection <Elément IlrVocabularyElement> getVocabularyElements (IlrSyntaxTree syntaxTree,
                                                                               java.util.Collection < erreursIlrBRLMarker>)

Ajoute tous les éléments de dictionnaire référencés par une arborescence de syntaxe à une collection. Le paramètre syntaxTree ne doit pas faire l'objet d'une reprise sur incident. Si c'est le cas, les informations renvoyées par cette méthode ne sont pas correctes. Les noeuds comportant des erreurs dans syntaxTree ne sont pas pris en compte.

Paramètres:

syntaxTree -Arbre de syntaxe nonnull à explorer.

errors -Collection d'erreurs générées par l'analyseur syntaxique qui a créé cette arborescence de syntaxe. Cette collection peut être null.

Sortie :

Collection d'objets IlrVocabularyElement référencés dans cette arborescence de syntaxe.

Chemin d'accès getNodePath

public static java.lang.String getNodePath (noeudIlrSyntaxTree.Node )

FindSubNode

public static IlrSyntaxTree.Node findSubNode (noeudIlrSyntaxTree.Node ,
                                             Java.lang.String chemin)