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

IMessageProducer

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

상속 계층 구조:
IBM.XMS.IPropertyContext
   |
   +----IBM.XMS.IMessageProducer

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

.NET 등록 정보

.NET 등록 정보 요약:
.NET 등록 정보 설명
DeliveryMode 메시지 생성자가 전송한 메시지의 기본 전달 모드를 가져오고 설정합니다.
Destination 메시지 생성자에 대한 목적지를 가져옵니다.
DisableMsgID 수신 응용프로그램에서 메시지 ID를 메시지 생성자가 전송한 메시지에 포함시킬지 여부를 나타내는 표시를 가져와서 수신 응용프로그램에서 메시지 ID를 메시지 생성자가 전송한 메시지에 포함시킬지 여부를 나타냅니다.
DisableMsgTS 수신 응용프로그램에서 시간 소인을 메시지 생성자가 전송한 메시지에 포함시킬지 여부를 나타내는 표시를 가져와서 수신 응용프로그램에서 시간 소인을 메시지 생성자가 전송한 메시지에 포함시킬지 여부를 나타냅니다.
Priority 메시지 생성자가 전송한 메시지의 기본 우선순위를 가져오고 설정합니다.
TimeToLive 만기될 때까지의 메시지 보존 시간을 가져오고 설정합니다.

DeliveryMode – 기본 전달 모드 가져오기 및 설정

인터페이스:
DeliveryMode DeliveryMode
{
  get;
  set;
}

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

기본 전달 모드로 다음 값 중 하나를 사용할 수 있습니다.

  • DeliveryMode.Persistent
  • DeliveryMode.NonPersistent

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

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

예외:
  • XMSException

Destination – 목적지 가져오기

인터페이스:
IDestination Destination
{
  get;
}

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

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

DisableMsgID – 메시지 ID 사용 안함 플래그 가져오기 및 설정

인터페이스:
Boolean DisableMessageID
{
  get;
  set;
}

수신 응용프로그램에서 메시지 ID를 메시지 생성자가 전송한 메시지에 포함시킬지 여부를 나타내는 표시를 가져와서 수신 응용프로그램에서 메시지 ID를 메시지 생성자가 전송한 메시지에 포함시킬지 여부를 나타냅니다.

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

DisabledMsgID는 다음 값 중 하나를 가질 수 있습니다.

  • True - 수신 응용프로그램에서 메시지 ID를 메시지 생성자가 전송한 메시지에 포함시킬 필요가 없는 경우
  • False - 수신 응용프로그램에서 메시지 ID를 메시지 생성자가 전송한 메시지에 포함시켜야 하는 경우
예외:
  • XMSException

DisableMsgTS – 시간 소인 사용 안함 플래그 가져오기 및 설정

인터페이스:
Boolean DisableMessageTimestamp
{
  get;
  set;
}

수신 응용프로그램에서 시간 소인을 메시지 생성자가 전송한 메시지에 포함시킬지 여부를 나타내는 표시를 가져와서 수신 응용프로그램에서 시간 소인을 메시지 생성자가 전송한 메시지에 포함시킬지 여부를 나타냅니다.

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

DisableMsgTS는 다음 값 중 하나를 가질 수 있습니다.

  • True - 수신 응용프로그램에서 시간 소인을 메시지 생성자가 전송한 메시지에 포함시킬 필요가 없는 경우
  • False - 수신 응용프로그램에서 시간 소인을 메시지 생성자가 전송한 메시지에 포함시켜야 하는 경우
리턴값:
예외:
  • XMSException

Priority – 기본 우선순위 가져오기 및 설정

인터페이스:
Int32 Priority
{
  get;
  set;
}

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

기본 메시지 우선순위 값은 0(가장 낮은 우선순위) - 9(가장 높은 우선순위) 범위에 있는 정수입니다.

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

예외:
  • XMSException

TimeToLive – 기본 TTL(Time to Live) 가져오기 및 설정

인터페이스:
Int64 TimeToLive
{
  get;
  set;
}

만기될 때까지의 메시지 보존 시간을 가져오고 설정합니다.

이 시간은 메시지 생성자가 메시지를 전송하는 시간부터 측정되며 밀리초 단위의 TTL(Time to Live)입니다. 값 0은 메시지가 만기되지 않음을 의미합니다.

브로커에 대한 실시간 연결의 경우 이 값은 항상 0입니다.

예외:
  • XMSException

메소드

메소드 요약:
메소드 설명
Close 메시지 생성자를 닫습니다.
Send 메시지 생성자가 작성되었을 당시에 지정된 목적지로 메시지를 전송합니다. 메시지 생성자의 기본 전달 모드, 우선순위 및 TTL(Time to Live)을 사용하여 메시지를 전송합니다.
Send 메시지 생성자가 작성되었을 당시에 지정된 목적지로 메시지를 전송합니다. 지정된 전달 모드, 우선순위 및 TTL(Time to Live)을 사용하여 메시지를 전송합니다.
Send 사용 중인 메시지 생성자에 대한 목적지를 메시지 생성자 작성 당시에 지정하지 않은 경우 지정된 목적지로 메시지를 전송합니다. 메시지 생성자의 기본 전달 모드, 우선순위 및 TTL(Time to Live)을 사용하여 메시지를 전송합니다.
Send 사용 중인 메시지 생성자에 대한 목적지를 메시지 생성자 작성 당시에 지정하지 않은 경우 지정된 목적지로 메시지를 전송합니다. 지정된 전달 모드, 우선순위 및 TTL(Time to Live)을 사용하여 메시지를 전송합니다.

Close – 메시지 생성자 닫기

인터페이스:
void  Close(); 

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

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

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

Send – 전송

인터페이스:
void Send(IMessage msg) ;

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

매개변수:
msg(입력)
Message 오브젝트
리턴값:
Void
예외:
  • XMSException
  • MessageFormatException
  • InvalidDestinationException

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

인터페이스:
void Send(IMessage msg,
          DeliveryMode deliveryMode,
          Int32 priority,
          Int64 timeToLive);

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

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

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

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

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

인터페이스:
void Send(IDestination dest, IMessage msg) ;

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

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

매개변수:
dest(입력)
Destination 오브젝트입니다.
msg(입력)
Message 오브젝트
리턴값:
Void
예외:
  • XMSException
  • MessageFormatException
  • InvalidDestinationException

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

인터페이스:
void Send(IDestination dest,
          IMessage msg,
          DeliveryMode deliveryMode,
          Int32 priority,
          Int64 timeToLive);

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

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

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

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

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

상속된 등록 정보 및 메소드


Reference topic

이용약관 | 피드백

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