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

MessageProducer

응용프로그램은 메시지 생성자를 사용하여 메시지를 목적지로 전송합니다.

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

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

메소드

메소드 요약:
메소드 설명
close 메시지 생성자를 닫습니다.
getDeliveryMode 메시지 생성자가 전송한 메시지의 기본 전달 모드를 가져옵니다.
getDestination 메시지 생성자에 대한 목적지를 가져옵니다.
getDisableMsgID 메시지 생성자가 전송한 메시지에 포함되는 메시지 ID가 수신 응용프로그램에 필요한지 여부에 대한 표시기를 가져옵니다.
getDisableMsgTS 메시지 생성자가 전송한 메시지에 포함되는 시간 소인이 수신 응용프로그램에 필요한지 여부에 대한 표시기를 가져옵니다.
getHandle C 응용프로그램이 메시지 생성자에 액세스하는 데 사용하는 핸들을 가져옵니다.
getPriority 메시지 생성자가 전송한 메시지의 기본 우선순위를 가져옵니다.
getTimeToLive 만기될 때까지의 메시지 보존 시간을 가져옵니다.
isNull MessageProducer 오브젝트가 널 오브젝트인지 여부를 판별합니다.
send 메시지 생성자가 작성되었을 당시에 지정된 목적지로 메시지를 전송합니다. 메시지 생성자의 기본 전달 모드, 우선순위 및 TTL(Time to Live)을 사용하여 메시지를 전송합니다.
send 메시지 생성자가 작성되었을 당시에 지정된 목적지로 메시지를 전송합니다. 지정된 전달 모드, 우선순위 및 TTL(Time to Live)을 사용하여 메시지를 전송합니다.
send 사용 중인 메시지 생성자에 대한 목적지를 메시지 생성자 작성 당시에 지정하지 않은 경우 지정된 목적지로 메시지를 전송합니다. 메시지 생성자의 기본 전달 모드, 우선순위 및 TTL(Time to Live)을 사용하여 메시지를 전송합니다.
send 사용 중인 메시지 생성자에 대한 목적지를 메시지 생성자 작성 당시에 지정하지 않은 경우 지정된 목적지로 메시지를 전송합니다. 지정된 전달 모드, 우선순위 및 TTL(Time to Live)을 사용하여 메시지를 전송합니다.
setDeliveryMode 메시지 생성자가 전송한 메시지의 기본 전달 모드를 설정합니다.
setDisableMsgID 메시지 생성자가 전송한 메시지에 포함되는 메시지 ID가 수신 응용프로그램에 필요한지 여부를 나타냅니다.
setDisableMsgTS 메시지 생성자가 전송한 메시지에 포함되는 시간 소인이 수신 응용프로그램에 필요한지 여부를 나타냅니다.
setPriority 메시지 생성자가 전송한 메시지의 기본 우선순위를 설정합니다.
setTimeToLive 만기될 때까지의 기본 메시지 보존 시간을 설정합니다.

close – 메시지 생성자 닫기

인터페이스:
xmsVOID close();

메시지 생성자를 닫습니다.

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

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

getDeliveryMode – 기본 전달 모드 가져오기

인터페이스:
xmsINT getDeliveryMode() const;

메시지 생성자가 전송한 메시지의 기본 전달 모드를 가져옵니다.

매개변수:
없음
리턴값:
기본 전달 모드로 다음 값 중 하나를 사용할 수 있습니다.
  • XMSC_DELIVERY_PERSISTENT
  • XMSC_DELIVERY_NON_PERSISTENT

브로커에 대한 실시간 연결의 경우 이 메소드는 항상 XMSC_DELIVERY_NON_PERSISTENT를 리턴합니다.

예외:
  • XMS_X_GENERAL_EXCEPTION

getDestination – 목적지 가져오기

인터페이스:
Destination getDestination() const;

메시지 생성자에 대한 목적지를 가져옵니다.

매개변수:
없음
리턴값:
Destination 오브젝트입니다. 메시지 생성자에 목적지가 없으면 이 메소드는 널 Destination 오브젝트를 리턴합니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getDisableMsgID – 메시지 ID 사용 안함 플래그 가져오기

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

메시지 생성자가 전송한 메시지에 포함되는 메시지 ID가 수신 응용프로그램에 필요한지 여부에 대한 표시기를 가져옵니다.

매개변수:
없음
리턴값:
  • xmsTRUE - 메시지 생성자가 전송한 메시지에 포함되는 메시지 ID가 수신 응용프로그램에 필요하지 않은 경우
  • xmsFALSE - 메시지 생성자가 전송한 메시지에 포함되는 메시지 ID가 수신 응용프로그램에 필요한 경우
예외:
  • XMS_X_GENERAL_EXCEPTION

getDisableMsgTS – 시간 소인 사용 안함 플래그 가져오기

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

메시지 생성자가 전송한 메시지에 포함되는 시간 소인이 수신 응용프로그램에 필요한지 여부에 대한 표시기를 가져옵니다.

