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

IConnection

Connection 오브젝트는 브로커에 대한 응용프로그램의 활성화된 연결을 나타냅니다.

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

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

.NET 등록 정보

.NET 등록 정보 요약:
.NET 등록 정보 설명
ClientID 연결에 대한 클라이언트 ID를 가져오고 설정합니다.
ExceptionListener 연결에 등록된 예외 리스너를 가져오고 연결에 예외 리스너를 등록합니다.
MetaData 연결에 대한 메타데이터를 가져옵니다.

ClientID – 클라이언트 ID 가져오기 및 설정

인터페이스:
String ClientID
      {
        get;
        set;
      }

연결에 대한 클라이언트 ID를 가져오고 설정합니다.

클라이언트 ID는 관리자가 ConnectionFactory에 미리 정의하거나 ClientID를 설정하여 지정할 수 있습니다.

클라이언트 ID는 공개/등록 도메인에서 지속 가능한 등록을 지원하는 데만 사용되며 지점 간 도메인에서는 무시됩니다.

응용프로그램이 연결에 대한 클라이언트 ID를 설정할 경우 응용프로그램은 연결이 작성된 직후 즉, 연결에서 다른 작업을 수행하기 전에 클라이언트 ID를 설정해야 합니다. 이 시점 이후에 응용프로그램에서 클라이언트 ID를 설정하려고 하면 IllegalStateException 예외가 발생합니다.

이 등록 정보는 실시간 브로커 연결에는 유효하지 않습니다.

예외:
  • XMSException
  • IllegalStateException
  • InvalidClientIDException

ExceptionListener – 예외 리스너 가져오기 및 설정

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

연결에 등록된 예외 리스너를 가져오고 연결에 예외 리스너를 등록합니다.

연결에 예외 리스너가 등록되어 있지 않을 경우 이 메소드가 널을 리턴합니다. 예외 리스너가 이미 연결에 등록되어 있을 경우 예외 리스너 대신 널을 지정하여 등록을 취소할 수 있습니다.

예외 리스너 사용에 대한 자세한 정보는 .NET에서 메시지 및 예외 리스너 사용을 참조하십시오.

예외:
  • XMSException

MetaData – 메타데이터 가져오기

인터페이스:
IConnectionMetaData MetaData
    {
      get;
    }

연결에 대한 메타데이터를 가져옵니다.

예외:
  • XMSException

메소드

메소드 요약:
메소드 설명
Close 연결을 닫습니다.
CreateSession 세션을 작성합니다.
Start 연결에 대한 수신 메시지 전달을 시작 또는 재시작합니다.
Stop 연결에 대한 수신 메시지 전달을 중지합니다.

Close – 연결 닫기

인터페이스:
void  Close();

연결을 닫습니다.

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

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

CreateSession – 세션 작성

인터페이스:
	ISession CreateSession(Boolean transacted,
                         AcknowledgeMode acknowledgeMode);

세션을 작성합니다.

매개변수:
transacted(입력)
True를 값으로 설정하면 세션이 트랜잭트되며, False를 값으로 설정하면 세션이 트랜잭트되지 않습니다.

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

acknowledgeMode(입력)
응용프로그램이 받은 메시지를 수신확인하는 방법을 나타냅니다. AcknowledgeMode 열거자에 있는 다음 값 중 하나를 사용해야 합니다.
  • AcknowledgeMode.AutoAcknowledge
  • AcknowledgeMode.ClientAcknowledge
  • AcknowledgeMode.DupsOkAcknowledge
브로커에 대한 실시간 연결의 경우 값이 AcknowledgeMode.AutoAcknowledge 또는 AcknowledgeMode.DupsOkAcknowledge여야 합니다.

트랜잭트된 세션일 경우 이 매개변수는 무시됩니다. 수신확인 모드에 대한 자세한 정보는 세션의 메시지 수신확인을 참조하십시오.

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

Start – 연결 시작

인터페이스:
void  Start();

연결에 대한 수신 메시지 전달을 시작 또는 재시작합니다. 연결이 이미 시작된 경우에는 호출이 무시됩니다.

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

Stop – 연결 중지

인터페이스:
void  Stop();

연결에 대한 수신 메시지 전달을 중지합니다. 연결이 이미 중지된 경우에는 호출이 무시됩니다.

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

상속된 등록 정보 및 메소드


Reference topic

이용약관 | 피드백

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