Class: DomainVO

getTransformers()의 반환값. 키는 필드명, 값은 (value) => * 변환 함수다.

Constructors

Constructor

new DomainVO(): DomainVO;

Returns

DomainVO

Methods

checkSchema()

checkSchema(data): SchemaCheckResult;

REST API 응답 데이터가 이 VO의 스키마(static fields)와 일치하는지 검증한다.

DomainState.fromJSON() 에 vo 옵션을 함께 넘기면 내부적으로 호출된다. 불일치 항목은 콘솔에 경고/에러를 출력하지만 실행을 중단하지는 않는다.

검증 결과 해석

• missingKeys.length > 0 → VO에 선언됐지만 응답에 없음 → valid: false (서버 API 응답 구조가 변경됐거나, VO 선언이 잘못된 경우)
• extraKeys.length > 0 → 응답에 있지만 VO에 없음 → valid: true (경고만) (서버가 추가 필드를 내려주는 경우, 무시해도 무방)

콘솔 출력

• missingKeys: logError(ERR.VO_SCHEMA_MISSING_KEY(k)) — 환경 무관 에러 (silent 제외)
• extraKeys: devWarn(ERR.VO_SCHEMA_EXTRA_KEY(k)) — 개발 환경 전용 경고 (silent 제외)

DomainState.configure({ silent: true }) 설정 시 모든 출력이 억제된다.

Parameters

data

object

DomainState._getTarget()으로 읽은 REST API 응답 데이터 객체

Returns

SchemaCheckResult

{ valid, missingKeys, extraKeys }

Examples

const user = DomainState.fromJSON(jsonText, api, { vo: new UserVO() });
// 스키마 불일치 시 콘솔에 에러/경고 출력, 실행은 계속

const result = new UserVO().checkSchema({ userId: 'u1', name: 'Davi', extra: 'unknown' });
// result.valid        → true  (missingKeys 없음)
// result.missingKeys  → []
// result.extraKeys    → ['extra']  → 콘솔 경고

class SimpleVO extends DomainVO {}
new SimpleVO().checkSchema({ anything: 1 });
// → { valid: true, missingKeys: [], extraKeys: [] }  (검증 스킵)

---

getBaseURL()

getBaseURL(): string | null;

서브클래스에 선언된 static baseURL을 반환한다. 미선언이면 null을 반환한다.

DomainState.fromVO()에서 options.urlConfig가 없을 때 폴백 URL로 사용된다. normalizeUrlConfig({ baseURL: vo.getBaseURL() })로 정규화되어 DomainState._urlConfig에 저장된다.

Returns

string | null

static baseURL 값 또는 null

Examples

class UserVO extends DomainVO {
    static baseURL = 'localhost:8080/api/users';
}
new UserVO().getBaseURL(); // → 'localhost:8080/api/users'

// DomainState.fromVO() 내부에서:
// urlConfig 미입력 → normalizeUrlConfig({ baseURL: 'localhost:8080/api/users' })
// → { protocol: 'http://', host: 'localhost:8080', basePath: '/api/users' }

class SimpleVO extends DomainVO {}
new SimpleVO().getBaseURL(); // → null
// → DomainState.fromVO() 에서 urlConfig는 null → handler.getUrlConfig() 폴백

---

getTransformers()

getTransformers(): TransformerMap;

static fields에서 transform 함수를 추출하여 필드명 → 함수 맵으로 반환한다.

DomainState.fromVO() 내부에서 호출되어 DomainState._transformers에 주입된다. toPayload() 직렬화 직전에 실행되어 각 필드 값을 변환한다. transform 없는 필드는 포함되지 않는다.

Returns

TransformerMap

{ 필드명: (value) => * } 맵. static fields 미선언 시 빈 객체.

Example

class OrderVO extends DomainVO {
    static fields = {
        quantity: { default: '0', transform: Number },  // 문자열 입력 → 숫자 변환
        note:     { default: '' , transform: v => v.trim() }, // 공백 제거
        orderId:  { default: '' }, // transform 없음 → 맵에 포함되지 않음
    };
}
new OrderVO().getTransformers();
// → { quantity: [Function: Number], note: [Function] }

---

getValidators()

getValidators(): ValidatorMap;

static fields에서 validate 함수를 추출하여 필드명 → 함수 맵으로 반환한다.

DomainState.fromVO() 내부에서 호출되어 DomainState._validators에 주입된다. validate 없는 필드는 포함되지 않는다.

Returns

ValidatorMap

{ 필드명: (value) => boolean } 맵. static fields 미선언 시 빈 객체.

Example

class ProductVO extends DomainVO {
    static fields = {
        name:  { default: '', validate: v => v.trim().length > 0 },
        price: { default: 0,  validate: v => v >= 0 },
        tags:  { default: [] },  // validate 없음 → 맵에 포함되지 않음
    };
}
new ProductVO().getValidators();
// → { name: [Function], price: [Function] }

---

toSkeleton()

toSkeleton(): object;

서브클래스에서 선언한 static fields를 기반으로 기본값 골격 객체를 생성한다.

DomainState.fromVO() 내부에서 createProxy()의 초기 입력 객체로 사용된다.

처리 규칙

1. static fields가 없으면 인스턴스의 own property를 얕은 복사({ ...this })로 반환.
2. static fields가 있으면 각 필드의 default 값으로 객체를 구성한다.
3. default가 없으면 '' (빈 문자열)을 사용한다.
4. default가 object 또는 array이면 safeClone(val)로 deep copy. structuredClone()을 우선 사용하고 미지원 환경에서는 재귀 폴백으로 처리한다. Date·RegExp 타입 손실을 방지하고, 인스턴스 간 참조를 독립적으로 유지한다.

Returns

object

static fields의 default 값으로 구성된 초기 객체

Examples

class UserVO extends DomainVO {
    static fields = {
        name:    { default: '' },
        age:     { default: 0 },
        address: { default: { city: '', zip: '' } },
    };
}
new UserVO().toSkeleton();
// → { name: '', age: 0, address: { city: '', zip: '' } }
// address는 deep copy이므로 인스턴스마다 독립적인 객체

class SimpleVO extends DomainVO {}
const vo = new SimpleVO();
vo.userId = 'u1';
vo.toSkeleton(); // → { userId: 'u1' }  (own property 얕은 복사)