매개변수:
없음
리턴값:
  • xmsTRUE - 메시지 생성자가 전송한 메시지에 포함되는 시간 소인이 수신 응용프로그램에 필요하지 않은 경우
  • xmsFALSE - 메시지 생성자가 전송한 메시지에 포함되는 시간 소인이 수신 응용프로그램에 필요한 경우
예외:
  • XMS_X_GENERAL_EXCEPTION

getHandle – 핸들 가져오기

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

C 응용프로그램이 메시지 생성자에 액세스하는 데 사용하는 핸들을 가져옵니다.

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

getPriority – 기본 우선순위 가져오기

인터페이스:
xmsINT getPriority() const;

메시지 생성자가 전송한 메시지의 기본 우선순위를 가져옵니다.

매개변수:
없음
리턴값:
기본 메시지의 우선순위입니다. 값은 0(가장 낮은 우선순위) - 9(가장 높은 우선순위) 범위에 있는 정수입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getTimeToLive – 기본 TTL(Time to Live) 가져오기

인터페이스:
xmsLONG getTimeToLive() const;

만기될 때까지의 메시지 보존 시간을 가져옵니다. 이 시간은 메시지 생성자가 메시지를 전송하는 시간부터 측정됩니다.

매개변수:
없음
리턴값:
밀리초 단위의 기본 TTL(Time to Live)입니다. 값 0은 메시지가 만기되지 않음을 의미합니다.

브로커에 대한 실시간 연결의 경우 이 메소드는 항상 0을 리턴합니다.

예외:
  • XMS_X_GENERAL_EXCEPTION

isNull – 널 여부 확인

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

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

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

send – 전송

인터페이스:
xmsVOID send(const Message & message) const;

메시지 생성자가 작성되었을 당시에 지정된 목적지로 메시지를 전송합니다. 메시지 생성자의 기본 전달 모드, 우선순위 및 TTL(Time to Live)을 사용하여 메시지를 전송합니다.

매개변수:
message(입력)
Message 오브젝트
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_FORMAT_EXCEPTION
  • XMS_X_INVALID_DESTINATION_EXCEPTION

send – 전송(전달 모드, 우선순위 및 TTL 지정)

인터페이스:
xmsVOID send(const Message & message,
             const xmsINT deliveryMode,
             const xmsINT priority,
             const xmsLONG timeToLive) const;

메시지 생성자가 작성되었을 당시에 지정된 목적지로 메시지를 전송합니다. 지정된 전달 모드, 우선순위 및 TTL(Time to Live)을 사용하여 메시지를 전송합니다.

매개변수:
message(입력)
Message 오브젝트
deliveryMode(입력)
메시지 전달 모드로 다음 값 중 하나를 사용할 수 있습니다.
  • XMSC_DELIVERY_PERSISTENT
  • XMSC_DELIVERY_NON_PERSISTENT

브로커에 대한 실시간 연결의 경우 값이 XMSC_DELIVERY_NON_PERSISTENT여야 합니다.

priority(입력)
메시지의 우선순위입니다. 값은 0(가장 낮은 우선순위) - 9(가장 높은 우선순위) 범위에 있는 정수입니다. 브로커에 대한 실시간 연결의 경우에는 이 값이 무시됩니다.
timeToLive(입력)
밀리초 단위의 메시지 TTL(Time to Live)입니다. 값 0은 메시지가 만기되지 않음을 의미합니다. 브로커에 대한 실시간 연결의 경우 이 값은 0이어야 합니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_FORMAT_EXCEPTION
  • XMS_X_INVALID_DESTINATION_EXCEPTION
  • XMS_X_ILLEGAL_STATE_EXCEPTION

send – 전송(지정된 목적지로)

인터페이스:
xmsVOID send(const Destination & destination,
             const Message & message) const;

사용 중인 메시지 생성자에 대한 목적지를 메시지 생성자 작성 당시에 지정하지 않은 경우 지정된 목적지로 메시지를 전송합니다. 메시지 생성자의 기본 전달 모드, 우선순위 및 TTL(Time to Live)을 사용하여 메시지를 전송합니다.

일반적으로 메시지 생성자를 생성할 때 목적지를 지정하십시오. 그렇지 않을 경우 메시지를 전송할 때마다 목적지를 지정해야 합니다.

매개변수:
destination(입력)
Destination 오브젝트입니다.
message(입력)
Message 오브젝트
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_FORMAT_EXCEPTION
  • XMS_X_INVALID_DESTINATION_EXCEPTION

send – 전송(전달 모드, 우선순위 및 TTL을 지정하여 지정된 목적지로)

인터페이스:
xmsVOID send(const Destination & destination,
             const Message & message,
             const xmsINT deliveryMode,
             const xmsINT priority,
             const xmsLONG timeToLive) const;

사용 중인 메시지 생성자에 대한 목적지를 메시지 생성자 작성 당시에 지정하지 않은 경우 지정된 목적지로 메시지를 전송합니다. 지정된 전달 모드, 우선순위 및 TTL(Time to Live)을 사용하여 메시지를 전송합니다.

