ODA Runtime Driver Plug-in Project

위클립스
이동: 둘러보기, 찾기

BIRT의 ODA Runtime Driver Plug-in Project는 Report 문서의 DataSource와 DataSet의 Type과 Property을 담당한다.

목차

[편집] 개요

이클립스의 새 파일을 작성할때 Business Intelligence and Reporting Tools 줄여 BIRT나 플러그인 프로젝트에서 제공되는 ODA Runtime Driver Plug-in Project의 확장점을 설명한다.

[편집] Extensions

Datasource extensions.png

[편집] dataSource

org.eclipse.datatools.connectivity.oda.dataSource

이 확장 점은 디자인 타임 및 데이터 응용 프로그램에서 런타임 데이터 소스 액세스 확장 을 지원 하는 데 사용됩니다. 각 확장은 org.eclipse.datatools.connectivity.oda.package에 정의된 Open Data Access (ODA) Java Runtime 인터페이스를 구현해야 합니다.

dataSource
design-time 및 런타임에 사용하기 위해 ODA 데이터소스 확장 타입 정의.
id 고유 ODA 소비자(consumer) 응용 프로그램(application)의 환경 내에 있는 ODA 데이터 소스 확장을 식별하는 정규화된 ID. 데이터 소스 디자이너 확장(data source designer extension)(확장점을 org.eclipse.datatools.connectivity.oda.design.ui.dataSource 구현) 이 드라이버를 사용 할 수 있는 경우, 이 속성의 값은 데이터 소스 요소(Element)에서 디자이너 확장의 id속성과 일치해야합니다.
odaVersion 이 드라이버를 개발하는 ODA 인터페이스의 버전. 이 요소는 필수이며 Major.Minor 또는 Major.Minor.Service(예 : 3.0 또는 2.0.1)의 형식을 요구합니다.
defaultDisplayName ODA 데이터 소스 확장의 표시 이름입니다. 이 값은 plugin.properties 메커니즘을 사용하여 지역화(localized) 할 수 있습니다. 디스플레이 이름이 없는 경우 확장 id를 기본값 사용. 이것은 그것들에 해당하는 데이터 소스 편집기(데이터 소스 UI 확장 지점)가 없을 때 ODA 데이터 소스 확장 목록 표시 중에 ODA 소비자(consumer) 응용 프로그램의 디자이너 도구로부터 사용할 수 있습니다.
driverClass org.eclipse.datatools.connectivity.oda.IDriver 인터페이스를 구현하는 콘크리트 클래스입니다. 이 ODA 런타입 드라이버의 진입 점입니다.
setThreadContextClassLoader true이면 ODA 런타임 확장 플러그인의 소비자(consumer)는 ODA 인터페이스 메서드를 호출 하기 전에 이 드라이버를 로드하는데 사용되는 하나의 스레드 컨텍스트 클래스 로더를 설정해야합니다. 모든 데이터 소스 플러그인 확장을 true로 설정하면 이 플래그와 우선권을 필요로 할것이며, 이 플러그인에 의해 구현되어 모든 데이터 소스 확장에 적용됩니다. 스레드 컨텍스트 클래스 로더가 설정 되는 것은 ODA 런타임 플러그인을 로드하는 데 사용된 OSGi 클래스 로더 인 경우는 부하가 추가 클래스를 차례로 플러그인을 사용하도록 설계 되어 있지 않습니다. 클래스 로딩이 필요한 경우 자체 URLClassLoader 및 적절한 스위치 스레드 컨텍스트 클래스 로더를 제공하기 위해 자신의 ODA 런타임 플러그인 구현에 달려있다.
overrideExplorerFiltering ODA 확장 탐색기 필터링 동작을 무시합니다. 기본값은 false 입니다. true로 설정하면 이 ODA 확장 탐색기 필터에 의해 제외 된 경우에도 이 확장은 항상 고객에게 표시됩니다.
dataSet
데이터 타입의 정의는 데이터 소스 확장에 의해 지원됩니다.
id 고유 이 ODA 데이터를 식별하는 정규화 된 ID 는ODA 소비자 응용 프로그램의 환경에서 정의를 설정합니다.
defaultDisplayName ODA 데이터의 표시 이름의 정의를 설정합니다. 값은 plugin.properties 메커니즘을 사용하여 지역화(localized) 할수 있습니다. 디스플레이 이름이 없을경우 id가 기본값이 됩니다.
dataTypeMapping
데이터 타입은 데이터 공급자의 기본 데이터 형식에서 하나 이상의 ODA 데이터 타입으로부터 매핑합니다. 드라이버는 선택적으로 기본 데이터 타입을 변환 할 수 있는 다른 ODA 데이터 타입의 목록을 제공 할 수 있습니다. 이 데이터 형식 매핑은 자신의 응용 프로그램 특정 데이터 타입에 대한 ODA 데이터 타입의 동일 한 셋(set)에서 맵에 대한 모든 ODA 소비자(consumer)를 촉진시킨다.
nativeDataType 기본 데이터 타입 이름(String). 정보로만 사용.
nativeDataTypeCode 기본 데이터 형식 코드(integer). 값은 드라이버의 ODA 인터페이스 구현에 반환된 데이터 타입 코드 중 하나와 일치해야 합니다.
odaScalarDataType 기본 ODA scalar(실수형) 데이터 타입은 기본형식에 매핑됩니다. 지원하는 ODA 데이터 유형은 다음과 같습니다. Date, Double, Integer, String, Time, Timestamp, Decima, Blob,Clob, Boolean 그리고 Object
alternativeOdaDataType
ODA의 scala(실수형) 데이터 타입으로 대체하는 매핑을 제공합니다.
odaScalarDataType 기본 타입은 드라이버에 의해 ODA scalar(실수형) 데이터 타입으로 변환 될 수 있습니다.
traceLogging
데이터 소스 확장을 위한 ODA 런타임 드라이버의 추적(trace) 로깅 설정을 구성합니다. 구성 값은 IDriver.setlogConfiguration 메서드의 드라이버 구현을 통해 전달 됩니다. 그것은 적절한 추적 로깅 속성 중 하나의 방법에 대해 각각의 ODA 드라이버에 달려있다.

