phpDocumentor db
[ class tree: db ] [ index: db ] [ all elements ]

Class: DB_SQL

Source Location: /c_db.inc

Class DB_SQL

Class Overview

Interfaccia per la trasformazione da dati-pagina a query e clausole per le condizioni where

Located in /c_db.inc [line 389]



		
				Author(s):
		
API Tags:
Abstract:  

Properties

Methods

[ Top ]
Descendants
Child Class Description
DB_SQL_MYSQL Generazione SQL per MYSQL
DB_SQL_FBIRD Generazione SQL per FIREBIRD / INTERBASE
DB_SQL_ODBC Generazione SQL per ODBC
DB_SQL_MSSQL Generazione SQL per SQL SERVER

[ Top ]
Property Summary
static string   $sql   Nome della classe sql - serve per le chiamate parametriche a metodi della stessa classe quando viene estesa

[ Top ]
Method Summary
static string   begins_like()   Genera un confronto di inizio simile (LIKE)
static string   between()   Genera una condizione BETWEEN
static string   cond()   Genera una condizione facente parte di una clausola WHERE, con un operatore binario qualunque. Se il valore da confrontare a' NULL, gli operatori = e != sono tradotti in IS e IS NOT, altrimenti viene sollevata un'eccezione
static string   cond_tp()   Versione contratta della op_tp, in cui la condizione viene passata gia' calcolata, senza usare la terna $operatore($campo_filtro, $valore)
static string   c_and()   Genera una condizione AND unendo tutte le sotto-clausole passate come argomento (usa func_get_args)
static string   c_not()   Nega la condizione passata
static string   c_or()   Genera una condizione OR unendo tutte le sotto-clausole passate come argomento (usa func_get_args)
static mixed   db_2_ascii()   Questa serve nel caso in cui i dati debbano arrivare a video ma non in HTML vengono restituite totalmente in chiaro. Vedere GESTORE::valore_ascii
static mixed   db_2_fwk()   Questa serve nel caso in cui i dati non debbano arrivare a video, ma debbano subire manipolazioni intermedie; vengono restituite totalmente in chiaro. Vedere GESTORE::valore_fwk
static mixed   db_2_utente()   Prende un valore in formato database e lo trasforma nel formato utente (quello visualizzato a video). I formati conosciuti sono: d (data), h (ora), r (timestamp), b (booleano), i (intero), f (float), s (stringa uppercase), t (stringa), e (codifica reversibile), c (codifica hash irreversibile)
static string   diff()   Genera un confronto di differenza (!=)
static string   ends_like()   Genera un confronto di fine simile (LIKE)
static string   equ()   Genera un confronto di uguaglianza (=)
static string   genera_count()   Genera una query COUNT su una tabella
static string   genera_delete()   Genera una clausola DELETE su una tabella data un'eventuale condizione
static string   genera_exists()   Genera una query EXISTS su una tabella
static string   genera_insert()   Genera una clausola INSERT su una tabella dati i valori in un array associativo e le eventuali colonne di filtro
static string   genera_select()   Ritorna la query di selezione in base ai parametri specificati
static string   genera_update()   Genera una clausola UPDATE su una tabella dati i valori in un array associativo e le eventuali colonne di filtro
static string   gt()   Genera un confronto di maggioranza (>)
static string   gte()   Genera un confronto di maggioranza o uguaglianza (>=)
static string   iequ()   Genera un confronto di uguaglianza (=) case-insensitive
static string   in()   Genera una condizione IN. Se l'array di valori passato a' vuoto, genera una clausola "dummy" sempre falsa
static string   in_tp()   Genera una clausola IN basata su una subquery. La subquery viene generata come SELECT $campo_ricerca FROM $tabella_ricerca WHERE cond($campo_filtro, $valore), $campo_ricerca deve essere presente anche nella tabella corrente. Es. i_acc_utente_id IN (SELECT i_acc_utente_id FROM t_p_acc_utente_gruppo WHERE i_acc_gruppo_id = 4)
static string   like()   Genera un confronto di similitudine (LIKE)
static string   lt()   Genera un confronto di minoranza (<)
static string   lte()   Genera un confronto di minoranza o uguaglianza (<=)
static string   not_in()   Genera una condizione NOT IN. Se l'array di valori passato a' vuoto, genera una clausola "dummy" sempre vera
static string   op_tp()   Genera una clausola IN basata su una subquery. E' una generalizzazione di in_tp, in cui la ricerca nella subquery e' generalizzata e i campi nella tabella corrente e in $tabella_ricerca non devono essere necessariamente omonimi.
static void   set_sql()   Imposta il nome della classe sql
static mixed   utente_2_db()   Prende un valore in formato utente (quello visualizzato a video) lo trasforma nel formato database
static string   word_like()   Genera un confronto di similitudine (LIKE) su ognuna delle parole (supposte separate da spazi) presenti nel valore specificato