일반적으로 메시지 생성자를 생성할 때 목적지를 지정하십시오. 그렇지 않을 경우 메시지를 전송할 때마다 목적지를 지정해야 합니다.

매개변수:
destination(입력)
Destination 오브젝트입니다.
message(입력)
Message 오브젝트
deliveryMode(입력)
메시지 전달 모드로 다음 값 중 하나를 사용할 수 있습니다.
  • XMSC_DELIVERY_PERSISTENT
  • XMSC_DELIVERY_NON_PERSISTENT

브로커에 대한 실시간 연결의 경우 값이 XMSC_DELIVERY_NON_PERSISTENT여야 합니다.

priority(입력)
메시지의 우선순위입니다. 값은 0(가장 낮은 우선순위) - 9(가장 높은 우선순위) 범위에 있는 정수입니다. 브로커에 대한 실시간 연결의 경우에는 이 값이 무시됩니다.
timeToLive(입력)
밀리초 단위의 메시지 TTL(Time to Live)입니다. 값 0은 메시지가 만기되지 않음을 의미합니다. 브로커에 대한 실시간 연결의 경우 이 값은 0이어야 합니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_MESSAGE_FORMAT_EXCEPTION
  • XMS_X_INVALID_DESTINATION_EXCEPTION
  • XMS_X_ILLEGAL_STATE_EXCEPTION

setDeliveryMode – 기본 전달 모드 설정

인터페이스:
xmsVOID setDeliveryMode(const xmsINT deliveryMode);

메시지 생성자가 전송한 메시지의 기본 전달 모드를 설정합니다.

매개변수:
deliveryMode(입력)
기본 전달 모드로 다음 값 중 하나를 사용해야 합니다.
  • XMSC_DELIVERY_PERSISTENT
  • XMSC_DELIVERY_NON_PERSISTENT

브로커에 대한 실시간 연결의 경우 값이 XMSC_DELIVERY_NON_PERSISTENT여야 합니다.

기본값은 XMSC_DELIVERY_PERSISTENT지만, 브로커에 대한 실시간 연결의 기본값은 XMSC_DELIVERY_NON_PERSISTENT입니다.

리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setDisableMsgID – 메시지 ID 사용 안함 플래그 설정

인터페이스:
xmsVOID setDisableMsgID(const xmsBOOL msgIDDisabled);

메시지 생성자가 전송한 메시지에 포함되는 메시지 ID가 수신 응용프로그램에 필요한지 여부를 나타냅니다.

대기열 관리자에 대한 연결이나 브로커에 대한 실시간 연결의 경우에는 이 플래그가 무시되고, 서비스 통합 버스에 대한 연결의 경우에는 이 플래그가 적용됩니다.

매개변수:
msgIDDisabled(입력)
xmsTRUE 값은 메시지 생성자가 전송한 메시지에 포함되는 메시지 ID가 수신 응용프로그램에 필요하지 않음을 의미합니다. xmsFALSE 값은 수신 응용프로그램에 메시지 ID가 필요하다는 것을 의미합니다. 기본값은 xmsFALSE입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setDisableMsgTS – 시간 소인 사용 안함 플래그 설정

인터페이스:
xmsVOID setDisableMsgTS(const xmsBOOL timeStampDisabled);

메시지 생성자가 전송한 메시지에 포함되는 시간 소인이 수신 응용프로그램에 필요한지 여부를 나타냅니다.

브로커에 대한 실시간 연결의 경우에는 이 플래그가 무시되고, 대기열 관리자에 대한 연결이나 서비스 통합 버스에 대한 연결의 경우에는 이 플래그가 적용됩니다.

매개변수:
timeStampDisabled(입력)
xmsTRUE 값은 메시지 생성자가 전송한 메시지에 포함되는 시간 소인이 수신 응용프로그램에 필요하지 않음을 의미합니다. xmsFALSE 값은 수신 응용프로그램에 시간 소인이 필요하다는 것을 의미합니다. 기본값은 xmsFALSE입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setPriority – 기본 우선순위 설정

인터페이스:
xmsVOID setPriority(const xmsINT priority);

메시지 생성자가 전송한 메시지의 기본 우선순위를 설정합니다.

브로커에 대한 실시간 연결의 경우에는 메시지 우선순위가 무시됩니다.

매개변수:
priority(입력)
기본 메시지의 우선순위입니다. 값은 0(가장 낮은 우선순위) - 9(가장 높은 우선순위) 범위에 있는 정수입니다. 기본값은 4입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setTimeToLive – 기본 TTL(Time to Live) 설정

인터페이스:
xmsVOID setTimeToLive(const xmsLONG timeToLive);

만기될 때까지의 기본 메시지 보존 시간을 설정합니다. 이 시간은 메시지 생성자가 메시지를 전송하는 시간부터 측정됩니다.

매개변수:
timeToLive(입력)
밀리초 단위의 기본 TTL(Time to Live)입니다. 기본값은 0이며, 메시지의 만기 기간이 없음을 의미합니다. 브로커에 대한 실시간 연결의 경우 이 값은 0이어야 합니다.
리턴값:
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 웹 사이트 참조)