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

MapMessage

맵 메시지는 본문이 각 값에 연관된 데이터 유형이 있는 이름-값 쌍 세트를 구성하는 메시지입니다.

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

응용프로그램이 이름-값 쌍의 값을 가져올 때 값은 XMS에 의해 다른 데이터 유형으로 변환될 수 있습니다. 이 형식의 암시적 변환에 대한 자세한 정보는 맵 메시지를 참조하십시오.

관련 참조
맵 메시지

메소드

메소드 요약:
메소드 설명
getBoolean 맵 메시지 본문에서 이름으로 식별된 부울 값을 가져옵니다.
getByte 맵 메시지 본문에서 이름으로 식별된 바이트를 가져옵니다.
getBytes 맵 메시지 본문에서 이름으로 식별된 바이트 배열을 가져옵니다.
getChar 맵 메시지 본문에서 이름으로 식별된 문자를 가져옵니다.
getDouble 맵 메시지 본문에서 이름으로 식별된 배정밀도 부동 소수점 수를 가져옵니다.
getFloat 맵 메시지 본문에서 이름으로 식별된 부동 소수점 수를 가져옵니다.
getInt 맵 메시지 본문에서 이름으로 식별된 정수를 가져옵니다.
getLong 맵 메시지 본문에서 이름으로 식별된 Long 정수를 가져옵니다.
getMap 맵 메시지 본문에서 이름-값 쌍 목록을 가져옵니다.
getObject 맵 메시지 본문에서 이름-값 쌍의 값 및 데이터 유형을 가져옵니다.
getShort 맵 메시지 본문에서 이름으로 식별된 Short 정수를 가져옵니다.
getString 맵 메시지 본문에서 이름으로 식별된 문자열을 가져옵니다.
itemExists 맵 메시지 본문에 지정된 이름의 이름-값 쌍이 있는지 검사합니다.
setBoolean 맵 메시지 본문에 부울 값을 설정합니다.
setByte 맵 메시지 본문에 바이트를 설정합니다.
setBytes 맵 메시지 본문에 바이트 배열을 설정합니다.
setChar 맵 메시지 본문에 2바이트 문자를 설정합니다.
setDouble 맵 메시지 본문에 배정밀도 부동 소수점 수를 설정합니다.
setFloat 맵 메시지 본문에 부동 소수점 수를 설정합니다.
setInt 맵 메시지 본문에 정수를 설정합니다.
setLong 맵 메시지 본문에 Long 정수를 설정합니다.
setObject 맵 메시지 본문에서 값을 지정된 데이터 유형으로 설정합니다.
setShort 맵 메시지 본문에 Short 정수를 설정합니다.
setString 맵 메시지 본문에 문자열을 설정합니다.

getBoolean – 부울 값 가져오기

인터페이스:
xmsBOOL getBoolean(const String & name) const;

맵 메시지 본문에서 이름으로 식별된 부울 값을 가져옵니다.

매개변수:
name(입력)
부울 값을 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
리턴값:
맵 메시지 본문에서 검색된 부울 값입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getByte – 바이트 가져오기

인터페이스:
xmsSBYTE getByte(const String & name) const;

맵 메시지 본문에서 이름으로 식별된 바이트를 가져옵니다.

매개변수:
name(입력)
바이트를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
리턴값:
맵 메시지 본문에서 검색된 바이트입니다. 바이트에 대한 데이터 변환은 수행되지 않습니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getBytes – 바이트 가져오기

인터페이스:
xmsINT getBytes(const String & name,
                xmsSBYTE *buffer,
                const xmsINT bufferLength,
                xmsINT *actualLength) const;

맵 메시지 본문에서 이름으로 식별된 바이트 배열을 가져옵니다.

이 메소드의 사용 방법에 대한 자세한 정보는 바이트 배열을 리턴하는 C++ 메소드를 참조하십시오.

매개변수:
name(입력)
바이트 배열을 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
buffer(출력)
바이트 배열을 포함하는 버퍼입니다. 리턴되는 바이트에 대한 데이터 변환은 수행되지 않습니다.
bufferLength(입력)
버퍼 길이(바이트)입니다. XMSC_QUERY_SIZE를 지정한 경우 바이트 배열은 actualLength 매개변수로 리턴되지 않습니다.
actualLength(출력)
배열의 바이트 수입니다. 입력에서 널 포인터를 지정한 경우 배열의 길이는 리턴되지 않습니다.
리턴값:
배열의 바이트 수입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getChar – 문자 가져오기

인터페이스:
xmsCHAR16 getChar(const String & name) const;

맵 메시지 본문에서 이름으로 식별된 문자를 가져옵니다.

매개변수:
name(입력)
문자를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
리턴값:
맵 메시지 본문에서 검색된 문자입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getDouble – 배정밀도 부동 소수점 수 가져오기

인터페이스:
xmsDOUBLE getDouble(const String & name) const;

맵 메시지 본문에서 이름으로 식별된 배정밀도 부동 소수점 수를 가져옵니다.

