Class: DB_BASE

Source Location: /c_accesso_db.inc

Class DB_BASE

Class Overview

Gestisce la connessione e fornisce i metodi di base per caricamento ed esecuzione

Located in /c_accesso_db.inc [line 53]

Properties

Methods

[ Top ]

Descendants

Child Class	Description
RECORDSET	Fornisce le funzionalita' di spostamento fra righe con impostazione di EOF e BOF, nonche' la restituzione dei valori in formato utente

[ Top ]

Property Summary

static mixed	$time
CACHE	$cache	Classe per la gestione della cache
array	$campi	Vettore con l'elenco delle colonne dell'ultima select
integer	$count	Numero di righe presenti in $rs
integer	$count_reale	Numero di righe ritornate dalla query (per la paginazione)
array	$db_connection	Informazioni per la connessione al db
array	$default	Array associativo con i valori di default dei campi - solo per tabelle
DB_DRIVER	$driver	Classe di interazione col db
array	$lunghezza	Array associativo con le lunghezze dei campi
DB_META	$meta	Classe che fornisce query sui metadati
array	$nullable	Array associativo di flag che mi dicono se il campo e' nullable (non obbligatorio) o meno - solo per tabelle
array	$rs	Recordset con i dati originali (formato db) dell'ultima select
DB_SQL	$sql	Classe di generazione sql
array	$tipo	Array associativo con i tipi fisici dei campi

[ Top ]

Method Summary

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)
void	apri_connessione()	Si connette al database usando i parametri di connessione specificati __construct, set_db_connection
void	carica_info_colonne()	Riempie gli array $campi con le informazioni della query passata; non tocca $default
void	carica_info_tabella()	Riempie gli array $default con le informazioni della tabella passata
integer	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)
void	chiudi_connessione()	Chiude la connessione al database
integer	conta_righe()	Conta tutte le righe della tabella che verificano la condizione passata
void	esegui()	Esegue una query generica che non necessita di ritorno di righe (INSERT, UPDATE, DELETE, etc.)
void	esegui_stored_procedure()	Esegue una stored procedure sul database
bool	esistono_righe()	Dice se esistono righe nella tabella che verificano la condizione passata
void	getRS()
array	parametri_stored_procedure()	Ritorna i parametri formattati in modo consono (es. per caricamenti)
void	select()	Esegue la query di select passata come argomento, caricando le informazioni in $rs
void	setRS()
void	set_db_connection()	Predispone le variabili membro db_connection, driver, meta per connettersi al db specificato
void	tr_begin()	Inizia la transazione.
void	tr_commit()	Fa il commit della transazione corrente
void	tr_rollback()	Fa il rollback della transazione corrente.
long	ultimo_id_tabella()	Ritorna il valore dell'ultimo ID ad incremento automatico generato nella tabella specificata
mixed	valore_default()	Ritorna il valore di default per il campo passato, o stringa vuota se non e' memorizzato

[ Top ]

Properties

static mixed $time = array('SQL' => 0, 'NUM' => 0, 'ALL' => array()) [line 55]

API Tags:

Access:

public

[ Top ]

CACHE $cache = NULL [line 75]

Classe per la gestione della cache

API Tags:

Access:

protected

[ Top ]

array $campi = array() [line 93]

Vettore con l'elenco delle colonne dell'ultima select

API Tags:

Access:

public

[ Top ]

integer $count = 0 [line 123]

Numero di righe presenti in $rs

API Tags:

Access:

public

[ Top ]

integer $count_reale = 0 [line 129]

Numero di righe ritornate dalla query (per la paginazione)

API Tags:

Access:

public

[ Top ]

array $db_connection = array() [line 81]

Informazioni per la connessione al db

API Tags:

Access:

protected

[ Top ]

array $default = array() [line 111]

Array associativo con i valori di default dei campi - solo per tabelle

API Tags:

Access:

public

[ Top ]

DB_DRIVER $driver = NULL [line 60]

Classe di interazione col db

API Tags:

Access:

protected

[ Top ]

array $lunghezza = array() [line 99]

Array associativo con le lunghezze dei campi

API Tags:

Access:

public

[ Top ]

DB_META $meta = NULL [line 65]

Classe che fornisce query sui metadati

API Tags:

Access:

protected

[ Top ]

array $nullable = array() [line 117]

Array associativo di flag che mi dicono se il campo e' nullable (non obbligatorio) o meno - solo per tabelle

API Tags:

Access:

public

[ Top ]

array $rs = array() [line 87]

Recordset con i dati originali (formato db) dell'ultima select

API Tags:

Access:

protected

[ Top ]

DB_SQL $sql = NULL [line 70]

Classe di generazione sql

API Tags:

Access:

protected

[ Top ]

array $tipo = array() [line 105]

Array associativo con i tipi fisici dei campi

API Tags:

Access:

public

[ Top ]

Methods

Constructor __construct [line 135]

DB_BASE __construct(
[array
$db_connection = NULL] 
)

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

Parameters:

array

$db_connection:

API Tags:

Access:

public

Redefined in descendants as:

RECORDSET::__construct() : Esegue e carica direttamente la query SELECT passata
GESTORE::__construct() : Carica le informazioni sulla tabella specificata

[ Top ]

apri_connessione [line 186]

