ORB (Java 2 Platform SE 5.0)

ORB 클래스는 범용 CORBA 기능을 캡슐화해서, 다음과 같은 조작을 실시합니다. 항목의 5 로 6 (ORB 클래스의 대부분의 메서드를 포함한다)은 보통, Dynamic Invocation Interface (DII)와 Dynamic Skeleton Interface (DSI)로 사용됩니다. 이러한 인터페이스는 개발자가 직접 사용할 수도 있습니다만, 일반적으로 ORB 로 내부적으로 사용되기 때문에 일반의 프로그래머가 볼 것은 없습니다.

정의 끝난 프로퍼티와 환경 파라미터의 값을 지정해 ORB 구현을 초기화한다
resolve_initial_references 메서드를 사용해, 네임 서비스등의 서비스에의 초기 객체 참조를 취득한다
객체 참조와 캐릭터 라인의 사이의 변환을 실시한다
ORB와 서번트 (CORBA 객체 구현의 인스턴스) 사이에서의 접속의 확립과 분리를 실시한다
다음과 같은 객체를 생성한다
- TypeCode
- Any
- NamedValue
- Context
- Environment
- 이러한 객체가 포함되고 있는 리스트 (NVList 등)
DII 복수의 메세지를 송신한다

ORB 클래스를 사용하면, 객체가 네트워크상의 어디에 구현되고 있어도, 그 참조를 취득할 수 있습니다.

어플리케이션이나 애플릿은 3개의 init 메서드의 1개를 사용해 그 자체를 ORB에 대해서 초기화하는 것으로써, CORBA 환경에의 액세스를 취득합니다. 3개의 메서드중 2개는 다음의 겉(표)에 기재되어 있는 프로퍼티 (이름과 값과의 관련짓고)를 사용합니다.

표준 Java CORBA 프로퍼티
프로퍼티명	프로퍼티치
org.omg.CORBA.ORBClass	ORB 구현의 클래스명
org.omg.CORBA.ORBSingletonClass	`init()`가 돌려주는 ORB 클래스명

이러한 프로퍼티에의해 다양한 벤더의 ORB 구현이 플러그 인 가능하게 됩니다.

ORB 인스턴스의 생성시에는 ORB 구현의 클래스명이 다음의 표준 검색순서로 검색됩니다.

Applet 파라미터 또는 어플리케이션 캐릭터 라인 배열이 있으면 체크인 한다
프로퍼티 파라미터가 있으면 체크인 한다
System 프로퍼티에 체크인 한다
user.home 디렉토리에 있는 orb.properties 파일에 체크인 한다 (존재하는 경우)
java.home/lib 디렉토리에 있는 orb.properties 파일에 체크인 한다 (존재하는 경우)
하드 코드 된 디폴트 동작하러 돌아온다 (Java IDL 구현을 사용한다)

Java IDL는 풀 기능의 ORB와 단체 ORB에 대해서 디폴트 구현을 제공합니다. init 메서드에 파라미터를 지정하지 않았던 경우는 디폴트의 단체 ORB가 리턴됩니다 . init 메서드에 파라미터를 지정했을 경우, ORB 클래스를 지정하지 않았을 때는 Java IDL ORB 구현이 리턴됩니다 .

다음에 디폴트의 단체 ORB 로 초기화되는 ORB 객체를 작성하는 코드를 나타냅니다. 악의가 있는 애플릿이 형태 코드의 작성 이외의 조작을 할 수 없게, 이 ORB 구현은 제한부입니다. 이 구현은 가상 머신 전체로 인스턴스가 1개 밖에 없기 때문에 단체 (singleton)로 불립니다.

 ORB orb = ORB.init();

다음에 어플리케이션의 ORB 객체를 작성하는 코드를 나타냅니다. args 파라미터는 어플리케이션의 main 메서드로 가리키는 인수를 나타냅니다. 프로퍼티는 ORB 클래스를 「SomeORBImplementation」로서 지정하므로 새로운 ORB는 그 ORB 구현으로 초기화됩니다. p가 null 로 A 인수가 ORB 클래스를 지정하고 있지 않았던 경우, 새로운 ORB는 디폴트의 Java IDL 구현으로 초기화됩니다.

 Properties p = new Properties(); p.put("org.omg.CORBA.ORBClass", "SomeORBImplementation"); ORB orb = ORB.init(args, p);

다음에 1번째의 파라미터로서 지정된 애플릿의 ORB 객체를 작성하는 코드를 나타냅니다. 지정된 애플릿이 ORB 클래스를 지정하고 있지 않는 경우는 새로운 ORB는 디폴트의 Java IDL 구현으로 초기화됩니다.

 ORB orb = ORB.init(myApplet, null);

어플리케이션이나 애플릿은 1개 이상의 ORB 로 초기화할 수 있습니다. ORB 에서의 초기화는 CORBA 세계에 대한 bootstrap 호출입니다.

도입된 버전 :: JDK1. 2

생성자 개요
`ORB ()`

