Class: GESTORE

Source Location: /c_accesso_db.inc

Class GESTORE

Class Overview

Gestisce la manipolazione dati su una tabella specifica, facendo da interfaccia tra la pagina HTML e il database

DB_BASE
   |
   --RECORDSET
      |
      --GESTORE

Properties

Methods

[ Top ]

Inherited Properties, Constants, and Methods

Inherited Properties

Inherited Methods

Inherited Constants

Inherited From RECORDSET

RECORDSET::$bof

RECORDSET::$eof

RECORDSET::$index

RECORDSET::$recordset_query

RECORDSET::$slice_stack

Inherited From DB_BASE

DB_BASE::$cache

DB_BASE::$campi

DB_BASE::$count

DB_BASE::$count_reale

DB_BASE::$db_connection

DB_BASE::$default

DB_BASE::$driver

DB_BASE::$lunghezza

DB_BASE::$meta

DB_BASE::$nullable

DB_BASE::$rs

DB_BASE::$sql

DB_BASE::$time

DB_BASE::$tipo

Inherited From RECORDSET

RECORDSET::RECORDSET()

Esegue e carica direttamente la query SELECT passata

RECORDSET::__construct()

Esegue e carica direttamente la query SELECT passata

RECORDSET::carica()

Ri-esegue la query SELECT con cui e' stato creato

RECORDSET::imposta_valore()

Imposta il valore del campo nella riga corrente

RECORDSET::move()

Si sposta sulla riga indicata

RECORDSET::move_first()

Si sposta sul primo record

RECORDSET::move_last()

Si sposta sull'ultimo record

RECORDSET::move_next()

Si sposta sul record successivo

RECORDSET::move_previous()

Si sposta sul record precedente

RECORDSET::move_rel()

Si sposta sulla riga indicata via offset rispetto a quella corrente

RECORDSET::move_to_value()

RECORDSET::restore()

Ritorna al recordset immediatamente precedente all'ultimo taglio

RECORDSET::slice()

Modifica il recordset sostituendolo con una sua parte, da $start a $end.

RECORDSET::somma_colonna()

Ritorna la somma di tutti valori presenti nella colonna indicata, 0 se la colonna non e' numerica (f o i)

RECORDSET::valore()

Ritorna il valore del campo specificato in formato utente

RECORDSET::valore_ascii()

Ritorna il valore del campo specificato in formato ASCII (vedere db_2_ascii)

RECORDSET::valore_db()

Ritorna il valore del campo specificato come appare sul db

RECORDSET::valore_fwk()

Ritorna il valore del campo specificato in formato fwk (vedere db_2_fwk)

RECORDSET::valore_generico()

RECORDSET::valori()

Ritorna tutti i valori attualmente caricati della / delle colonne specificate in un array associativo (colonna, array valori)

RECORDSET::valori_colonna()

Ritorna tutti i valori attualmente caricati della colonna specificata in un array

RECORDSET::valori_riga()

Ritorna tutti i valori attualmente caricati nella riga indicata (quella corrente se omessa)

RECORDSET::__get()

Come valore in sintassi $o->campo

Inherited From DB_BASE

DB_BASE::__construct()

Richiama set_db_connection e predispone l'oggetto di gestione cache. se il parametro e' NULL, viene usata la connessione di default (DB_DEFAULT)

DB_BASE::apri_connessione()

Si connette al database usando i parametri di connessione specificati __construct, set_db_connection

DB_BASE::carica_info_colonne()

Riempie gli array $campi con le informazioni della query passata; non tocca $default

DB_BASE::carica_info_tabella()

Riempie gli array $default con le informazioni della tabella passata

DB_BASE::carica_righe()

