주요 구조Permalink

속성 관계Permalink

Class diagram

MetaTable 은 .NET 프레임웍의 DataTable 클래스의 구조와 사용법이 흡사합니다

상속 관계Permalink

Class diagram

주요 요소Permalink

속성Permalink

메소드Permalink

세부 설명Permalink

주요 속성Permalink

tableNamePermalink

테이블의 이름을 나타냅니다.

Copy codetype tableName = string;

columnsPermalink

테이블의 컬럼 컬렉션 입니다.

Copy codetype columns = MetaTableColumnCollection;

rowsPermalink

테이블의 데이터(로우) 컬렉션 입니다.

Copy codetype rows = MetaRowCollection;

_metaSetPermalink

테이블이 소속되어 있는 메타셋 입니다.

Copy codetype _metaSet = MetaSet;

_guidPermalink

객체의 고유 식별자 (GUID). 객체를 고유하게 식별합니다.

Copy codetype _guid = string;

_typePermalink

객체의 생성자 함수입니다. 객체가 생성될 때 사용된 함수입니다.

Copy codetype _type = Function;

주요 메소드Permalink

clone()Permalink

현재 객체의 깊은 복사본을 생성하여 반환합니다.

Copy codetype clone = () => MetaTable;

• return : 현재 객체의 복제본입니다.

copy()Permalink

대상 컬럼을 복사한다.

Copy codetype copy = (
    filter: (row, idx, entity) => boolean | string[], arguments<string>, 
    cols?: string[] | arguments<string>
) => MetaTable;

• filter :
  • Function 타입이면 컬럼을 선택하는 콜백함수를 입니다.
  • string[] 타입이면 복사할 컬럼명입니다.
• cols : 복사할 컬럼명입니다. filter 가 Function 타입일 때만 유효합니다.

예제 : filter, cols 을 사용하는 경우Permalink

Copy codevar table = new MetaTable('t1');

// ... 컬럼 추가, aa, bb, cc, ee 및 rows 추가 

var temp = table.copy(
    (row, idx, entity) => { return (idx % 2) > 0; },
    ['aa', 'bb']
);

• temp 에는 ‘aa’, ‘bb’ 컬럼의 로우 인덱스가 홀수인 경우만 복사됩니다.

예제 : cols 만 사용하는 경우Permalink

Copy codevar table = new MetaTable('t1');

// ... 컬럼 추가, aa, bb, cc, ee 및 rows 추가 

var temp = table.copy(
    ['aa', 'bb']
);

• temp 에는 ‘aa’, ‘bb’ 컬럼의 전체 로우가 복사됩니다.

acceptChanges()Permalink

현재 객체에 대한 모든 변경 사항을 커밋합니다. 변경사항 허락 : commit

Copy codetype acceptChanges = () => void;

rejectChanges()Permalink

현재 객체에 대한 모든 변경 사항을 롤백합니다. 변경사항 취소 : rollback

Copy codetype rejectChanges = () => void;

getChanges()Permalink

현재 객체에 대한 변경 사항 목록을 반환합니다.

Copy codetype getChanges = () => object[];

• return : 변경된 목록입니다.

transformSchema()Permalink

주어진 직렬화 객체를 스키마 객체로 변환합니다.

Copy codetype transformSchema = (oGuid: object) => object; // static

• oGuid : getObject()로 얻은 객체입니다.

clear()Permalink

엔티티의 모든 데이터를 초기화합니다.

Copy codetype clear = () => void;

reset()Permalink

엔티티의 컬럼 및 데이터를 초기화합니다.

Copy codetype reset = () => void;

newRow()Permalink

컬럼 구조에 맞는 새로운 로우를 생성하여 반환합니다.

Copy codetype newRow = () => MetaRow;

• return : 생성된 MetaRow 객체입니다.

  getValue()Permalink

컬럼의 value 값을 MetaRow 타입 객체로 반환합니다.

Copy codetype getValue = () => MetaRow;

• return : 컬럼의 값이 설정된 MetaRow 객체입니다.

setValue()Permalink

MetaRow 값을 컬럼의 value에 설정합니다.

Copy codetype setValue = (row: MetaRow) => void;

• row : 설정할 MetaRow 객체입니다.

merge()Permalink

주어진 엔티티와 현재 엔티티를 병합합니다.

Copy codetype merge = (target: BaseEntity, option: number, matchType?: boolean) => void;

• target : 병합할 대상 엔티티입니다.
• option : 병합 옵션입니다.
• matchType : 로우 유효성 검사 유무입니다. (기본값: false)

select()Permalink

주어진 콜백 함수에 따라 로우를 조회합니다.

Copy codetype select = (
    filter: (row, idx, entity) => boolean | string[], | arguments<string>,
    cols?: string[] | arguments<string>
) => MetaView;

• filter :
  • Function 타입이면 컬럼을 선택하는 콜백함수를 입니다.
  • string[] 타입이면 복사할 컬럼명입니다.
• cols : 복사할 컬럼명입니다. filter 가 Function 타입일 때만 유효합니다.

예제 : filter, cols 을 사용하는 경우Permalink

Copy codevar table = new MetaTable('t1');

// ... 컬럼 추가, aa, bb, cc, ee 및 rows 추가 