메서드 개요
`void`	`connect (Object obj)` 지정된 서번트 객체 (서버 구현 클래스의 인스턴스인 Java 객체)를 ORB에 접속합니다.
`TypeCode`	`create_abstract_interface_tc (String id, String name)` IDL 추상 인터페이스의 `TypeCode` 객체를 생성합니다.
`abstract TypeCode`	`create_alias_tc (String id, String name, TypeCode original_type)` IDL `alias` (`typedef`)를 나타내는 `TypeCode` 객체를 생성합니다.
`abstract Any`	`create_any ()` `kind` 필드가 `TCKind.tc_null`로 설정된 `TypeCode` 객체를 포함하도록 초기화된, IDL `Any` 객체를 생성합니다.
`abstract TypeCode`	`create_array_tc (int length, TypeCode element_type)` IDL `array`를 나타내는 `TypeCode` 객체를 생성합니다.
`DynAny`	`create_basic_dyn_any (TypeCode type)` 추천하지 않습니다. 대신에 새로운 DynAnyFactory API를 사용해 주세요.
`abstract ContextList`	`create_context_list ()` 비어있는 `ContextList` 객체를 생성합니다.
`DynAny`	`create_dyn_any (Any value)` 추천하지 않습니다. 대신에 새로운 DynAnyFactory API를 사용해 주세요.
`DynArray`	`create_dyn_array (TypeCode type)` 추천하지 않습니다. 대신에 새로운 DynAnyFactory API를 사용해 주세요.
`DynEnum`	`create_dyn_enum (TypeCode type)` 추천하지 않습니다. 대신에 새로운 DynAnyFactory API를 사용해 주세요.
`DynSequence`	`create_dyn_sequence (TypeCode type)` 추천하지 않습니다. 대신에 새로운 DynAnyFactory API를 사용해 주세요.
`DynStruct`	`create_dyn_struct (TypeCode type)` 추천하지 않습니다. 대신에 새로운 DynAnyFactory API를 사용해 주세요.
`DynUnion`	`create_dyn_union (TypeCode type)` 추천하지 않습니다. 대신에 새로운 DynAnyFactory API를 사용해 주세요.
`abstract TypeCode`	`create_enum_tc (String id, String name, String [] members)` IDL `enum`를 나타내는 `TypeCode` 객체를 생성합니다.
`abstract Environment`	`create_environment ()` `Environment` 객체를 생성합니다.
`abstract ExceptionList`	`create_exception_list ()` 비어있는 `ExceptionList` 객체를 생성합니다.
`abstract TypeCode`	`create_exception_tc (String id, String name, StructMember [] members)` IDL `exception`을 나타내는 `TypeCode` 객체를 생성합니다.
`TypeCode`	`create_fixed_tc (short digits, short scale)` IDL fixed 형의 `TypeCode` 객체를 생성합니다.
`abstract TypeCode`	`create_interface_tc (String id, String name)` IDL `interface`를 나타내는 `TypeCode` 객체를 생성합니다.
`abstract NVList`	`create_list (int count)` 지정수의 `NamedValue` 객체에 있어 (아마) 충분한 공간을 `NVList`에 할당합니다.
`abstract NamedValue`	`create_named_value (String s, Any any, int flags)` 지정된 이름, 값, 인수 모드 플래그를 사용해, `NamedValue` 객체를 생성합니다.
`TypeCode`	`create_native_tc (String id, String name)` IDL 네이티브형의 `TypeCode` 객체를 생성합니다.
`NVList`	`create_operation_list (Object oper)` 지정된 `OperationDef` 객체로 기술되는 조작의 인수 기술로 초기화된, `NVList`를 생성합니다.
`abstract OutputStream`	`create_output_stream ()` 새로운 `org.omg.CORBA.portable.OutputStream` 객체를 생성합니다.
`Policy`	`create_policy (int type, Any val)` 지정된 초기 상태로 특정의 형태의 정책 객체의 인스턴스를 새로운 작성하기 위해서 호출합니다.
`abstract TypeCode`	`create_recursive_sequence_tc (int bound, int offset)` 추천하지 않습니다. 대신에 create_recursive_tc와 create_sequence_tc 편성을 사용해 주세요.
`TypeCode`	`create_recursive_tc (String id)` 재귀를 포함한 TypeCode를 생성하는 처리 시에 구상 TypeCode 플레이스홀더로서 기능하는 재귀 `TypeCode`를 생성합니다.
`abstract TypeCode`	`create_sequence_tc (int bound, TypeCode element_type)` IDL `sequence`를 나타내는 `TypeCode` 객체를 생성합니다.
`abstract TypeCode`	`create_string_tc (int bound)` IDL 바운드 형식 `string`를 나타내는 `TypeCode` 객체를 생성합니다.
`abstract TypeCode`	`create_struct_tc (String id, String name, StructMember [] members)` IDL `struct`를 나타내는 `TypeCode` 객체를 생성합니다.
`abstract TypeCode`	`create_union_tc (String id, String name, TypeCode discriminator_type, UnionMember [] members)` IDL `union`을 나타내는 `TypeCode` 객체를 생성합니다.
`TypeCode`	`create_value_box_tc (String id, String name, TypeCode boxed_type)` IDL 치 박스의 `TypeCode` 객체를 생성합니다.
`TypeCode`	`create_value_tc (String id, String name, short type_modifier, TypeCode concrete_base, ValueMember [] members)` IDL 치 형의 `TypeCode` 객체를 생성합니다.
`abstract TypeCode`	`create_wstring_tc (int bound)` IDL 바운드 형식 `wstring` (와이드 캐릭터 라인)를 나타내는 `TypeCode` 객체를 생성합니다.
`void`	`destroy ()` 자원을 재사용할 수 있도록 ORB를 파기합니다.
`void`	`disconnect (Object obj)` 지정된 서번트 객체를 ORB 로부터 떼어냅니다.
`Current`	`get_current ()` 추천하지 않습니다. `resolve_initial_references`를 사용해 주세요.
`abstract Context`	`get_default_context ()` 디폴트의 `Context` 객체를 취득합니다.
`abstract Request`	`get_next_response ()` 응답을 받아들인 다음의 `Request` 인스턴스를 취득합니다.
`abstract TypeCode`	`get_primitive_tc (TCKind tcKind)` 지정된 원시적 IDL 형을 나타내는 `TypeCode` 객체를 꺼냅니다.
`boolean`	`get_service_information (short service_type, ServiceInformationHolder service_info)` 이 ORB가 지원하는 CORBA 기능과 서비스에 관한 정보의 취득에 사용됩니다.
`static ORB`	`init ()` `ORB` 단체 객체를 리턴합니다.
`static ORB`	`init (Applet app, Properties props)` 애플릿용으로 새로운 `ORB` 인스턴스를 생성합니다.
`static ORB`	`init (String [] args, Properties props)` 스탠드얼론 어플리케이션용으로 새로운 `ORB` 인스턴스를 생성합니다.
`abstract String []`	`list_initial_services ()` 「네임 서비스」나 「인터페이스 리포지터리(repository)」 등, 사용 가능한 CORBA 초기 서비스의 객체 참조를 리턴합니다.
`abstract String`	`object_to_string (Object obj)` 지정된 CORBA 객체 참조를 캐릭터 라인으로 변환합니다.
`void`	`perform_work ()` 메인 thread로부터 불려가 면, 구현에 의존된 처리 단위를 실행합니다.
`abstract boolean`	`poll_next_response ()` 그대로 두어진 (비동기) 호출안에 응답이 있던 것이 있을지 어떨지를 판정합니다.
`abstract Object`	`resolve_initial_references (String object_name)` 사용 가능한 일련의 초기 서비스명으로부터, 특정의 객체 참조를 해결합니다.
`void`	`run ()` 이 조작은 ORB가 셧다운 프로세스를 완료할 때까지 현행의 thread를 블록 해, 어느 thread가 `shutdown`을 호출하면 시작합니다.
`abstract void`	`send_multiple_requests_deferred (Request [] req)` 복수의 동적 (DII) 요구를 비동기적으로 보냅니다.
`abstract void`	`send_multiple_requests_oneway (Request [] req)` 응답을 전제로 하지 못하고, 복수의 동적 (DII) 요구를 비동기적으로 보냅니다.
`protected abstract void`	`set_parameters (Applet app, Properties props)` ORB 구현을 지정된 파라미터와 프로퍼티로 초기화합니다.
`protected abstract void`	`set_parameters (String [] args, Properties props)` ORB 구현을 지정된 파라미터와 프로퍼티로 초기화합니다.
`void`	`shutdown (boolean wait_for_completion)` ORB에 셧다운을 지시해, 이것에 의해 파기의 준비로서 모든 객체 어댑터가 셧다운 됩니다.
`abstract Object`	`string_to_object (String str)` `object_to_string` 메서드에 의해 생성된 캐릭터 라인을 변환해 CORBA 객체 참조에 되돌립니다.
`boolean`	`work_pending ()` ORB가 처리를 실행하기 위해서 메인 thread를 필요로 하는 경우는 `true`, 메인 thread를 필요로 하지 않는 경우는 `false`를 리턴합니다.

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