매개변수:
name(입력)
배정밀도 부동 소수점 수를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
리턴값:
맵 메시지 본문에서 검색된 배정밀도 부동 소수점 수
예외:
  • XMS_X_GENERAL_EXCEPTION

getFloat – 부동 소수점 수 가져오기

인터페이스:
xmsFLOAT getFloat(const String & name) const;

맵 메시지 본문에서 이름으로 식별된 부동 소수점 수를 가져옵니다.

매개변수:
name(입력)
부동 소수점 수를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
리턴값:
맵 메시지 본문에서 검색된 부동 소수점 수입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getInt – 정수 가져오기

인터페이스:
xmsINT getInt(const String & name) const;

맵 메시지 본문에서 이름으로 식별된 정수를 가져옵니다.

매개변수:
name(입력)
정수를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
리턴값:
맵 메시지 본문에서 검색된 정수입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getLong – Long 정수 가져오기

인터페이스:
xmsLONG getLong(const String & name) const;

맵 메시지 본문에서 이름으로 식별된 Long 정수를 가져옵니다.

매개변수:
name(입력)
Long 정수를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
리턴값:
맵 메시지 본문에서 검색된 Long 정수입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getMap – 이름-값 쌍 가져오기

인터페이스:
Iterator getMap() const;

맵 메시지 본문에서 이름-값 쌍 목록을 가져옵니다.

이 메소드는 Property 오브젝트의 목록을 캡슐화하는 반복기를 리턴합니다. 각 Property 오브젝트는 이름-값 쌍을 캡슐화합니다. 응용프로그램은 반복기를 사용하여 각 이름-값 쌍에 차례로 액세스할 수 있습니다.

주: 이와 동등한 JMS 메소드는 약간 다른 기능을 수행합니다. JMS 메소드는 맵 메시지 본문에 값은 리턴하지 않고 이름 목록만 리턴합니다.
매개변수:
없음
리턴값:
Iterator 오브젝트입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

getObject – 오브젝트 가져오기

인터페이스:
xmsOBJECT_TYPE getObject(const String & name,
                         xmsSBYTE *buffer,
                         const xmsINT bufferLength,
                         xmsINT *actualLength) const;

맵 메시지 본문에서 이름-값 쌍의 값 및 데이터 유형을 가져옵니다. 이름-값 쌍은 이름으로 식별할 수 있습니다.

이 메소드의 사용 방법에 대한 자세한 정보는 바이트 배열을 리턴하는 C++ 메소드를 참조하십시오.

매개변수:
name(입력)
이름-값 쌍의 이름을 캡슐화하는 String 오브젝트입니다.
buffer(출력)
바이트 배열로 리턴되는 값을 포함하는 버퍼입니다. 값이 문자열이고 데이터 변환이 필수인 경우 이 매개변수는 변환 후 값입니다.
bufferLength(입력)
버퍼 길이(바이트)입니다. XMSC_QUERY_SIZE를 지정한 경우 값은 리턴되지 않고 actualLength 매개변수로 길이가 리턴됩니다.
actualLength(출력)
값의 길이(바이트)입니다. 값이 문자열이고 데이터 변환이 필수인 경우 이 매개변수는 변환 후 길이입니다. 입력에서 널 포인트를 지정한 경우 길이가 리턴되지 않습니다.
리턴값:
다음 오브젝트 유형 중 하나를 값의 데이터 유형으로 사용할 수 있습니다.
  • XMS_OBJECT_TYPE_BOOL
  • XMS_OBJECT_TYPE_BYTE
  • XMS_OBJECT_TYPE_BYTEARRAY
  • XMS_OBJECT_TYPE_CHAR
  • XMS_OBJECT_TYPE_DOUBLE
  • XMS_OBJECT_TYPE_FLOAT
  • XMS_OBJECT_TYPE_INT
  • XMS_OBJECT_TYPE_LONG
  • XMS_OBJECT_TYPE_SHORT
  • XMS_OBJECT_TYPE_STRING
예외:
XMS_X_GENERAL_EXCEPTION

getShort – Short 정수 가져오기

인터페이스:
xmsSHORT getShort(const String & name) const;

맵 메시지 본문에서 이름으로 식별된 Short 정수를 가져옵니다.

매개변수:
name(입력)
Short 정수를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
리턴값:
맵 메시지 본문에서 검색된 Short 정수
예외:
  • XMS_X_GENERAL_EXCEPTION

getString – 문자열 가져오기

인터페이스:
String getString(const String & name) const;

맵 메시지 본문에서 이름으로 식별된 문자열을 가져옵니다.

매개변수:
name(입력)
맵 메시지 본문에 있는 문자열을 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
리턴값:
맵 메시지 본문에서 검색된 문자열을 캡슐화하는 String 오브젝트입니다. 데이터 변환이 필수인 경우 이 매개변수는 변환 후 문자열입니다.
예외:
  • XMS_X_GENERAL_EXCEPTION

itemExists – 이름-값 쌍 존재 여부 검사

인터페이스:
xmsBOOL itemExists(const String & name) const;

맵 메시지 본문에 지정된 이름의 이름-값 쌍이 있는지 검사합니다.

