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

Session

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

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

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

메소드

메소드 요약:
메소드 설명
close 세션을 닫습니다.
commit 현재 트랜잭션에서 처리된 모든 메시지를 확약합니다.
createBrowser 지정된 대기열에 대한 대기열 브라우저를 작성합니다.
createBrowser 메시지 선택자를 사용하여 지정된 대기열에 대한 대기열 브라우저를 작성합니다.
createBytesMessage 바이트 메시지를 작성합니다.
createConsumer 지정된 목적지에 대한 메시지 처리자를 작성합니다.
createConsumer 메시지 선택자를 사용하여 지정된 목적지에 대한 메시지 처리자를 작성합니다.
createConsumer 메시지 선택자를 사용하여 지정된 목적지에 대한 메시지 처리자를 작성합니다. 이 때 목적지가 주제일 경우 메시지 처리자가 자체 연결을 통해 공개된 메시지를 수신할지 여부도 지정합니다.
createDurableSubscriber 지정된 주제에 대해 지속 가능한 등록자를 작성합니다.
createDurableSubscriber 메시지 선택자를 사용하여 지정된 주제에 대한 지속 가능한 등록자를 작성합니다. 이 때 지속 가능한 등록자가 자체 연결을 통해 공개된 메시지를 수신할지 여부도 지정합니다.
createMapMessage 맵 메시지를 작성합니다.
createMessage 본문이 없는 메시지를 작성합니다.
createObjectMessage 오브젝트 메시지를 작성합니다.
createProducer 메시지를 지정된 목적지로 전송하는 메시지 생성자를 작성합니다.
createQueue 메시지 서버의 대기열을 나타내는 Destination 오브젝트를 작성합니다.
createStreamMessage 스트림 메시지를 작성합니다.
createTemporaryQueue 임시 대기열을 작성합니다.
createTemporaryTopic 임시 주제를 작성합니다.
createTextMessage 본문이 비어 있는 텍스트 메시지를 작성합니다.
createTextMessage 지정된 텍스트로 본문이 초기화되는 텍스트 메시지를 작성합니다.
createTopic 주제를 나타내는 Destination 오브젝트를 작성합니다.
getAcknowledgeMode 세션의 수신확인 모드를 가져옵니다.
getHandle C 응용프로그램이 세션에 액세스하는 데 사용하는 핸들을 가져옵니다.
getTransacted 트랜잭트된 세션인지 여부를 판별합니다.
isNull Session 오브젝트가 널 오브젝트인지 여부를 판별합니다.
recover 세션을 복구합니다.
rollback 현재 트랜잭션에서 처리된 모든 메시지를 롤백합니다.
unsubscribe 지속 가능한 등록을 삭제합니다.

close – 세션 닫기

인터페이스:
xmsVOID close();

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

세션에 종속된 모든 오브젝트가 삭제됩니다. 삭제되는 오브젝트에 대한 자세한 정보는 오브젝트 삭제을 참조하십시오.

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

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

commit – 확약

인터페이스:
xmsVOID commit();

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

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

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

createBrowser – 대기열 브라우저 작성

인터페이스:
QueueBrowser createBrowser(const Destination & queue) const;

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

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

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

인터페이스:
QueueBrowser createBrowser(const Destination & queue
                           const String & messageSelector) const; 

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

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

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

리턴값:
QueueBrowser 오브젝트
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_INVALID_DESTINATION_EXCEPTION
  • XMS_X_INVALID_SELECTOR_EXCEPTION

createBytesMessage – 바이트 메시지 작성

인터페이스:
BytesMessage createBytesMessage() const;

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

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

createConsumer – 처리자 작성

인터페이스:
 
MessageConsumer createConsumer(const Destination & destination) const;

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

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

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

인터페이스:
MessageConsumer createConsumer(const Destination & destination,
                               const String & messageSelector) const;

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

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

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

리턴값:
MessageConsumer 오브젝트
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_INVALID_DESTINATION_EXCEPTION
  • XMS_X_INVALID_SELECTOR_EXCEPTION

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

인터페이스:
 MessageConsumer createConsumer(const Destination & destination,
                               const String & messageSelector,
                               const xmsBOOL noLocal) const;

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

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

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

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

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

인터페이스:
MessageConsumercreateDurableSubscriber(const Destination & topic,
                        const String & subscriptionName) const;

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

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

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

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

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

인터페이스:
MessageConsumer createDurableSubscriber(const Destination & topic,
                                        const String & subscriptionName;
                                        const String & messageSelector,
                                        const xmsBOOL noLocal) const;

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

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

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

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

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

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

createMapMessage – 맵 메시지 작성

인터페이스:
MapMessage createMapMessage() const;

맵 메시지를 작성합니다.

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

createMessage – 메시지 작성

인터페이스:
Message createMessage() const;

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

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

createObjectMessage – 오브젝트 메시지 작성

인터페이스:
ObjectMessage createObjectMessage() const;

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

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

createProducer – 생성자 작성

인터페이스:
MessageProducer createProducer(const Destination & destination) const;

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

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

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

리턴값:
MessageProducer 오브젝트
예외:
  • XMS_X_GENERAL_EXCEPTION
  • XMS_X_INVALID_DESTINATION_EXCEPTION

createQueue – 대기열 작성

인터페이스:
Destination createQueue(const String & queueName) const;

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

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

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

createStreamMessage – 스트림 메시지 작성

인터페이스:
StreamMessage createStreamMessage() const;

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

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

createTemporaryQueue – 임시 대기열 작성

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

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

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

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

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

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

createTemporaryTopic – 임시 주제 작성

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

임시 주제를 작성합니다.

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

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

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

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

createTextMessage – 텍스트 메시지 작성

인터페이스:
TextMessage createTextMessage() const;

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

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

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

인터페이스:
TextMessage createTextMessage(const String & text) const;

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

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

createTopic – 주제 작성

인터페이스:
Destination createTopic(const String & topicName) const;

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

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

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

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

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

트랜잭트된 세션에는 수신확인 모드가 없습니다.

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

매개변수:
없음
리턴값:
수신확인 모드입니다. 트랜잭트되지 않은 세션의 경우 다음 값 중 하나를 수신확인 모드로 사용할 수 있습니다.
  • XMSC_AUTO_ACKNOWLEDGE
  • XMSC_CLIENT_ACKNOWLEDGE
  • XMSC_DUPS_OK_ACKNOWLEDGE
트랜잭트된 세션일 경우 이 메소드는 XMSC_SESSION_TRANSACTED를 대신 리턴합니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getHandle – 핸들 가져오기

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

C 응용프로그램이 세션에 액세스하는 데 사용하는 핸들을 가져옵니다.

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

getTransacted – 트랜잭트 여부 판별

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

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

매개변수:
없음
리턴값:
  • xmsTRUE - 세션이 트랜잭트된 경우
  • xmsFALSE - 세션이 트랜잭트되지 않은 경우

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

예외:
  • XMS_X_GENERAL_EXCEPTION

isNull – 널 여부 확인

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

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

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

recover – 복구

인터페이스:
xmsVOID recover() const;

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

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

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

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

rollback – 롤백

인터페이스:
xmsVOID rollback() const;

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

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

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

unsubscribe – 등록 해제

인터페이스:
xmsVOID unsubscribe(const String & subscriptionName) const;

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

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

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

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

상속된 메소드


Reference topic

이용약관 | 피드백

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