var temp = table.copy(
    (row, idx, entity) => { return (idx % 2) > 0; },
    ['aa', 'bb']
);

• temp 뷰 에는 ‘aa’, ‘bb’ 컬럼의 로우 인덱스가 홀수인 경우만 복사됩니다.

예제 : cols 만 사용하는 경우Permalink

Copy codevar table = new MetaTable('t1');

// ... 컬럼 추가, aa, bb, cc, ee 및 rows 추가 

var temp = table.copy(
    ['aa', 'bb']
);

• temp 뷰 에는 ‘aa’, ‘bb’ 컬럼의 전체 로우가 복사됩니다.

load()Permalink

주어진 객체를 현재 엔티티로 불러옵니다. 기존 데이터를 초기화하고 새로운 데이터를 로드합니다.

Copy codetype load = (obj: object | string, parse?: Function) => void;

• obj : 불러올 대상 객체입니다.
• parse : 파서 함수입니다. (선택)

output()Permalink

현재 엔티티를 직렬화된 문자열로 출력합니다.

Copy codetype output = (vOpt: number, stringify?: Function, space?: string) => string;

• vOpt : 옵션입니다. (0, 1, 2)
• stringify : 사용자 정의 파서 함수입니다. (옵션)
• space : 출력 시 사용할 공백 문자열입니다. (옵션)

read()Permalink

주어진 객체를 엔티티로 읽어옵니다. JSON 스키마 규칙을 따릅니다.

Copy codetype read = (obj: object, option: number) => void;

• obj : 읽어올 대상 객체입니다.
• option : 읽기 옵션입니다. (기본값: 3)

Copy codevar schema1 = { 
    table: { 
        columns: {}, 
        rows: {} 
    }
};

var schema1 = { 
    columns: {...}, 
    rows: {} 
};

readSchema()Permalink

주어진 스키마 객체를 현재 엔티티로 읽어옵니다.

Copy codetype readSchema = (obj: object, createRow?: boolean) => void;

• obj : 읽어올 스키마 객체입니다.
• createRow : true일 경우, row[0] 기준으로 컬럼을 추가합니다. (기본값: false)

readData()Permalink

주어진 객체에서 존재하는 로우만 읽어옵니다.

Copy codetype readData = (obj: object) => void;

• obj : 읽어올 객체입니다.

write()Permalink

현재 엔티티를 스키마 타입의 객체로 변환하여 반환합니다.

Copy codetype write = (vOpt?: number) => object;

• vOpt : 옵션입니다. (기본값: 0)
• return : 스키마 타입의 객체입니다.

writeSchema()Permalink

현재 엔티티의 스키마를 스키마 타입의 객체로 변환하여 반환합니다.

Copy codetype writeData = (vOpt?: number): object;

• vOpt : 옵션입니다. (기본값: 0)
• return : 스키마 타입의 객체입니다.

writeData()Permalink

현재 엔티티의 데이터를 스키마 타입의 객체로 변환하여 반환합니다.

Copy codetype writeData = (vOpt?: number) => object;

• vOpt : 옵션입니다. (기본값: 0)
• return : 스키마 타입의 객체입니다.

getObject()Permalink

현재 객체를 직렬화(guid 타입) 객체로 얻습니다. (순환참조는 $ref 값으로 대체됩니다.)

Copy codetype getObject = (vOpt?: number, owned?: object | Array<object>) => object;

• vOpt : 가져오기 옵션입니다. 기본값은 0 입니다.
  • opt=0 : 참조 구조(_guid:Yes, $ref:Yes)
  • opt=1 : 중복 구조(_guid:Yes, $ref:Yes)
  • opt=2 : 비참조 구조(_guid:No, $ref:No)
• owned : 현재 객체를 소유하는 상위 객체들입니다. 기본값은 빈객체 입니다.
• return : 직렬화된 객체를 반환합니다.

Copy codea.getObject(2) == b.getObject(2)

setObject()Permalink

직렬화(guid 타입) 객체를 현재 객체에 설정합니다. (객체는 초기화 됩니다.)

Copy codetype setObject = (oGuid: object, origin?: object) => void;

• oGuid : 직렬화할 guid 타입의 객체입니다.
• origin : 현재 객체를 설정하는 원본 객체입니다. 기본값은 oGuid 입니다.

equal()Permalink

현재 객체와 지정된 객체가 동일한지 비교합니다.

Copy codetype equal = (target: object) => boolean;

• return : 두 객체가 동일한지 여부를 반환합니다.

getTypes()Permalink

현재 객체의 생성자와 프로토타입 체인의 모든 생성자를 배열로 반환합니다.

Copy codetype getTypes = () => Array<Function>;

• return : 생성자 함수의 배열을 반환합니다.

Copy codeconst types = obj.getTypes();
console.log(types); // [Function: MetaObject]

instanceOf()Permalink

현재 객체가 지정된 타입의 인스턴스인지 확인합니다. (_UNION 포함)

Copy codetype instanceOf = (target: object | string) => boolean;

• target : 확인할 대상 타입 (객체 또는 문자열)입니다.
• return : 지정된 타입의 인스턴스인지 여부를 반환합니다.