ObjectMySQL
Os obxectos MySQL son clases utilizadas para operar bases de datos MySQL.
A continuación móstrase un exemplo de uso de obxectos MySQL.
1
2
3
4
5
6
7
8
9
10
11
12
13var db = require('db');
var conn = db.openMySQL('mysql://root:password@localhost/test');
// call execute method to insert data
var res = conn.execute("insert into user(username, password) values ('testuser', '123456')");
console.log(res);
// call execute method to query data
res = conn.execute("select * from user where username = 'testuser'");
console.log(res);
conn.close();
No exemplo anterior, primeiro usamosdb.openMySQLO método crea un obxecto de conexión MySQL e especifica a información de conexión. Despois usamos o método execute para engadir un novo usuario á táboa de datos de usuario que preparamos previamente e, a continuación, chamamos ao método execute para consultar o rexistro de usuario que acabamos de crear. Finalmente chamamos ao método close para pechar o obxecto de ligazón e completar a nosa operación MySQL.
relación de herdanza
propiedades dos membros
rxBufferSize
Enteiro, a conexión de base de datos recibe o tamaño da caché
1Integer MySQL.rxBufferSize;
txBufferSize
Enteiro, tamaño da caché de envío de conexión de base de datos
1Integer MySQL.txBufferSize;
type
String, consulta o tipo de base de datos de conexión actual
1readonly String MySQL.type;
función de membro
close
Pecha a conexión actual da base de datos
1MySQL.close() async;
use
Seleccione a base de datos predeterminada para a conexión de base de datos actual
1MySQL.use(String dbName) async;
Parámetros de chamada:
- dbName: Cadea, especifique o nome da base de datos
begin
Iniciar unha transacción na conexión de base de datos actual
1MySQL.begin(String point = "") async;
Parámetros de chamada:
- point: Cadea, especifica o nome da transacción, non especificado por defecto
commit
Confirme a transacción na conexión de base de datos actual
1MySQL.commit(String point = "") async;
Parámetros de chamada:
- point: Cadea, especifica o nome da transacción, non especificado por defecto
rollback
Revertir unha transacción na conexión de base de datos actual
1MySQL.rollback(String point = "") async;
Parámetros de chamada:
- point: Cadea, especifica o nome da transacción, non especificado por defecto
trans
Introduza unha transacción para executar unha función e comite ou retroceda en función da execución da función.
1Boolean MySQL.trans(Function func);
Parámetros de chamada:
- func: Función, unha función executada de forma transaccional
Resultados de devolución:
- Boolean, devolve se a transacción está confirmada, devolve verdadeiro para a confirmación normal, devolve false para a recuperación e arroxa un erro se a transacción sae mal.
Hai tres resultados da execución da función:
- A función volve normalmente, incluíndo o final da operación e o retorno activo, momento no que a transacción confirmarase automaticamente.
- A función devolve false e a transacción será revertida
- Erro na operación da función, a transacción retrocedeuse automaticamente
Introduza unha transacción para executar unha función e comite ou retroceda en función da execución da función.
1
2Boolean MySQL.trans(String point,
Function func);
Parámetros de chamada:
- point: Cadea, especifica o nome da transacción
- func: Función, unha función executada de forma transaccional
Resultados de devolución:
- Boolean, devolve se a transacción está confirmada, devolve verdadeiro para a confirmación normal, devolve false para a recuperación e arroxa un erro se a transacción sae mal.
Hai tres resultados da execución da función:
- A función volve normalmente, incluíndo o final da operación e o retorno activo, momento no que a transacción confirmarase automaticamente.
- A función devolve false e a transacción será revertida
- Erro na operación da función, a transacción retrocedeuse automaticamente
execute
Execute un comando sql e devolve o resultado da execución
1NArray MySQL.execute(String sql) async;
Parámetros de chamada:
- sql: Corda, corda
Resultados de devolución:
- NArray, devolve unha matriz que contén rexistros de resultados. Se a solicitude é UPDATE ou INSERT, o resultado devolto tamén incluirá afectados e insertId. mssql non admite insertId.
Execute un comando sql e devolve o resultado da execución. A cadea pódese formatar segundo os parámetros.
1
2NArray MySQL.execute(String sql,
...args) async;
Parámetros de chamada:
- sql: A cadea, a cadea de formato e os parámetros opcionais especifícanse con ?. Por exemplo: 'SELECT FROM TEST WHERE [id]=?'
- args: ..., lista de parámetros opcional
Resultados de devolución:
- NArray, devolve unha matriz que contén rexistros de resultados. Se a solicitude é UPDATE ou INSERT, o resultado devolto tamén incluirá afectados e insertId. mssql non admite insertId.
createTable
Crear táboa de datos
1MySQL.createTable(Object opts) async;
Parámetros de chamada:
- opts: Obxecto, lista de parámetros
dropTable
Eliminar a táboa de datos
1MySQL.dropTable(Object opts) async;
Parámetros de chamada:
- opts: Obxecto, lista de parámetros
createIndex
Crear índice de táboa de datos
1MySQL.createIndex(Object opts) async;
Parámetros de chamada:
- opts: Obxecto, lista de parámetros
dropIndex
Eliminar o índice da táboa de datos
1MySQL.dropIndex(Object opts) async;
Parámetros de chamada:
- opts: Obxecto, lista de parámetros
insert
Insire novo rexistro
1Number MySQL.insert(Object opts) async;
Parámetros de chamada:
- opts: Obxecto, lista de parámetros
Resultados de devolución:
- Number, devolve o id que contén a inserción ou 0 se o motor non o admite.
find
Consulta os datos en función das condicións especificadas
1NArray MySQL.find(Object opts) async;
Parámetros de chamada:
- opts: Obxecto, lista de parámetros
Resultados de devolución:
- NArray, devolve rexistros que conteñen resultados
count
Conta o número de rexistros de datos en función das condicións especificadas
1Integer MySQL.count(Object opts) async;
Parámetros de chamada:
- opts: Obxecto, lista de parámetros
Resultados de devolución:
- Integer, devolve o número de rexistros que conteñen o resultado
update
Actualizar os datos en función das condicións especificadas
1Integer MySQL.update(Object opts) async;
Parámetros de chamada:
- opts: Obxecto, lista de parámetros
Resultados de devolución:
- Integer, devolve o número de rexistros que conteñen actualizacións
remove
Elimina os datos en función das condicións especificadas
1Integer MySQL.remove(Object opts) async;
Parámetros de chamada:
- opts: Obxecto, lista de parámetros opcional
Resultados de devolución:
- Integer, devolve o número de rexistros que conteñen actualizacións
format
Formatear un comando sql e devolver o resultado formateado
1
2String MySQL.format(String method,
Object opts);
Parámetros de chamada:
- method: String, especifica o método solicitado
- opts: Obxecto, lista de parámetros opcional
Resultados de devolución:
- String, devolve o comando sql con formato
Formatear un comando sql e devolver o resultado formateado
1
2String MySQL.format(String sql,
...args);
Parámetros de chamada:
- sql: A cadea, a cadea de formato e os parámetros opcionais especifícanse con ?. Por exemplo: 'SELECT FROM TEST WHERE [id]=?'
- args: ..., lista de parámetros opcional
Resultados de devolución:
- String, devolve o comando sql con formato
toString
Devolve a representación en cadea do obxecto. Polo xeral, devólvese "[Obxecto nativo]". O obxecto pódese volver implementar segundo as súas propias características.
1String MySQL.toString();
Resultados de devolución:
- String, devolve a representación en cadea do obxecto
toJSON
Devolve unha representación en formato JSON do obxecto, devolvendo xeralmente unha colección de propiedades lexibles definidas polo obxecto.
1Value MySQL.toJSON(String key = "");
Parámetros de chamada:
- key: Cadena, non usada
Resultados de devolución:
- Value, devolve un valor que contén JSON serializable