개요

데이터베이스 쿼리 실행을 관리하는 오브젝트입니다.

지원 환경

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

속성

async

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

지원 환경

속성 타입

문법 설정

bAsync ::= 'true' | 'false'

this.LiteDBConnection00.async = false;

참고

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


◆ Mobile 제약

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

id

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

지원 환경

속성 타입

문법

LiteDBStatement.id

문법 설정

참고

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

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

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

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

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

ldbconnection

데이터베이스 연결을 위해 LiteDBConnection 객체를 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.LiteDBStatement00.ldbconnection = this.LiteDBConnection00;

name

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

지원 환경

속성 타입

문법

LiteDBStatement.name[= strName]

문법 설정

참고

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

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

parameters

쿼리문에 사용된 파라미터를 배열로 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

Var arrParam = new Array();

arrParam.add(new LiteDBParameter());
this.LiteDBStatement00.parameters = arrParam;

참고

- parameters 속성은 Collection 접근방식을 사용할 수 있습니다.
  LiteDBStatement.parameters[0], LiteDBStatement.parameters["ChildFrame0"], LiteDBStatement.parameters.length 등의 방법을 사용합니다.

parent

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

지원 환경

속성 타입

문법

LiteDBStatement.parent

문법 설정

var objParent = this.LiteDBStatement00.parent;

참고

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

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

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

query

executeQuery() 또는 executeUpdate() 메소드 수행 시 사용되는 쿼리문을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- 쿼리 문장에 ":ParameterName" 형식으로 설정하면 LiteDBStatement 의 parameters 속성을 통해 접근할 수 있습니다.

메서드

close

LiteDBStatement 에서 수행중이던 동작을 중단하는 메소드입니다.

지원 환경

문법

LiteDBStatement.close()

파라미터

this.LiteDBStatement00.close();

참고

- 수행중이던 동작 중단에 성공하면 onsuccess 이벤트가 발생합니다.
  수행중이던 동작 중단에 실패하면 onerror 이벤트가 발생합니다.

executeQuery

Select 쿼리를 수행하는 메소드입니다.

지원 환경

문법

LiteDBStatement.executeQuery([strQuery])

파라미터

var strQuery = "select * from *";
this.LiteDBStatement00.executeQuery(strQuery);

반환

참고

- SQL문이 에러 없이 실행된 경우 onsuccess 이벤트가 발생합니다.
  onsuccess 이벤트 발생 시 LiteDBEventInfo 오브젝트의 returnvalue 속성값에서 SQL문 실행 결과 데이터를 Dataset 오브젝트로 확인할 수 있습니다.

executeUpdate

Insert, Update, Delete 쿼리문을 수행하는 메소드입니다.

지원 환경

문법

LiteDBStatement.executeUpdate([strQuery])

파라미터

var strQuery = "insert into .....";
this.LiteDBStatement00.executeUpdate(strQuery);

반환

참고

- SQL문이 에러 없이 실행된 경우 onsuccess 이벤트가 발생합니다.
  onsuccess 이벤트 발생 시 LiteDBEventInfo 오브젝트의 returnvalue 속성값에서 SQL문 실행으로 처리된 Row 숫자를 확인할 수 있습니다.

이벤트

onerror

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

지원 환경

문법

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

파라미터

onsuccess

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

지원 환경

문법

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

파라미터