생성자 상세

ORB

public ORB()

메서드의 상세

init

public static ORB  init()

ORB 단체 객체를 리턴합니다. 이 메서드는 항상, 같은 ORB 인스턴스를 리턴합니다. 이 인스턴스는 org.omg.CORBA.ORBSingletonClass 시스템 프로퍼티가 기술하는 클래스의 인스턴스입니다.

이 인수 없음의 형식의 init 메서드는 주로TypeCode 객체의 팩토리로서 사용됩니다. Helper 클래스는 이 객체를 사용해, type 메서드를 구현합니다. 또, union TypeCode 객체를 작성할 경우에 union 라벨을 기술하기 위해서 사용하는 Any 객체의 작성에도 사용됩니다.

이 메서드는 애플릿으로 사용하는 것은 도되지 않습니다. 따라서, 애플릿 환경에서 불려 갔을 경우, 리턴된 ORB는 제약 첨부이며, TypeCode 객체의 팩토리로서 밖에 사용할 수 없습니다. 이 때문에 이 메서드에 의해 작성되는 TypeCode객체는 모두, 신뢰할 수 없는 애플릿간이라도 안전하게 공유할 수 있습니다.

애플릿으로부터 이 메서드를 사용해 ORB를 작성하는 경우, TypeCode 객체의 작성 이외의 목적으로 이 메서드가 불려가 면, 시스템 예외가 발생 됩니다.

반환값:: 단독 ORB

init

public static ORB  init(String [] args,
                       Properties  props)

스탠드얼론 어플리케이션용으로 새로운 ORB 인스턴스를 생성합니다. 이 메서드를 호출할 수 있는 것은 어플리케이션만입니다. 이 메서드는 불려 갈 때마다 새로운 풀 기능의 ORB 객체를 리턴합니다.

