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

ISession

세션은 메시지 전송 및 수신을 위한 싱글 스레드 컨텍스트입니다.

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

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

.NET 등록 정보

.NET 등록 정보 요약:
.NET 등록 정보 설명
AcknowledgeMode 세션의 수신확인 모드를 가져옵니다.
Transacted 트랜잭트된 세션인지 여부를 판별합니다.

AcknowledgeMode – 수신확인 모드 가져오기

인터페이스:
AcknowledgeMode AcknowledgeMode
    {
      get;
    }

세션의 수신확인 모드를 가져옵니다.

수신확인 모드는 세션이 작성될 때 지정됩니다.

트랜잭트되지 않은 세션의 경우 다음 값 중 하나를 수신확인 모드로 사용할 수 있습니다.

  • AcknowledgeMode.AutoAcknowledge
  • AcknowledgeMode.ClientAcknowledge
  • AcknowledgeMode.DupsOkAcknowledge

수신확인 모드에 대한 자세한 정보는 세션의 메시지 수신확인을 참조하십시오.

트랜잭트된 세션에는 수신확인 모드가 없습니다. 트랜잭트된 세션일 경우 이 메소드는 AcknowledgeMode.SessionTransacted를 대신 리턴합니다.

예외:
  • XMSException

Transacted – 트랜잭트 여부 판별

인터페이스:
Boolean Transacted
    {
      get;
    }

트랜잭트된 세션인지 여부를 판별합니다.

트랜잭트 상태는 다음과 같습니다.

  • True - 세션이 트랜잭트된 경우
  • False - 세션이 트랜잭트되지 않은 경우

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

예외:
  • XMSException

메소드

메소드 요약:
메소드 설명
Close 세션을 닫습니다.
Commit 현재 트랜잭션에서 처리된 모든 메시지를 확약합니다.
CreateBrowser 지정된 대기열에 대한 대기열 브라우저를 작성합니다.
CreateBrowser 메시지 선택자를 사용하여 지정된 대기열에 대한 대기열 브라우저를 작성합니다.
CreateBytesMessage 바이트 메시지를 작성합니다.
CreateConsumer 지정된 목적지에 대한 메시지 처리자를 작성합니다.
CreateConsumer 메시지 선택자를 사용하여 지정된 목적지에 대한 메시지 처리자를 작성합니다.
CreateConsumer 메시지 선택자를 사용하여 지정된 목적지에 대한 메시지 처리자를 작성합니다. 이 때 목적지가 주제일 경우 메시지 처리자가 자체 연결을 통해 공개된 메시지를 수신할지 여부도 지정합니다.
CreateDurableSubscriber 지정된 주제에 대해 지속 가능한 등록자를 작성합니다.
CreateDurableSubscriber 메시지 선택자를 사용하여 지정된 주제에 대한 지속 가능한 등록자를 작성합니다. 이 때 지속 가능한 등록자가 자체 연결을 통해 공개된 메시지를 수신할지 여부도 지정합니다.
CreateMapMessage 맵 메시지를 작성합니다.
CreateMessage 본문이 없는 메시지를 작성합니다.
CreateObjectMessage 오브젝트 메시지를 작성합니다.
CreateProducer 메시지를 지정된 목적지로 전송하는 메시지 생성자를 작성합니다.
CreateQueue 메시지 서버의 대기열을 나타내는 Destination 오브젝트를 작성합니다.
CreateStreamMessage 스트림 메시지를 작성합니다.
CreateTemporaryQueue 임시 대기열을 작성합니다.
CreateTemporaryTopic 임시 주제를 작성합니다.
CreateTextMessage 본문이 비어 있는 텍스트 메시지를 작성합니다.
CreateTextMessage 지정된 텍스트로 본문이 초기화되는 텍스트 메시지를 작성합니다.
CreateTopic 주제를 나타내는 Destination 오브젝트를 작성합니다.
Recover 세션을 복구합니다.
Rollback 현재 트랜잭션에서 처리된 모든 메시지를 롤백합니다.
Unsubscribe 지속 가능한 등록을 삭제합니다.

Close – 세션 닫기

인터페이스:
void  Close(); 

세션을 닫습니다. 트랜잭트된 세션 경우 진행 중인 트랜잭션이 롤백됩니다.

응용프로그램이 이미 닫힌 세션을 닫으려고 하면 호출이 무시됩니다.

매개변수:
없음
리턴값:
Void
스레드 컨텍스트:
임의
예외:
  • XMSException

Commit – 확약

