WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 운영 체제: Linux, Windows

MessageConsumer

응용프로그램은 메시지 처리자를 사용하여 목적지로 전송된 메시지를 수신합니다.

상속 계층 구조:
xms::PropertyContext
   |
   +----xms::MessageConsumer

MessageConsumer 오브젝트의 XMS 정의 등록 정보 목록은 MessageConsumer 등록 정보를 참조하십시오.

메소드

메소드 요약:
메소드 설명
close 메시지 목록을 닫습니다.
getHandle C 응용프로그램이 메시지 처리자에 액세스하기 위해 사용할 핸들을 가져옵니다.
getMessageListener 메시지 처리자에 등록된 메시지 리스너로 포인터를 가져옵니다.
getMessageSelector 메시지 처리자에 대한 메시지 선택자를 가져옵니다.
isNull MessageConsumer 오브젝트가 널 오브젝트인지 여부를 판별합니다.
receive 메시지 처리자의 다음 메시지를 수신합니다. 호출이 무기한으로 메시지를 기다리거나 메시지 처리자가 닫힐 때까지 기다립니다.
receive 메시지 처리자의 다음 메시지를 수신합니다. 호출이 지정된 기간 동안 메시지를 기다리거나 메시지 처리자가 닫힐 때까지 기다립니다.
receiveNoWait 메시지를 즉시 사용할 수 있는 경우 메시지 처리자의 다음 메시지를 수신합니다.
setMessageListener 메시지 리스너를 메시지 처리자에 등록합니다.

close – 메시지 처리자 닫기

인터페이스:
xmsVOID close();

메시지 목록을 닫습니다.

응용프로그램이 이미 닫힌 메시지 처리자를 닫으려고 하면 호출이 무시됩니다.

매개변수:
없음
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

getHandle – 핸들 가져오기

인터페이스:
xmsHMsgConsumer getHandle() const;

C 응용프로그램이 메시지 처리자에 액세스하기 위해 사용할 핸들을 가져옵니다.

매개변수:
없음
리턴값:
메시지 처리자의 핸들입니다.
스레드 컨텍스트:
임의
예외:
  • XMS_X_GENERAL_EXCEPTION

getMessageListener – 메시지 리스너 가져오기

인터페이스:
MessageListener * getMessageListener() const;

메시지 처리자에 등록된 메시지 리스너로 포인터를 가져옵니다.

메시지 리스너 사용에 대한 자세한 정보는 C++에서 메시지 리스너 사용을 참조하십시오.

매개변수:
없음
리턴값:
메시지 리스너에 대한 포인터입니다. 메시지 처리자에 메시지 리스너가 등록되어 있지 않을 경우 이 메소드가 널 포인터를 리턴합니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getMessageSelector – 메시지 선택자 가져오기

인터페이스:
String getMessageSelector() const;

메시지 처리자에 대한 메시지 선택자를 가져옵니다.

매개변수:
없음
리턴값:
메시지 선택자 표현식을 캡슐화하는 String 오브젝트입니다. 데이터 변환이 필수인 경우 이 매개변수는 변환 후 메시지 선택자 표현식입니다. 메시지 처리자에 메시지 선택자가 없으면 이 메소드는 널 String 오브젝트를 리턴합니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

isNull – 널 여부 확인

인터페이스:
xmsBOOL isNull() const;

MessageConsumer 오브젝트가 널 오브젝트인지 여부를 판별합니다.

매개변수:
없음
리턴값:
  • xmsTRUE - MessageConsumer 오브젝트가 널 오브젝트인 경우
  • xmsFALSE - MessageConsumer 오브젝트가 널 오브젝트가 아닌 경우
스레드 컨텍스트:
임의
예외:
  • XMS_X_GENERAL_EXCEPTION

receive – 수신

인터페이스:
Message * receive() const;

메시지 처리자의 다음 메시지를 수신합니다. 호출이 무기한으로 메시지를 기다리거나 메시지 처리자가 닫힐 때까지 기다립니다.

매개변수:
없음
리턴값:
Message 오브젝트에 대한 포인터입니다. 호출이 메시지를 기다리는 동안 메시지 처리자가 닫힌 경우 이 메소드는 널 Message 오브젝트에 대한 포인터를 리턴합니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

receive – 수신(대기 간격 지정)

인터페이스:
Message * receive(const xmsLONG waitInterval) const;

메시지 처리자의 다음 메시지를 수신합니다. 호출이 지정된 기간 동안 메시지를 기다리거나 메시지 처리자가 닫힐 때까지 기다립니다.

매개변수:
waitInterval(입력)
호출이 메시지를 기다리는 시간(밀리초)입니다. 대기 간격을 0으로 지정하면 호출이 메시지를 무기한으로 기다립니다.
리턴값:
Message 오브젝트에 대한 포인터입니다. 대기 간격 중 메시지가 도착하지 않았거나 호출이 메시지를 기다리는 동안 메시지 처리자가 닫힌 경우 이 메소드는 널 Message 오브젝트에 대한 포인터만 리턴하고 예외를 처리하지는 않습니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

receiveNoWait – 수신(대기하지 않음)

인터페이스:
Message * receiveNoWait() const;

메시지를 즉시 사용할 수 있는 경우 메시지 처리자의 다음 메시지를 수신합니다.

매개변수:
없음
리턴값:
Message 오브젝트에 대한 포인터입니다. 즉시 사용할 수 있는 메시지가 없는 경우 이 메소드는 널 Message 오브젝트에 대한 포인터를 리턴합니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

setMessageListener – 메시지 리스너 설정

인터페이스:
xmsVOID setMessageListener(const MessageListener *lsr);

메시지 리스너를 메시지 처리자에 등록합니다.

메시지 리스너 사용에 대한 자세한 정보는 C++에서 메시지 리스너 사용을 참조하십시오.

매개변수:
lsr(입력)
메시지 리스너에 대한 포인터입니다. 메시지 리스너가 이미 메시지 처리자에 등록되어 있을 경우 대신 널 포인터를 지정하여 등록을 취소할 수 있습니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

상속된 메소드


Reference topic

이용약관 | 피드백

Timestamp icon마지막 갱신 날짜: 3 Mar 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
이 Information Center는 Eclipse 기술 기반입니다. (http://www.eclipse.org 웹 사이트 참조)