파라미터:: args - 어플리케이션의 main 메서드의 커멘드행 인수. null도 가능; props - 어플리케이션 고유의 프로퍼티. null도 가능
반환값:: 새롭게 생성된 ORB 인스턴스

init

public static ORB  init(Applet  app,
                       Properties  props)

애플릿용으로 새로운 ORB 인스턴스를 생성합니다. 이 메서드를 호출할 수 있는 것은 애플릿만입니다. 이 메서드는 불려 갈 때마다 새로운 풀 기능의 ORB 객체를 리턴합니다.

파라미터:: app - 애플릿. null도 가능; props - 애플릿 고유의 프로퍼티. null도 가능
반환값:: 새롭게 생성된 ORB 인스턴스

set_parameters

protected abstract void set_parameters(String [] args,
                                       Properties  props)

ORB 구현을 지정된 파라미터와 프로퍼티로 초기화합니다. 이 메서드는 어플리케이션 전용입니다. 이 메서드는 서브 클래스 ORB 구현에 의해 구현되어 적절한 init 메서드로 불려가 면, 파라미터를 건네줍니다.

파라미터:: args - 어플리케이션의 main 메서드의 커멘드행 인수. null도 가능; props - 어플리케이션 고유의 프로퍼티. null도 가능

set_parameters

protected abstract void set_parameters(Applet  app,
                                       Properties  props)

ORB 구현을 지정된 파라미터와 프로퍼티로 초기화합니다. 이 메서드는 애플릿 전용입니다. 이 메서드는 서브 클래스 ORB 구현에 의해 구현해, 적절한 init 메서드로 불려가 면, 파라미터를 건네줍니다.

파라미터:: app - 애플릿. null도 가능; props - 애플릿 고유의 프로퍼티. null도 가능

connect

public void connect(Object  obj)

지정된 서번트 객체 (서버 구현 클래스의 인스턴스인 Java 객체)를 ORB에 접속합니다. 서번트 클래스는 서버가 지원하는 인터페이스에 대응하는 ImplBase 클래스를 확장할 필요가 있습니다. 이 때문에 서번트는 CORBA 객체 참조이며, org.omg.CORBA.Object로 부터 상속할 필요가 있습니다. 사용자가 작성한 서번트는 connect 메서드의 호출 후에 리모트 호출을 받을 수가 있게 됩니다. 로컬이 아닌 객체의 IDL 메서드 호출로 IDL 파라미터로서 서번트가 건네받았을 경우, 즉 서번트 객체를 정렬화해, 프로세스 address 공간의 범위외에 보낼 필요가 있는 경우는 서번트를 자동적이고 암묵적으로 ORB에 접속할 수도 있습니다.

서번트 객체가 이미 ORB에 접속되고 있을 때는 connect 메서드를 호출해도 아무것도 변화는 없습니다.

Portable Object Adapter API를 우선하므로 OMG 에서는 추천 되지 않습니다.

파라미터:: obj - 서번트 객체 참조

destroy

public void destroy()

자원을 재사용할 수 있도록 ORB를 파기합니다. 파기된 ORB 참조로 어떠한 조작이 불려가 면, OBJECT_NOT_EXIST 예외가 발생 됩니다. ORB가 파기된뒤 같은 ORBid를 사용해 init를 호출하면 새롭게 구축된 ORB 에의 참조가 리턴됩니다 .

셧다운되어 있지 않은 ORB 로 destroy가 불려가 면, 셧다운 프로세스가 시작해, ORB가 셧다운 할 때까지 블록 하고 나서, ORB를 파기합니다.
현재 호출을 처리하고 있는 thread로 어플리케이션이 destroy를 호출하면, 블록에 의해 데드 록이 되기 때문에 OMG 마이너 코드 3 으로 BAD_INV_ORDER 시스템 예외가 발생 됩니다.

최대한의 이식성을 확보해, 자원 리크를 막기 위해, 어플리케이션은 종료전에 모든 ORB 인스턴스로 shutdown와 destroy를 반드시 호출할 필요가 있습니다.

예외:: BAD_INV_ORDER - 현재의 thread가 호출을 처리하고 있는 경우

disconnect

public void disconnect(Object  obj)

지정된 서번트 객체를 ORB 로부터 떼어냅니다. 이 메서드가 복귀하면, ORB는 떼어내진 서번트로부터의 착신 리모트 요구를 거부해, org.omg.CORBA.OBJECT_NOT_EXIST 예외를 리모트 클라이언트에 리턴합니다. 이 때문에 리모트 클라이언트로부터는 객체가 파기된 것처럼 보입니다. 다만, 서번트를 직접 사용해 발행된 로컬 요구는 ORB를 개입시켜 건네받을 것은 없습니다. 이 때문에 서번트에 한 처리가 계속됩니다.

서번트가 ORB에 접속되어 있지 않은 경우는 disconnect 메서드를 호출해도 아무것도 변화는 없습니다.

Portable Object Adapter API를 우선하므로 OMG 에서는 추천 되지 않습니다.

파라미터:: obj - ORB 로부터 떼어내지는 서번트 객체

list_initial_services

public abstract String [] list_initial_services()

「네임 서비스」나 「인터페이스 리포지터리(repository)」 등, 사용 가능한 CORBA 초기 서비스의 객체 참조를 리턴합니다.

반환값:: 이 ORB 로 사용 가능한 CORBA 초기 서비스의 객체 참조를 나타내는 String 객체의 배열

