TypeCode (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

org.omg.CORBA
클래스 TypeCode

java.lang.Object 
  org.omg.CORBA.TypeCode

모든 구현된 인터페이스:: Serializable, IDLEntity

public abstract class TypeCode
extends Object
implements IDLEntity
extends Object
implements IDLEntity

특정의 CORBA 데이터형에 대한 정보를 포함하는 컨테이너입니다.

TypeCode 객체의 사용법은 다음과 같습니다.

Dynamic Invocation Interface인 경우 -- 반환값의 실제의 인수 또는 형태를 나타낸다
NamedValue객체는 인수 및 반환값을 나타내기 위해서 사용된다. 그러한 컴퍼넌트의 1개는 Any 객체이며, Any객체는 TypeCode 객체를 그 컴퍼넌트의 1개 로서 가진다
많은 OMG IDL 선언의 일부인 형태 지정을 나타내는 인터페이스 리포지터리(repository)에 의해 사용되는

TypeCode 객체의 표현은 불투명합니다만, 추상적으로는 TypeCode 객체의 원가요소는 다음과 같습니다.

TCKind 클래스의 인스턴스로 설정되는 kind 필드
특정의 종류에 적응하는 0 이상의 추가 필드. 예를 들어 OMG IDL 형 1ong를 기술하는 TypeCode객체는 TCKind.tk_long 종류를 가져, 추가 필드를 가지지 않는다. OMG IDL 형 sequence<boolean, 10>를 기술하는 TypeCode는 값 TCKind.tk_sequence kind 필드 및 순서 요소의 형태 및 순서의 길이를 위한, 값 boolean 및 10 필드를 가진다

TypeCode객체는 다양한 방법으로 취득할 수 있습니다.

Any.insert_X 메서드의 호출로부터 취득한다. X는 기본적인 IDL 형. 이 메서드는 형태 X TypeCode 객체를 생성해, 그 객체를 Any 객체의 type 필드에 할당한다
ORB 클래스의 메서드의 호출로부터 얻는
예를 들어 다음의 메서드는 최대 30 문자의 string TypeCode 객체를 생성합니다.
```
 org.omg.CORBA.TypeCode tcString = orb.create_string_tc(30);
```
다음은 5개의 string array에 대해 TypeCode 객체를 생성합니다.
```
 org.omg.CORBA.TypeCode tcArray = orb.create_array_tc( 5, TCKind.tk_string);
```
다음은 Account 라는 이름의 인터페이스의 TypeCode 객체를 생성합니다.
```
 org.omg.CORBA.TypeCode tcInterface = orb.create_interface_tc( "thisId", "Account");
```
사용자 정의 IDL 형 Holder 클래스의 _type 메서드로부터의 반환값으로서 취득한다. 이러한 Holder 클래스는 idltojava 컴파일러에 의해 생성된다
CORBA 인터페이스 리포지터리(repository)로부터 얻는

TypeCode 클래스의 대부분의 메서드는 액세스용 메서드이며, TypeCode 객체에 포함되고 있는 정보는 특정의 형태에 고유합니다. 그 때문에 메서드는 메서드가 적용되는 종류의 형태 코드만으로 불려 갈 필요가 있습니다. 액세스용 메서드가 부적절한 종류의 형태 코드의 정보에 액세스 하려고 하면, 예외 TypeCodePackage.BadKind가 발생 됩니다. 예를 들어, discriminator_type 메서드가 union 이외로 불려가 면, BadKind가 발생 됩니다. 이것은, union 만이 판별자를 가지기 때문에입니다. 다음의 리스트는 메서드가 어느 종류의 형태 코드에 적용되는지를 나타냅니다.

다음의 메서드는 TypeCode 모든 종류로 호출할 수 있습니다 .

equal
kind

다음의 메서드는 objref, struct, union, enum, alias, exception, value, value_box, native 및 abstract_interface로 호출할 수 있습니다 .

id
name

다음의 메서드는 struct, union, enum 및 exception로 호출할 수 있습니다 .

member_count
member_name

다음의 메서드는 struct, union 및 exception로 호출할 수 있습니다 .

member_type(int index)

다음의 메서드는 union로 호출할 수 있습니다 .

member_label
discriminator_type
default_index

다음의 메서드는 string, sequence 및 array로 호출할 수 있습니다 .

length

다음의 메서드는 alias, sequence, array 및 value_box로 호출할 수 있습니다 .

content_type

다른 CORBA 유사 객체와 달리, TypeCode객체는 일반적인 IDL 파라미터로서 건네줄 수가 있습니다.

parameter 메서드 및 param_count 메서드 (추천 되지 않는다)는 매핑 되지 않습니다.

Java IDL는 CORBA 사양을 확장해, struct TypeCode로 허가 떠날 수 있어 모든 조작이 exception TypeCode에 서도 허가되도록 합니다.

생성자 개요
`TypeCode ()`

메서드 개요
`abstract TypeCode`	`concrete_base_type ()` 이 `TypeCode` 객체로 기술되는 치 형의 구상 기저형을 기술하는 `TypeCode` 객체를 리턴합니다.
`abstract TypeCode`	`content_type ()` 이 `TypeCode` 객체에 의해 기술되는 객체의 멤버의 IDL 형을 나타내는 `TypeCode` 객체를 리턴합니다.
`abstract int`	`default_index ()` 디폴트 멤버의 인덱스, 또는 디폴트의 멤버가 없는 경우는 -1을 리턴합니다.
`abstract TypeCode`	`discriminator_type ()` 디폴트의 멤버는 아닌 모든 라벨을 기술하는 `TypeCode` 객체를 리턴합니다.
`abstract boolean`	`equal (TypeCode tc)` 이 `TypeCode` 객체와 지정된 `TypeCode` 객체가 동일한지 어떤지를 비교합니다.
`abstract boolean`	`equivalent (TypeCode tc)` 이 `TypeCode` 객체와 지정된 `TypeCode` 객체가 동일한지 어떤지를 판정합니다.
`abstract short`	`fixed_digits ()` 이 `TypeCode` 객체로 기술된 fixed 형의 자리수를 리턴합니다.
`abstract short`	`fixed_scale ()` 이 `TypeCode` 객체로 기술된 fixed 형의 스케일을 리턴합니다.
`abstract TypeCode`	`get_compact_typecode ()` 모든 옵션명 및 멤버명 필드를 삭제합니다만, 별명형 코드는 모두 그대로 남깁니다.
`abstract String`	`id ()` 이 `TypeCode` 객체의 형태를 포괄적으로 식별하는 리포지터리(repository) ID를 취득합니다.
`abstract TCKind`	`kind ()` 이 `TypeCode` 객체의 종류를 취득합니다.
`abstract int`	`length ()` 이 `TypeCode` 객체에 의해 기술되는 형태의 요소수를 리턴합니다.
`abstract int`	`member_count ()` 이 `TypeCode` 객체로 기술되는 형태의 멤버수를 취득합니다.
`abstract Any`	`member_label (int index)` 지정된 인덱스에 의해 식별되는 공용체 멤버의 라벨을 취득합니다.
`abstract String`	`member_name (int index)` 지정된 인덱스로 식별되는 멤버의 단순명을 취득합니다.
`abstract TypeCode`	`member_type (int index)` 지정된 인덱스로 식별되는 멤버의 형태를 기술하는 `TypeCode` 객체를 취득합니다.
`abstract short`	`member_visibility (int index)` 지정된 인덱스의 멤버의 가시성을 나타내는 정수를 리턴합니다.
`abstract String`	`name ()` 포위 스코프내에서 `TypeCode` 객체를 식별하는 단순명을 취득합니다.
`abstract short`	`type_modifier ()` 이 `TypeCode` 객체가 기술하는 치 형의 수식자를 나타내는 정수를 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

생성자 상세

TypeCode

public TypeCode()

메서드의 상세

equal

public abstract boolean equal(TypeCode  tc)

이 TypeCode 객체와 지정된 TypeCode 객체가 동일한지 어떤지를 비교합니다. 2개의 TypeCode객체는 그것들이 교환 가능하고, TypeCode 조작이 적용되었을 때에 같은 결과가 되는 경우에 같습니다.

파라미터:: tc - 비교 대상의 TypeCode 객체
반환값:: 2개의 형태 코드가 동일한 경우는 true, 그렇지 않은 경우는 false

equivalent

public abstract boolean equivalent(TypeCode  tc)

이 TypeCode 객체와 지정된 TypeCode 객체가 동일한지 어떤지를 판정합니다.

파라미터:: tc - 이 형태 코드와 비교하는 형태 코드
반환값:: 지정된 형태 코드가 이 형태 코드와 같은 경우는 true, 그렇지 않은 경우는 false

get_compact_typecode

public abstract TypeCode  get_compact_typecode()

모든 옵션명 및 멤버명 필드를 삭제합니다만, 별명형 코드는 모두 그대로 남깁니다.

반환값:: 그대로 남기는 별명형 코드를 제외한, 옵션명과 멤버명 필드가 삭제된 TypeCode 객체
관련 항목:: CORBA package comments for unimplemented features

kind

public abstract TCKind  kind()

이 TypeCode 객체의 종류를 취득합니다. 형태 코드의 종류는 어느 TypeCode 메서드가 정상적으로 호출할 수 있는 지를 나타냅니다.

kind 메서드는 어느 TypeCode 객체에서도 호출할 수 있습니다 .

반환값:: 이 TypeCode 객체의 kind 필드의 값을 나타내는 TCKind 인스턴스

id

public abstract String  id()
                   throws BadKind

이 TypeCode 객체의 형태를 포괄적으로 식별하는 리포지터리(repository) ID를 취득합니다.

id 메서드는 객체 참조, 구조체, 공용체, 열거, 앨리어스(alias), 예외, value 형, boxed value 형, 네이티브 및 추상 인터페이스의 형태 코드로 호출할 수 있습니다 . 객체 참조, 예외, value 형, boxed value 형, 네이티브, 추상 인터페이스 TypeCode객체는 항상 리포지터리(repository) ID를 가집니다. 인터페이스 리포지터리(repository) 또는 ORB.create_operation_list 메서드로부터 취득되는 구조체, 공용체, 열거 및 앨리어스(alias) TypeCode 객체도 항상 리포지터리(repository) ID를 가집니다. 리포지터리(repository) ID가 없는 경우, 메서드는 비어있는 캐릭터 라인을 리턴합니다.

반환값:: 이 TypeCode 객체의 리포지터리(repository) ID. 리포지터리(repository) ID가 없는 경우는 비어있는 캐릭터 라인
예외:: BadKind - 메서드가 부적절한 종류의 TypeCode 객체로 불려 갔을 경우

name

public abstract String  name()
                     throws BadKind

포위 스코프내에서 TypeCode 객체를 식별하는 단순명을 취득합니다. 이름은 리포지터리(repository)에 로컬이므로TypeCode 객체로부터 리턴된 이름은 특정의 리포지터리(repository) 내부의 형태의 이름과는 일치하지 않는 경우가 있어, 비어있는 캐릭터 라인의 경우도 있습니다.

name 메서드는 객체 참조, 구조체, 공용체, 열거, 앨리어스(alias), 예외, value 형, boxed value 형, 네이티브 및 추상 인터페이스 TypeCode 객체로 호출할 수 있습니다 .

반환값:: 이 TypeCode 객체를 식별하는 이름, 또는 비어있는 캐릭터 라인
예외:: BadKind - 메서드가 부적절한 종류의 TypeCode 객체로 불려 갔을 경우

member_count

public abstract int member_count()
                          throws BadKind

이 TypeCode 객체로 기술되는 형태의 멤버수를 취득합니다.

member_count 메서드는 구조체, 공용체, 열거 TypeCode 객체로 호출할 수 있습니다 . Java IDL는 CORBA 사양을 확장해, 이 메서드가 예외에도 작용할 수 있도록 합니다.

반환값:: 이 TypeCode 객체에 의해 기술되는 형태를 구성하는 멤버의 수
예외:: BadKind - 메서드가 부적절한 종류의 TypeCode 객체로 불려 갔을 경우

member_name

public abstract String  member_name(int index)
                            throws BadKind,

                                   Bounds

지정된 인덱스로 식별되는 멤버의 단순명을 취득합니다. 이름은 리포지터리(repository)에 로컬이기 때문에 TypeCode 객체로부터 리턴된 이름은 특정의 리포지터리(repository)의 멤버명으로 일치하지 않는 경우가 있어, 비어있는 캐릭터 라인인 경우도 있습니다.

member_name 메서드는 구조체, 공용체 및 열거 TypeCode 객체로 호출할 수 있습니다 . Java IDL는 CORBA 사양을 확장해, 이 메서드가 예외도 처리할 수 있도록 합니다.

파라미터:: index - 이름이 요구되는 멤버의 인덱스
반환값:: 인덱스로 식별되는 멤버의 단순명 또는 비어있는 캐릭터 라인
예외:: Bounds - 지정된 인덱스가 형태를 구성하는 멤버의 수로 동일한지, 그것보다 큰 값의 경우; BadKind - 메서드가 부적절한 종류의 TypeCode 객체로 불려 갔을 경우

member_type

public abstract TypeCode  member_type(int index)
                              throws BadKind,

                                     Bounds

지정된 인덱스로 식별되는 멤버의 형태를 기술하는 TypeCode 객체를 취득합니다.

member_type 메서드는 구조체 및 공용체 TypeCode 객체로 호출할 수 있습니다 . Java IDL는 CORBA 사양을 확장해, 이 메서드가 예외도 처리할 수 있도록 합니다.

파라미터:: index - 형 정보가 요구되는 멤버의 인덱스
반환값:: 지정된 인덱스의 멤버를 기술하는 TypeCode 객체
예외:: Bounds - 지정된 인덱스가 형태를 구성하는 멤버의 수로 동일한지, 그것보다 큰 값의 경우; BadKind - 메서드가 부적절한 종류의 TypeCode 객체로 불려 갔을 경우

member_label

public abstract Any  member_label(int index)
                          throws BadKind,

                                 Bounds

지정된 인덱스에 의해 식별되는 공용체 멤버의 라벨을 취득합니다. 디폴트의 멤버의 경우, 라벨은 0 8중창입니다.

member_label 메서드는 공용체 TypeCode 객체만으로 호출할 수 있습니다 .

파라미터:: index - 라벨이 요구되는 공용체 멤버의 인덱스
반환값:: 요구된 공용체 멤버의 라벨을 기술하는 Any 객체, 또는 디폴트의 멤버의 0 8중창
예외:: Bounds - 지정된 인덱스가 공용체를 구성하는 멤버의 수로 동일한지, 그것보다 큰 값의 경우; BadKind - 메서드가 공용체가 아닌 TypeCode 객체로 불려 갔을 경우

discriminator_type

public abstract TypeCode  discriminator_type()
                                     throws BadKind

디폴트의 멤버는 아닌 모든 라벨을 기술하는 TypeCode 객체를 리턴합니다. discriminator_type 메서드는 공용체 TypeCode 객체만으로 호출할 수 있습니다 .

반환값:: 디폴트의 멤버가 아닌 라벨을 기술하는 TypeCode 객체
예외:: BadKind - 메서드가 공용체가 아닌 TypeCode 객체로 불려 갔을 경우

default_index

public abstract int default_index()
                           throws BadKind

디폴트 멤버의 인덱스, 또는 디폴트의 멤버가 없는 경우는 -1을 리턴합니다.

default_index 메서드는 공용체 TypeCode 객체만으로 호출할 수 있습니다 .

반환값:: 디폴트의 멤버의 인덱스. 디폴트의 멤버가 없는 경우는 -1
예외:: BadKind - 메서드가 공용체가 아닌 TypeCode 객체로 불려 갔을 경우

length

public abstract int length()
                    throws BadKind

이 TypeCode 객체에 의해 기술되는 형태의 요소수를 리턴합니다. 캐릭터 라인 및 순서의 경우는 바운드가 돌려주고져 0 은 안 바운드의 캐릭터 라인 또는 순서를 나타냅니다. 배열의 경우, 배열의 요소수가 리턴됩니다 .

length 메서드는 캐릭터 라인, 순서 및 배열 TypeCode 객체로 호출할 수 있습니다 .

반환값:: 캐릭터 라인 및 순서의 바운드, 또는 배열의 요소수
예외:: BadKind - 메서드가 부적절한 종류의 TypeCode 객체로 불려 갔을 경우

content_type

public abstract TypeCode  content_type()
                               throws BadKind

이 TypeCode 객체에 의해 기술되는 객체의 멤버의 IDL 형을 나타내는 TypeCode 객체를 리턴합니다. 순서 및 배열의 경우는 요소의 형태가 리턴됩니다 . 앨리어스(alias)의 경우는 원의 형태가 리턴됩니다 . 다차원 배열은 차원 마다 1개의 TypeCode 객체를 상자로 하는 것으로 나타내집니다. boxed value 형의 경우는 boxed 형이 리턴됩니다 .

content_type 메서드는 순서, 배열, 앨리어스(alias) 및 boxed value 형 TypeCode 객체로 호출할 수 있습니다 .

반환값:: 순서 및 배열의 요소의 형태, 앨리어스(alias)의 원의 형태, 또는 boxed value 형의 boxed 형을 나타내는 TypeCode 객체
예외:: BadKind - 메서드가 부적절한 종류의 TypeCode 객체로 불려 갔을 경우

fixed_digits

public abstract short fixed_digits()
                            throws BadKind

이 TypeCode 객체로 기술된 fixed 형의 자리수를 리턴합니다. 예를 들어 수치 3000.275d 형태 코드는 fixed>7, 3< 입니다. 7 은 정밀도, 3 은 스케일입니다.

반환값:: 자리수의 총수
예외:: BadKind - 이 메서드가 부적절한 종류의 TypeCode 객체로 불려 갔을 경우

fixed_scale

public abstract short fixed_scale()
                           throws BadKind

이 TypeCode 객체로 기술된 fixed 형의 스케일을 리턴합니다. 정의 수치는 소수점의 우측에 있는 자리수를 나타냅니다. 예를 들어 수치 3000d 형태 코드는 fixed>4, 0> 입니다. 최초의 수치는 정밀도로 2번째의 수치는 스케일입니다. 부의 수치도 가능합니다. 그 경우는 소수점의 좌측으로 제로를 붙입니다. 이 경우 fixed>1, -3<는 수치 3000d 형태 코드가 됩니다.

반환값:: 이 TypeCode 객체로 기술되는 fixed 형의 스케일
예외:: BadKind - 이 메서드가 부적절한 종류의 TypeCode 객체로 불려 갔을 경우

member_visibility

public abstract short member_visibility(int index)
                                 throws BadKind,

                                        Bounds

지정된 인덱스의 멤버의 가시성을 나타내는 정수를 리턴합니다.이 조작은 비 boxed 치 TypeCode 객체만으로 호출할 수 있습니다 .

파라미터:: index - 값의 인덱스를 나타내는 int
반환값:: PRIVATE_MEMBER.value 또는 PUBLIC_MEMBER.value
예외:: BadKind - 이 메서드가 치 형이 아닌 TypeCode 객체로 불려 갔을 경우; Bounds - 지정한 인덱스가 범위외에 있는 경우
관련 항목:: CORBA package comments for unimplemented features

type_modifier

public abstract short type_modifier()
                             throws BadKind

이 TypeCode 객체가 기술하는 치 형의 수식자를 나타내는 정수를 리턴합니다. 리턴된 정수는 VM_NONE.value, VM_ABSTRACT.value, VM_CUSTOM.value, 또는 VM_TRUNCATABLE.value 어떤 것인가일 필요가 있습니다.

반환값:: 이 TypeCode 객체로 기술되는 치 형을 기술하는 정수
예외:: BadKind - 이 메서드가 치 형이 아닌 TypeCode 객체로 불려 갔을 경우
관련 항목:: CORBA package comments for unimplemented features

concrete_base_type

public abstract TypeCode  concrete_base_type()
                                     throws BadKind

이 TypeCode 객체로 기술되는 치 형의 구상 기저형을 기술하는 TypeCode 객체를 리턴합니다. 구상 기저형이 없는 경우는 null을 리턴합니다.

반환값:: 이 TypeCode 객체로 기술되는 치 형의 구상 기저형을 기술하는 TypeCode 객체
예외:: BadKind - 이 메서드가 비 boxed 치 형의 TypeCode 객체로 불려 갔을 경우
관련 항목:: CORBA package comments for unimplemented features

개요