ObjectDbConnection
DBConnection은 데이터베이스 연결의 기본 클래스이며 데이터베이스 연결 세션을 설정하고 유지하는 데 사용됩니다. 이는 연결의 기본 작업을 구현하고 파생 클래스의 기초 역할을 합니다. 또한 트랜잭션 시작, 트랜잭션 커밋, 트랜잭션 롤백과 같은 작업도 지원합니다.
DBConnection의 하위 클래스는 다음과 같습니다.Odbc,MySQL,SQLite, 각 하위 클래스를 인스턴스화함으로써 다양한 종류의 데이터베이스에 쉽게 액세스할 수 있습니다.
DBConnection은 직접 생성할 수 없으며 다음을 통해서만 생성할 수 있습니다.db.open다른 방법으로 생성됩니다. 예를 들면 다음과 같습니다.
1
2var db = require("db");
var conn = db.open("mysql://root:123456@localhost:3306/test");
상속관계
구성원 속성
type
문자열, 현재 연결 데이터베이스 유형을 쿼리합니다.
1readonly String DbConnection.type;
멤버 함수
close
현재 데이터베이스 연결 닫기
1DbConnection.close() async;
use
현재 데이터베이스 연결에 대한 기본 데이터베이스를 선택하세요.
1DbConnection.use(String dbName) async;
호출 매개변수:
- dbName: 문자열, 데이터베이스 이름을 지정합니다.
begin
현재 데이터베이스 연결에서 트랜잭션 시작
1DbConnection.begin(String point = "") async;
호출 매개변수:
- point: 문자열, 기본적으로 지정되지 않은 트랜잭션 이름을 지정합니다.
commit
현재 데이터베이스 연결에서 트랜잭션을 커밋합니다.
1DbConnection.commit(String point = "") async;
호출 매개변수:
- point: 문자열, 기본적으로 지정되지 않은 트랜잭션 이름을 지정합니다.
rollback
현재 데이터베이스 연결에서 트랜잭션 롤백
1DbConnection.rollback(String point = "") async;
호출 매개변수:
- point: 문자열, 기본적으로 지정되지 않은 트랜잭션 이름을 지정합니다.
trans
함수를 실행하기 위해 트랜잭션을 입력하고, 함수 실행에 따라 커밋 또는 롤백합니다.
1Boolean DbConnection.trans(Function func);
호출 매개변수:
- func: 함수, 트랜잭션 방식으로 실행되는 함수
결과 반환:
- Boolean, 트랜잭션이 커밋되었는지 여부를 반환하고, 일반 커밋의 경우 true를 반환하고, 롤백의 경우 false를 반환하고, 트랜잭션이 잘못되면 오류를 발생시킵니다.
func 실행에는 세 가지 결과가 있습니다.
- 함수는 작업 종료 및 활성 반환을 포함하여 정상적으로 반환되며 이때 트랜잭션이 자동으로 커밋됩니다.
- 함수는 false를 반환하고 트랜잭션은 롤백됩니다.
- 함수 연산 오류, 트랜잭션 자동 롤백
함수를 실행하기 위해 트랜잭션을 입력하고, 함수 실행에 따라 커밋 또는 롤백합니다.
1
2Boolean DbConnection.trans(String point,
Function func);
호출 매개변수:
- point: 문자열, 트랜잭션 이름을 지정합니다.
- func: 함수, 트랜잭션 방식으로 실행되는 함수
결과 반환:
- Boolean, 트랜잭션이 커밋되었는지 여부를 반환하고, 일반 커밋의 경우 true를 반환하고, 롤백의 경우 false를 반환하고, 트랜잭션이 잘못되면 오류를 발생시킵니다.
func 실행에는 세 가지 결과가 있습니다.
- 함수는 작업 종료 및 활성 반환을 포함하여 정상적으로 반환되며 이때 트랜잭션이 자동으로 커밋됩니다.
- 함수는 false를 반환하고 트랜잭션은 롤백됩니다.
- 함수 연산 오류, 트랜잭션 자동 롤백
execute
SQL 명령을 실행하고 실행 결과를 반환합니다.
1NArray DbConnection.execute(String sql) async;
호출 매개변수:
- sql: 문자열, 문자열
결과 반환:
- NArray, 결과 레코드가 포함된 배열을 반환합니다. 요청이 UPDATE 또는 INSERT인 경우 반환된 결과에는 영향을 받은 및 insertId도 포함됩니다. mssql은 insertId를 지원하지 않습니다.
SQL 명령을 실행하고 실행 결과를 반환하며, 문자열은 매개변수에 따라 형식화될 수 있습니다.
1
2NArray DbConnection.execute(String sql,
...args) async;
호출 매개변수:
- sql: 문자열, 형식 문자열, 선택적 매개변수는 ?로 지정됩니다. 예: '테스트에서 선택: [id]=?'
- args: ..., 선택적 매개변수 목록
결과 반환:
- NArray, 결과 레코드가 포함된 배열을 반환합니다. 요청이 UPDATE 또는 INSERT인 경우 반환된 결과에는 영향을 받은 및 insertId도 포함됩니다. mssql은 insertId를 지원하지 않습니다.
createTable
데이터 테이블 생성
1DbConnection.createTable(Object opts) async;
호출 매개변수:
- opts: 객체, 매개변수 목록
dropTable
데이터 테이블 삭제
1DbConnection.dropTable(Object opts) async;
호출 매개변수:
- opts: 객체, 매개변수 목록
createIndex
데이터 테이블 인덱스 생성
1DbConnection.createIndex(Object opts) async;
호출 매개변수:
- opts: 객체, 매개변수 목록
dropIndex
데이터 테이블 인덱스 삭제
1DbConnection.dropIndex(Object opts) async;
호출 매개변수:
- opts: 객체, 매개변수 목록
insert
새 레코드 삽입
1Number DbConnection.insert(Object opts) async;
호출 매개변수:
- opts: 객체, 매개변수 목록
결과 반환:
- Number, 삽입이 포함된 ID를 반환하거나, 엔진이 이를 지원하지 않는 경우 0을 반환합니다.
find
지정된 조건에 따라 데이터 쿼리
1NArray DbConnection.find(Object opts) async;
호출 매개변수:
- opts: 객체, 매개변수 목록
결과 반환:
- NArray, 결과가 포함된 레코드를 반환합니다.
count
지정된 조건에 따라 데이터 레코드 수를 계산합니다.
1Integer DbConnection.count(Object opts) async;
호출 매개변수:
- opts: 객체, 매개변수 목록
결과 반환:
- Integer, 결과를 포함하는 레코드 수를 반환합니다.
update
지정된 조건에 따라 데이터 업데이트
1Integer DbConnection.update(Object opts) async;
호출 매개변수:
- opts: 객체, 매개변수 목록
결과 반환:
- Integer, 업데이트가 포함된 레코드 수를 반환합니다.
remove
지정된 조건에 따라 데이터 삭제
1Integer DbConnection.remove(Object opts) async;
호출 매개변수:
- opts: 객체, 선택적 매개변수 목록
결과 반환:
- Integer, 업데이트가 포함된 레코드 수를 반환합니다.
format
SQL 명령 형식을 지정하고 형식화된 결과를 반환합니다.
1
2String DbConnection.format(String method,
Object opts);
호출 매개변수:
- method: 문자열, 요청된 메소드를 지정합니다.
- opts: 객체, 선택적 매개변수 목록
결과 반환:
- String, 형식화된 SQL 명령을 반환합니다.
SQL 명령 형식을 지정하고 형식화된 결과를 반환합니다.
1
2String DbConnection.format(String sql,
...args);
호출 매개변수:
- sql: 문자열, 형식 문자열, 선택적 매개변수는 ?로 지정됩니다. 예: '테스트에서 선택: [id]=?'
- args: ..., 선택적 매개변수 목록
결과 반환:
- String, 형식화된 SQL 명령을 반환합니다.
toString
객체의 문자열 표현을 반환하며 일반적으로 "[Native Object]"를 반환하며 객체 자체의 특성에 따라 다시 구현될 수 있습니다.
1String DbConnection.toString();
결과 반환:
- String, 객체의 문자열 표현을 반환합니다.
toJSON
객체의 JSON 형식 표현을 반환하며 일반적으로 객체에 의해 정의된 읽을 수 있는 속성 컬렉션을 반환합니다.
1Value DbConnection.toJSON(String key = "");
호출 매개변수:
- key: 문자열, 사용되지 않음
결과 반환:
- Value, 직렬화 가능한 JSON을 포함하는 값을 반환합니다.