resolve_initial_references

public abstract Object  resolve_initial_references(String  object_name)
                                           throws InvalidName

사용 가능한 일련의 초기 서비스명으로부터, 특정의 객체 참조를 해결합니다.

파라미터:: object_name - 캐릭터 라인으로서의 초기 서비스명
반환값:: 지정된 이름에 관련하고 있는 객체 참조
예외:: InvalidName - 지정된 이름이 정의 끝난 서비스에 관련하고 있지 않는 경우

object_to_string

public abstract String  object_to_string(Object  obj)

지정된 CORBA 객체 참조를 캐릭터 라인으로 변환합니다. 이 캐릭터 라인의 형식은 IIOP 로 미리 정의되고 있으므로 다른 ORB 로 생성된 캐릭터 라인을 변환해 객체 참조에 되돌릴 수가 있습니다.

결과의 String객체는 String 객체를 조작 가능한 방법으로 포함 또는 통신할 수 있습니다.

파라미터:: obj - 캐릭터 라인에 변환되는 객체 참조
반환값:: 객체 참조를 나타내는 캐릭터 라인

string_to_object

public abstract Object  string_to_object(String  str)

object_to_string 메서드에 의해 생성된 캐릭터 라인을 변환해 CORBA 객체 참조에 되돌립니다.

파라미터:: str - 변환되어 객체 참조에 되돌려지는 캐릭터 라인. object_to_string 메서드를 사용해 객체 참조를 캐릭터 라인으로 변환한 결과가 아니면 안된다
반환값:: 객체 참조

create_list

public abstract NVList  create_list(int count)

지정수의 NamedValue 객체에 있어 (아마) 충분한 공간을 NVList에 할당합니다. 지정된 사이즈는 기억역할당을 위한 단순한 힌트이며, 리스트의 최대 사이즈를 미하지 않습니다.

파라미터:: count - 공간을 할당하는 NamedValue 객체의 추천수
반환값:: 새롭게 생성된 NVList
관련 항목:: NVList

create_operation_list

public NVList  create_operation_list(Object  oper)

지정된 OperationDef 객체로 기술되는 조작의 인수 기술로 초기화된, NVList를 생성합니다. 이 OperationDef객체는 인터페이스 리포지터리(repository)로부터 취득됩니다. 리턴된 NVList 객체내의 인수는 원의 IDL 조작 정의와 같은 순서가 됩니다. 이 때문에 이 리스트를 동적으로 호출하는 요구로 사용할 수 있습니다.

파라미터:: oper - 리스트 작성에 사용되는 OperationDef 객체
반환값:: 지정된 OperationDef 객체로 기술되는 메서드의 인수 기술을 포함하고 있는 새롭게 생성된 NVList 객체
관련 항목:: NVList

create_named_value

public abstract NamedValue  create_named_value(String  s,
                                              Any  any,
                                              int flags)

지정된 이름, 값, 인수 모드 플래그를 사용해, NamedValue 객체를 생성합니다.

NamedValue객체는 (1) 파라미터나 반환값, 또는 (2) 컨텍스트 프로퍼티로서 기능합니다. NamedValue 객체 자체로 사용하는 일도, NVList 객체내의 요소로서 사용할 수도 있습니다.

파라미터:: s - NamedValue 객체의 이름; any - NamedValue 객체에 삽입되는 Any 치; flags - NamedValue 인수 모드 플래그. ARG_IN.value, ARG_OUT.value, ARG_INOUT.value 가운데 1개
반환값:: 새롭게 생성된 NamedValue 객체
관련 항목:: NamedValue

create_exception_list

public abstract ExceptionList  create_exception_list()

비어있는 ExceptionList 객체를 생성합니다.

반환값:: 새롭게 생성된 ExceptionList 객체

create_context_list

public abstract ContextList  create_context_list()

비어있는 ContextList 객체를 생성합니다.

반환값:: 새롭게 생성된 ContextList 객체
관련 항목:: ContextList, Context

get_default_context

public abstract Context  get_default_context()

디폴트의 Context 객체를 취득합니다.

반환값:: 디폴트의 Context 객체
관련 항목:: Context

create_environment

public abstract Environment  create_environment()

Environment 객체를 생성합니다.

반환값:: 새롭게 생성된 Environment 객체
관련 항목:: Environment

create_output_stream

public abstract OutputStream  create_output_stream()

새로운 org.omg.CORBA.portable.OutputStream 객체를 생성합니다. 메서드 호출시에 이 객체의 내부에서 IDL 메서드의 파라미터를 정렬화할 수 있습니다.

반환값:: 새롭게 생성된 org.omg.CORBA.portable.OutputStream 객체

send_multiple_requests_oneway

public abstract void send_multiple_requests_oneway(Request [] req)

응답을 전제로 하지 못하고, 복수의 동적 (DII) 요구를 비동기적으로 보냅니다. 한방향 호출은 서버에 도달할지 어떨지가 보증되지 않는 것에 주의해 주세요.

파라미터:: req - 요구 객체의 배열

send_multiple_requests_deferred

public abstract void send_multiple_requests_deferred(Request [] req)

복수의 동적 (DII) 요구를 비동기적으로 보냅니다.

파라미터:: req - Request 객체의 배열

poll_next_response

public abstract boolean poll_next_response()