참고 : 플러그인 PDE에 지정된 추적 로깅 구성. 디버그 추적 플래그가 “true”로 설정되어 있으면 옵션 파일이 요소에 구성들 보다 우선합니다. 상호 참조를 위해 아래에 나열된 ODA 플러그인 PDE 추적 옵션은 이 속성과 일치합니다. <plug-in Id>/debug = true/false <plug-in Id>/traceLogging/logLevel <plug-in Id>/traceLogging/logFileNamePrefix <plug-in Id>/traceLogging/logDirectory <plug-in Id>/traceLogging/logFormatterClass

logLevel 이름이나 드라이버의 로그 레벨 숫자 값. 로그 레벨의 이름과 해당 숫자 값 : “SERVERE” = 1000; “WARNING”=900; “INFO”=800; “CONFIG”=700; “FINE”=500; “FINER”=400; “FINEST”=300; “ALL”=0; “OFF”=1001 또는 높게
logFileNamePrefix 드라이버의 로그 파일 이름에 대한 문자열 접두어(string prefix)
logDirectory 로그 파일의 디렉토리
logFormatterClass 드라이버 특정 로깅 유틸리티에서 사용에 적합한 콘크리트 로그 포맷터(formatter)의 클래스 이름.
property
속성 값은 ODA 소비자(consumer) 응용 프로그램의 디자이너 도구를 사용하여 디자인 타임을 편집 할 수 있습니다. 그 값은 다음 런타임 동안 ODA 드라이버에 전달됩니다.
name 속성의 고유 이름
defaultDisplayName 기본 이름을 표시. 그 값은 plugin.properties 메커니즘을 사용에 의해 지역화 할수 있습니다.
type 속성의 타입. 속성 타입은 타입은 제한하는 열거에 나열된 값 중 하나가 될수 있습니다.
canlnherit Reserved
defaultValue 속성 값 아닌걸 설정할 경우 속성의 기본값이 입력됨.
isEncryptable 이 속성 값이 encryptable 인지 여부를 플래그로 나타냅니다. “true”로 설정하면 이 속성의 값이 암호화 되어야하는 ODA 소비자(consumer) 응용 프로그램에 나타냅니다.
allowsEmptyValueAsNull 이 플래그는 속성의 빈 값이 null 값으로 처리 할 수 있는지 여부를 나타냅니다. 기본값은 true 입니다. ODA 소비자(consumer)가 ODA 런타임 드라이버 속성의 값을 전달하면 이 속성 설정이 적용됩니다. 이 옵션 속성은 속성 값의 입력 컨트롤이 null 값을 지정 할 수 있는 방법을 제공하지 않는 경우를 수용하는데 사용할 수 있습니다.


