Nodedbi NPM | npm.io

NodeDBI

NodeDBI estas LibDBI interfaco por Node.js.

Por la fontkodo bonvolu vizitu la github pagxo

La NodeDBI interfaco liveras tradiciajn metodojn por uzi SQL datumbazoj, kaj ankaux la kapablo por pagxi rezultatojn kun persistaj objektoj. Vidu la suban ekzemplojn.

Gxi estas plejparte plena, kaj kontribuoj estas tre aprezas.

Por uzi tio cxi, vi deve havas LibDBI-n kaj gxiajn rubrikojn.

Por Debian aux Ubuntu, apt-get install libdbi-dev.

Por konstrui, tajpu: node-gyp configure build kaj node-gyp install por instali.

Ekzemploj

Mi havas kelke da Gistojn kiu eble uza:

#!/usr/bin/nodejs

var mod = require('nodedbi');

var args = { 'host':'localhost', 'port':3306, 'username':'root', 'password':'', 'type':'mysql', 'dbname':'test' };

var obj = new mod.DBConnection( args );

var q = obj.query("SELECT * FROM users WHERE username=%1 OR id=%2", ['doneill', 6]);
if( !q )
{
        console.log("SQL peto malsukcesis: "+obj.lastError());
        return;
}

// Simple:
var results = q.toArray();

// Malsimple, se eble rapida:
var rc = q.count();
console.log("Nombro da vicoj: "+rc);

var fc = q.fieldCount();
console.log("Nombro da kolumnoj: "+q.fieldCount());

var fna = [];
for( var x=0; x < fc; x++ )
{
        var fn = q.fieldName(x+1);
        console.log("Rubrikonomo ("+(x+1)+"): "+fn);
        fna.push( fn );
}

for( var y=0; y < rc; y++ )
{
        q.seek(y+1);
        for( var x=0; x < fc; x++ )
        {
                var v = q.value(x+1);
                console.log( y+" ["+fna[x]+"] = ["+v+"]" );
        }
}

Metodoj

DBConnection( parametroj )

Verku novan konekton al datumbazon.

var NodeDBI = require('nodedbi');
var parametroj = { 'type':'sqlite', 'dbname':'test' };
var db = new NodeDBI.DBConnection(parametroj);

La parametro type (en parametroj) estas deva. Ioj parametroj estas datumbazo specifa. Por datumbazo specifa parametroj vizitu la libdbi-drivers pagxo.

parametroj - Objekto kun LibDBI-specifaj konektaj parametroj en sxlosilo:valoro paroj.
Revenos: Datumbaza objekto, aux undefined se malsukcese.

DBConnection::query(petoLiteraro, parametroj)

Verku kaj ekzekutu datumbazan peton.

petoLiteraro - Peto liter-ar-o kun lokokupiloj por parametroj %1, %2, ktp.
parametroj - Faktultativa listo de parametroj por la lokokupiloj.
Revenos: DBQuery objekto, aux false se la peton malsukcesas por ia kialo.

DBConnection::lastError()

Revenu la plejnovan eraron literaron.

Revenos: Supre menciita.

DBConnection::lastInsertId(nomo)

La aktualan vicen legitimilon generis de la antauxa INSERT komando.

nomo - La nomon de la vico ("sequence", ne "row",) aux NULL se la datumbazon ne havas vicojn eksplicitan.
Revenos: La aktualan vicen legitimilon generis de la antauxa INSERT komando. Se la datumbazo ne uzi vicojn, tio cxi revenos 0.

Query()

Tio cxi objekto estas revenas per DBConnection::query kaj malpermesas verki de mem alie.

Query::count()

Revenu la nombron da vicoj de la rezultaro.

Revenos: Supre menciita, havas unu da taskon.

Query::fieldCount()

Revenu la nombron da kolumnoj de la rezultaro.

Revenos: Supre menciita.

Query::fieldName(kolumnIndekso)

Revenu la kampo-nomon de specifa kolomno-indekso. Indeksoj komencas cxe 1 , ne 0.

kolumnIndekso - La kolumno-indekso de la rezultan objekton. Kolumno-indeksoj en LibDBI komencas cxe 1, ne 0.
Revenos: La nomon de la kampo cxe la specifike indekson aux undefined kaj escepto se la indekso estas malvalida.

Query::fieldIndex(kampnomo)

Revenu la kampo-indekso de specifa kampo-nomon. Indeksoj komencas cxe 1 , ne 0.

kampnomo - La kampo-nomo de la rezultan objekton.
Revenos: La kolomnon-indekson kun la specifike kampo-nomo aux undefined kaj escepto se la nomon maltrovas. Kolumnejn indeksojn en LibDBI komencas cxe 1, ne 0.