그대로 두어진 (비동기) 호출안에 응답이 있던 것이 있을지 어떨지를 판정합니다.

반환값:: 응답이 있었을 경우는 true, 그렇지 않은 경우는 false

get_next_response

public abstract Request  get_next_response()
                                   throws WrongTransaction

응답을 받아들인 다음의 Request 인스턴스를 취득합니다.

반환값:: 응답의 준비가 되어 있는 다음의 Request 객체
예외:: WrongTransaction - 원의 요구의 송신원과는 다른 트랜잭션(transaction) 스코프로부터 get_next_response 메서드가 불려 갔을 경우. 자세한 내용은 「OMG Transaction Service 사양」을 참조

get_primitive_tc

public abstract TypeCode  get_primitive_tc(TCKind  tcKind)

지정된 원시적 IDL 형을 나타내는 TypeCode 객체를 꺼냅니다.

파라미터:: tcKind - 원시형에 대응하는 TCKind 인스턴스
반환값:: 요구된 TypeCode 객체

create_struct_tc

public abstract TypeCode  create_struct_tc(String  id,
                                          String  name,
                                          StructMember [] members)

IDL struct를 나타내는 TypeCode 객체를 생성합니다. TypeCode객체는 지정된 ID, 이름, 멤버로 초기화됩니다.

파라미터:: id - struct 리포지터리(repository) ID; name - struct 이름; members - struct 멤버를 기술하는 배열
반환값:: IDL struct를 기술하는 새롭게 생성된 TypeCode 객체

create_union_tc

public abstract TypeCode  create_union_tc(String  id,
                                         String  name,
                                         TypeCode  discriminator_type,
                                         UnionMember [] members)

IDL union을 나타내는 TypeCode 객체를 생성합니다. TypeCode객체는 지정된 ID, 이름, 판별자의 형태, 멤버로 초기화됩니다.

파라미터:: id - union 리포지터리(repository) ID; name - union 이름; discriminator_type - union 판별자의 형태; members - union 멤버를 기술하는 배열
반환값:: IDL union을 기술하는 새롭게 생성된 TypeCode 객체

create_enum_tc

public abstract TypeCode  create_enum_tc(String  id,
                                        String  name,
                                        String [] members)

IDL enum를 나타내는 TypeCode 객체를 생성합니다. TypeCode객체는 지정된 ID, 이름, 멤버로 초기화됩니다.

파라미터:: id - enum 리포지터리(repository) ID; name - enum 이름; members - enum 멤버를 기술하는 배열
반환값:: IDL enum를 기술하는 새롭게 생성된 TypeCode 객체

create_alias_tc

public abstract TypeCode  create_alias_tc(String  id,
                                         String  name,
                                         TypeCode  original_type)

IDL alias (typedef)를 나타내는 TypeCode 객체를 생성합니다. TypeCode객체는 지정된 ID, 이름, 원의 형태로 초기화됩니다.

파라미터:: id - alias 리포지터리(repository) ID; name - alias 이름; original_type - alias 인 원의 형태를 기술하는 TypeCode 객체
반환값:: IDL alias를 기술하는 새롭게 생성된 TypeCode 객체

create_exception_tc

public abstract TypeCode  create_exception_tc(String  id,
                                             String  name,
                                             StructMember [] members)

IDL exception을 나타내는 TypeCode 객체를 생성합니다. TypeCode객체는 지정된 ID, 이름, 멤버로 초기화됩니다.

파라미터:: id - exception 리포지터리(repository) ID; name - exception 이름; members - exception 멤버를 기술하는 배열
반환값:: IDL exception을 기술하는 새롭게 생성된 TypeCode 객체

create_interface_tc

public abstract TypeCode  create_interface_tc(String  id,
                                             String  name)

IDL interface를 나타내는 TypeCode 객체를 생성합니다. TypeCode객체는 지정된 ID와 이름으로 초기화됩니다.

파라미터:: id - interface 리포지터리(repository) ID; name - interface 이름
반환값:: IDL interface를 기술하는 새롭게 생성된 TypeCode 객체

create_string_tc

public abstract TypeCode  create_string_tc(int bound)

IDL 바운드 형식 string를 나타내는 TypeCode 객체를 생성합니다. TypeCode객체는 지정된 바운드로 초기화됩니다. 이 바운드는 캐릭터 라인의 최대장을 나타냅니다. 제로는 이 형태 코드로 기술되는 캐릭터 라인이 안 바운드 형식인 것을 나타냅니다.

파라미터:: bound - string 바운드. 잘못된 값은 불가
반환값:: IDL 바운드 형식 string를 기술하는 새롭게 생성된 TypeCode 객체
예외:: BAD_PARAM - 바운드가 잘못된 값 의 경우

create_wstring_tc

public abstract TypeCode  create_wstring_tc(int bound)

IDL 바운드 형식 wstring (와이드 캐릭터 라인)를 나타내는 TypeCode 객체를 생성합니다. TypeCode객체는 지정된 바운드로 초기화됩니다. 이 바운드는 와이드 캐릭터 라인의 최대장을 나타냅니다. 제로는 이 형태 코드로 기술되는 캐릭터 라인이 안 바운드 형식인 것을 나타냅니다.

파라미터:: bound - wstring 바운드. 잘못된 값은 불가
반환값:: IDL 바운드 형식 wstring를 기술하는 새롭게 생성된 TypeCode 객체
예외:: BAD_PARAM - 바운드가 잘못된 값 의 경우

