세션은 메시지 전송 및 수신을 위한 싱글 스레드 컨텍스트입니다.
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 | 지속 가능한 등록을 삭제합니다. |
xmsVOID close();
세션을 닫습니다. 트랜잭트된 세션 경우 진행 중인 트랜잭션이 롤백됩니다.
세션에 종속된 모든 오브젝트가 삭제됩니다. 삭제되는 오브젝트에 대한 자세한 정보는 오브젝트 삭제을 참조하십시오.
응용프로그램이 이미 닫힌 세션을 닫으려고 하면 호출이 무시됩니다.
QueueBrowser createBrowser(const Destination & queue const String & messageSelector) const;
메시지 선택자를 사용하여 지정된 대기열에 대한 대기열 브라우저를 작성합니다.
널 String 오브젝트는 대기열 브라우저에 대한 메시지 선택자가 없음을 의미합니다.
MessageConsumer createConsumer(const Destination & destination, const String & messageSelector) const;
메시지 선택자를 사용하여 지정된 목적지에 대한 메시지 처리자를 작성합니다.
널 String 오브젝트는 메시지 처리자에 대한 메시지 선택자가 없음을 의미합니다.
MessageConsumer createConsumer(const Destination & destination, const String & messageSelector, const xmsBOOL noLocal) const;
메시지 선택자를 사용하여 지정된 목적지에 대한 메시지 처리자를 작성합니다. 이 때 목적지가 주제일 경우 메시지 처리자가 자체 연결을 통해 공개된 메시지를 수신할지 여부도 지정합니다.
널 String 오브젝트는 메시지 처리자에 대한 메시지 선택자가 없음을 의미합니다.
MessageConsumercreateDurableSubscriber(const Destination & topic, const String & subscriptionName) const;
이 메소드는 실시간 브로커 연결에는 유효하지 않습니다.
지속 가능한 등록자에 대한 자세한 정보는 지속 가능한 등록자를 참조하십시오.
MessageConsumer createDurableSubscriber(const Destination & topic, const String & subscriptionName; const String & messageSelector, const xmsBOOL noLocal) const;
메시지 선택자를 사용하여 지정된 주제에 대한 지속 가능한 등록자를 작성합니다. 이 때 지속 가능한 등록자가 자체 연결을 통해 공개된 메시지를 수신할지 여부도 지정합니다.
이 메소드는 실시간 브로커 연결에는 유효하지 않습니다.
지속 가능한 등록자에 대한 자세한 정보는 지속 가능한 등록자를 참조하십시오.
널 String 오브젝트는 지속 가능한 등록자에 대한 메시지 선택자가 없음을 의미합니다.
MessageProducer createProducer(const Destination & destination) const;
메시지를 지정된 목적지로 전송하는 메시지 생성자를 작성합니다.
널 Destination 오브젝트를 지정하면 메시지 생성자가 목적지 없이 작성됩니다. 이 경우 응용프로그램은 메시지 생성자를 사용하여 메시지를 전송할 때마다 목적지를 지정해야 합니다.
Destination createQueue(const String & queueName) const;
메시지 서버의 대기열을 나타내는 Destination 오브젝트를 작성합니다.
이 메소드는 메시지 서버에 대기열을 작성하지 않습니다. 따라서 응용프로그램이 이 메소드를 호출하기 전에 대기열을 작성해야 합니다.
Destination createTemporaryQueue() const;
임시 대기열의 범위는 연결입니다. 연결에 의해 작성된 세션만 임시 대기열을 사용할 수 있습니다.
임시 대기열은 명시적으로 삭제되거나 연결이 끊길 때까지 그대로 유지됩니다.
임시 대기열에 대한 자세한 정보는 임시 목적지를 참조하십시오.
Destination createTemporaryTopic() const;
임시 주제의 범위는 연결입니다. 연결에 의해 작성된 세션만 임시 주제를 사용할 수 있습니다.
임시 주제는 명시적으로 삭제되거나 연결이 끊길 때까지 그대로 유지됩니다.
임시 주제에 대한 자세한 정보는 임시 목적지를 참조하십시오.
xmsINT getAcknowledgeMode() const;
세션의 수신확인 모드를 가져옵니다. 수신확인 모드는 세션이 작성될 때 지정됩니다.
트랜잭트된 세션에는 수신확인 모드가 없습니다.
수신확인 모드에 대한 자세한 정보는 세션의 메시지 수신확인을 참조하십시오.
xmsVOID recover() const;
세션을 복구합니다. 메시지 전달이 중지되었다가 수신확인되지 않은 가장 이전 메시지를 사용하여 재시작됩니다.
세션은 트랜잭트된 세션이 아니어야 합니다.
세션 복구에 대한 자세한 정보는 세션의 메시지 수신확인을 참조하십시오.
xmsVOID unsubscribe(const String & subscriptionName) const;
지속 가능한 등록을 삭제합니다. 메시징 서버는 유지보수 중인 지속 가능한 등록의 레코드를 삭제하고 지속 가능한 등록자에게 추가 메시지를 전송하지 않습니다.
이 메소드는 실시간 브로커 연결에는 유효하지 않습니다.