컬럼 관리
컬럼을 만들고 화면 요소와 명령에 연결하는 방법을 알아봅니다.
MetaColumn은 모델(BindModel)의 기본 구성 단위입니다.
컬럼은 다음 세가지 방식으로 추가할 수 있습니다:
- 모델(BindModel) 객체에서 추가
- 명령(BindCommand) 객체에서 추가
- 서비스객체에서 추가
셀렉터 속성으로 컬럼 추가#
모델(BindModel) 객체에 컬럼을 추가하고, 해당 컬럼에 selector 속성을 지정합니다.
type KeyType = 'value' | 'text' | 'html' | 'attr.*' | 'prop.*' | 'css.*' | 'none';
type SelectorType = { key: string, type: KeyType };
type viewsType = 'valid' | 'bind' | 'output' | 'misc' | string /* 추가 뷰*/;
declare function addSelector(
columnName: string,
selector: string | SelectorType,
cmds?: string | string[],
views?: '$all' | viewsType | viewsType[],
bTable?: string | MetaTable
): void;
- addSelector() : 컬럼 객체 또는 이름으로 컬럼을 추가 selector 객체를 설정합니다.
columnName: 추가할 컬럼명 입니다.selectorstring:selector문자열을 지정합니다. ('value', 'text', 'html')SelectorType:selector객체를 지정합니다.
cmds: 명령(BindCommand) 이름을 지정합니다.views: 참조를 등록할 뷰(MetaView) 이름을 지정합니다.bTable: 컬럼이 등록될 테이블(MetaTable)을 지정합니다.
Tip
selector에 문자열 키를 지정하면, 해당 DOM 요소를 검사하여value,text,html중 적절한 타입이 자동으로 지정됩니다. 이 외의 타입을 사용하려면, 객체를 통해 직접 지정해야 합니다.
컬럼 추가하기#
기본테이블(first)의 columns 컬렉션에 컬럼을 추가합니다.
const bm = new BindModel();
// 컬럼 추가 및 selector 초기값 설정
bm.addSelector('aa', '#u_id');
bm.addSelector('bb', { key: '#u_name', type: 'value'});
// bm.first.columns.count === 2 (aa, bb)
// bm.columns.count === 2 (aa, bb)
aa 컬럼: 컬럼을 추가하고#u_idselector속성을 자동으로 지정합니다.bb 컬럼: 컬럼을 추가하고#u_nameselector속성을 명시적으로 지정합니다.
Tip
columns속성은first테이블의columns컬렉션을 가르킵니다.
컬럼 추가 및 매핑하기#
기본 테이블(first)의 columns 컬렉션에 컬럼을 추가한 후, 지정한 명령(BindCommand)의 뷰(MetaView)에 참조를 등록합니다.
const bm = new BindModel();
// 컬럼 추가 및 selector 초기값 설정
bm.addSelector('cc', '#addr', 'read');
bm.addSelector('dd', '#tel', 'read', ['valid', 'bind']);
// bm.columns.count === 2 (cc, dd)
// bm.cmd['read'].valid.columns.count === 2 (cc, dd)
// bm.cmd['read'].bind.columns.count === 2 (cc, dd)
// bm.cmd['read'].output.columns.count === 1 (cc)
cc 컬럼:#addrselector 로 컬럼을 추가하고, 'read' 명령의 모든 뷰에 참조를 등록합니다.- 모든 뷰 :
valid, bind, output, misc
- 모든 뷰 :
dd 컬럼:#telselector 로 컬럼을 추가하고, 'read' 명령의bind,valid뷰에 참조를 등록합니다.
모델에서 컬럼 추가#
모델(BindModel)객체에서 컬럼을 추가하고 초기값을 설정할 수 있습니다.
type viewsType = 'valid' | 'bind' | 'output' | 'misc' | string /* 추가 뷰*/;
declare function addColumn(
column: string | MetaColumn,
cmds?: '$all' | string | string[],
views?: '$all' | viewsType | viewsType[],
bTable?: string | MetaTable
): BindCommand;
declare function addColumnValue(
columnName: string,
value: string | number | boolean | { /* 컬럼속성 */ },
cmds?: string | string[],
views?: viewsType | viewsType[],
bTable?: string | MetaTable
): BindCommand;
- addColumn() : 컬럼 객체 또는 이름으로 빈 컬럼을 추가합니다.
column: 추가할 컬럼 객체 또는 컬럼명 입니다.cmds: 명령(BindCommand) 이름을 지정합니다.views: 참조를 등록할 뷰(MetaView) 이름을 지정합니다.bTable: 컬럼이 등록될 테이블(MetaTable)을 지정합니다.
- addColumnValue() : 지정한 이름으로 컬럼을 추가하고 초기값을 설정합니다.
columnName: 추가할 컬럼명 입니다.value: 컬럼의 초기값입니다.cmds: 명령(BindCommand) 이름을 지정합니다.views: 참조를 등록할 뷰(MetaView) 이름을 지정합니다.bTable: 컬럼이 등록될 테이블(MetaTable)을 지정합니다.
Tip
cmds값으로$all을 지정하면, 등록된 모든 명령(BindCommand)에 참조가 추가됩니다.views값으로$all또는undefined지정하면 모든 뷰(valid,bind,output,misc)에 참조가 추가됩니다.
컬럼 추가하기#
기본테이블(first)의 columns 컬렉션에 컬럼을 추가합니다.
const bm = new BindModel();
// 'aa' 컬럼 추가
bm.addColumn('aa');
// 'bb' 컬럼 추가 및 초기값 설정
bm.addColumnValue('bb', 10);
// bm.first.columns.count == 2
// bm.columns.count == 2
// bm.columns['aa'].value == ''
// bm.columns['bb'].value == 10
addColumn(): 컬럼을 추가합니다.addColumnValue(): 컬럼을 추가하고 초기값을 설정합니다.
Tip
columns속성은first테이블의columns컬렉션을 가르킵니다.
컬럼 추가 및 매핑하기#
기본 테이블(first)에 컬럼을 추가한 후, 지정한 명령(BindCommand)의 뷰(MetaView)에 참조를 등록합니다.
const bm = new BindModel();
// 'aa' 컬럼을 'cmd1'의 모든 뷰에 매핑
bm.addColumn('aa', 'cmd1');
// 'bb' 컬럼을 'cmd2', 'cmd3'의 'valid', 'bind'에 매핑
bm.addColumn('bb', ['cmd2', 'cmd3'], ['valid', 'bind']);
// 'cc' 컬럼을 모든 명령의 'output'에 매핑
bm.addColumn('cc', '$all', 'output');
// bm.columns.count == 3 ('aa', 'bb', 'cc')
// bm.command['cmd1'].valid.columns.count == 1 ('aa')
// bm.command['cmd1'].bind.columns.count == 1 ('aa')
// bm.command['cmd1'].output.columns.count == 2 ('aa', 'cc')
// bm.command['cmd2'].valid.columns.count == 1 ('bb')
// bm.command['cmd2'].bind.columns.count == 1 ('bb')
// bm.command['cmd2'].output.columns.count == 1 ('cc')
// bm.command['cmd3'].valid.columns.count == 1 ('bb')
// bm.command['cmd3'].bind.columns.count == 1 ('bb')
// bm.command['cmd3'].output.columns.count == 1 ('cc')
aa 컬럼: 빈 컬럼을 추가하고, 지정한('cmd1') 명령의 모든 뷰에 참조값을 매핑합니다.bb 컬럼: 빈 컬럼을 추가하고, 지정한('cmd1', 'cmd2') 명령의 특정('valid', 'bind') 뷰에 참조값을 매핑합니다.cc 컬럼: 빈 컬럼을 추가하고, 전체 명령의 특정('output') 뷰에 참조값을 매핑합니다.
Tip
addColumnValue()를 사용하면 컬럼 추가와 초기값 설정을 동시에 수행하고 매핑할 수 있습니다.
명령에서 컬럼 추가#
명령(BindCommand) 객체에서 컬럼을 추가하거나 초기값을 설정할 수 있습니다.
type viewsType = 'valid' | 'bind' | 'output' | 'misc' | string/* 사용자 정의 뷰 */;
declare function addColumn(
column: string | MetaColumn,
views?: '$all' | viewsType | viewsType[],
bTable?: string | MetaTable
): BindCommand;
declare function addColumnValue(
columnName: string,
value: string | number | boolean | { /*property*/ },
views?: viewsType | viewsType[],
bTable?: string | MetaTable
): BindCommand;
- addColumn() : 컬럼 객체 또는 이름으로 컬럼을 추가합니다.
column: 추가할 컬럼 객체 또는 컬럼명 입니다.views: 참조를 등록할 뷰(MetaView) 이름를 지정합니다.bTable: 컬럼의 등록되는 테이블(MetaTable)입니다.
- addColumnValue() : 컬럼을 추가하고 초기값을 설정합니다.
columnName: 추가할 컬럼명 입니다.value: 컬럼의 초기값입니다.views: 참조를 등록할 뷰(MetaView) 이름를 지정합니다.bTable: 컬럼의 등록되는 테이블(MetaTable)입니다.
Tip
views에'$all'을 지정하면, 모든 뷰(valid,bind,output,misc)에 참조가 추가됩니다.
컬럼 추가 및 매핑하기#
기본 테이블(first)에 컬럼을 추가하고, 대상 명령(BindCommand)의 뷰(MetaView)에 참조를 등록합니다.
const bm = new BindModel();
// 명령 추가
bm.addCommand('cmd1');
// 'aa' 컬럼을 'valid' 뷰에 매핑
bm.command['cmd1'].addColumn('aa', 'valid');
// 'bb' 컬럼을 'bind'와 'output' 뷰에 매핑
bm.command['cmd1'].addColumn('bb', ['bind', 'output']);
// 'cc' 컬럼을 모든 뷰에 매핑
bm.command['cmd1'].addColumn('cc', '$all');
// 'dd' 컬럼을 모든 뷰에 매핑
bm.command['cmd1'].addColumn('dd');
// bm.columns.count == 4 ('aa', 'bb', 'cc', 'dd')
// bm.command['cmd1'].valid.columns.count == 3 ('aa', 'cc', 'dd')
// bm.command['cmd1'].bind.columns.count == 3 ('bb', 'cc', 'dd')
// bm.command['cmd1'].output.columns.count == 3 ('bb', 'cc', 'dd')
aa 컬럼: 빈 컬럼을 추가하고, 지정한 명령의 특정 뷰('valid')에 참조값을 매핑합니다.bb 컬럼: 빈 컬럼을 추가하고, 지정한 명령의 특정 뷰('bind', 'output')에 참조값을 매핑합니다.cc 컬럼: 빈 컬럼을 추가하고, 지정한 명령의 전체 뷰에 참조값을 매핑합니다.dd 컬럼: 빈 컬럼을 추가하고, 지정한 명령의 전체 뷰에 참조값을 매핑합니다.
Tip '$all' 지시자는 명령의 모든 뷰(valid, bind, output, misc)와 함께, 사용자가 정의한 추가 출력 뷰까지 포함하여 참조합니다.
기존 컬럼 매핑하기#
이미 등록된 컬럼을 MetaView에 참조로 등록하거나 해제할 수 있습니다.
type TableNameType = string;
type ColumnType = string;
type FullColumnType = `${TableNameType}.${ColumnType}`;
type ColumnDotType = FullColumnType | ColumnType;
type ViewType = 'valid' | 'bind' | 'output' | 'misc' | string /* 사용자 정의 뷰 */;
declare function setColumn(
colName: ColumnDotType,
views: '$all' | ViewType | ViewType[],
bTable?: string | MetaTable
): void;
declare function release(
colName: string,
views?: ViewType | ViewType[]
): void;
- setColumn() : 기존에 등록된 컬럼을 지정한 뷰(
MetaView)에 참조로 등록합니다. - release() : 지정한 뷰(MetaView)에 참조를 해제합니다.
- 뷰를 지정하지 않으면, 해당 명령의 모든 뷰에서 컬럼이 해제됩니다.
이미 등록된 컬럼을 특정 뷰(MetaView)에 참조로 등록합니다.
const bm = new BindModel();
// 테이블 추가
bm.addTable('second');
// 기본 테이블(first)에 컬럼 추가
bm.addColumn('aa');
bm.addColumn('bb');
// 확장 테이블(second)에 컬럼 추가
bm['second'].columns.add('cc');
bm['second'].columns.add('dd');
// 명령 추가
bm.addCommand('test');
// 'aa'를 'valid' 뷰에 매핑
bm.command['test'].setColumn('aa', 'valid');
// 'bb'와 second 테이블의 'cc'를 'bind' 뷰에 매핑
bm.command['test'].setColumn(['bb', 'second.cc'], 'bind');
// second 테이블의 'dd'를 모든 뷰에 매핑
bm.command['test'].setColumn('second.dd', '$all');
// bm.first.columns.count == 2 ('aa', 'bb')
// bm.second.columns.count == 2 ('cc', 'dd')
// bm.command['test'].valid.columns.count == 2 ('aa', 'dd')
// bm.command['test'].bind.columns.count == 2 ('bb', 'cc')
// bm.command['test'].output.columns.count == 2 ('cc', 'dd')
- addTable() : 지정한 이름으로
MetaTable을 추가합니다. - columns.add() : 테이블에 컬럼을 추가합니다.
Tip 컬럼을 설정할 때는
테이블명 + . + 컬럼명표기법을 사용하여 특정 테이블의 컬럼을 지정할 수 있습니다.
컬럼 해제하기#
release() 메서드를 사용하여 특정 뷰 또는 모든 뷰에서 컬럼 참조를 해제합니다.
// 'valid' 뷰에서 'aa' 컬럼 참조 해제
bm.command['test'].release('aa', 'valid');
// 'bind' 뷰에서 'bb'와 'cc' 컬럼 참조 해제
bm.command['test'].release(['bb', 'cc'], 'bind');
// 모든 뷰에서 'dd' 컬럼 참조 해제
bm.command['test'].release('dd', '$all');
// bm.command['test'].valid.columns.count == 0
// bm.command['test'].bind.columns.count == 0
// bm.command['test'].output.columns.count == 0
- 컬럼을 해제할 때는 테이블명을 생략하고, 컬럼명만 지정하면 됩니다.
컬럼 및 명령 일괄 등록#
setMapping() 메서드는 컬럼과 명령별 역할(뷰)을 일괄 등록하는 기능을 제공합니다.
type ColumnKey = string; // 예: 'aa', 'first.bb', 'second.cc'
type CommandKey = string | '$all'; // 예: 'read', 'write', '$all'
type ViewEntry = 'valid' | 'bind' | 'output' | 'misc' | '$all';
type CommandMapping = Record<CommandKey, ViewEntry | ViewEntry[]> | {};
type MappingObject = Record<ColumnKey, CommandMapping>;
declare function setMapping(
mapping: MappingObject,
bTable?: string | MetaTable
): void;
bTable: 매핑 시 컬럼 키에 테이블명이 생략된 경우 기본적으로 사용할 테이블을 지정합니다. (기본값: 'first')
const bm = new BindModel(); // 기본 생성
bm.setMapping({
aa: {},
bb: { cmd1: '$all' }, // 전체 뷰 매핑
cc: { cmd2: ['valid', 'bind'] }
});
// bm.columns.count === 3 ('aa', 'bb', 'cc')
// bm.command['cmd1'].valid.columns.count === 1 ('bb')
// bm.command['cmd1'].bind.columns.count === 1 ('bb')
// bm.command['cmd1'].output.columns.count === 1 ('bb')
// bm.command['cmd2'].valid.columns.count === 1 ('cc')
// bm.command['cmd2'].bind.columns.count === 1 ('cc')
// bm.command['cmd2'].output.columns.count === 0
컬럼 키에 테이블명 + '.' + 컬럼명 형식을 사용하면, 컬럼은 기본 테이블이 아닌 해당 테이블에 등록됩니다.
const bm = new BindModel(); // 기본 생성
bm.setMapping({
'aa': {},
'first.bb': { cmd1: '$all' }, // 전체 뷰 매핑
'second.cc': { cmd2: ['valid', 'bind'] }
});
// bm.columns.count === 2 ('aa', 'bb')
// bm.first.columns.count === 2 ('aa', 'bb')
// bm.second.columns.count === 1 ('cc')
// bm.command['cmd1'].valid.columns.count === 1 ('bb')
// bm.command['cmd1'].bind.columns.count === 1 ('bb')
// bm.command['cmd1'].output.columns.count === 1 ('bb')
// bm.command['cmd2'].valid.columns.count === 1 ('cc')
// bm.command['cmd2'].bind.columns.count === 1 ('cc')
// bm.command['cmd2'].output.columns.count === 0
columns속성은first.columns컬렉션의 참조 속성입니다.
컬럼 주요 속성#
HTMLColumn은 모델(BindModel)에서 사용되며, MetaColumn을 상속하여 확장된 구성 요소입니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| value | string | number | boolean | 컬럼의 현재 값을 나타냅니다. |
| default | string | number | boolean | 컬럼의 기본 값을 설정합니다. |
| getter | () => any | value 값을 가져오는 getter 함수입니다. |
| setter | (val: any) => void | value 값을 설정하는 setter 함수입니다. |
| getFilter | (val: any) => any | value 값을 가져올 때 적용되는 filter 함수입니다. |
| setFilter | (val: any) => any | value 값을 설정할 때 적용되는 filter 함수입니다. |
| selector | { key: string, type: string} | 셀렉터를 정의합니다. |
| required | boolean | 필수 여부를 설정합니다. |
| constraints | {regex: RegExp, msg: string} <br>(val: any) => boolean | 컬럼의 제약 조건을 정의합니다.(복수 제약조건) |
| columnName | string | 컬럼의 이름을 나타냅니다. |
| alias | string | 컬럼의 별칭을 나타냅니다. |
| caption | string | 컬럼에 대한 설명을 제공합니다. |
컬럼값(value)#
컬럼 값(value)을 조회하거나 설정할 때는 다음과 같은 속성을 활용하여 다양한 처리를 수행할 수 있습니다.
default, getter,setter,getFilter,setFilter,selector
참조 : 컬럼값 호출 구조 #참조
제약 조건#
MetaColumn에 제약조건은 required와 constraints 속성을 통해 value 값을 검사할 수 있습니다.
type ConstraintType = { regex: RegExp, msg: string, match: boolean };
type FunctionType = (value: any) => boolean ;
type complexType = ConstraintType | FunctionType;
type constraints = complexType[] | complexType;
required: 필수값 여부를 지정합니다.true로 설정하면 필수값으로 지정되며, 기본값은false입니다.
constraints: 함수 또는 객체 타입으로 설정하여 제약 조건을 지정합니다.regex: 정규 표현식msg: 검사 실패 시 출력할 메시지match: 매칭 방식false로 설정하면 비매칭 조건으로 처리됩니다. (기본값:true)
제약조건 사용 빈도#
컬럼의 특성에 따라 조건을 혼합하여 구성할 수 있습니다. 기본값은 선택 조건입니다.
| 사용빈도 | required | constraints | 설명 |
|---|---|---|---|
| 50% | 선택값입니다. | ||
| 30% | true | 필수값입니다. | |
| 15% | {…} | Function | 선택값이며, value 에 제약조건이 있습니다. |
|
| 5% | true | {…} | Function | 필수값이며, value 에 제약조건이 있습니다. |
필수 조건#
컬럼 추가 시 초기값으로 required 속성을 설정합니다.
bm.addColumnValue('u_code', {
required: true
});
- 필수 조건으로 설정되며, 공백일 경우 실패 처리되고
cbFail콜백 함수가 호출됩니다.
매칭 제약 조건#
컬럼 추가 시 초기값으로 constraints 속성에 매칭할 정규식을 설정합니다.
bm.addColumnValue('u_code', {
constraints: {
regex: /[a-zA-Z0-9]{6,}/,
msg: "Please enter at least 6 chars."
}
});
- 값이 없으면 통과되며, 값이 있을 경우 사용자 정의 함수가 true를 반환해야 조건을 만족합니다.
- required의 기본값은 false이며, 이는 선택 입력 조건을 의미합니다.
비매칭 제약 조건#
컬럼 추가 시 초기값으로 constraints 속성에 비매칭 조건과 match 값을 false 로 설정합니다
bm.addColumnValue('u_code', {
constraints: { regex: /[0-9]/, msg: "No numbers", match: false }
});
- 선택 조건으로 동작하며, 값이 공백일 경우 유효성 검사를 통과합니다. 단, 값이 입력된 경우에는 지정된 정규식과 매칭되지 않아야 통과됩니다.
사용자 함수 제약 조건#
컬럼 추가 시 초기값으로 constraints 속성에 사용자 정의 함수를 설정합니다.
bm.addColumnValue('u_code', {
constraints: (val) => { return val.length > 8 }
});
- 선택 조건으로 설정되며, 값이 공백일 경우 유효성 검사를 통과합니다. 그러나 값이 입력된 경우에는, 사용자 정의 함수가 true를 반환해야 유효성 검사를 통과합니다.
혼합 제약 조건#
컬럼 추가 시 초기값으로 constraints 속성에 배열로 사용자 정의 함수와 정규식을 설정합니다.
bm.addColumnValue('u_code', {
constraints: [
{ regex: /# .{6}$/, msg: "Minimum 6 characters required" },
{ regex: /[0-9]/, msg: "Numbers are not allowed", match: false },
(val) => { return val.length >= 8 } // // Must be at least 8 characters
],
required: true
});
- 필수 조건으로 설정되며, 숫자를 제외한 문자의 길이가 6 이상 8 이하일 경우 유효성 검사를 통과합니다.
Tip 복수의
constraints를 설정하려면 배열로 추가할 수 있으며, 모든 조건이 충족되어야 성공으로 간주됩니다. 기존constraints에 조건을 추가하려면addConstraint()메서드를 사용하세요.
별칭(alias)#
별칭은 서버로 데이터를 전송하거나 서버에서 데이터를 받을 때 컬럼명과 데이터 키를 매칭하는 데 사용됩니다.
제약조건 별칭 이름은 기존의 컬럼명이나 다른 별칭과 중복될 수 없습니다.
데이터를 전송할 경우#
서버로 데이터를 전송할 때 별칭이 설정된 컬럼은 별칭 이름으로 전송됩니다.
const bm = new BindModel();
// 'create' 명령 추가
bm.addCommand('create');
// 'aa', 'bb' 컬럼 추가
bm.command['create'].addColumnValue('aa', 10);
bm.command['create'].addColumnValue('bb', 20);
// 'AA' 별칭 설정
bm.columns['aa'].alias = 'AA';
// 'create' 명령 실행
bm.cmd['create'].execute('SEND', '/user');
// SEND DATA
{ "AA": 10, "bb": 20 }
- 'aa' 컬럼은 전송시 'AA' 이름으로 전송됩니다.
데이터를 가져올 경우#
서버에서 데이터를 받을 때, 별칭을 기준으로 로우 데이터를 컬럼명과 매칭합니다.
// SERVER DATA
{ "AA": 10, "bb": 20, "cc": 30 }
const bm = new BindModel();
// 'list' 명령 추가
bm.addCommand('list', 'VIEW');
// 'list' 명령의 서버 경로 설정
bm.command['list'].url = '/user';
// 'aa', 'bb' 컬럼 추가
bm.command['list'].addColumnValue('aa', 10);
bm.command['list'].addColumnValue('bb', 20);
// 별칭 설정
bm.columns['aa'].alias = 'AA';
// 'list' 명령 실행
bm.cmd['list'].execute();
// bm.columns['aa'].value == 10
// bm.columns['bb'].value == 20
// bm.cmd['list'].output.rows[0]['AA'] == 10
// bm.cmd['list'].output.rows[0]['bb'] == 20
- 서버 응답 데이터 중 'AA'라는 이름의 항목은, 내부적으로 'aa' 컬럼에 값으로 설정됩니다.
Tip
MetaRow객체 내부에서 별칭은 속성값으로 참조됩니다.