create_sequence_tc

public abstract TypeCode  create_sequence_tc(int bound,
                                            TypeCode  element_type)

IDL sequence를 나타내는 TypeCode 객체를 생성합니다. TypeCode객체는 지정된 바운드와 요소형으로 초기화됩니다.

파라미터:: bound - sequence 바운드. 안 바운드의 경우는 0; element_type - sequence에 포함되고 있는 요소를 기술하는 TypeCode 객체
반환값:: IDL sequence를 기술하는 새롭게 생성된 TypeCode 객체

create_recursive_sequence_tc

@Deprecated 
public abstract TypeCode  create_recursive_sequence_tc(int bound,
                                                                 int offset)

추천하지 않습니다. 대신에 create_recursive_tc와 create_sequence_tc 편성을 사용해 주세요.

IDL 재귀적 sequence를 나타내는 TypeCode 객체를 생성합니다.

다음의 코드에 나타내는 IDL struct Node 에서는 순서를 작성하는 오프셋(offset) 파라미터는 1 이 됩니다.

 Struct Node { long value; Sequence <Node> subnodes; };

파라미터:: bound - 순서의 바운드. 안 바운드의 경우는 0; offset - 이 순서의 요소를 기술하는 포위 TypeCode 객체의 인덱스
반환값:: 재귀적 순서를 기술하는 새롭게 생성된 TypeCode 객체
관련 항목:: create_recursive_tc, create_sequence_tc

create_array_tc

public abstract TypeCode  create_array_tc(int length,
                                         TypeCode  element_type)

IDL array를 나타내는 TypeCode 객체를 생성합니다. TypeCode객체는 지정된 길이와 요소형으로 초기화됩니다.

파라미터:: length - array 길이; element_type - array에 포함되고 있는 요소의 형태를 기술하는 TypeCode 객체
반환값:: IDL array를 기술하는 새롭게 생성된 TypeCode 객체

create_native_tc

public TypeCode  create_native_tc(String  id,
                                 String  name)

IDL 네이티브형의 TypeCode 객체를 생성합니다.

파라미터:: id - 네이티브형의 논리 ID; name - 네이티브형의 이름
반환값:: 요구된 TypeCode

create_abstract_interface_tc

public TypeCode  create_abstract_interface_tc(String  id,
                                             String  name)

IDL 추상 인터페이스의 TypeCode 객체를 생성합니다.

파라미터:: id - 추상 인터페이스형의 논리 ID; name - 추상 인터페이스형의 이름
반환값:: 요구된 TypeCode

create_fixed_tc

public TypeCode  create_fixed_tc(short digits,
                                short scale)

IDL fixed 형의 TypeCode 객체를 생성합니다.

파라미터:: digits - 10 진수의 합계수를 숫자로 지정. 1 에서 31 까지의 논리합일 필요가 있는; scale - 소수점의 위치
반환값:: 요구된 TypeCode

create_value_tc

public TypeCode  create_value_tc(String  id,
                                String  name,
                                short type_modifier,
                                TypeCode  concrete_base,
                                ValueMember [] members)

IDL 치 형의 TypeCode 객체를 생성합니다. concrete_base 파라미터는 TypeCode가 생성되는 value 형의 즉시 구상 기저 value 형에 대한 TypeCode 입니다. value 형에 구상 기저가 없는 경우는 null 로 할 수도 있습니다.

파라미터:: id - 치 형의 논리 ID; name - 치 형의 이름; type_modifier - 치 형수식자 정수. VM_NONE, VM_CUSTOM, VM_ABSTRACT, 또는 VM_TRUNCATABLE 가운데 1개; concrete_base - 구상 기저 value 형을 기술하는 TypeCode 객체; members - 치 형의 멤버를 포함하는 배열
반환값:: 요구된 TypeCode

create_recursive_tc

public TypeCode  create_recursive_tc(String  id)

재귀를 포함한 TypeCode를 생성하는 처리 시에 구상 TypeCode 플레이스홀더로서 기능하는 재귀 TypeCode를 생성합니다. id 파라미터에의해 재귀 TypeCode가 플레이스홀더로서 기능하는 형태의 리포지터리(repository) ID가 지정됩니다. 지정한 리포지터리(repository) ID에 대응하는 포위 TypeCode에 재귀 TypeCode가 올바르게 파묻히면, 표준의 TypeCode 로서 기능합니다. 포위 TypeCode에 파묻히기 전에 재귀 TypeCode 로 조작을 호출하면, BAD_TYPECODE 예외가 발생합니다.

예를 들어 다음의 IDL 형 선언에는 재귀가 포함됩니다.

 Struct Node { Sequence<Node> subnodes; };

구조체 Node에 TypeCode를 생성하려면, 다음에 나타내도록 TypeCode 생성 조작을 호출합니다.

 String nodeID = "IDL:Node:1. 0"; TypeCode recursiveSeqTC = orb.create_sequence_tc(0, orb.create_recursive_tc(nodeID)); StructMember[] members = { new StructMember("subnodes", recursiveSeqTC, null) }; TypeCode structNodeTC = orb.create_struct_tc(nodeID, "Node", members);

다음은 부정한 IDL 형 선언입니다.

 Struct Node { Node next; };