인터페이스:
void Commit();

현재 트랜잭션에서 처리된 모든 메시지를 확약합니다.

세션은 트랜잭트된 세션이어야 합니다.

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

CreateBrowser – 대기열 브라우저 작성

인터페이스:
IQueueBrowser CreateBrowser(IDestination queue) ;

지정된 대기열에 대한 대기열 브라우저를 작성합니다.

매개변수:
queue(입력)
대기열을 나타내는 Destination 오브젝트입니다.
리턴값:
QueueBrowser 오브젝트
예외:
  • XMSException
  • InvalidDestinationException

CreateBrowser – 대기열 브라우저 작성(메시지 선택자 사용)

인터페이스:
IQueueBrowser CreateBrowser(IDestination queue, String selector) ;

메시지 선택자를 사용하여 지정된 대기열에 대한 대기열 브라우저를 작성합니다.

매개변수:
queue(입력)
대기열을 나타내는 Destination 오브젝트입니다.
selector(입력)
메시지 선택자 표현식을 캡슐화하는 String 오브젝트입니다. 메시지 선택자 표현식과 일치하는 속성을 갖는 메시지만 대기열 브라우저에 전달됩니다.

널 String 오브젝트는 대기열 브라우저에 대한 메시지 선택자가 없음을 의미합니다.

리턴값:
QueueBrowser 오브젝트
예외:
  • XMSException
  • InvalidDestinationException
  • InvalidSelectorException

CreateBytesMessage – 바이트 메시지 작성

인터페이스:
IBytesMessage CreateBytesMessage();

바이트 메시지를 작성합니다.

매개변수:
없음
리턴값:
BytesMessage 오브젝트
예외:
  • XMSException
  • IllegalStateException(세션이 닫힘)

CreateConsumer – 처리자 작성

인터페이스:
IMessageConsumer CreateConsumer(IDestination dest) ;

지정된 목적지에 대한 메시지 처리자를 작성합니다.

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

CreateConsumer – 처리자 작성(메시지 선택자 사용)

인터페이스:
IMessageConsumer CreateConsumer(IDestination dest,
                                String selector) ;

메시지 선택자를 사용하여 지정된 목적지에 대한 메시지 처리자를 작성합니다.

매개변수:
dest(입력)
Destination 오브젝트
selector(입력)
메시지 선택자 표현식을 캡슐화하는 String 오브젝트입니다. 메시지 선택자 표현식과 일치하는 속성을 갖는 메시지만 메시지 처리자에게 전달됩니다.

널 String 오브젝트는 메시지 처리자에 대한 메시지 선택자가 없음을 의미합니다.

리턴값:
MessageConsumer 오브젝트
예외:
  • XMSException
  • InvalidDestinationException
  • InvalidSelectorException

CreateConsumer – 처리자 작성(메시지 선택자 및 로컬 메시지 플래그 사용)

인터페이스:
IMessageConsumer CreateConsumer(IDestination dest,
                                String selector,
                                Boolean noLocal) ;

메시지 선택자를 사용하여 지정된 목적지에 대한 메시지 처리자를 작성합니다. 이 때 목적지가 주제일 경우 메시지 처리자가 자체 연결을 통해 공개된 메시지를 수신할지 여부도 지정합니다.

매개변수:
dest(입력)
Destination 오브젝트입니다.
selector(입력)
메시지 선택자 표현식을 캡슐화하는 String 오브젝트입니다. 메시지 선택자 표현식과 일치하는 속성을 갖는 메시지만 메시지 처리자에게 전달됩니다.

널 String 오브젝트는 메시지 처리자에 대한 메시지 선택자가 없음을 의미합니다.

noLocal(입력)
값을 True로 설정하면 메시지 처리자가 자체 연결을 통해 공개된 메시지를 수신하지 않으며, 값을 False로 설정하면 메시지 처리자가 자체 연결을 통해 공개된 메시지를 수신합니다. 기본값은 False입니다.
리턴값:
MessageConsumer 오브젝트
예외:
  • XMSException
  • InvalidDestinationException
  • InvalidSelectorException

CreateDurableSubscriber – 지속 가능한 등록자 작성

인터페이스:
IMessageConsumer CreateDurableSubscriber(IDestination dest,
                                         String subscription) ;

지정된 주제에 대해 지속 가능한 등록자를 작성합니다.

이 메소드는 실시간 브로커 연결에는 유효하지 않습니다.

지속 가능한 등록자에 대한 자세한 정보는 지속 가능한 등록자를 참조하십시오.

