MDatabase¶

MDb Framework 에 대한 필수 API 를 정의

Db API¶

로컬 데이터 베이스 기능에 대한 API 를 제공

DB 생성¶

M.db.create(options)¶

Changed in version 2.1.0.

Arguments

options (Object) – 설정 값
options.path (String) – 데이터베이스 파일 이름
options.callback (Function) –
실행 결과를 확인하는 함수
M.db.callback(status, name)¶
Arguments
status (String) – 실행 결과 ( SUCCESS: 성공 코드, FAIL: 실패 코드 )

name (String) – 데이터베이스 파일 이름

Surrogate Keys: 위 옵션키들과 같은 하위 버전 호환을 위한 대체 옵션 값들

source = path
name = path
db = path
database = path
finish = callback
onfinish = callback

Example:

M.db.create({
        path:'db_name',
        callback: function(status, path){
                console.log(status, path);
        }
});

M.db.create(name, callback)¶

Changed in version 2.1.0.

Arguments

name (String) – 데이터베이스 파일 이름
callback (Function) – 실행 결과를 확인하는 함수

데이터베이스 파일을 생성한다.

Example:

M.db.create('db_name', function(status, name){
        console.log(status, name);
});

DB 닫기¶

M.db.close(options)¶

Changed in version 2.1.0.

Arguments

options (Object) – 설정 값
options.path (String) – 데이터베이스 파일 이름
options.callback (Function) –
실행 결과를 확인하는 함수
M.db.callback(status, name)¶
Arguments
status (String) – 실행 결과 ( SUCCESS: 성공 코드, FAIL: 실패 코드 )

name (String) – 데이터베이스 파일 이름

Surrogate Keys: 위 옵션키들과 같은 하위 버전 호환을 위한 대체 옵션 값들

source = path
alias = path
name = path
db = path
database = path
finish = callback
onfinish = callback

Example:

M.db.close({
        path:'db_name',
        callback: function(status, path){
                console.log(status, path);
        }
});

M.db.close(name, callback)¶

Changed in version 2.1.0.

Arguments

name (String) – 데이터베이스 파일 이름
callback (Function) – 실행 결과를 확인하는 함수

데이터베이스 파일을 닫는다.

Example:

M.db.close('db_name', function(status, name){
        console.log(status, name);
});

DB 열기¶

M.db.open(options)¶

Changed in version 2.1.0.

Arguments

options (Object) – 설정 값
options.path (String) – 데이터베이스 파일 이름
options.callback (Function) –
실행 결과를 확인하는 함수
M.db.callback(status, name)¶
Arguments
status (String) – 실행 결과 ( SUCCESS: 성공 코드, FAIL: 실패 코드 )

name (String) – 데이터베이스 파일 이름
Surrogate Keys: 위 옵션키들과 같은 하위 버전 호환을 위한 대체 옵션 값들
- source = path
- alias = path
- name = path
- db = path
- database = path
- finish = callback
- onfinish = callback

Example:

M.db.open({
        path:'db_name',
        callback: function(status, path){
                console.log(status, path);
        }
});

M.db.open(name, callback)¶

Changed in version 2.1.0.

Arguments

name (String) – 데이터베이스 파일 이름
callback (Function) – 실행 결과를 확인하는 함수

데이터베이스 파일을 연다.

Example:

M.db.open('db_name', function(status, name){
        console.log(status, name);
});

DB 삭제¶

M.db.remove(options)¶

Changed in version 2.1.0.

Arguments

options (Object) – 설정 값
options.path (String) – 데이터베이스 파일 이름
options.callback (Function) –
실행 결과를 확인하는 함수
M.db.callback(status, name)¶
Arguments
status (String) – 실행 결과 ( SUCCESS: 성공 코드, FAIL: 실패 코드 )

name (String) – 데이터베이스 파일 이름

Surrogate Keys: 위 옵션키들과 같은 하위 버전 호환을 위한 대체 옵션 값들

source = path
alias = path
name = path
db = path
database = path
finish = callback
onfinish = callback

Example:

M.db.remove({
        path:'db_name',
        callback: function(status, path){
                console.log(status, path);
        }
});

M.db.remove(name, callback)¶

Changed in version 2.1.0.

Arguments

name (String) – 데이터베이스 파일 이름
callback (Function) – 실행 결과를 확인하는 함수

데이터베이스 파일을 삭제한다.

Example:

M.db.remove('db_name', function(status, name){
        console.log(status, name);
});

DB 쿼리¶

M.db.execute(options)¶

Changed in version 2.1.0.

Arguments

options (Object) – 설정 값
options.path (String) – 데이터베이스 파일 이름
options.sql (String) – SQL 구문 (SQL Lite)
options.multiple (boolean) – 다중 쿼리 실행 여부 (default : false), 다중 쿼리 실행시 sql은 “;”로 구분
options.callback (Function) –
실행 결과를 확인하는 함수
M.db.callback(status, result, name)¶
Arguments
status (String) – 실행 결과 ( SUCCESS: 성공 코드, FAIL: 실패 코드 )

result (Object) – result 객체, 쿼리 실행 결과

result.column_count (int) – 행 개수

result.row_count (int) – 결과 레코드 수

result.row_list (String) – 레코드 데이터

name (String) – 데이터베이스 파일 이름

Surrogate Keys: 위 옵션키들과 같은 하위 버전 호환을 위한 대체 옵션 값들

source = path
alias = path
name = path
db = path
database = path
query = sql
finish = callback
onfinish = callback

Example:

DataBase 실행 (Select)

var query = 'SELECT * FROM books';
M.db.execute({
        path:'db_name',
        sql: query,
        callback: function(status, result, name){
                console.log(status, path);
        }
});

DataBase 실행 (Insert multiple)

var query = 'INSERT INTO books (title, author) values ("제목1", "작가1");INSERT INTO books (title, author) values ("제목2", "작가2")';
M.db.execute({
        path:'db_name',
        sql: query,
        multiple: true,
        callback: function(status, result, name){
                console.log(status, path);
        }
});

M.db.execute(name, sql, callback)¶

Changed in version 2.1.0.

Arguments

name (String) – 데이터베이스 파일 이름
sql (String) – SQL 구문 (SQL Lite)
callback (Function) – 실행 결과를 확인하는 함수

데이터베이스 sql 쿼리를 실행한다.

Example:

DataBase 실행 (Create)

var query = 'CREATE TABLE books (id INTEGER PRIMARY KEY, title varchar(255) not null, author varchar(255) not null )'
M.db.execute('db_name', query, function(status, result, name){
        M.tool.log(status, result, name);
        alert( status + ", " + JSON.stringify(result) + ", " + name );
});

DataBase 실행 (Insert)

var query = 'INSERT INTO books (title, author) values ("제목1", "작가1")';
M.db.execute('db_name', query, function(status, result, name){
        M.tool.log(status, result, name);
        alert( status + ", " + JSON.stringify(result) + ", " + name );
});

DataBase 실행 (Select)

var query = 'SELECT * FROM books';
M.db.execute('db_name', query, function(status, result, name){
        console.log(status, result, name);
});