매개변수:
name(입력)
이름-값 쌍의 이름을 캡슐화하는 String 오브젝트입니다.
리턴값:
  • xmsTRUE - 맵 메시지 본문에 지정된 이름의 이름-값 쌍이 있는 경우
  • xmsFALSE - 맵 메시지 본문에 지정된 이름의 이름-값 쌍이 없는 경우
예외:
  • XMS_X_GENERAL_EXCEPTION

setBoolean – 세트 값 설정

인터페이스:
xmsVOID setBoolean(const String & name,
                   const xmsBOOL value);

맵 메시지 본문에 부울 값을 설정합니다.

매개변수:
name(입력)
맵 메시지 본문에 있는 부울 값을 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
value(입력)
설정할 부울 값입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setByte – 바이트 설정

인터페이스:
xmsVOID setByte(const String & name,
                const xmsSBYTE value);

맵 메시지 본문에 바이트를 설정합니다.

매개변수:
name(입력)
맵 메시지 본문에 있는 바이트를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
value(입력)
설정할 바이트입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setBytes – 세트 설정

인터페이스:
xmsVOID setBytes(const String & name,
                 const xmsSBYTE *value,
                 const xmsINT length);

맵 메시지 본문에 바이트 배열을 설정합니다.

매개변수:
name(입력)
맵 메시지 본문에 있는 바이트 배열을 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
value(입력)
설정할 바이트 배열입니다.
length(입력)
배열의 바이트 수입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setChar – 세트 설정

인터페이스:
xmsVOID setChar(const String & name,
                const xmsCHAR16 value);

맵 메시지 본문에 2바이트 문자를 설정합니다.

매개변수:
name(입력)
맵 메시지 본문에 있는 문자를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
value(입력)
설정할 문자입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setDouble – 배정밀도 부동 소수점 수 설정

인터페이스:
xmsVOID setDouble(const String & name,
                  const xmsDOUBLE value);

맵 메시지 본문에 배정밀도 부동 소수점 수를 설정합니다.

매개변수:
name(입력)
맵 메시지 본문에 있는 배정밀도 부동 소수점 수를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
value(입력)
설정할 배정밀도 부동 소수점 수입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setFloat – 부동 소수점 수 설정

인터페이스:
xmsVOID setFloat(const String & name,
                 const xmsFLOAT value);

맵 메시지 본문에 부동 소수점 수를 설정합니다.

매개변수:
name(입력)
맵 메시지 본문에 있는 부동 소수점 수를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
value(입력)
설정할 부동 소수점 수입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setInt – 세트 설정

인터페이스:
xmsVOID setInt(const String & name,
               const xmsINT value);

맵 메시지 본문에 정수를 설정합니다.

매개변수:
name(입력)
맵 메시지 본문에 있는 정수를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
value(입력)
설정할 정수입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setLong – Long 정수 설정

인터페이스:
xmsVOID setLong(const String & name,
                const xmsLONG value);

맵 메시지 본문에 Long 정수를 설정합니다.

매개변수:
name(입력)
맵 메시지 본문에 있는 Long 정수를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
value(입력)
설정할 Long 정수입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setObject – 세트 설정

인터페이스:
xmsVOID setObject(const String & name,
                  const xmsOBJECT_TYPE objectType,
                  const xmsSBYTE *value,
                  const xmsINT length);

맵 메시지 본문에서 값을 지정된 데이터 유형으로 설정합니다.

매개변수:
name(입력)
맵 메시지 본문에 있는 값을 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
objectType(입력)
다음 오브젝트 유형 중 하나를 값의 데이터 유형으로 사용해야 합니다.
  • XMS_OBJECT_TYPE_BOOL
  • XMS_OBJECT_TYPE_BYTE
  • XMS_OBJECT_TYPE_BYTEARRAY
  • XMS_OBJECT_TYPE_CHAR
  • XMS_OBJECT_TYPE_DOUBLE
  • XMS_OBJECT_TYPE_FLOAT
  • XMS_OBJECT_TYPE_INT
  • XMS_OBJECT_TYPE_LONG
  • XMS_OBJECT_TYPE_SHORT
  • XMS_OBJECT_TYPE_STRING
value(입력)
설정할 값을 포함하는 바이트 배열입니다.
length(입력)
배열의 바이트 수입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setShort – Short 정수 설정

인터페이스:
xmsVOID setShort(const String & name,
                 const xmsSHORT value);

맵 메시지 본문에 Short 정수를 설정합니다.

매개변수:
name(입력)
맵 메시지 본문에 있는 Short 정수를 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
value(입력)
설정할 Short 정수입니다.
리턴값:
Void
예외:
  • XMS_X_GENERAL_EXCEPTION

setString – 문자열 설정

인터페이스:
xmsVOID setString(const String & name,
                  const String value);

맵 메시지 본문에 문자열을 설정합니다.

매개변수:
name(입력)
맵 메시지 본문에 있는 문자열을 식별하는 이름을 캡슐화하는 String 오브젝트입니다.
value(입력)
설정할 문자열을 캡슐화하는 String 오브젝트입니다.
리턴값:
Void
예외:
  • 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 웹 사이트 참조)