개요

데이터베이스 연결 정보를 관리하고 제어하는 오브젝트입니다.

지원 환경

- LiteDBConnection 오브젝트는 SQLite 데이터베이스만 지원합니다.
  SQLite 데이터베이스에 대한 세부적인 기능은 https://www.sqlite.org/ 를 참고하세요.

속성

async

LiteDBConnection 에 요청된 작업이 동작되는 방식을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

bAsync ::= 'true' | 'false'

this.LiteDBConnection00.async = false;

참고

- async 속성값을 설정하지 않으면 true 로 적용됩니다.


◆ Mobile 제약

- 모바일 환경에서는 항상 비동기(Async) 로 동작합니다.

busytimeout

LiteDBConnection 에 연결된 데이터베이스에서 응답을 받기 위한 최대 대기시간을 설정하는 속성입니다.

지원 환경

속성 타입

문법

문법 설정

this.LiteDBConnection00.busytimeout = 1000;

참고

- busytimeout 속성값을 설정하지 않으면 60000 으로 적용됩니다.

- Android NRE 는 지원하지 않는 속성입니다.

datasource

LiteDBConnection 에 연결할 데이터베이스의 위치정보를 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.LiteDBConnection00.datasource = "%USERAPP%filename";

참고

- strPath 에 사용할 수 있는 Alias 실제경로입니다.



  * %USERAPP% : 애플리케이션에서 할당받은 공간, 다른 애플리케이션 접근불가
  * %SD_CARD% : 모바일 기기의 외부 저장소 공간, 다른 애플리케이션 접근가능

id

LiteDBConnection의 고유 식별자를 설정하는 속성입니다.

지원 환경

속성 타입

문법

LiteDBConnection.id

문법 설정

참고

-  addChild나 insertChild 메소드를 사용하여 컴포넌트를 등록할때 parent 가 자식컴포넌트를 구별하기 위한 고유한 key값입니다.

- 속성명이나 메소드명과 같은 예약어를 id 속성값으로 설정할 경우 오류가 발생할 수 있습니다.

- 컴포넌트의 속성은 아니지만 편의를 위하여 넥사크로 스튜디오에서 설정할 수 있는 기능이 제공됩니다.

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

name

LiteDBConnection 의 이름을 설정하는 속성입니다.

지원 환경

속성 타입

문법

LiteDBConnection.name[= strName]

문법 설정

참고

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

openflag

LiteDBConnection 에 데이터베이스를 연결하는 옵션을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.LiteDBConnection00.openflag = LiteDBConnection.openReadWrite;

참고

- openflag 속성값을 설정하지 않으면 LiteDBConnection.openReadWriteCreate 로 적용됩니다.

- 넥사크로 스튜디오는 "openReadWrite", "openReadWriteCreate" 의 Enum 형태로 값을 설정하면 Generate 시 상수값이 설정됩니다.

parent

LiteDBConnection 의 부모 오브젝트를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

LiteDBConnection.parent

문법 설정

var objParent = this.LiteDBConnection00.parent;

참고

- parent 속성은 일반적으로 컴포넌트가 속한 Form을 갖습니다.

- LiteDBConnection 이(가) Div 와 같은 컨테이너 컴포넌트에 자식으로 존재한다면 parent 속성은 해당 컨테이너 컴포넌트를 갖습니다.

- Calendar 와 같이 서브컨트롤이 존재하는 컴포넌트에서 서브컨트롤의 parent 속성은 해당 컴포넌트를 갖습니다.

preconnect

LiteDBConnection 생성 시 데이터베이스를 연결할지 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

bPreconn ::= 'true' | 'false'

this.LiteDBConnection00.preconnect = true;

참고

- preconnect 속성값을 설정하지 않으면 "false" 로 적용됩니다.

메서드

begin

LiteDBConnection 에 연결된 데이터베이스에 트랜잭션을 설정하는 메소드입니다.

