개체 DB 연결

데이터베이스 연결 개체는 데이터베이스 연결 세션을 설정하고 유지하는 데 사용됩니다.

계승

회원 속성

type

문자열, 현재 연결 데이터베이스 유형 쿼리

1
readonly String DbConnection.type;

멤버 함수

close

현재 데이터베이스 연결 닫기

1
DbConnection.close() async;

---

use

현재 데이터베이스 연결에 대한 기본 데이터베이스 선택

1
DbConnection.use(String dbName) async;

호출 매개변수:

• dbName: 문자열, 데이터베이스 이름 지정

---

begin

현재 데이터베이스 연결에서 트랜잭션 시작

1
DbConnection.begin(String point = "") async;

호출 매개변수:

• point: 문자열, 기본적으로 지정되지 않은 트랜잭션의 이름을 지정합니다.

---

commit

현재 데이터베이스 연결에서 트랜잭션 커밋

1
DbConnection.commit(String point = "") async;

호출 매개변수:

• point: 문자열, 기본적으로 지정되지 않은 트랜잭션의 이름을 지정합니다.

---

rollback

현재 데이터베이스 연결에서 트랜잭션 롤백

1
DbConnection.rollback(String point = "") async;

호출 매개변수:

• point: 문자열, 기본적으로 지정되지 않은 트랜잭션의 이름을 지정합니다.

---

trans

기능을 실행할 트랜잭션을 입력하고 기능 실행에 따라 제출 또는 롤백

1
Boolean DbConnection.trans(Function func);

호출 매개변수:

• func: 함수, 트랜잭션 방식으로 실행되는 함수

반환 결과:

• Boolean, 트랜잭션이 커밋되었는지 여부를 반환하고 일반 커밋이면 true, 롤백이면 false를 반환하고 트랜잭션에 오류가 있으면 오류가 발생합니다.

func를 실행하면 세 가지 결과가 나타납니다.

• 함수는 작업 종료 및 활성 반환을 포함하여 정상적으로 반환되며, 이때 트랜잭션이 자동으로 커밋됩니다.
• 이 함수는 false를 반환합니다. 이때 트랜잭션은 롤백됩니다.
• 함수가 잘못 실행되고 트랜잭션이 자동으로 롤백됩니다.

---

기능을 실행할 트랜잭션을 입력하고 기능 실행에 따라 제출 또는 롤백

1
2
Boolean DbConnection.trans(String point,
    Function func);

호출 매개변수:

• point: 문자열, 트랜잭션 이름 지정
• func: 함수, 트랜잭션 방식으로 실행되는 함수

반환 결과:

• Boolean, 트랜잭션이 커밋되었는지 여부를 반환하고 일반 커밋이면 true, 롤백이면 false를 반환하고 트랜잭션에 오류가 있으면 오류가 발생합니다.

func를 실행하면 세 가지 결과가 나타납니다.

• 함수는 작업 종료 및 활성 반환을 포함하여 정상적으로 반환되며, 이때 트랜잭션이 자동으로 커밋됩니다.
• 이 함수는 false를 반환합니다. 이때 트랜잭션은 롤백됩니다.
• 함수가 잘못 실행되고 트랜잭션이 자동으로 롤백됩니다.

---

execute

sql 명령을 실행하고 실행 결과를 반환

1
NArray DbConnection.execute(String sql) async;

호출 매개변수:

• sql: 문자열, 문자열

반환 결과:

• NArray, 결과 레코드가 포함된 배열을 반환합니다. 요청이 UPDATE 또는 INSERT인 경우 반환된 결과에도 영향을 받는 및 insertId가 포함됩니다. mssql은 insertId를 지원하지 않습니다.

---

sql 명령을 실행하고 실행 결과를 반환하고 매개변수에 따라 문자열을 형식화할 수 있습니다.

1
2
NArray DbConnection.execute(String sql,
    ...args) async;

호출 매개변수:

