확장 데이터 요소 설명은 ExtendedDataElementDescription 클래스의
인스턴스입니다.
이 타스크의 수행 목적 및 시기
이벤트 정의에 확장 데이터 요소 설명을 추가하려면
먼저 새 확장 데이터 요소 설명을 작성한 후 필드의 값을 설정해야
합니다. 중첩 확장 데이터 요소에 대해 설명하는 중첩(하위) 확장 데이터 요소 설명도
추가할 수 있습니다. 그런 다음, 확장 데이터 요소 설명을 이벤트 정의에
추가할 수 있습니다.
이 타스크의 단계
- 확장 데이터 요소 설명을 새로 작성하려면 확장 데이터
요소의 이름 및 유형을 지정하여 ExtendedDataElementDescription
인스턴스를 작성하십시오.
ExtendedDataElementDescription edeDesc =
new ExtendedDataElementDescription(name, type);
이 작성자의
매개변수는 다음과 같습니다. - name
- 확장 데이터 요소의 이름. 이는 설명하려는 확장 데이터 요소의
name 등록 정보의 값이어야 합니다.
- type
- 확장 데이터 요소의 데이터 유형. 유형은
org.eclipse.hyades.logging.events.cbe.ExtendedDataElement 클래스에 의해
정의되는 다음 정수 상수 중 하나여야 합니다.
- TYPE_BOOLEAN_ARRAY_VALUE
- TYPE_BOOLEAN_VALUE
- TYPE_BYTE_ARRAY_VALUE
- TYPE_BYTE_ARRAY
- TYPE_DATE_TIME_ARRAY_VALUE
- TYPE_DATE_TIME_VALUE
- TYPE_DOUBLE_ARRAY_VALUE
- TYPE_DOUBLE_VALUE
- TYPE_FLOAT_ARRAY_VALUE
- TYPE_FLOAT_VALUE
- TYPE_HEX_BINARY_VALUE
- TYPE_INT_ARRAY_VALUE
- TYPE_INT_VALUE
- TYPE_LONG_ARRAY_VALUE
- TYPE_LONG_VALUE
- TYPE_NO_VALUE_VALUE
- TYPE_SHORT_ARRAY_VALUE
- TYPE_SHORT_VALUE
- TYPE_STRING_ARRAY_VALUE
- TYPE_STRING_VALUE
리턴되는 오브젝트는 새 ExtendedDataElementDescription
오브젝트입니다.
- 확장 데이터 요소 설명의 필드를 채우십시오. ExtendedDataElementDescription 클래스는 확장 데이터 요소 설명에 있는
각 필드에 setter 메소드를 제공합니다. 이들 메소드에 대한 자세한 정보는
Javadoc API 문서를 참조하십시오. 예를 들어
확장 데이터 요소가 최소한 한 번 발생해야 함을 지정하려면
setMaxOccurs(int) 메소드를 사용하여 maxOccurs 등록 정보를
4로 설정합니다.
edeDesc.setMaxOccurs(4);
- 옵션: 하위 확장 데이터 요소 설명을 추가하려면
ExtendedDataElementDescription.addChild() 메소드를 사용하십시오.
edeDesc.addChild(childEdeDesc);
childEdeDesc
매개변수는 유효한 확장 데이터 요소 설명이어야 합니다.
- EventDefinition.addExtendedDataElementDescription() 메소드를 사용하여
이벤트 정의에 확장 데이터 요소 설명을 추가하십시오.
definition.addExtendedDataElementDescription(edeDesc);
이벤트 정의에 이미 같은 이름 및 경로의 다른 확장 데이터 요소 설명이 포함되어 있는 경우,
DescriptionExistsException 예외가 발생합니다.
다음 코드 단편은 확장 데이터 요소 설명을 작성하여 데이터로
채운 후, 이벤트 정의에 추가합니다.
ExtendedDataElementDescription edeDesc =
new ExtendedDataElementDescription("age", TYPE_SHORT_VALUE);
edeDesc.setMinOccurs(1);
edeDesc.setMaxOccurs(1);
// definition is a valid event definition
definition.addExtendedDataElementDescription(edeDesc);