재귀형은 공백도 가능한 순서내에서만 사용할 수 있습니다. 이것에 의해 Any 로 구조체를 전송 하는 경우와 같은 정렬화의 문제가 회피됩니다.

파라미터:: id - 참조형의 논리 ID
반환값:: 요구된 TypeCode

create_value_box_tc

public TypeCode  create_value_box_tc(String  id,
                                    String  name,
                                    TypeCode  boxed_type)

IDL 치 박스의 TypeCode 객체를 생성합니다.

파라미터:: id - 치 형의 논리 ID; name - 치 형의 이름; boxed_type - 형의 TypeCode
반환값:: 요구된 TypeCode

create_any

public abstract Any  create_any()

kind 필드가 TCKind.tc_null로 설정된 TypeCode 객체를 포함하도록 초기화된, IDL Any 객체를 생성합니다.

반환값:: 새롭게 생성된 Any 객체

get_current

@Deprecated 
public Current  get_current()

추천하지 않습니다. resolve_initial_references를 사용해 주세요.

Current 객체를 꺼냅니다. Current인터페이스는 트랜잭션(transaction)나 시큐러티등의 서비스로 사용하는 thread 고유의 정보를 관리하기 위해서 사용합니다.

반환값:: 새롭게 생성된 Current 객체
관련 항목:: CORBA package comments for unimplemented features

run

public void run()

이 조작은 ORB가 셧다운 프로세스를 완료할 때까지 현행의 thread를 블록 해, 어느 thread가 shutdown을 호출하면 시작합니다. 이것은 ORB 셧다운시에 통지를 받는 복수의 thread로 사용할 수 있습니다.

shutdown

public void shutdown(boolean wait_for_completion)

ORB에 셧다운을 지시해, 이것에 의해 파기의 준비로서 모든 객체 어댑터가 셧다운 됩니다.
wait_for_completion 파라미터가 true인 경우, 이 조작은 모든 ORB 처리 (현재 실행중의 요구, 객체의 비액티브화, 그 외의 객체 어댑터의 조작등)가 완료할 때까지 블록 됩니다. 어플리케이션이 현재 호출을 처리하고 있는 thread로 이것을 실행했을 경우, 블록에 의해 데드 록이 되므로 OMG 마이너 코드 3 으로 BAD_INV_ORDER 시스템 예외가 발생 됩니다.
wait_for_completion 파라미터가 FALSE인 경우, 복귀시에 셧다운이 완료하고 있지 않는 경우가 있습니다.

ORB가 셧다운의 처리 그 중에서 ORB는 보통 대로에 동작해, 모든 요구가 완료할 때까지 수신 및 송신 요구를 처리합니다. ORB가 셧다운 하면, 객체 참조 관리 조작만이 ORB 또는 그리고 취득되는 임의의 객체 참조로 호출할 수 있습니다 . 어플리케이션은 ORB 자체에 대해서 destroy 조작을 호출할 수도 있습니다. 그 외의 조작을 호출하면, OMG 마이너 코드 4 로 BAD_INV_ORDER 시스템 예외가 발생 됩니다.

shutdown가 불려 간 후에 ORB.run 메서드가 복귀합니다.

파라미터:: wait_for_completion - 셧다운이 완료할 때까지 호출을 블록 하는 경우는 true, 즉시 복귀하는 경우는 false
예외:: BAD_INV_ORDER - 현재의 thread가 호출을 처리하고 있는 경우

work_pending

public boolean work_pending()

ORB가 처리를 실행하기 위해서 메인 thread를 필요로 하는 경우는 true, 메인 thread를 필요로 하지 않는 경우는 false를 리턴합니다.

반환값:: 작업 대기가 있는 경우, 즉 ORB가 처리를 실행하기 위해서 메인 thread를 필요로 하는 경우는 true, 작업 대기가 없고, 메인 thread를 필요로 하지 않는 경우는 false

perform_work

public void perform_work()

메인 thread로부터 불려가 면, 구현에 의존된 처리 단위를 실행합니다. 그렇지 않은 경우, 처리는 없습니다. work_pending 메서드와 perform_work 메서드를 제휴해 사용하면, ORB와 다른 액티버티의 사이에 메인 thread를 다중화하는 단순한 폴링 루프를 구현할 수 있습니다.

get_service_information

public boolean get_service_information(short service_type,
                                       ServiceInformationHolder  service_info)

이 ORB가 지원하는 CORBA 기능과 서비스에 관한 정보의 취득에 사용됩니다. 정보를 요구하는 서비스 타입은 CORBA 모듈내에서 정수에 의해 정의되는 값인, in 파라미터 service_type로 서 건네받습니다. 서비스 정보를 그 타입으로 이용할 수 있는 경우, out 파라미터 service_info 내에서 리턴됩니다 . 또, 조작은 값 true를 리턴합니다. 요구된 서비스 타입의 정보가 없는 경우, 조작은 false를 리턴합니다 (즉, 이 ORB 에서는 서비스는 지원 되지 않는다).

파라미터:: service_type - 요구하는 정보의 서비스 타입을 나타내는 short; service_info - 이 메서드로 생성된 ServiceInformation 객체를 보관 유지하는 ServiceInformationHolder 객체
반환값:: service_type 서비스 정보를 사용할 수 있는 경우는 true, 요구된 서비스 타입의 정보가 없는 경우는 false
관련 항목:: CORBA package comments for unimplemented features