Ilog.rules.studio.model.query

Service IlrQueryService

Toutes les superinterfaces:

org.eclipse.emf.ecore.EObject, ilog.rules.brl.bql.parser.IlrBOMConstants, ilog.rules.brl.bql.IlrQueryEnvironment, ilog.rules.brl.bql.IlrQueryParsingService, IlrRuleProjectService, org.eclipse.emf.common.notify.Notificateur

Interface publique Service IlrQueryService
étend IlrRuleProjectService, ilog.rules.brl.bql.IlrQueryEnvironment, ilog.rules.brl.bql.IlrQueryParsingService

Ce service est utilisé pour exécuter des requêtes écrites dans la langue BQL sur un projet de règles.

Exemple d'utilisation:

 IlrQueryService queryService = (IlrQueryServiceImpl) IlrStudioQueryPlugin.getQueryService (ruleProject) ;
 IlrQuery myQuery = ... ;
 queryService.initQuery(myQuery, null);
 List results = queryService.runQuery();
 

Si une requête comporte des actions (par exemple, " Rechercher toutes les règles de ce type ... Faites une copie de chaque règle dans le package pack1"), ces actions doivent être exécutées séparément une fois que la requête a été exécutée et que les éléments correspondants ont été renvoyés:

 If (queryService.queryHasActions ()) {
   QueryService.runQueryActions (résultats) ;
 }
 

Récapitulatif des zones

Zones

Modificateur et type	Zone et description
static java.lang.String	SERVICE_ID

Récapitulatif de la méthode

Modificateur et type	Méthode et description
java.util.Locale	getQueryLocale(ilog.rules.brl.bql.model.IlrQueryElement query) Retourne l'environnement local de la requête donnée, ou une locale de secours si elle est nulle.
void	initializeQuery(IlrQuery query, IlrRuleQueryMatchCollector mc) Initialise une requête avant qu'elle puisse être exécutée.
void	initQuery(IlrQuery query, IlrRuleQueryMatchCollector mc) Obsolète. Utiliser initializeQuery(IlrQuery, IlrRuleQueryMatchCollector) à la place
void	initQuery(IlrRuleProject queryProject, boolean queryIncludeDependencies, java.util.Locale queryLocale, java.lang.String queryText, IlrRuleQueryMatchCollector mc) Initialise une requête avant qu'elle puisse être exécutée.
boolean	queryHasActions() Renvoie des informations sur la question de savoir si la requête ayant initialisé le service a des actions ou non.
java.util.List	runQuery() Exécute la requête avec laquelle le service a été initialisé et renvoie le résultat dans une liste.
void	runQueryActions(java.util.List queryResult) Exécute les actions de requête (le cas échéant) sur une liste de résultats.

Méthodes héritées de l'interface ilog.rules.studio.model.base.IlrRuleProjectService

dispose, getRuleProject, getServiceID, initialize, setRuleProject, setServiceID

Méthodes héritées de l'interface org.eclipse.emf.ecore.EObject

eAllContents, eClass, eContainer, eContainingFeature, eContainmentFeature, eContents, eCrossReferences, eGet, eGet, eInvoke, eIsProxy, eIsSet, eResource, eSet, eUnset

Méthodes héritées de l'interface org.eclipse.emf.common.notify.Notificateur

eAdapters, eDeliver, eNotify, eSetDeliver

Détail de la zone

ID_SERVICE

Static final java.lang.String SERVICE_ID

Voir aussi :

Valeurs de zones constantes

Détail de la méthode

InitQuery

void initQuery (IlrRuleProject queryProject,
               Boolean queryIncludeDependencies,
               Java.util.Locale queryLocale,
               Java.lang.String queryText,
               IlrRuleQueryMatchCollector mc)
        émet IlrSyntaxError,
               Java.io.IOException

Initialise une requête avant qu'elle puisse être exécutée.

Throws :

java.io.IOException

IlrSyntaxError

Paramètres:

queryProject -Projet de règles sur lequel cette requête est censée s'exécuter

queryIncludeDependencies -true si les dépendances de projet doivent être suivies

queryLocale -environnement local de la requête

queryText -texte de la requête (par exemple, "Rechercher toutes les règles telles que ...")

mc -collecteur dans lequel les résultats de la requête seront stockés. La transmission de la valeur null signifie que IlrQueryServiceImpl sera utilisé comme collecteur.

InitQuery

@Deprecated
void initQuery (IlrQuery query,
                           IlrRuleQueryMatchCollector mc)
                    Génère java.io.IOException,
                           IlrSyntaxError,
                           Org.eclipse.core.runtime.CoreException

Obsolète. Utiliser initializeQuery(IlrQuery, IlrRuleQueryMatchCollector) à la place

Initialise une requête avant qu'elle puisse être exécutée.

Throws :

java.io.IOException

IlrSyntaxError

org.eclipse.core.runtime.CoreException

Paramètres:

query -La condition IlrQuery qui sera utilisée (@see IlrQuery#getCondition).

mc -Collecteur dans lequel les résultats de la requête seront stockés.

Requête initializée

void initializeQuery (IlrQuery query,
                     IlrRuleQueryMatchCollector mc)
              émet IlrQueryException

Initialise une requête avant qu'elle puisse être exécutée.

Throws :

IlrQueryException

Paramètres:

query -La condition IlrQuery qui sera utilisée (@see IlrQuery#getCondition).

mc -Collecteur dans lequel les résultats de la requête seront stockés.

RunQuery

Java.util.List runQuery ()

Exécute la requête avec laquelle le service a été initialisé et renvoie le résultat dans une liste.

La liste est générée par l'objet #IlrRuleQueryMatchCollector qui a été utilisé pour initialiser le service. Si la requête portait sur des objets #IlrProjectElement , la liste contiendra des objets #IlrQueryProjectElementWrapper .

Voir aussi :

IlrQueryProjectElementWrapper

QueryHasActions

Boolean queryHasActions ()

Renvoie des informations sur la question de savoir si la requête ayant initialisé le service a des actions ou non.

Par exemple, si la requête est de la forme "Find all elements such that < condition> Do < actions>" ou simplement "Find all elements such that < condition>".

RunQueryActions

Void runQueryActions (java.util.List queryResult)
              Génère une exception java.io.FileNotFoundException

Exécute les actions de requête (le cas échéant) sur une liste de résultats.

La liste est généralement celle renvoyée par #runQuery().

Throws :

java.io.FileNotFoundException -si une action de requête telle que'copy to package'ou'move to package'échoue car un package qui n'existe pas a été spécifié.

GetQueryLocale

Java.util.Locale getQueryLocale (requête ilog.rules.brl.bql.model.IlrQueryElement)

Retourne l'environnement local de la requête donnée, ou une locale de secours si elle est nulle. (Les paramètres régionaux de requête null ne peuvent se produire que lors de la lecture des anciennes requêtes, celles en cours sont toujours sauvegardées avec un environnement local)