[ Top ]
Properties
static string   $sql = 'DB_SQL' [line 395]

Nome della classe sql - serve per le chiamate parametriche a metodi della stessa classe quando viene estesa

API Tags:
Access:  protected


[ Top ]
Methods
static method begins_like  [line 633]

  static string begins_like( string $colonna, mixed $valore  )

Genera un confronto di inizio simile (LIKE)

Parameters:
string   $colonna:  Nome del campo
mixed   $valore:  Valore in formato utente

API Tags:
Access:  public


Redefined in descendants as:

[ Top ]
static method between  [line 739]

  static string between( string $colonna, mixed $valore_inizio, mixed $valore_fine  )

Genera una condizione BETWEEN

Parameters:
string   $colonna:  Nome del campo
mixed   $valore_inizio:  Valore minimo
mixed   $valore_fine:  Valore massimo

API Tags:
Access:  public


[ Top ]
static method cond  [line 511]

  static string cond( string $colonna, mixed $valore, string $operatore  )

Genera una condizione facente parte di una clausola WHERE, con un operatore binario qualunque. Se il valore da confrontare a' NULL, gli operatori = e != sono tradotti in IS e IS NOT, altrimenti viene sollevata un'eccezione

Parameters:
string   $colonna:  Nome del campo
mixed   $valore:  Valore in formato utente
string   $operatore:  Operatore binario di confronto

API Tags:
Access:  protected


[ Top ]
static method cond_tp  [line 794]

  static string cond_tp( string $tabella_ricerca, string $campo_ricerca, string $campo, string $cond  )

Versione contratta della op_tp, in cui la condizione viene passata gia' calcolata, senza usare la terna $operatore($campo_filtro, $valore)

Parameters:
string   $tabella_ricerca:  Tabella in cui la ricerca viene effettuata
string   $campo_ricerca:  Nome del campo su cui viene effettuata la ricerca (il campo della tabella corrente viene confrontato con i valori della query su $tabella_ricerca.$campo_ricerca)
string   $campo:  Campo della tabella corrente, operando di sinistra della clausola IN
string   $cond:  Condizione di filtro su $tabella_ricerca

API Tags:
Access:  public


[ Top ]
static method c_and  [line 478]

  static string c_and( )

Genera una condizione AND unendo tutte le sotto-clausole passate come argomento (usa func_get_args)


API Tags:
Access:  public


[ Top ]
static method c_not  [line 499]

  static string c_not( string $cond  )

Nega la condizione passata

Parameters:
string   $cond: 

API Tags:
Access:  public


[ Top ]
static method c_or  [line 488]

  static string c_or( )

Genera una condizione OR unendo tutte le sotto-clausole passate come argomento (usa func_get_args)


API Tags:
Access:  public


[ Top ]
static method db_2_ascii  [line 453]

  static mixed db_2_ascii( string $colonna, mixed $valore  )

Questa serve nel caso in cui i dati debbano arrivare a video ma non in HTML vengono restituite totalmente in chiaro. Vedere GESTORE::valore_ascii

Parameters:
string   $colonna:  Nome del campo, mi serve per conoscerne il tipo
mixed   $valore:  Valore in formato db

API Tags:
Access:  public


[ Top ]
static method db_2_fwk  [line 427]

  static mixed db_2_fwk( string $colonna, mixed $valore  )

Questa serve nel caso in cui i dati non debbano arrivare a video, ma debbano subire manipolazioni intermedie; vengono restituite totalmente in chiaro. Vedere GESTORE::valore_fwk

Parameters:
string   $colonna:  Nome del campo, mi serve per conoscerne il tipo
mixed   $valore:  Valore in formato db

API Tags:
Access:  public


[ Top ]
static method db_2_utente  [line 412]

  static mixed db_2_utente( string $colonna, mixed $valore  )

Prende un valore in formato database e lo trasforma nel formato utente (quello visualizzato a video). I formati conosciuti sono: d (data), h (ora), r (timestamp), b (booleano), i (intero), f (float), s (stringa uppercase), t (stringa), e (codifica reversibile), c (codifica hash irreversibile)

Parameters:
string   $colonna:  Nome del campo, mi serve per conoscerne il tipo
mixed   $valore:  Valore in formato db

API Tags:
Abstract:  
Access:  public


Redefined in descendants as:

[ Top ]
static method diff  [line 558]

  static string diff( string $colonna, mixed $valore  )

Genera un confronto di differenza (!=)

Parameters:
string   $colonna:  Nome del campo
mixed   $valore:  Valore in formato utente

