queryman
Class GlobalQuery

java.lang.Object
  |
  +--queryman.Query
        |
        +--queryman.GlobalQuery

public class GlobalQuery

extends Query

questa specializzazione della classe Query rappresenta le query poste sullo chema globale

Fields inherited from class queryman.Query

data, globalSc, plan, subQueries

Constructor Summary

GlobalQuery(java.io.File f, GlobalClass glSc)
ricevendo come parametro un riferimento la file contenente la query crea un'istanza provvedendo a definire il piano ed essa associato.

GlobalQuery(java.lang.String str, GlobalClass glSc)
ricevendo come parametro una stringa contenente il testo della query crea un'istanza provvedendo a definire il piano ed essa associato.

Method Summary

void	evaluatePlan(Oql_Query globQue) questa versione per la generazione del piano di esecuzione si limita a controllare che la query passata come parametro rientri nel sottoinsieme delle Basic Query, cioe` nell'insieme delle query che non richiedono alcuna decomposizione e per le quali la definizione del piano e` estremamente semplificata: - l'insieme delle subquery e` costituito dalla query stessa - il piano invoca il metodo per l'esecuzione della query
java.lang.Object	executeQuery(java.lang.Object pl, java.util.TreeMap sb) esegue il piano associato alla query.
java.lang.String	gqErr(java.lang.String ss) compone un messagio di errore aggiungendo la stringa passata come parametro.
java.lang.String	printPlan(java.lang.Object plan, java.util.TreeMap sb) restituisce in una stringa una rappresentazione del piano per la query.
java.lang.String	toString() restituisce in un stringa il testo della query

Methods inherited from class queryman.Query

evaluatePlan, executeQuery, printPlan

Methods inherited from class java.lang.Object

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

Constructor Detail

GlobalQuery

public GlobalQuery(java.lang.String str,
                   GlobalClass glSc)
            throws java.lang.Exception

ricevendo come parametro una stringa contenente il testo della query crea un'istanza provvedendo a definire il piano ed essa associato. Se la query non e` corretta, sintatticamente o semanticamente, o se per qualche motivo non potesse essere gestita allora il costruttore ritornerebbe un null object. Occorre osservare ce il parser OQL-Java non prevede la fase di controllo semantico della query pertanto la query globale, prima di poter essere gestita dai moduli creati per il Query Manager di MOMIS-1998, deve essere validata. Questa fase di validazione e` ottenuta mediante gli ODB-tools e in particolare dal modulo "ODB-Qoptimizer", che oltre ad ottimizzare la query fa i necessari controlli semantici.

Parameters:

str - e` la stringa contenente il testo della query.

glSc - e` la struttura dati rappresentante lo schema globale

Throws:

-Exception - indica la presenza di errori o situazioni non non gestite (la query non e` di tipo base)

GlobalQuery

public GlobalQuery(java.io.File f,
                   GlobalClass glSc)
            throws java.lang.Exception

ricevendo come parametro un riferimento la file contenente la query crea un'istanza provvedendo a definire il piano ed essa associato. Se la query non e` corretta, sintatticamente o semanticamente, o se per qualche motivo non potesse essere gestita allora il costruttore ritornerebbe un null object. Occorre osservare ce il parser OQL-Java non prevede la fase di controllo semantico della query pertanto la query globale, prima di poter essere gestita dai moduli creati per il Query Manager di MOMIS-1998, deve essere validata. Questa fase di validazione e` ottenuta mediante gli ODB-tools e in particolare dal modulo "ODB-Qoptimizer", che oltre ad ottimizzare la query fa i necessari controlli semantici.

Parameters:

str - e` la stringa contenente il testo della query

glSc - e` la struttura dati rappresentante lo schema globale

Throws:

-Exception - indica la presenza di errori o situazioni non non gestite (la query non e` di tipo base)

Method Detail

evaluatePlan

public void evaluatePlan(Oql_Query globQue)
                  throws java.lang.Exception

questa versione per la generazione del piano di esecuzione si limita a controllare che la query passata come parametro rientri nel sottoinsieme delle Basic Query, cioe` nell'insieme delle query che non richiedono alcuna decomposizione e per le quali la definizione del piano e` estremamente semplificata: - l'insieme delle subquery e` costituito dalla query stessa
- il piano invoca il metodo per l'esecuzione della query

Parameters:

globQue - e` la struttura dati che rappresenta la query globale

mapTab - e` la struttura dati che rappresenta lo schema globale

Throws:

-Exception - indica che il piano non e` gestibile.

executeQuery

public java.lang.Object executeQuery(java.lang.Object pl,
                                     java.util.TreeMap sb)

esegue il piano associato alla query.
Vengono eseguiti i comandi indicati nella veriabile plan operando sui dati ritornati dalle sottoquery. Nella versione QM-1998 non si e` implementato il processo che di ricostruzione della risposta percio` questo metodo ritorna sempre un oggetto null.

Parameters:

pl - e` l'insieme di comandi che costituiscono il piano da eseguire.

sb - e` l'insieme di sottoqueri i cui risultati costituiscono gli insiemi di dati su cui operare.

Returns:

viene restituito un oggetto,(la cui struttura deve essere definita), contenente i dati in risposta all query.

toString

public java.lang.String toString()

restituisce in un stringa il testo della query

Overrides:

toString in class Query

printPlan

public java.lang.String printPlan(java.lang.Object plan,
                                  java.util.TreeMap sb)

restituisce in una stringa una rappresentazione del piano per la query.

Parameters:

pl - rappresenta il piano

sb - sono le sottoquery che compaiono nel piano

Returns:

restitui in una stringa la rappresentazione del piano

gqErr

public java.lang.String gqErr(java.lang.String ss)

compone un messagio di errore aggiungendo la stringa passata come parametro.