링크 유형의 메타데이터
링크 유형(Link type)은 관계 자체의 식별 정보와 양쪽의 표시 및 탐색 정보를 가집니다. 각 쪽은 그쪽 객체 유형(Object type)으로 향하는 관계입니다.
| 항목 | 의미와 예 |
|---|---|
| ID | 앱 구성에서 관계를 참조하는 고유 식별자입니다. 예는 Employee와 Company 사이의 employee-employer입니다. |
| RID | 자동 생성한 리소스 식별자(Resource identifier)이며 오류 메시지에 사용합니다. |
| Status | active, experimental, deprecated 또는 example입니다. 기본값은 experimental이며 연결된 객체 유형과 외래 키의 상태 일관성 조건을 따릅니다. |
| Object types | 관계를 맺는 두 유형입니다. Employee와 Company 또는 같은 Employee 유형의 두 역할을 선택할 수 있습니다. |
| Cardinality | 각 방향에서 한 객체 또는 여러 객체가 연결되는 형태입니다. 일반적인 Employee와 Employer 예는 여러 직원이 한 회사에 연결됩니다. |
| Key | 외래 키(Foreign key)와 대상 기본 키(Primary key), 또는 조인 테이블(Join table)의 기본 키 쌍입니다. |
| Display name | 각 쪽의 단수 표시 이름입니다. Employee 쪽은 Employee, Company 쪽은 Employer일 수 있습니다. |
| Plural display name | 여러 대상을 표시할 쪽의 복수 이름입니다. 직원 쪽은 Employees이며 직원당 회사 하나인 회사 쪽에는 복수 표시가 필요하지 않습니다. |
| API name | 해당 방향으로 조회할 코드 이름입니다. 양쪽 이름을 따로 지정합니다. |
| Visibility | 각 쪽별 prominent, hidden 또는 normal을 지정합니다. 기본은 양쪽 모두 normal입니다. |
| Type classes | 앱에서 해석할 추가 메타데이터입니다. |
키와 관계의 예
Employee.employer ID가 Company.company ID를 참조하면 직원과 회사의 외래 키 관계를 만듭니다. Direct Report와 Manager가 서로 여러 명일 수 있는 모델이라면 양쪽이 many이며 직원 번호 쌍을 가진 조인 테이블로 관계를 나타낼 수 있습니다.
API 이름과 다중성
직원 쪽 API 이름을 employee로 정했다면 회사의 TypeScript v1 객체 변수 company에서 company.employee.all() 또는 allAsync()로 여러 직원을 읽습니다. 단일 연결은 get() 또는 getAsync()를 사용합니다. 단일 대상이 없으면 undefined일 수 있고 다중 대상이 없으면 빈 배열을 반환합니다.
한 관계의 반대 방향 때문에 다른 링크 유형을 만들지는 않습니다. 양방향 개념과 생성 시 이름 규칙을 확인합니다. active 링크의 삭제와 API 이름 변경은 편집 제한을 따릅니다.