模块 db
数据库访问模块
基础模块。可用于创建和操作数据库资源,引用方式:
1var db = require('db');
静态函数
open
打开一个数据库,此方法为通用入口,根据提供的 connString 不同调用不同的引擎
1static object db.open(String connString) async;
调用参数:
- connString: String, 数据库描述,如:mysql://user:pass\@host/db
返回结果:
- object, 返回数据库连接对象
openMySQL
打开一个 mysql 数据库
1static MySQL db.openMySQL(String connString) async;
调用参数:
- connString: String, 数据库描述,如:mysql://user:pass\@host/db
返回结果:
- MySQL, 返回数据库连接对象
openMSSQL
打开一个 mysql 数据库
1static MSSQL db.openMSSQL(String connString) async;
调用参数:
- connString: String, 数据库描述,如:mssql://user:pass\@host/db
返回结果:
- MSSQL, 返回数据库连接对象
openSQLite
打开一个 sqlite 数据库
1static SQLite db.openSQLite(String connString) async;
调用参数:
- connString: String, 数据库描述,如:sqlite:test.db 或者 test.db
返回结果:
- SQLite, 返回数据库连接对象
openMongoDB
打开一个 mongodb 数据库
1static MongoDB db.openMongoDB(String connString) async;
调用参数:
- connString: String, 数据库描述
返回结果:
- MongoDB, 返回数据库连接对象
openLevelDB
打开一个 leveldb 数据库
1static LevelDB db.openLevelDB(String connString) async;
调用参数:
- connString: String, 数据库描述,如:level:test.db 或者 test.db
返回结果:
- LevelDB, 返回数据库对象
openRedis
打开一个 Redis 数据库
1static Redis db.openRedis(String connString) async;
调用参数:
- connString: String, 数据库描述,如:redis://server:port 或者 "server"
返回结果:
- Redis, 返回数据库连接对象
format
格式化一个 sql 命令,并返回格式化结果
1
2static String db.format(String method,
Object opts);
调用参数:
- method: String, 指定请求的方法
- opts: Object, 参数列表
返回结果:
- String, 返回格式化之后的 sql 命令
格式化一个 sql 命令,并返回格式化结果
1
2static String db.format(String sql,
...args);
调用参数:
- sql: String, 格式化字符串,可选参数用 ? 指定。例如:'SELECT FROM TEST WHERE [id]=?'
- args: ..., 可选参数列表
返回结果:
- String, 返回格式化之后的 sql 命令
formatMySQL
格式化一个 mysql 命令,并返回格式化结果
1
2static String db.formatMySQL(String method,
Object opts);
调用参数:
- method: String, 指定请求的方法
- opts: Object, 参数列表
返回结果:
- String, 返回格式化之后的 mysql 命令
格式化一个 mysql 命令,并返回格式化结果
1
2static String db.formatMySQL(String sql,
...args);
调用参数:
- sql: String, 格式化字符串,可选参数用 ? 指定。例如:'SELECT FROM TEST WHERE [id]=?'
- args: ..., 可选参数列表
返回结果:
- String, 返回格式化之后的 sql 命令
formatMSSQL
格式化一个 mssql 命令,并返回格式化结果
1
2static String db.formatMSSQL(String method,
Object opts);
调用参数:
- method: String, 指定请求的方法
- opts: Object, 参数列表
返回结果:
- String, 返回格式化之后的 mssql 命令
格式化一个 mssql 命令,并返回格式化结果
1
2static String db.formatMSSQL(String sql,
...args);
调用参数:
- sql: String, 格式化字符串,可选参数用 ? 指定。例如:'SELECT FROM TEST WHERE [id]=?'
- args: ..., 可选参数列表
返回结果:
- String, 返回格式化之后的 sql 命令
escape
将字符串编码为 SQL 安全编码字符串
1
2static String db.escape(String str,
Boolean mysql = false);
调用参数:
- str: String, 要编码的字符串
- mysql: Boolean, 指定 mysql 编码,缺省为 false
返回结果:
- String, 返回编码后的字符串