콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

Aggrega Wasm Annotation-Transform 소켓 스키마

자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.

스키마 id: https://aggrega.ai/schemas/wasm-annotation-transform-v1beta1.schema.json

annotation-transform 역할에 연결된 거버넌스 플러그인이 소비하는(AnnotationTransformInput) 와이어 형태와 내보내는(AnnotationTransformOutput) 와이어 형태입니다. 이 역할은 resolve 이후, 어노테이션 확장 이전에 실행됩니다. 플러그인은 해석된 주입 대상과 Manifest에 등록된 바인딩 키를 읽고, 호스트가 해당 대상에 적용할 어노테이션 주입 목록을 반환합니다. 호스트는 확장 단계가 바인딩된 어노테이션을 Feature 연결로 바꾸기 전에 이 주입을 적용합니다. Go, Rust, TypeScript 페이로드 타입은 이 스키마로부터 plugin-ABI 패키지에 생성되므로 세 언어는 하나의 와이어를 읽고 씁니다. 게스트는 이 타입을 해당 패키지에서, 또는 플러그인 키트가 다시 내보내는 경우 플러그인 키트를 통해 가져옵니다.

다음 형태 중 하나

  • AnnotationTransformInput
  • AnnotationTransformOutput

정의

AnnotationTransformInput

호스트가 호출할 때마다 annotation-transform 플러그인에 전달하는 페이로드입니다. 현재 어노테이션을 포함한 해석된 주입 대상, Manifest에 등록된 어노테이션 바인딩 키, 그리고 연결 자체의 고정된 소스와 설정으로 구성됩니다.

속성타입필수설명
targetsAnnotationTarget[]예주입 대상입니다. 플러그인이 어노테이션을 주입할 수 있는 해석된 컴포넌트로, 각각 현재 어노테이션 집합을 포함하므로 플러그인은 기존 키를 덮어쓰지 않고 무엇을 추가할지 결정할 수 있습니다. 호스트가 결정론적으로 정렬합니다.
binding_keysstring[]예Manifest가 바인딩을 등록한 어노테이션 키로, 작성자 순서를 따릅니다. 키가 등록된 주입은 Feature 연결로 확장됩니다. 플러그인은 이 목록을 읽어 바인딩될 키만 주입합니다. 호스트는 주입이 등록된 키를 지정하도록 요구하지 않으며, 등록되지 않은 주입 어노테이션은 작성자가 작성한 바인딩되지 않은 어노테이션과 정확히 동일하게 동작합니다.
sourcesAnnotationSource[]아니요호스트가 읽어 플러그인에 그대로 전달하는 정의 파일로, 경로순으로 정렬된 목록입니다. 호스트는 바이트를 불투명한 내용으로 읽으며 파싱하지 않습니다. 연결이 소스를 선언하지 않으면 없습니다.
settingsobject아니요호스트가 플러그인에 그대로 전달하는 자유 형식 설정 객체입니다. 호스트는 그 내용을 파싱하거나 그에 따라 동작하지 않습니다. 연결이 설정을 선언하지 않으면 없습니다.

추가 속성은 허용되지 않습니다.

AnnotationTransformOutput

annotation-transform 플러그인이 내보내는 응답 형태로, 호스트가 지정된 대상에 적용할 어노테이션 주입 목록입니다. 호스트는 기존 대상 좌표에 대한 어노테이션 추가만 적용하며, 각 추가는 작성자가 해당 어노테이션에 쓸 수 있는 값, 즉 문자열 또는 하위 키 객체를 담습니다. 존재하지 않는 좌표를 지정하거나 그 밖의 형태의 값을 담은 주입은 빌드를 명시적으로 중단시킵니다.

속성타입필수설명
injectionsAnnotationInjection[]예순서대로 적용할 어노테이션 주입입니다. 각 주입은 기존 대상 좌표와 그곳에 추가할 어노테이션 키 및 값을 지정합니다.
errorstring아니요게스트가 실행되었지만 작업을 완료하지 못했을 때 설정되는 실패 메시지이며, 성공 시에는 없습니다. 호스트는 존재하는 error를 실패한 플러그인 호출로 표시합니다.

추가 속성은 허용되지 않습니다.

AnnotationTarget

플러그인이 어노테이션을 주입할 수 있는 해석된 주입 대상 하나입니다. 경계 경로와 컴포넌트 이름, 그리고 컴포넌트가 이미 가진 어노테이션 집합으로 구성됩니다.

속성타입필수설명
boundary_pathstring예Release에서 컴포넌트가 위치한, 슬래시로 구분된 경계 경로입니다.
component_namestring예경계 내에서의 컴포넌트 이름입니다.
annotationsstring 또는 object 또는 null의 맵예Release가 컴포넌트 자체에 쓰는 어노테이션으로, 어노테이션 키를 키로 하며 쓰인 순서대로 정렬됩니다. 각 값은 작성자가 쓴 그대로입니다. 문자열, 쓰인 순서를 유지하는 하위 키 객체, 또는 컴포넌트가 원래 상속할 어노테이션을 옵트아웃하는 경우 null입니다. 값과 관계없이 모든 키가 존재하므로, 플러그인은 컴포넌트가 이미 가진 어노테이션과 갖지 않은 어노테이션을 구별하여 없는 것만 추가할 수 있습니다.

추가 속성은 허용되지 않습니다.

AnnotationInjection

대상에 주입할 어노테이션 하나입니다. 대상 좌표와 어노테이션 키 및 그 값으로 구성됩니다.

속성타입필수설명
boundary_pathstring예대상 컴포넌트의, 슬래시로 구분된 경계 경로입니다. 호스트가 제공한 대상을 지정해야 하며, 알 수 없는 좌표는 빌드를 중단시킵니다.
component_namestring예대상 컴포넌트의 이름입니다. 호스트가 제공한 대상을 지정해야 하며, 알 수 없는 좌표는 빌드를 중단시킵니다.
annotation_keystring예대상 컴포넌트에 추가할 어노테이션 키입니다.
annotation_valuestring 또는 object예어노테이션의 값으로, JSON으로 전달됩니다. 문자열이거나, 키가 하위 키이고 항목이 구조화된 어노테이션의 하위 키 아래에 작성자가 쓸 수 있는 내용인 객체입니다. 호스트는 이 값을 Release에서 컴포넌트에 쓰인 같은 값을 읽을 때와 정확히 같은 방식으로 읽으며 객체의 키 순서를 유지합니다. 따라서 객체는 여러 하위 키를 한 번에 라우팅하는 바인딩에, 문자열은 하나를 라우팅하는 바인딩에 공급될 수 있습니다. null, 리스트, 숫자, 불리언, 하위 키가 없는 객체는 해당 주입을 명시하며 거부됩니다. 주입은 어노테이션을 추가할 뿐이며, 어노테이션을 제거하거나 옵트아웃하지 않습니다.

추가 속성은 허용되지 않습니다.

AnnotationSource

플러그인에 전달되는 정의 파일 하나입니다. 기본 이름 경로와 파일 내용으로 구성됩니다. 둘 다 그대로 전달되며, 호스트는 내용을 파싱하지 않습니다.

속성타입필수설명
pathstring예소스 파일의 기본 이름입니다. 호스트는 절대 호스트 경로가 아닌 기본 이름만 제공하므로 와이어는 이식 가능하고 결정론적입니다.
contentstring예불투명한 string으로 그대로 전달되는 소스 파일의 내용입니다.

추가 속성은 허용되지 않습니다.