CommandBar 구성요소

CommandBar 구성요소를 사용하여 응용프로그램에 조치 단추를 추가할 수 있습니다. 구성요소는 사용자 인터페이스에서 조치에 대한 단추를 작성하고 단추를 누를 때 작성되는 이벤트를 핸들링합니다.

이 단추는 BPCListHandler 클래스 또는 BPCDetailsHandler 클래스와 같은 com.ibm.bpe.jsf.handler.ItemProvider 인터페이스가 리턴하는 오브젝트에서 실행되는 함수들을 트리거합니다. CommandBar 구성요소는 bpe:commandbar 태그의 model 속성 값으로 정의된 항목 제공자를 사용합니다.

명령 처리 방법

응용프로그램의 사용자 인터페이스의 명령 막대 섹션에서 단추가 눌러지면, 다음과 같이 CommandBar 구성요소가 연관된 이벤트를 핸들링합니다.
  1. CommandBar 구성요소는 이벤트를 생성하는 단추에 지정된 com.ibm.bpc.clientcore.Command 인터페이스의 구현을 정의합니다.
  2. CommandBar 구성요소와 연관된 모델이 com.ibm.bpe.jsf.handler.ErrorHandler 인터페이스를 구현하는 경우, 이전 이벤트에서 오류 메시지를 제거하기 위해 clearErrorMap 메소드가 호출됩니다.
  3. ItemProvider 인터페이스의 getSelectedItems가 호출됩니다. 리턴된 항목 목록은 명령의 execute 메소드로 전달되며 이 명령이 호출되게 됩니다.
  4. CommandBar 구성요소는 JSP(JavaServer Faces) 탐색 대상을 결정합니다. action 속성이 bpe:commandbar 태그에 지정되지 않은 경우, execute 메소드의 리턴값은 탐색 대상을 지정합니다. action 속성이 JSF 메소드 바인딩으로 설정되면 이 메소드에서 리턴된 문자열이 탐색 대상으로 해석됩니다. 또한 action 속성은 명확한 탐색 대상을 지정할 수도 있습니다.

오류 핸들링

bpe:commandbar 태그의 action 속성으로 지정된 조치 메소드는 다음 중 한 가지가 충족되는 경우에 호출됩니다.
  • 예외가 생성되지 않음
  • 예외가 생성된 경우, 해당 예외는 ErrorsInCommandException 예외임
CommandBar 구성요소에서 오류 핸들링을 구성할 수 있는 몇 가지 방법이 있습니다.
  • CommandBar 구성요소의 어떠한 기능도 사용하지 않도록 결정할 수 있습니다. 예를 들어, 선택한 명령에 특정한 어떤 페이지에 오류를 표시하려면 명령 구현은 오류 페이지에 사용되는 페이지 bean에 오류를 발생시키고 전파하는 예외를 발견할 수 있습니다. bpe:commandbar 태그의 context 속성을 사용하여 명령 구현에 페이지 bean을 사용할 수 있습니다. 예외를 페이지 Bean에 설정한 후에 명령은 오류 페이지에 정의된 JSF 탐색 규칙의 문자열을 리턴합니다.
  • 사용자 인터페이스에서 command-bar 섹션 아래에 오류 메시지를 표시하려면 com.ibm.bpc.clientcore.exception.CommandBarMessage 표시자 인터페이스를 구현하는 예외 클래스를 작성하십시오. 이 인터페이스는 오류 메시지의 메시지 카탈로그를 제공합니다.
  • 항목 목록에서 명령을 사용하는 경우, 목록의 각 항목에 대해 명령 성공을 추적하기를 원할 수 있습니다. 오류를 추적하려면 조작이 실패한 항목에 대해 각각의 예외를 맵핑하십시오. CommandBar 구성요소는 ID(키로 사용)와 예외(값으로 사용)를 포함하는 맵을 CommandBar 구성요소에 대해 정의된 모델 오브젝트로 전달할 수 있습니다.

    이러한 메커니즘을 사용하려면 모델 오브젝트가 com.ibm.bpe.jsf.handler.ErrorHandler 인터페이스를 구현하고 해당 명령이 com.ibm.bpc.clientcore.exception.ErrorsInCommandException 예외를 생성해야 합니다. 그런 다음 CommandBar 구성요소가 예외에 포함된 맵을 오류 핸들러에 전달합니다. 이렇게 하면 오류가 발생해도 조치 메소드가 트리거되며 현재 보기는 새로 고쳐집니다. Business Process Choreographer 탐색기 응용프로그램은 이 메소드를 사용하여 목록에 예외를 표시합니다.

  • CommandBarMessage 인터페이스를 구현하지 않는 ClientException 예외를 생성하고 이 예외가 ErrorsInCommandException이 아닌 경우, CommandBar 구성요소는 이 예외를 응용프로그램의 구성 파일에 정의된 BPCError 오류 Bean으로 전파합니다. 이 오류 처리는 오류 페이지에서 계속됩니다.

ⓒ Copyright IBM Corporation 2005, 2006.
이 Information Center는 Eclipse 기술을 기반으로 합니다. (http://www.eclipse.org)