void apri_connessione(
)

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

API Tags:

Access:

protected

[ Top ]

carica_info_colonne [line 204]

void carica_info_colonne(
resource_id
$res_rs, [string
$sql = null] 
)

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

Parameters:

resource_id	$res_rs:	risorsa risultato di una dbms_query
string	$sql:	sql della query (facoltativo usato per alimentare e ricercare nella cache dei metadati)

API Tags:

Access:

protected

[ Top ]

carica_info_tabella [line 246]

void carica_info_tabella(

$table_name, string
$table 
)

Riempie gli array $default con le informazioni della tabella passata

Parameters:

string	$table:	tabella di cui caricare le informazioni
	$table_name:

API Tags:

Access:

protected

[ Top ]

carica_righe [line 416]

integer carica_righe(
string
$table, [mixed
$colonne = NULL], [string
$condizione = NULL], [string
$ordine = NULL], [bool
$distinct = FALSE], [integer
$pagina = NULL], [integer
$dim_pagina = NULL], [boolean
$conta = TRUE], [mixed
$usa_cache = FALSE] 
)

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)

Parameters:

string	$table:	Nome della tabella o vista da caricare
mixed	$colonne:	Opzionale, dice quali colonne devono essere caricate, tutte se omesso o NULL
string	$condizione:	Opzionale, condizioni della clausola WHERE
string	$ordine:	Opzionale, condizioni della clausola ORDER BY
bool	$distinct:	Indica se inserire la clausola DISTINCT nel caricamento
integer	$pagina:	Per caricamenti paginati, la pagina da caricare
integer	$dim_pagina:	Per caricamenti paginati, la dimensione delle pagine
boolean	$conta:	Dice se eseguire o meno in conteggio dei record
mixed	$usa_cache:	Dice se usare o meno la cache. Se FALSE non la usa, se !FALSE e' una stringa tabella.campo_id usata per capire se si puo' o meno

API Tags:

Access:

protected

[ Top ]

chiudi_connessione [line 194]

void chiudi_connessione(
)

Chiude la connessione al database

API Tags:

Access:

protected

[ Top ]

conta_righe [line 347]

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

Conta tutte le righe della tabella che verificano la condizione passata

Parameters:

string	$table:	Nome della tabella o vista da caricare
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:

protected

[ Top ]

esegui [line 499]

void esegui(
string
$sql 
)

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

Parameters:

string

$sql:

La query (INSERT, UPDATE, DELETE) da eseguire

API Tags:

Access:

public

[ Top ]

esegui_stored_procedure [line 533]

void esegui_stored_procedure(
string
$procedure, mixed
$parametro 
)

Esegue una stored procedure sul database

Parameters:

string	$procedure:	nome della stored procedure da chiamare
mixed	$parametro:	(quanti ne servono)

API Tags:

Access:

public

[ Top ]

esistono_righe [line 378]

bool esistono_righe(
string
$table, [string
$condizione = NULL] 
)

Dice se esistono righe nella tabella che verificano la condizione passata

Parameters:

string	$table:	Nome della tabella o vista da caricare
string	$condizione:	Condizione WHERE

API Tags:

Access:

protected

[ Top ]

getRS [line 590]

void getRS(
[
$fmt = NULL] 
)

Parameters:

$fmt:

API Tags:

Access:

public

[ Top ]

parametri_stored_procedure [line 558]

array parametri_stored_procedure(
string
$procedure, mixed
$parametro 
)

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

Parameters:

string	$procedure:	nome della stored procedure
mixed	$parametro:	(quanti ne servono)

API Tags:

Access:

public

[ Top ]

select [line 287]

void select(
mixed
$sql, bool
$carica_info, [string
$campo_id = NULL] 
)

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

Parameters:

mixed	$sql:	Query SELECT da caricare
bool	$carica_info:	Indica se caricare o meno le meta-informazioni sulla query da eseguire
string	$campo_id:	specifica il campo id (che deve essere presente nella query), che viene utilizzato per indicizzare l'array. !Attenzione! vengono persi gli eventuali record che hanno lo stesso campo_id!!!

API Tags:

Access:

protected

[ Top ]

setRS [line 606]

void setRS(

&$rs 
)

Parameters:

&$rs:

API Tags:

Access:

public

[ Top ]

set_db_connection [line 146]

void set_db_connection(
array
$db_connection 
)

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

Parameters:

array

$db_connection:

API Tags:

Access:

public

[ Top ]

tr_begin [line 161]

void tr_begin(
)

Inizia la transazione.

API Tags:

Access:

public

[ Top ]

tr_commit [line 170]

void tr_commit(
)

Fa il commit della transazione corrente

API Tags:

Access:

public

[ Top ]

tr_rollback [line 178]

void tr_rollback(
)

Fa il rollback della transazione corrente.

API Tags:

Access:

public

[ Top ]

ultimo_id_tabella [line 514]

long ultimo_id_tabella(
string
$tabella 
)

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

Parameters:

string

$tabella:

API Tags:

Access:

protected

[ Top ]

valore_default [line 335]

mixed valore_default(

$campo, string
$nome_campo 
)

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

Parameters:

string	$nome_campo:	Nome del campo di cui ottenere il default
	$campo:

API Tags:

Access:

public

[ Top ]

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