매개변수:
dest(입력)
주제를 나타내는 Destination 오브젝트입니다. 주제는 임시 주제일 수 없습니다.
subscription(입력)
지속 가능한 등록을 식별하는 이름을 캡슐화하는 String 오브젝트입니다. 이 이름은 연결에 대한 클라이언트 ID 내에서 고유해야 합니다.
리턴값:
지속 가능한 등록자를 나타내는 MessageConsumer 오브젝트
예외:
  • XMSException
  • InvalidDestinationException

CreateDurableSubscriber – 지속 가능한 등록자 작성(메시지 선택자 및 로컬 메시지 플래그 사용)

인터페이스:
IMessageConsumer CreateDurableSubscriber(IDestination dest,
                                         String subscription,
                                         String selector,
                                         Boolean noLocal) ;

메시지 선택자를 사용하여 지정된 주제에 대한 지속 가능한 등록자를 작성합니다. 이 때 지속 가능한 등록자가 자체 연결을 통해 공개된 메시지를 수신할지 여부도 지정합니다.

이 메소드는 실시간 브로커 연결에는 유효하지 않습니다.

지속 가능한 등록자에 대한 자세한 정보는 지속 가능한 등록자를 참조하십시오.

매개변수:
dest(입력)
주제를 나타내는 Destination 오브젝트입니다. 주제는 임시 주제일 수 없습니다.
subscription(입력)
지속 가능한 등록을 식별하는 이름을 캡슐화하는 String 오브젝트입니다. 이 이름은 연결에 대한 클라이언트 ID 내에서 고유해야 합니다.
selector(입력)
메시지 선택자 표현식을 캡슐화하는 String 오브젝트입니다. 메시지 선택자 표현식과 일치하는 속성을 갖는 메시지만 지속 가능한 등록자에게 전달됩니다.

널 String 오브젝트는 지속 가능한 등록자에 대한 메시지 선택자가 없음을 의미합니다.

noLocal(입력)
값을 True로 설정하면 지속 가능한 등록자가 자체 연결을 통해 공개된 메시지를 수신하지 않으며, 값을 False로 설정하면 지속 가능한 등록자가 자체 연결을 통해 공개된 메시지를 수신합니다. 기본값은 False입니다.
리턴값:
지속 가능한 등록자를 나타내는 MessageConsumer 오브젝트
예외:
  • XMSException
  • InvalidDestinationException
  • InvalidSelectorException

CreateMapMessage – 맵 메시지 작성

인터페이스:
IMapMessage CreateMapMessage();

맵 메시지를 작성합니다.

매개변수:
없음
리턴값:
MapMessage 오브젝트
예외:
  • XMSException
  • IllegalStateException(세션이 닫힘)

CreateMessage – 메시지 작성

인터페이스:
IMessage CreateMessage();

본문이 없는 메시지를 작성합니다.

매개변수:
없음
리턴값:
Message 오브젝트
예외:
  • XMSException
  • IllegalStateException(세션이 닫힘)

CreateObjectMessage – 오브젝트 메시지 작성

인터페이스:
IObjectMessage CreateObjectMessage();

오브젝트 메시지를 작성합니다.

매개변수:
없음
리턴값:
ObjectMessage 오브젝트
예외:
  • XMSException
  • IllegalStateException(세션이 닫힘)

CreateProducer – 생성자 작성

인터페이스:
IMessageProducer CreateProducer(IDestination dest) ;

메시지를 지정된 목적지로 전송하는 메시지 생성자를 작성합니다.

매개변수:
dest(입력)
Destination 오브젝트입니다.

널 Destination 오브젝트를 지정하면 메시지 생성자가 목적지 없이 작성됩니다. 이 경우 응용프로그램은 메시지 생성자를 사용하여 메시지를 전송할 때마다 목적지를 지정해야 합니다.

리턴값:
MessageProducer 오브젝트
예외:
  • XMSException
  • InvalidDestinationException

CreateQueue – 대기열 작성

인터페이스:
IDestination CreateQueue(String queue) ;

메시지 서버의 대기열을 나타내는 Destination 오브젝트를 작성합니다.

이 메소드는 메시지 서버에 대기열을 작성하지 않습니다. 따라서 응용프로그램이 이 메소드를 호출하기 전에 대기열을 작성해야 합니다.

매개변수:
queue(입력)
대기열 이름을 캡슐화하거나 대기열을 식별하는 URI(Uniform Resource Identifier)를 캡슐화하는 String 오브젝트입니다.
리턴값:
대기열을 나타내는 Destination 오브젝트입니다.
예외:
  • XMSException