propertyGroup
ODA 소비자(consumer) 응용 프로그램의 디자이너 도구에 하나 이상 속성의 그룹화. 그룹 속성은 표시 할수 있습니다. propertyGroup 아래에 나열된 모든 속성은 런타임에 scala(실수) 속성으로 처리됩니다.
name
defaultDisplayName 기본 표시 이름의 값은 plugin.properties 메커니즘을 사용하여 지역화(localized) 할 수 있습니다.
propertyGroup
ODA 소비자(consumer) 응용 프로그램의 디자이너 도구에 하나 이상 속성의 그룹화. 그룹 속성은 표시 할수 있습니다. propertyGroup 아래에 나열된 모든 속성은 런타임에 scala(실수) 속성으로 처리됩니다.
propertyVisibility 이 ODA 소비자(consumer) 응용 프로그램의 디자이너 도구의 속성 시트에 표표 될 때 명명된 속성의 가시성 수준을 설정 하는데 사용됩니다.
name 속성의 이름은 데이터 소스의 확장에 의해 정의 되거나 시스템 정의 속성입니다.
visibility 유효한 옵션은 다음과 같습니다. change, hide, lock
choice
속성의 선택 값.
name choice의 이름
value 주어진 선택이 선택되어 있으면 값은 사용 할 수 있습니다.
defaultDisplayName 기본 표시 이름입의 값은 plugin.properties 메커니즘을 사용하여 지역화(localized) 할 수 있습니다.
relationship
이 요소(Element)의 관계를 지정하는 선택 요소입니다.
type 이 확장 데이터 소스 또는 데이터 셋 요소가 relatedId 요소(Element)가 되는 관계의 타입입니다. 유효한 값은 다음과 같습니다.
replacedBy : 이 데이터 소스/ DataSet이 relatedId에 의해 사용되지 않고 대체 하도록 지정합니다. 그것은 예를 들어, 적절하게 적용 할 수 있는 ODA 호스트에 달려있다. 중지 된 확장의 참조를 마이그레이션 할 수 있으며, 런타임에 사용할 ODA 확장 제어 할 수 있습니다. 사용되지 않는 데이터 소스 타입은 이러한 새로운 프로필 인스턴스를 생성하는 등 ODA 디자인 UI 프레임 워크에서 제공 데이터 소스의 목록에서 기본적으로 숨겨져 있습니다.
wrapperOf : 이 DataSource/DataSet가 relateId 식별자의 wrapper를 지정합니다. wrapper 데이터소스 타입은 ODA 디자인 UI 프레임 워크에서 제공 가능한 데이터 소스 목록에서 기본적으로 숨겨져있습니다. Since : 3.1.2
relateId 관련 ODA DataSource 또는 DataSet 요소의 정규화 된 ID. replacedBy 타입의 값은 DataSource에 해당하는 것과 일치해야 합니다. ID 또는 dataset.id는 다른 ODA 드라이버의 ord 드라이버의 org.eclipse.datatools.connectity.oda.dataSource 확장에 정의 된 속성입니다.

[편집] connectionProfile

org.eclipse.connectivity.connectionProfile 원문

이 확장점은 연결 프로필의 다른 타입에 대한 지원을 추가하는 플러그인을 위한 장소를 제공합니다. 또한 정의된 확장점의 기능을 확장하는 것을 허용합니다.

