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

Destination

목적지는 응용프로그램이 메시지를 전송하는 위치이거나 응용프로그램이 메시지를 수신하는 소스입니다.

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

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

관련 개념
연결 팩토리 및 연결
WebSphere 서비스 통합 버스와의 연결
목적지
목적지 와일드 카드
주제 URI(uniform resource identifier)
대기열 URI(uniform resource identifier)
임시 목적지
관련 태스크
관리 오브젝트 작성

생성자

생성자 요약:
생성자 설명
Destination 지정된 목적지 유형 및 이름을 사용하여 목적지를 작성합니다.
Destination 지정된 URI(Uniform Resource Identifier)를 사용하여 목적지를 작성합니다.

Destination – 목적지 작성(유형 및 이름 지정)

인터페이스:
Destination(const xmsDESTINATION_TYPE destinationType,
            const String & destinationName);

지정된 목적지 유형 및 이름을 사용하여 목적지를 작성합니다.

목적지가 대기열인 경우 이 생성자가 메시지 서버에 대기열을 작성하지 않습니다. 따라서 응용프로그램이 이 생성자를 호출하기 전에 대기열을 작성해야 합니다.

매개변수:
destinationType(입력)
다음 값 중 하나를 목적지 유형으로 사용해야 합니다.
  • XMS_DESTINATION_TYPE_QUEUE
  • XMS_DESTINATION_TYPE_TOPIC
destinationName(입력)
목적지의 이름을 캡슐화하는 String 오브젝트는 대기열의 이름이나 주제의 이름을 캡슐화하는 문자열입니다.
목적지가 WebSphere MQ 대기열인 경우 다음 방법 중 하나를 사용하여 목적지의 이름을 지정할 수 있습니다.
  • QName
  • QMgrName/QName
QNameWebSphere MQ 대기열의 이름이며 QMgrNameWebSphere MQ 대기열 관리자의 이름입니다. WebSphere MQ 대기열 이름 분석 프로세스는 QNameQMgrName의 값을 사용하여 실제 목적지 대기열을 판별합니다. 대기열 이름 분석 프로세스에 대한 자세한 정보는 WebSphere MQ Application Programming Guide를 참조하십시오.
예외:
  • XMS_X_GENERAL_EXCEPTION

Destination – 목적지 작성(URI 사용)

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

지정된 URI(Uniform Resource Identifier)를 사용하여 목적지를 작성합니다. URI에 의해 지정되지 않은 목적지의 등록 정보는 기본값을 사용합니다.

목적지가 대기열인 경우 이 생성자가 메시지 서버에 대기열을 작성하지 않습니다. 따라서 응용프로그램이 이 생성자를 호출하기 전에 대기열을 작성해야 합니다.

매개변수:
URI(입력)
URI를 캡슐화하는 String 오브젝트입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

메소드

메소드 요약:
메소드 설명
~Destination 목적지를 삭제합니다.
getHandle C 응용프로그램이 목적지에 액세스하기 위해 사용할 핸들을 가져옵니다.
getName 목적지의 이름을 가져옵니다.
getTypeId 목적지의 유형을 가져옵니다.
isNull Destination 오브젝트가 널 오브젝트인지 여부를 판별합니다.
toString 목적지 이름을 URI(Uniform Resource Identifier) 형식으로 가져옵니다.

~Destination – 목적지 삭제

인터페이스:
virtual ~Destination();

목적지를 삭제합니다.

목적지가 대기열인 경우 대기열이 XMS 임시 대기열용으로 작성되지 않은 한 이 메소드가 메시지 서버에서 대기열을 삭제하지 않습니다.

응용프로그램이 이미 삭제된 목적지를 삭제하려고 하면 호출이 무시됩니다.

매개변수:
없음
예외:
  • XMS_X_GENERAL_EXCEPTION

getHandle – 핸들 가져오기

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

C 응용프로그램이 목적지에 액세스하기 위해 사용할 핸들을 가져옵니다.

매개변수:
없음
리턴값:
목적지의 핸들입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getName – 목적지 이름 가져오기

인터페이스:
String getName() const;

목적지의 이름을 가져옵니다.

매개변수:
없음
리턴값:
목적지의 이름을 캡슐화하는 String 오브젝트입니다. 이 이름은 대기열의 이름 또는 주제의 이름입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getTypeId – 목적지 유형 가져오기

인터페이스:
xmsDESTINATION_TYPE getTypeId();

목적지의 유형을 가져옵니다.

매개변수:
없음
리턴값:
다음 값 중 하나를 목적지 유형으로 사용할 수 있습니다.
  • XMS_DESTINATION_TYPE_QUEUE
  • XMS_DESTINATION_TYPE_TOPIC
예외:
  • XMS_X_GENERAL_EXCEPTION

isNull – 널 여부 확인

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

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

매개변수:
없음
리턴값:
  • xmsTRUE - Destination 오브젝트가 널 오브젝트인 경우
  • xmsFALSE - Destination 오브젝트가 널 오브젝트가 아닌 경우
예외:
  • XMS_X_GENERAL_EXCEPTION

toString – URI 형식으로 목적지 이름 가져오기

인터페이스:
String toString() const;

목적지 이름을 URI(Uniform Resource Identifier) 형식으로 가져옵니다.

매개변수:
없음
리턴값:
URI를 캡슐화하는 String 오브젝트입니다. URI는 대기열 URI 또는 주제 URI입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

상속된 메소드


Reference topic

이용약관 | 피드백

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