CreateStreamMessage – 스트림 메시지 작성

인터페이스:
IStreamMessage CreateStreamMessage();

스트림 메시지를 작성합니다.

매개변수:
없음
리턴값:
StreamMessage 오브젝트
예외:
  • XMSException
  • XMS_ILLEGAL_STATE_EXCEPTION

CreateTemporaryQueue – 임시 대기열 작성

인터페이스:
IDestination CreateTemporaryQueue() ;

임시 대기열을 작성합니다.

임시 대기열의 범위는 연결입니다. 연결에 의해 작성된 세션만 임시 대기열을 사용할 수 있습니다.

임시 대기열은 명시적으로 삭제되거나 연결이 끊길 때까지 그대로 유지됩니다.

임시 대기열에 대한 자세한 정보는 임시 목적지를 참조하십시오.

매개변수:
없음
리턴값:
임시 대기열을 나타내는 Destination 오브젝트입니다.
예외:
  • XMSException

CreateTemporaryTopic – 임시 주제 작성

인터페이스:
IDestination CreateTemporaryTopic() ;

임시 주제를 작성합니다.

임시 주제의 범위는 연결입니다. 연결에 의해 작성된 세션만 임시 주제를 사용할 수 있습니다.

임시 주제는 명시적으로 삭제되거나 연결이 끊길 때까지 그대로 유지됩니다.

임시 주제에 대한 자세한 정보는 임시 목적지를 참조하십시오.

매개변수:
없음
리턴값:
임시 주제를 나타내는 Destination 오브젝트입니다.
예외:
  • XMSException

CreateTextMessage – 텍스트 메시지 작성

인터페이스:
ITextMessage CreateTextMessage();

본문이 비어 있는 텍스트 메시지를 작성합니다.

매개변수:
없음
리턴값:
TextMessage 오브젝트
예외:
  • XMSException

CreateTextMessage – 텍스트 메시지 작성(초기화됨)

인터페이스:
ITextMessage CreateTextMessage(String initialValue);

지정된 텍스트로 본문이 초기화되는 텍스트 메시지를 작성합니다.

매개변수:
initialValue(입력)
텍스트 메시지의 본문을 초기화하는 텍스트를 캡슐화하는 String 오브젝트입니다.
없음
리턴값:
TextMessage 오브젝트
예외:
  • XMSException

CreateTopic – 주제 작성

인터페이스:
IDestination CreateTopic(String topic) ;

주제를 나타내는 Destination 오브젝트를 작성합니다.

매개변수:
topic(주제)
주제 이름을 캡슐화하거나 주제를 식별하는 URI(Uniform Resource Identifier)를 캡슐화하는 String 오브젝트입니다.
리턴값:
주제를 나타내는 Destination 오브젝트입니다.
예외:
  • XMSException

Recover – 복구

인터페이스:
void Recover();

세션을 복구합니다. 메시지 전달이 중지되었다가 수신확인되지 않은 가장 이전 메시지를 사용하여 재시작됩니다.

세션은 트랜잭트된 세션이 아니어야 합니다.

세션 복구에 대한 자세한 정보는 세션의 메시지 수신확인을 참조하십시오.

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

Rollback – 롤백

인터페이스:
void Rollback();

현재 트랜잭션에서 처리된 모든 메시지를 롤백합니다.

세션은 트랜잭트된 세션이어야 합니다.

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

Unsubscribe – 등록 해제

인터페이스:
void Unsubscribe(String subscription);

지속 가능한 등록을 삭제합니다. 메시징 서버는 유지보수 중인 지속 가능한 등록의 레코드를 삭제하고 지속 가능한 등록자에게 추가 메시지를 전송하지 않습니다.

다음과 같은 경우 응용프로그램은 지속 가능한 등록을 삭제할 수 없습니다.
  • 지속 가능한 등록에 대해 활성 메시지 처리자가 있는 경우
  • 사용된 메시지가 보류 중인 트랜잭션의 일부인 경우
  • 사용된 메시지가 수신확인되지 않은 경우

이 메소드는 실시간 브로커 연결에는 유효하지 않습니다.

매개변수:
subscription(입력)
지속 가능한 등록을 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
리턴값:
Void
예외:
  • XMSException
  • InvalidDestinationException
  • IllegalStateException

상속된 등록 정보 및 메소드


Reference topic

이용약관 | 피드백

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