category
이 요소(Element)는 카테고리를 식별하는데 사용됩니다. 카테고리는 그룹 관련 연결 프로필 타입(예: 데이터베이스)에 사용됩니다.
point 대상 확장점의 정규화 된 식별자(fully qualified identifier) , org.eclipse.datatools.connectivity.connectionProfile
id 확장 인스턴스의 선택적 식별자(optional identifier)
name 확장 인스턴스의 선택적 이름
connectionProfile
이 요소(Element)는 연결 프로필 타입을 정의 하는데 사용합니다.
id 이 연결 프로필의 id. 이 연결 프로필을 고유 식별이어야 한다.
name connectionProfile 타입의 보여주는 이름.
category 이 연결 프로필이 속한 카테고리입니다. 이 카테고리/ID로 매핑해야 합니다.
Deprecated configurationType 이 연결 프로필에 대한 구성 타입입니다. configurationType/ID로 매핑해야 합니다.
icon 플러그인 이미지 파일에 대한 상대 경로입니다. 이 이미지는 서버 보기에서 이 타입의 자원(resource)을 식별하는데 사용됩니다.
pingFactory connectionFactory의 “ping” 기능 구현하는데 사용됩니다.
propertiesPersistenceHook 플러그인이 속성 뿐 아니라 프레임워크에게 속성 집합(Property set)의 “완전성(Completeness)”에 대한 쿼리를 할 수 있는 장소를 제공하며, 프레임워크에 의해 지속해되야 지정할 수 있습니다. org.eclipse.datatools.connectivity.IPropertiesPersistenceHook에 대한 javadoc을 참조하시기 바랍니다. 기본적으로 지정된 모든 속성이 지속되고 속성 집합은 항상 “완료(Complete)”로 간주됩니다.
connectionFactory
이 요소는 연결 프로필 자원(resource)에 저장된 속성을 사용하여 서버에 연결을 만드는 데 사용할 수 있는 연결 팩토리를 정의합니다.
profile connectionProfile은 이 팩토리에서 지원합니다. 이 connectionProfile/id 를 참조해야 합니다. 이 필드를 지정하면, 이 팩토리는 지정된 프로필에게만 사용 할 수 있습니다. 그렇지않으면 이 팩토리는 지정된 팩토리가 있는 모든 프로필에 사용할 수 있습니다.
name connection factory의 이름
id connectionFactory에 대한 특별한 식별자. 이 id는 connectionFactory의 인스턴스를 검색 할 플러그인에 의해 사용될 수 있다.
class connectionFactory를 구현하는 클래스. 지정된 클래스는 IConnectionFactory 인스턴스이어야 합니다.
priority 우선 순위는 여러 connectionFactory을 특정 프로필에 등록 할 때 팩토리가 우선적으로 적용을 나타내는 정수 값입니다. 높은 숫자가 우선입니다. 우선 순위가 지정 되지 않은 경우 가장 낮은 우선 순위로 간주됩니다.
profileExtension
이 요소는 connectionProfile에 추가 속성을 설정하기 위한 지원을 제공하는 확장을 정의하는데 사용됩니다. 필요한 경우 이 확장 점을 구현할 때, 당신은 connectionFactory도 구현해야 합니다.
profile connectionProfile의 확장을 지원하는 것. connectionProfile/id 에 매핑해야 합니다.
name 이 확장의 이름
id 확장에 대한 고유 식별자
propertiesPersistenceHook 플러그인이 속성 뿐 아니라 프레임워크에게 속성 집합(property set)의 “완전성(completeness)”에 대한 쿼리를 할 수 있는 장소를 제공하며, 프레임워크에 의해 지속해야 지정할 수 있습니다. org.eclipse.datatools.connectivity.IPropertiesPersistenceHook에 대한 javadoc 를 참조하시기 바랍니다. 기본적으로 지정된 모든 속성이 지속되고 속성 집합은 항상 “완료(complete)”로 간주됩니다.
newWizard
이 요소(Element)는 connection profile wizard를 식별하는데 사용됩니다. 마법사가 연결프로필(connection profile)을 작성하는데 사용됩니다.
id new wizard의 고유 식별자
name
class 새로운 마법사를 구현하는 클래스입니다. 지정된 클래스는 IWizard의 인스턴스이어야 합니다. org.eclipse.datatools.connectivity.ui.wizards.NewConnectionProfileWizard가 이 연결 프로필(connection profile) 공급자가 확장하는 것에 기본 구현 의도입니다. org.eclipse.datatools.connectivity.ui.wizards.ConnectionProfileDetailPage는 위의 마법사 구현에 사용하기 위한 기본 마법사 페이지에서 구현한 것입니다.
icon 플러그인 이미지 파일에 대한 상대 경로입니다. 이 이미지는 새 마법사를 식별하는데 사용됩니다.
description 새 마법사의 설명
profile 연결 프로필이 새 마법사가 지원됩니다. connectionProfile/id를 참조해야 합니다.
category
suppressedProfile 연결 프로필이 새로운 마법사에 억압(suppressed). 이 connectionProfile/id를 참조해야 합니다.
wizardCategory
id 이 요소는 마법사 카테고리 식별자에 사용됩니다. 카테고리는 연결 프로필 마법사(예:데이터베이스)에 관련 그룹에 사용됩니다.
parentCategory 이 상위 카테고리의 id, 카테고리의 부모가 있는 경우
name 카테고리에 대해 이름 표시
icon 플러그인 이미지 파일에 대한 상대 경로입니다. 이 이미지는 새 마법사를 식별하는데 사용됩니다.
description 새 마법사 카테고리의 설명
wizardTitle 마법사 제목
wizardDescription 마법사 설명
connectionFactoryAdapter
이 요소는 뷰에서 사용하는 기본 열결 개체를 생성하기 위해 기존 연결 팩토리를 사용하여 서버에 뷰의 특정 유형을 대표하는 연결을 만드는데 사용할 수 있는 팩토리를 정의합니다.
name connectionFactory의 이름
class 이 연결 팩토리를 구현하는 클래스 입니다. 지정된 클래스는 IConnectionFactory의 인스턴스이어야 합니다.
id 이 연결 팩토리에 대한 고유 식별자. 이 id는 연결 팩토리의 인스턴스를 검색 할 플러그인에 의해 사용 될 수 있다.
factory 연결 팩토리 id가 있는 이 어댑터(adapter)가 적용합니다. 이 connectionFactory/@id 값과 일치 합니다.
profile 연결 프로필을 팩토리에서 지원. 이 connectionProfile/@id를 참조해야 합니다. 이 필드를 지정하면, 이 팩토리는 지정된 프로필만 사용할 수 있으며, 그렇지 않으면 팩토리는 지정된 팩토리에 있는 모든 프로필을 사용할수 있습니다.
개인 도구
이름공간
변수
행위
포탈
탐색
도움
도구모음