EMF 및 UML 데이터 세트에 대한 추가 XPath 함수

다음 함수는 XPath 1.0 코어 함수 라이브러리 및 JET에서 지정하는 XPath 함수 외에 EMF 및 UML 데이터 세트에 대한 테이블 및 열 맵핑에 사용할 수 있습니다.
주: XPath문 내에서 콜렉션을 리턴하는 함수를 사용하는 경우, 콜렉션을 1 기본 색인 콜렉션으로 처리하십시오.

Collection<Diagram> getDiagrams (xpath)

이 함수는 하나 이상의 UML 요소에 대한 XPath 표현식을 사용하며 해당 요소가 포함하는 UML 다이어그램 콜렉션을 리턴합니다.

인수:
xpath: 하나 이상의 UML 요소에 대한 XPath 표현식
결과:
지정된 UML 요소가 포함하는 UML 다이어그램의 콜렉션
응용프로그램:
행 맵핑 페이지에서 함수를 사용하여 UML 다이어그램 콜렉션을 생성할 수 있습니다.
열 맵핑 페이지에서 함수를 사용하여 콜렉션을 자세히 조회할 수 있습니다(예: 콜렉션의 count 값 가져오기).
함수는 UML 드라이버에 대해 사용 가능합니다.
예제:
다음 예제는 모델의 모든 다이어그램을 리턴합니다.

     getDiagrams( //*)

맨 위로 돌아가기

Blob getDiagramImage (xpath, [resWidth], [resHeight])

이 함수는 다이어그램 요소에 대한 XPath 표현식을 사용하며 최대 해상도가 지정된 경우 이에 따라 다이어그램 이미지 데이터 블럽을 리턴합니다.

인수:
xpath: 다이어그램 요소에 대한 XPath 표현식
resWidth(선택사항): 최대 해상도 너비를 픽셀로 나타내는 int
resHeight(선택사항): 최대 해상도 높이를 픽셀로 나타내는 int
결과:
다이어그램 이미지 데이터 블럽
응용프로그램:
이미지 열을 설정하려면 열 맵핑 페이지에서 이 함수를 사용하십시오. 열을 동적 이미지 요소에 대한 입력으로 사용할 수 있습니다. 선택적 최대 해상도 매개변수를 사용하여 다이어그램 이미지를 렌더링하는 데 필요한 메모리를 제어하십시오. 해상도가 낮을수록 필요한 메모리가 적습니다. 그러나 이미지 품질도 낮을 수 있습니다.
두 가지 선택적 인수를 생략하거나 해당 인수에 -1 값을 지정하여 차원에 대해 최대 해상도가 지정되지 않았음을 표시할 수 있습니다. 보고서를 좀 더 융통성있게 작성하려면 해상도 값을 하드코드화하는 대신에 보고서 매개변수로 사용자에게 표시하십시오.
oda-diagrams 플러그인이 설치된 경우 이 함수는 UML 및 EMF 드라이버 둘 다에 대해 사용 가능합니다.
예제:
다음 예제는 제한사항이 없는 다이어그램 이미지를 리턴합니다.

     getDiagramImage(.)

다음 예제는 앞 예제와 동일한 결과를 리턴합니다.

     getDiagramImage(., -1, -1)

다음 예제는 800 x 600 픽셀의 최대 해상도를 갖는 다이어그램 이미지를 리턴합니다.

     getDiagramImage(., 800, 600)

다음 예제는 보고서 사용자가 지정하는 해상도를 갖는 다이어그램 이미지를 리턴합니다.

     getDiagramImage(., $resWidth, $resHeight)

맨 위로 돌아가기

String getDiagramHtmlImage (xpath, genPath, [tileWidth], [tileHeight])

이 함수는 다이어그램 요소에 대한 XPath 표현식을 사용하며 바둑판식 다이어그램 이미지를 렌더링하는 HTML 코드의 스니펫을 나타내는 문자열을 리턴합니다.

인수:
xpath: 다이어그램 요소에 대한 XPath 표현식
genPath: 바둑판식 생성에 사용된 파일 시스템의 임시 디렉토리 경로
tileWidth(선택사항): 바둑판식 다이어그램 이미지 조각의 최대 너비(픽셀)
tileHeight(선택사항): 바둑판식 다이어그램 이미지 조각의 최대 높이(픽셀)
응용프로그램:
이미지 열을 설정하려면 열 맵핑 페이지에서 이 함수를 사용하십시오. 열을 동적 텍스트(HTML) 요소에 대한 입력으로 사용할 수 있습니다. 함수는 다이어그램 이미지를 선택적 매개변수인 tileWidth 및 tileHeight로 크기를 지정한 바둑판식 조각으로 나누어 다이어그램 이미지를 렌더링합니다.
선택적 매개변수를 생략하거나 해당 매개변수에 기본 바둑판식 조각 크기를 표시하는 -1 값을 지정하여 할 수 있습니다. 바둑판식 이미지는 지정된 genPath 폴더에 생성됩니다. 이 폴더는 함수가 호출된 후 지워지지 않으며 반복된 호출은 경고 없이 이전 이미지를 겹쳐씁니다. 바둑판식 조각 크기를 사용하여 다이어그램을 렌더링하는 데 필요한 최대 메모리를 제어하십시오. 바둑판식 조각 크기가 작을수록 필요한 메모리가 적습니다. 그러나 바둑판식 조각의 수는 많아집니다.
이 함수는 페이지 크기를 제한하지 않는 HTML과 같은 보고서 출력 형식에만 사용하십시오.
보고서를 좀 더 융통성있게 작성하려면 genPath 및 바둑판식 조각 크기 값을 하드코드화하는 대신에 보고서 매개변수로 사용자에게 표시하십시오.
oda-diagrams 플러그인이 설치된 경우 이 함수는 UML 및 EMF 드라이버 둘 다에 대해 사용 가능합니다.
예제:
다음 예제는 기본 바둑판식 조각 크기를 사용하여 이미지를 나눕니다.

     getDiagramHtmlImage(., "c:/temp")

다음 예제는 앞 예제와 동일한 결과를 리턴합니다.

     getDiagramHtmlImage(., "c:/temp", -1, -1)

다음 예제는 1000 x 1000 픽셀 크기의 바둑판식 조각을 사용하여 이미지를 나눕니다.

     getDiagramHtmlImage(., "c:/temp", 1000, 1000)

맨 위로 돌아가기

String getXMIID (xpath)

이 함수는 요소에 대한 XPath 표현식을 사용하며 요소의 XMI ID 값을 리턴합니다.

인수
xpath: 요소에 대한 XPath 표현식
결과:
요소의 XMI ID 값
응용프로그램:
열 맵핑 페이지에서 이 함수를 사용하십시오.
이 함수는 UML 및 EMF 드라이버 둘 다에 대해 사용 가능합니다.
예제
getXMIID(.)
맨 위로 돌아가기

String getXMIType (xpath)

이 함수는 요소에 대한 XPath 표현식을 사용하며 요소의 XMI 유형 값을 리턴합니다.

인수:
xpath: 요소에 대한 XPath 표현식
결과:
요소의 XMI 유형
응용프로그램:
열 맵핑 페이지에서 이 함수를 사용하십시오.
이 함수는 UML 및 EMF 드라이버 둘 다에 대해 사용 가능합니다.
예제:
다음 예제는 현재 요소의 XMI 유형을 리턴합니다.
getXMItype(.)
맨 위로 돌아가기

String getURI (xpath)

이 함수는 단일 요소로 분석되는 XPath 표현식을 사용하며 해당 요소 URI의 문자열 표시를 리턴합니다. URI는 자원 전체에서 고유하므로 데이터 세트 결합에 사용하기에 적절한 열이 됩니다.

인수:
xpath: 단일 요소에 대한 XPath 표현식
결과:
요소의 URI 문자열
응용프로그램:
열 맵핑 페이지에서 이 함수를 사용하십시오.
이 함수는 UML 및 EMF 드라이버 둘 다에 대해 사용 가능합니다.
예제:
다음 예제는 현재 요소의 URI를 표시하는 문자열을 리턴합니다.

     getURI(.)

맨 위로 돌아가기

EObject resolveURI (uri)

이 함수는 지정된 URI를 분석하며 해당 요소를 리턴합니다.

인수:
uri: 요소의 URI
결과:
지정된 URI가 있는 요소
응용프로그램:
행 맵핑 페이지 또는 열 맵핑 페이지에서 이 함수를 사용하십시오.
이 함수는 UML 및 EMF 드라이버 둘 다에 대해 사용 가능합니다.
예제:
다음 예제는 데이터 세트 매개변수로 전달되는 요소의 URI를 분석합니다.

     resolveURI($element)

주:

resolveURI 함수를 사용할 때 행 맵핑 페이지에서 모든 데이터 소스 인스턴스 모델에 대해 평가 선택란 지우기를 고려하십시오. 결정은 표현식의 탐색에 따라 다릅니다.

  • 표현식에 모델 루트에서 시작하는 탐색이 포함된 경우 선택란을 지우지 마십시오. 이 인스턴스에서 선택란을 지우면 루트로부터의 탐색이 실패하고 예외가 발생합니다.
  • 기타 상황에서는 선택란을 지우십시오.

    일반적으로 데이터 세트의 행 맵핑 조회는 데이터 세트에 바인딩되어 있는 데이터 소스에 정의된 인스턴스 모델의 루프에서 실행됩니다. 즉, 조회 실행은 인스턴스 모델에서 각 모델에 대해 루핑되며 해당 모델에 대한 조회의 컨텍스트를 변경하고 결과 행 오브젝트를 수집합니다. 그러나 resolveURI 함수를 사용하면 resolveURI($class)/ownedAttribute 예제에서처럼 행 맵핑 조회에서 오브젝트 매개변수를 조회에 대한 컨텍스트로 대신 사용할 수 있습니다. 이러한 조회에서는 일반 조회에서처럼 모델의 루트로부터 탐색이 수행되지 않습니다. 이는 조회와 같은 실행의 결과가 컨텍스트 모델과 관계없이 동일함을 의미합니다. 이로 인해 결과 세트가 변경되지 않는 동안 조회가 모든 인스턴스 모델에 대해 되풀이해서 실행되므로 성능 문제점이 발생할 수 있습니다.

맨 위로 돌아가기

Collection<EObject> instanceOf (xpath, type)

이 함수는 XPath 표현식 및 유형 문자열을 사용하고 찾은 유형의 모든 요소로 구성된 콜렉션을 리턴합니다.

인수:
xpath: 하나 이상의 요소에 대한 XPath 표현식
유형: 규정된 메타 유형을 나타내는 (packagePrefix:typeName) 형식의 문자열
결과:
지정된 유형을 따르는 요소의 서브콜렉션
응용프로그램:
행 맵핑 페이지 또는 열 맵핑 페이지에서 이 함수를 사용하십시오.
열 맵핑 페이지에서 이 함수를 사용하여 요소 콜렉션을 리턴한 다음 추가 XPath 표현식(예: count)을 사용하여 단순 값을 조회하십시오.
이 함수는 UML 및 EMF 드라이버 둘 다에 대해 사용 가능합니다.
예제:
다음 예제는 uml:Class: 유형의 모든 요소를 리턴합니다.

     instanceOf(//*, "uml:Class")

맨 위로 돌아가기

Collection<EObject> oclQuery (xpath, boolean_ocl_expression)

이 함수는 XPath 표현식 및 부울 값을 갖는 OCL 조회 표현식을 사용하고 OCL 조회가 true를 리턴하는 대상 XPath 표현식의 요소 서브세트를 리턴합니다.

인수:
xpath: XPath 표현식
boolean_ocl_expression: 부울 OCL 조회 문자열
결과:
지정된 유형을 따르는 요소의 서브콜렉션
응용프로그램:
행 맵핑 페이지 또는 열 맵핑 페이지에서 이 함수를 사용하십시오.
열 맵핑 페이지에서 이 함수를 사용하여 요소 콜렉션을 리턴한 다음 추가 XPath 표현식(예: count)을 사용하여 단순 값을 조회하십시오.
이 함수는 UML 및 EMF 드라이버 둘 다에 대해 사용 가능합니다.
예제:
다음 예제는 uml::Dependency: 유형의 모든 요소를 리턴합니다.

     oclQuery(//*, "self.oclIsKindOf(uml::Dependency)")

맨 위로 돌아가기

Object oclEvaluate (xpath , ocl_expression)

이 함수는 단일 요소 및 OCL 조회 문자열에 대한 XPath 표현식을 사용하며 요소에 대한 조회 평가 후 결과를 리턴합니다.

인수:
xpath: 단일 요소에 대한 XPath 표현식
ocl_expression: OCL 조회 문자열
결과:
지정된 요소에 대한 OCL 표현식 평가 결과
응용프로그램:
행 맵핑 페이지 또는 열 맵핑 페이지에서 이 함수를 사용하여 요소에 대한 OCL 표현식을 평가하십시오.
이 함수는 UML 및 EMF 드라이버 둘 다에 대해 사용 가능합니다.
예제:
다음 예제는 모델의 모든 중첩된 패키지를 리턴합니다(행 맵핑 페이지):

     oclEvaluate(Model, "self.nestedPackages")

다음 예제는 요소 이름을 리턴합니다(열 맵핑 페이지):

     oclEvaluate(., "name")

맨 위로 돌아가기

Collection<Element> getElementsWithStereotype (xpath, stereotype)

이 함수는 하나 이상의 UML 요소에 대한 XPath 표현식 및 스테레오타입을 사용하고 주어진 스테레오타입의 요소 콜렉션을 리턴합니다.

인수:
xpath: 하나 이상의 UML 요소에 대한 XPath 표현식
스테레오타입: (profileName::stereotypeName) 형식의 완전한 스테레오타입 이름
결과:
지정된 스테레오타입이 적용되는 요소의 서브콜렉션
응용프로그램:
행 맵핑 페이지 또는 열 맵핑 페이지에서 이 함수를 사용하십시오.
열 맵핑 페이지에서 이 함수를 사용하여 요소 콜렉션을 가져온 다음 추가 XPath 표현식(예: count)을 사용하여 단순 값을 조회하십시오.
이 함수는 UML 드라이버에 대해서만 사용 가능합니다.
예제:
다음 예제는 비즈니스 목적으로 스테레오타입화된 모델의 모든 요소를 리턴합니다.

          getElementsWithSterotype(//*, "Business Modeling::BusinessGoal")

맨 위로 돌아가기

Object getStereotypePropertyValue (xpath, property)

이 함수는 단일 UML 요소에 대한 XPath 표현식 및 스테레오타입 특성을 사용하고 주어진 스테레오타입 특성의 값을 리턴합니다.

인수:
xpath: 단일 UML 요소에 대한 XPath 표현식
특성: (profileName::stereotypeName::propertyName) 형식의 완전한 스테레오타입 특성 이름
응용프로그램:
행 맵핑 페이지 또는 열 맵핑 페이지에서 이 함수를 사용하십시오.
이 함수는 UML 드라이버에 대해서만 사용 가능합니다.
예제:
다음 예제는 마침표가 표시하는 비즈니스 룰 유형을 나타내는 열거 리터럴을 리턴합니다.

     getStereotypePropertyValue( . , "Business Modeling::BusinessRule::Kind")

맨 위로 돌아가기
주: Eclipse 문서 또는 개발자 안내서에 대한 링크와 같은 일부 정보는 제품 도움말의 주제에서만 사용 가능합니다.

피드백