API Tags:
Access:  public


[ Top ]
static method ends_like  [line 653]

  static string ends_like( string $colonna, mixed $valore  )

Genera un confronto di fine simile (LIKE)

Parameters:
string   $colonna:  Nome del campo
mixed   $valore:  Valore in formato utente

API Tags:
Access:  public


Redefined in descendants as:

[ Top ]
static method equ  [line 531]

  static string equ( string $colonna, mixed $valore  )

Genera un confronto di uguaglianza (=)

Parameters:
string   $colonna:  Nome del campo
mixed   $valore:  Valore in formato utente

API Tags:
Access:  public


[ Top ]
static method genera_count  [line 895]

  static string genera_count( string $tabella, [string $condizione = NULL], [mixed $distinct = FALSE]  )

Genera una query COUNT su una tabella

Parameters:
string   $tabella:  Nome della tabella
string   $condizione:  Eventuale clausola WHERE
mixed   $distinct:  se FALSE a' un count *, se diverso a' il campo di cui fare la distinct

API Tags:
Access:  public


[ Top ]
static method genera_delete  [line 878]

  static string genera_delete( string $tabella, [string $condizione = NULL]  )

Genera una clausola DELETE su una tabella data un'eventuale condizione

Parameters:
string   $tabella:  Nome della tabella
string   $condizione:  Eventuale clausola WHERE

API Tags:
Access:  public


[ Top ]
static method genera_exists  [line 912]

  static string genera_exists( string $tabella, [string $condizione = NULL]  )

Genera una query EXISTS su una tabella

Parameters:
string   $tabella:  Nome della tabella
string   $condizione:  Eventuale clausola WHERE

API Tags:
Access:  public


Redefined in descendants as:

[ Top ]
static method genera_insert  [line 818]

  static string genera_insert( string $tabella, array $valori, [array $colonne_filtro = NULL]  )

Genera una clausola INSERT su una tabella dati i valori in un array associativo e le eventuali colonne di filtro

Parameters:
string   $tabella:  Nome della tabella
array   $valori:  Array associativo (campo => valore)
array   $colonne_filtro:  Se impostato, indica le sole colonne da inserire

API Tags:
Access:  public


[ Top ]
static method genera_select  [line 809]

  static string genera_select( $nome_tabella, $colonne, [string $condizione = NULL], [string $ordine = NULL], [string $distinct = false], [string $pagina_iniziale = NULL], [string $dim_pagina = NULL], string $tabella  )

Ritorna la query di selezione in base ai parametri specificati

Parameters:
string   $tabella:  Il nome della tabella di cui caricare l'identita' * @param string $colonne La stringa con in nomi di colonna separati da virgole (come da SQL)
string   $condizione:  Il contenuto dell WHERE
string   $ordine:  Il contenuto della ORDER BY
string   $distinct:  Vero o falso
string   $pagina_iniziale:  Il numero di pagina da cui iniziare a visualizzare
string   $dim_pagina:  Numero di record da visualizzare
   $nome_tabella: 
   $colonne: 

API Tags:
Abstract:  
Access:  public


Redefined in descendants as:

[ Top ]
static method genera_update  [line 844]

  static string genera_update( string $tabella, array $valori, [array $colonne_filtro = NULL], [string $condizione = NULL]  )

Genera una clausola UPDATE su una tabella dati i valori in un array associativo e le eventuali colonne di filtro

Parameters:
string   $tabella:  Nome della tabella
array   $valori:  Array associativo (campo => valore)
array   $colonne_filtro:  Se impostato, indica le sole colonne da inserire
string   $condizione:  Eventuale clausola WHERE

API Tags:
Access:  public


[ Top ]
static method gt  [line 569]

  static string gt( string $colonna, mixed $valore  )

Genera un confronto di maggioranza (>)

Parameters:
string   $colonna:  Nome del campo
mixed   $valore:  Valore in formato utente

API Tags:
Access:  public


[ Top ]
static method gte  [line 591]

  static string gte( string $colonna, mixed $valore  )

Genera un confronto di maggioranza o uguaglianza (>=)

Parameters:
string   $colonna:  Nome del campo
mixed   $valore:  Valore in formato utente

API Tags:
Access:  public


[ Top ]
static method iequ  [line 542]

  static string iequ( string $colonna, mixed $valore  )

Genera un confronto di uguaglianza (=) case-insensitive

Parameters:
string   $colonna:  Nome del campo
mixed   $valore:  Valore in formato utente

API Tags:
Access:  public


Redefined in descendants as:

[ Top ]
static method in  [line 697]

  static string in( string $colonna, array $valori  )

Genera una condizione IN. Se l'array di valori passato a' vuoto, genera una clausola "dummy" sempre falsa