지원 환경

문법

LiteDBConnection.begin()

파라미터

this.LiteDBConnection00.begin();

참고

- 트랜잭션 설정에 성공하면 onsuccess 이벤트가 발생합니다.
  트랜잭션 설정에 실패하면 onerror 이벤트가 발생합니다.

close

LiteDBConnection 에 연결된 데이터베이스를 닫는 메소드입니다.

지원 환경

문법

LiteDBConnection.close()

파라미터

this.LiteDBConnection00.close();

참고

- 데이터베이스 닫기에 성공하면 onsuccess 이벤트가 발생합니다.
  데이터베이스 닫기에 실패하면 onerror 이벤트가 발생합니다.

- 이미 닫혀있는 데이터베이스에 close() 메소드 수행 시 정상으로 처리되어 onsuccess 이벤트가 발생합니다.

commit

LiteDBConnection 에 연결된 데이터베이스에 트랜잭션 Commit 을 수행하는 메소드입니다.

지원 환경

문법

LiteDBConnection.commit()

파라미터

this.LiteDBConnection00.commit();

참고

- 트랜잭션 Commit 에 성공하면 onsuccess 이벤트가 발생합니다.
  트랜잭션 Commit 에 실패하면 onerror 이벤트가 발생합니다.

isConnected

LiteDBConnection 에 데이터베이스가 연결되어 있는지 확인하는 메소드입니다.

지원 환경

문법

LiteDBConnection.isConnected()

파라미터

this.LiteDBConnection00.isConnected();

참고

- 데이터베이스가 연결되어 있으면 onsuccess 이벤트가 발생합니다.
  데이터베이스가 연결되어 있지 않으면 onerror 이벤트가 발생합니다.

open

LiteDBConnection 에 데이터베이스를 연결하는 메소드입니다.

지원 환경

문법

LiteDBConnection.open( [strDataSource [,constOpenFlag]] )

파라미터

this.LiteDBConnection00.open();
this.LiteDBConnection00.open("%USERAPP%datasource");
this.LiteDBConnection00.open("%USERAPP%datasource", LiteDBConnection.openReadWrite);

반환

참고

- 데이터베이스 연결에 성공하면 onsuccess 이벤트가 발생합니다.
   데이터베이스 연결에 실패하면 onerror 이벤트가 발생합니다.

- 이미 연결되어 열려 있는 데이터베이스에 open() 메소드 수행 시 정상으로 처리되어 onsuccess 이벤트가 발생합니다.

- strDataSource 에 사용할 수 있는 Alias 실제경로입니다.



  * %USERAPP% : 애플리케이션에서 할당받은 공간, 다른 애플리케이션 접근불가
  * %SD_CARD% : 모바일 기기의 외부 저장소 공간, 다른 애플리케이션 접근가능

rollback

LiteDBConnection 에 연결된 데이터베이스에 트랜잭션 RollBack 을 수행하는 메소드입니다.

지원 환경

문법

LiteDBConnection.rollback()

파라미터

this.LiteDBConnection00.rollback();

참고

- 트랜잭션 RollBack 에 성공하면 onsuccess 이벤트가 발생합니다.
  트랜잭션 RollBack 에 실패하면 onerror 이벤트가 발생합니다.

- RollBack 을 수행할 대상이 없는 경우도 정상으로 처리되어 onsuccess 이벤트가 발생합니다.

이벤트

onerror

LiteDBConnection 에 요청된 작업이 실패했을 때 발생하는 이벤트입니다.

지원 환경

문법

onerror(obj:nexacro.LiteDBConnection,e:nexacro.LiteDBErrorEventInfo);

파라미터

onsuccess

LiteDBConnection 에 요청된 작업이 성공했을 때 발생하는 이벤트입니다.

지원 환경

문법

onsuccess(obj:nexacro.LiteDBConnection,e:nexacro.LiteDBEventInfo);

파라미터