Carica la variabile $rs con una query SELECT costruita in base ai parametri passati; ritorna il numero di pagine effettivamente caricate (se la pagina specificata e' maggiore del numero di pagine possibili, viene decrementato il suo valore)

DB_BASE::chiudi_connessione()

Chiude la connessione al database

DB_BASE::conta_righe()

Conta tutte le righe della tabella che verificano la condizione passata

DB_BASE::esegui()

Esegue una query generica che non necessita di ritorno di righe (INSERT, UPDATE, DELETE, etc.)

DB_BASE::esegui_stored_procedure()

Esegue una stored procedure sul database

DB_BASE::esistono_righe()

Dice se esistono righe nella tabella che verificano la condizione passata

DB_BASE::getRS()

DB_BASE::parametri_stored_procedure()

Ritorna i parametri formattati in modo consono (es. per caricamenti)

DB_BASE::select()

Esegue la query di select passata come argomento, caricando le informazioni in $rs

DB_BASE::setRS()

DB_BASE::set_db_connection()

Predispone le variabili membro db_connection, driver, meta per connettersi al db specificato

DB_BASE::tr_begin()

Inizia la transazione.

DB_BASE::tr_commit()

Fa il commit della transazione corrente

DB_BASE::tr_rollback()

Fa il rollback della transazione corrente.

DB_BASE::ultimo_id_tabella()

Ritorna il valore dell'ultimo ID ad incremento automatico generato nella tabella specificata

DB_BASE::valore_default()

Ritorna il valore di default per il campo passato, o stringa vuota se non e' memorizzato

[ Top ]

Property Summary

string	$campo_id	Campo id della tabella (di default i_nome_tabella_id)
string	$dim_pagina	Dimensione delle pagine
string	$pagina	Pagina caricata / da caricare
string	$tabella	Tabella gestita
string	$usa_cache	Utilizzo cache

[ Top ]

Method Summary

GESTORE	__construct()	Carica le informazioni sulla tabella specificata
GESTORE	GESTORE()	Backward compatibility
void	abilita_cache()	Abilita la cache per il gestore
void	aggiorna()	Esegue un aggiornamento della riga il cui valore di $campo_id corrisponde al valore passato, con i valori specificati
void	aggiorna_dove()	Esegue un aggiornamento delle riga rispondenti al criterio passato con i valori specificati
void	carica()	Esegue un caricamento
void	carica_righe_id()	Esegue un caricamento delle righe il cui valore di $campo_id corrisponde al valore passato
integer	conta()	Conta tutte le righe della tabella che verificano la condizione passata
void	crea()	Esegue un inserimento con i valori specificati (riga -1)
mixed	decode()	"Decodifica" un valore in un altro nella stessa tabella: ritorna il valore di $campo_out legato al $valore di $campo_in nella tabella
void	elimina()	Elimina le righe il cui valore di $campo_id corrisponde al valore passato, con i valori specificati
void	elimina_dove()	Elimina le righe rispondenti al criterio passato
bool	esiste()	Dice se esistono righe della tabella che verificano la condizione passata
integer	ultimo_id()	Ritorna il valore dell'ultimo ID ad incremento automatico generato nella tabella gestita
array	valori_per_query()	Ritorna i valori dei campi specificati come provenissero dalla pagina ($_POST) per eseguire una query (crea o aggiorna) sulla riga specificata

[ Top ]

Properties

string $campo_id = "" [line 993]

Campo id della tabella (di default i_nome_tabella_id)

API Tags:

Access:

public

[ Top ]

string $dim_pagina = NULL [line 1003]

Dimensione delle pagine

API Tags:

Access:

public

[ Top ]

string $pagina = NULL [line 998]

Pagina caricata / da caricare

API Tags:

Access:

public

[ Top ]

string $tabella = "" [line 988]

Tabella gestita

API Tags:

Access:

public

[ Top ]

string $usa_cache = FALSE [line 1009]

Utilizzo cache

API Tags:

Access:

private

[ Top ]

Methods

Constructor __construct [line 1018]

GESTORE __construct(
string
$tabella, [string
$campo_id = NULL], [bool
$usa_cache = FALSE], [array
$db_connection = NULL] 
)

Carica le informazioni sulla tabella specificata

Parameters:

string	$tabella:
string	$campo_id:	Opzionale
bool	$usa_cache:	Opzionale, attiva la cache per i risultati del gestore
array	$db_connection:	Connessione su cui operare

API Tags:

Access:

public

Redefinition of:

RECORDSET::__construct(): Esegue e carica direttamente la query SELECT passata

[ Top ]

Constructor GESTORE [line 1036]

GESTORE GESTORE(
string
$tabella, [string
$campo_id = NULL], [bool
$usa_cache = FALSE], [array
$db_connection = NULL] 
)

Backward compatibility

Parameters:

string	$tabella:
string	$campo_id:	Opzionale
bool	$usa_cache:	Opzionale, attiva la cache per i risultati del gestore
array	$db_connection:	Connessione su cui operare

API Tags:

Access:

public

[ Top ]

abilita_cache [line 1051]

void abilita_cache(
[bool
$usa_cache = TRUE] 
)

Abilita la cache per il gestore

Parameters:

bool

$usa_cache:

Opzionale, attiva la cache per i risultati del gestore

API Tags:

Access:

public

[ Top ]

aggiorna [line 1092]

void aggiorna(
mixed
$id_riga, array
$valori 
)

Esegue un aggiornamento della riga il cui valore di $campo_id corrisponde al valore passato, con i valori specificati

Parameters:

mixed	$id_riga:
array	$valori:	Matrice del tipo (id_riga, nome_colonna) => valore contenente dati, tipicamente provenienti dalla pagina ($_POST)

API Tags:

Access:

public

[ Top ]

aggiorna_dove [line 1111]

void aggiorna_dove(
array
$associazioni, string
$condizione 
)

Esegue un aggiornamento delle riga rispondenti al criterio passato con i valori specificati

Parameters:

array	$associazioni:	Matrice del tipo nome_colonna => valore contenente i dati da aggiornare
string	$condizione:	Condizione WHERE

API Tags:

Access:

public

[ Top ]

carica [line 1067]

void carica(
[string
$condizione = NULL], [string
$ordine = NULL], [array
$colonne = NULL], [bool
$distinct = FALSE], [bool
$conta = TRUE] 
)

Esegue un caricamento

Parameters:

string	$condizione:	Condizione WHERE
string	$ordine:	Opzionale, campi da ordinare (argomento della ORDER BY)
array	$colonne:	Opzionale, colonne da reperire - se omesso, vengono prese tutte le colonne della tabella gestita
bool	$distinct:	Indica se inserire la clausola DISTINCT nel caricamento
bool	$conta:	Indica se eseguire la conta prima di fare il caricamento

API Tags:

Access:

public

Redefinition of:

RECORDSET::carica(): Ri-esegue la query SELECT con cui e' stato creato

[ Top ]

carica_righe_id [line 1082]

void carica_righe_id(
mixed
$valore_id, [string
$ordine = NULL], [array
$colonne = NULL], [bool
$distinct = FALSE], [
$conta = TRUE] 
)

Esegue un caricamento delle righe il cui valore di $campo_id corrisponde al valore passato

Parameters:

mixed	$valore_id:
string	$ordine:	Opzionale, campi da ordinare (argomento della ORDER BY)
array	$colonne:	Opzionale, colonne da reperire - se omesso, vengono prese tutte le colonne della tabella gestita
bool	$distinct:	Indica se inserire la clausola DISTINCT nel caricamento
	$conta:

API Tags:

Access:

public

[ Top ]

conta [line 1181]

integer conta(
[string
$condizione = NULL], [mixed
$distinct = FALSE] 
)

Conta tutte le righe della tabella che verificano la condizione passata

Parameters:

string	$condizione:	Condizione WHERE
mixed	$distinct:	Indica se inserire la clausola DISTINCT nel conteggio; se FALSE o equivalente non la inserisce, else indica cosa contare in modo distinto (elenco colonne, *, etc.)

API Tags:

Access:

public

[ Top ]

crea [line 1129]

void crea(
array
$valori, [
$id = '-1'] 
)

Esegue un inserimento con i valori specificati (riga -1)

Parameters:

array	$valori:	Matrice del tipo (id_riga, nome_colonna) => valore contenente dati, tipicamente provenienti dalla pagina ($_POST)
	$id:

API Tags:

Access:

public

[ Top ]

decode [line 1204]

mixed decode(
mixed
$valore, string
$campo_out, [string
$campo_in = NULL], [mixed
$ret_on_eof = FALSE] 
)

"Decodifica" un valore in un altro nella stessa tabella: ritorna il valore di $campo_out legato al $valore di $campo_in nella tabella

Parameters:

mixed	$valore:	Valore da cercare
string	$campo_out:	Campo di cui ritornare il valore
string	$campo_in:	Opzionale - campo di cui cercare $valore, se omesso viene usato $campo_id
mixed	$ret_on_eof:	Se false solleva un errore nel caso la decode fallisca, altrimenti ritorna quel valore

API Tags:

Access:

public

[ Top ]

elimina [line 1146]

void elimina(
mixed
$id_riga 
)

Elimina le righe il cui valore di $campo_id corrisponde al valore passato, con i valori specificati

Parameters:

mixed

$id_riga:

API Tags:

Access:

public

[ Top ]

elimina_dove [line 1162]

void elimina_dove(
string
$condizione 
)

Elimina le righe rispondenti al criterio passato

Parameters:

string

$condizione:

Condizione WHERE

API Tags:

Access:

public

[ Top ]

esiste [line 1191]

bool esiste(
[string
$condizione = NULL] 
)

Dice se esistono righe della tabella che verificano la condizione passata

Parameters:

string

$condizione:

Condizione WHERE

API Tags:

Access:

public

[ Top ]

ultimo_id [line 1242]

integer ultimo_id(
)

Ritorna il valore dell'ultimo ID ad incremento automatico generato nella tabella gestita

API Tags:

Access:

public

[ Top ]

valori_per_query [line 1229]

array valori_per_query(
array
$campi, [string
$id = "-1"] 
)

Ritorna i valori dei campi specificati come provenissero dalla pagina ($_POST) per eseguire una query (crea o aggiorna) sulla riga specificata

Parameters:

array	$campi:	Campi per cui ritornare i valori
string	$id:	Riga su cui bisognera' operare

API Tags:

Access:

public

[ Top ]

Documentation generated on Thu, 25 Sep 2008 23:28:59 +0200 by phpDocumentor 1.4.0