Parameters:
string   $colonna:  Nome del campo
array   $valori:  Valori di confronto

API Tags:
Access:  public


[ Top ]
static method in_tp  [line 757]

  static string in_tp( string $tabella_ricerca, string $campo_ricerca, [string $campo_filtro = NULL], [mixed $valore = NULL]  )

Genera una clausola IN basata su una subquery. La subquery viene generata come SELECT $campo_ricerca FROM $tabella_ricerca WHERE cond($campo_filtro, $valore), $campo_ricerca deve essere presente anche nella tabella corrente. Es. i_acc_utente_id IN (SELECT i_acc_utente_id FROM t_p_acc_utente_gruppo WHERE i_acc_gruppo_id = 4)

Parameters:
string   $tabella_ricerca:  Tabella in cui la ricerca viene effettuata
string   $campo_ricerca:  Nome del campo su cui viene effettuata la ricerca (il campo della tabella corrente viene confrontato con i valori della query su $tabella_ricerca.$campo_ricerca)
string   $campo_filtro:  Campo su cui viene fatto un filtro nella tabella di ricerca; se NULL, nessuna WHERE condition viene aggiunta
mixed   $valore:  Valore ( o array di valori ) su cui viene fatto il filtro; se NULL, nessuna WHERE condition viene aggiunta

API Tags:
Access:  public


[ Top ]
static method like  [line 613]

  static string like( string $colonna, mixed $valore  )

Genera un confronto di similitudine (LIKE)

Parameters:
string   $colonna:  Nome del campo
mixed   $valore:  Valore in formato utente

API Tags:
Access:  public


Redefined in descendants as:

[ Top ]
static method lt  [line 580]

  static string lt( string $colonna, mixed $valore  )

Genera un confronto di minoranza (<)

Parameters:
string   $colonna:  Nome del campo
mixed   $valore:  Valore in formato utente

API Tags:
Access:  public


[ Top ]
static method lte  [line 602]

  static string lte( string $colonna, mixed $valore  )

Genera un confronto di minoranza o uguaglianza (<=)

Parameters:
string   $colonna:  Nome del campo
mixed   $valore:  Valore in formato utente

API Tags:
Access:  public


[ Top ]
static method not_in  [line 719]

  static string not_in( string $colonna, array $valori  )

Genera una condizione NOT IN. Se l'array di valori passato a' vuoto, genera una clausola "dummy" sempre vera

Parameters:
string   $colonna:  Nome del campo
array   $valori:  Valori di confronto

API Tags:
Access:  public


[ Top ]
static method op_tp  [line 779]

  static string op_tp( string $operatore, string $tabella_ricerca, string $campo_ricerca, string $campo_filtro, string $campo, mixed $valore  )

Genera una clausola IN basata su una subquery. E' una generalizzazione di in_tp, in cui la ricerca nella subquery e' generalizzata e i campi nella tabella corrente e in $tabella_ricerca non devono essere necessariamente omonimi.

Parameters:
string   $operatore:  Operatore di confronto fra $campo_filtro e $valore
string   $tabella_ricerca:  Tabella in cui la ricerca viene effettuata
string   $campo_ricerca:  Nome del campo su cui viene effettuata la ricerca (il campo della tabella corrente viene confrontato con i valori della query su $tabella_ricerca.$campo_ricerca)
string   $campo_filtro:  Campo su cui viene fatto un filtro nella tabella di ricerca
string   $campo:  Campo della tabella corrente, operando di sinistra della clausola IN
mixed   $valore:  Valore ( o array di valori ) su cui viene fatto il filtro

API Tags:
Access:  public


[ Top ]
static method set_sql  [line 401]

  static void set_sql( string $sql  )

Imposta il nome della classe sql

Parameters:
string   $sql: 

API Tags:
Access:  public


[ Top ]
static method utente_2_db  [line 419]

  static mixed utente_2_db( string $colonna, mixed $valore  )

Prende un valore in formato utente (quello visualizzato a video) lo trasforma nel formato database

Parameters:
string   $colonna:  Nome del campo, mi serve per conoscerne il tipo
mixed   $valore:  Valore in formato utente

API Tags:
Abstract:  
Access:  public


Redefined in descendants as:

[ Top ]
static method word_like  [line 674]

  static string word_like( string $colonna, mixed $parole_str  )

Genera un confronto di similitudine (LIKE) su ognuna delle parole (supposte separate da spazi) presenti nel valore specificato

Parameters:
string   $colonna:  Nome del campo
mixed   $parole_str:  Elenco di parole separate da spazi, in formato utente

API Tags:
Access:  public


[ Top ]

Documentation generated on Thu, 25 Sep 2008 23:29:08 +0200 by phpDocumentor 1.4.0