• sql: 문자열, 형식 문자열, 선택적 매개변수는 ?로 지정됩니다. 예: 'SELECT FROM TEST WHERE [id]=?'
• args: ..., 선택적 매개변수 목록

반환 결과:

• NArray, 결과 레코드가 포함된 배열을 반환합니다. 요청이 UPDATE 또는 INSERT인 경우 반환된 결과에도 영향을 받는 및 insertId가 포함됩니다. mssql은 insertId를 지원하지 않습니다.

---

createTable

데이터 테이블 생성

1
DbConnection.createTable(Object opts) async;

호출 매개변수:

• opts: 개체, 매개변수 목록

---

dropTable

데이터 테이블 삭제

1
DbConnection.dropTable(Object opts) async;

호출 매개변수:

• opts: 개체, 매개변수 목록

---

createIndex

데이터 테이블 인덱스 생성

1
DbConnection.createIndex(Object opts) async;

호출 매개변수:

• opts: 개체, 매개변수 목록

---

dropIndex

데이터 테이블 인덱스 삭제

1
DbConnection.dropIndex(Object opts) async;

호출 매개변수:

• opts: 개체, 매개변수 목록

---

insert

새 레코드 삽입

1
Number DbConnection.insert(Object opts) async;

호출 매개변수:

• opts: 개체, 매개변수 목록

반환 결과:

• Number, 삽입을 포함하는 ID를 반환하거나 엔진이 지원하지 않는 경우 0을 반환합니다.

---

find

지정된 조건에 따라 데이터 쿼리

1
NArray DbConnection.find(Object opts) async;

호출 매개변수:

• opts: 개체, 매개변수 목록

반환 결과:

• NArray, 결과가 포함된 레코드를 반환합니다.

---

count

지정된 조건에 따라 데이터 레코드 수를 계산합니다.

1
Integer DbConnection.count(Object opts) async;

호출 매개변수:

• opts: 개체, 매개변수 목록

반환 결과:

• Integer, 결과를 포함하는 레코드 수를 반환합니다.

---

update

지정된 조건에 따라 데이터 업데이트

1
Integer DbConnection.update(Object opts) async;

호출 매개변수:

• opts: 개체, 매개변수 목록

반환 결과:

• Integer, 업데이트가 포함된 레코드 수를 반환합니다.

---

remove

지정된 조건에 따라 데이터 삭제

1
Integer DbConnection.remove(Object opts) async;

호출 매개변수:

• opts: 객체, 선택적 매개변수 목록

반환 결과:

• Integer, 업데이트가 포함된 레코드 수를 반환합니다.

---

format

sql 명령을 형식화하고 형식화된 결과를 반환합니다.

1
2
String DbConnection.format(String method,
    Object opts);

호출 매개변수:

• method: 문자열, 요청된 메서드 지정
• opts: 객체, 선택적 매개변수 목록

반환 결과:

• String, 형식이 지정된 SQL 명령을 반환합니다.

---

sql 명령을 형식화하고 형식화된 결과를 반환합니다.

1
2
String DbConnection.format(String sql,
    ...args);

호출 매개변수:

• sql: 문자열, 형식 문자열, 선택적 매개변수는 ?로 지정됩니다. 예: 'SELECT FROM TEST WHERE [id]=?'
• args: ..., 선택적 매개변수 목록

반환 결과:

• String, 형식이 지정된 SQL 명령을 반환합니다.

---

toString

개체의 문자열 표현을 반환하고 일반적으로 "[네이티브 개체]"를 반환하며 개체는 고유한 특성에 따라 다시 구현할 수 있습니다.

1
String DbConnection.toString();

반환 결과:

• String, 객체의 문자열 표현을 반환합니다.

---

toJSON

객체의 JSON 형식 표현을 반환하고 일반적으로 객체에 의해 정의된 읽을 수 있는 속성 모음을 반환합니다.

1
Value DbConnection.toJSON(String key = "");

호출 매개변수:

• key: 문자열, 미사용

반환 결과:

• Value, 직렬화 가능한 JSON을 포함하는 값을 반환합니다.