패키지 org.omg.CosNaming

Java IDL 의 네임 서비스를 제공합니다.

참조처:
설명

인터페이스의 개요

BindingIterator	BindingIterator 인터페이스를 사용하면(자), 클라이언트는 next_one 또는 next_n 를 사용해 바인딩을 차례차례로 돌려줄 수가 있습니다.
BindingIteratorOperations	BindingIterator 인터페이스를 사용하면(자), 클라이언트는 next_one 또는 next_n 를 사용해 바인딩을 차례차례로 돌려줄 수가 있습니다.
NamingContext	네이밍 문맥은, 각각이 일의의 이름을 가지는 일련의 네임 바인딩을 포함하는 객체입니다.
NamingContextExt	NamingContextExt 는, 각각의 이름이 고유해 Interoperable Naming Service 의 일부인 이름 바인딩세트를 포함하는 NamingContext 의 확장입니다.
NamingContextExtOperations	NamingContextExt 는, 각각의 이름이 고유해 Interoperable Naming Service 의 일부인 이름 바인딩세트를 포함하는 NamingContext 의 확장입니다.
NamingContextOperations	네이밍 문맥은, 각각이 일의의 이름을 가지는 일련의 네임 바인딩을 포함하는 객체입니다.

클래스의 개요

_BindingIteratorImplBase
_BindingIteratorStub	BindingIterator 인터페이스를 사용하면(자), 클라이언트는 next_one 또는 next_n 를 사용해 바인딩을 차례차례로 돌려줄 수가 있습니다.
_NamingContextExtStub	NamingContextExt 는, 각각의 이름이 고유해 Interoperable Naming Service 의 일부인 이름 바인딩세트를 포함하는 NamingContext 의 확장입니다.
_NamingContextImplBase
_NamingContextStub	네이밍 문맥은, 각각이 일의의 이름을 가지는 일련의 네임 바인딩을 포함하는 객체입니다.
Binding	org/omg/CosNaming/Binding.java.
BindingHelper	org/omg/CosNaming/BindingHelper.java.
BindingHolder	org/omg/CosNaming/BindingHolder.java.
BindingIteratorHelper	BindingIterator 인터페이스를 사용하면(자), 클라이언트는 next_one 또는 next_n 를 사용해 바인딩을 차례차례로 돌려줄 수가 있습니다.
BindingIteratorHolder	BindingIterator 인터페이스를 사용하면(자), 클라이언트는 next_one 또는 next_n 를 사용해 바인딩을 차례차례로 돌려줄 수가 있습니다.
BindingIteratorPOA	BindingIterator 인터페이스를 사용하면(자), 클라이언트는 next_one 또는 next_n 를 사용해 바인딩을 차례차례로 돌려줄 수가 있습니다.
BindingListHelper	바인딩의 리스트입니다.
BindingListHolder	바인딩의 리스트입니다.
BindingType	지정된 바인딩이, 객체용 (즉 네이밍 문맥이 아니다)이나 네이밍 문맥용인지를 지정합니다.
BindingTypeHelper	지정된 바인딩이, 객체용 (즉 네이밍 문맥이 아니다)이나 네이밍 문맥용인지를 지정합니다.
BindingTypeHolder	지정된 바인딩이, 객체용 (즉 네이밍 문맥이 아니다)이나 네이밍 문맥용인지를 지정합니다.
IstringHelper	org/omg/CosNaming/IstringHelper.java.
NameComponent	org/omg/CosNaming/NameComponent.java.
NameComponentHelper	org/omg/CosNaming/NameComponentHelper.java.
NameComponentHolder	org/omg/CosNaming/NameComponentHolder.java.
NameHelper	이름은, 이름 컴퍼넌트의 순서입니다.
NameHolder	이름은, 이름 컴퍼넌트의 순서입니다.
NamingContextExtHelper	NamingContextExt 는, 각각의 이름이 고유해 Interoperable Naming Service 의 일부인 이름 바인딩세트를 포함하는 NamingContext 의 확장입니다.
NamingContextExtHolder	NamingContextExt 는, 각각의 이름이 고유해 Interoperable Naming Service 의 일부인 이름 바인딩세트를 포함하는 NamingContext 의 확장입니다.
NamingContextExtPOA	NamingContextExt 는, 각각의 이름이 고유해 Interoperable Naming Service 의 일부인 이름 바인딩세트를 포함하는 NamingContext 의 확장입니다.
NamingContextHelper	네이밍 문맥은, 각각이 일의의 이름을 가지는 일련의 네임 바인딩을 포함하는 객체입니다.
NamingContextHolder	네이밍 문맥은, 각각이 일의의 이름을 가지는 일련의 네임 바인딩을 포함하는 객체입니다.
NamingContextPOA	네이밍 문맥은, 각각이 일의의 이름을 가지는 일련의 네임 바인딩을 포함하는 객체입니다.

패키지 org.omg.CosNaming 의 설명

Java IDL 의 네임 서비스를 제공합니다. Object Request Broker Daemon (ORBD)에도 일시적 및 지속적인 네임 서비스가 있습니다.

이 패키지, 및 이 패키지에 포함할 수 있어 모든 클래스 및 인터페이스는, OMG IDL 로 기술된 모듈인 파일 nameservice.idl 로,idlj 툴을 실행하는 것으로써 생성되고 있습니다.

패키지의 스펙

Java(TM) Platform, Standard Edition 6, ORB 가 준거하는 공식의 스펙의 지원 섹션의 정확한 리스트는,「Java(TM) SE 6 에서의 정식적 CORBA 지원 스펙」을 참조해 주세요.

인터페이스

패키지 org.omg.CosNaming 에는, 2 개의 public 인터페이스와 몇개의 보조 클래스가 포함되어 있습니다.

인터페이스는 다음의 2 개입니다.

• NamingContext
• BindingIterator

이 2 개의 인터페이스는, 이름과 객체 참조의 바인드와 언바인드(unbind), 바인드 된 객체 참조의 취득, 및 바인딩을 리스트로부터 차례차례로 돌려주기 위한 수단을 제공합니다. NamingContext 인터페이스는, 네임 서비스의 주요한 기능을 제공해,BindingIterator 인터페이스는, 이름과 객체 참조의 바인딩을 리스트로부터 차례차례로 돌려주기 위한 수단을 제공합니다.

보조 클래스

OMG IDL 인터페이스를 Java 프로그램 언어에 매핑 하기 위해서, idlj 컴파일러는, 보조 클래스라고 보여지는 Java 클래스를 작성합니다. 생성된 보조 클래스는,NamingContext 인터페이스 및 BindingIterator 인터페이스에 의해 사용됩니다. 보조 클래스에 대한 코멘트를 다음에 나타냅니다.

NamingContext 및 BindingIterator 에 의해 사용되는 클래스

네임 서비스에 의해 사용되는 클래스를 다음에 나타냅니다. 이러한 클래스 각각 대해 생성되는 헬퍼 클래스 및 홀더 클래스에 대해서는 나중에 설명하겠습니다.

• public final class NameComponent -- 이름의 기본 단위입니다. 이름은, 네이밍 문맥으로 객체 참조에 바인드 됩니다.

  이름은, 1 개(살) 또는 복수의 NameComponent 객체로부터 완성되는 배열입니다. 1 개의 NameComponent 를 가지는 이름을 「단순명」이라고 불러, 복수의 NameComponent 객체를 가지는 이름을 「복합명」이라고 부릅니다.

  NameComponent 객체는 2 개의 필드로부터 구성되어 있습니다.

  1. id -- 식별자로서 사용되는 String
  2. kind -- 기술의 목적으로 사용되는 String. 이것은, 구문에 영향을 주는 일 없이 객체를 기술할 수 있다고 하는 점으로써 중요. 예를 들어, C 프로그램 언어에서는, 원시 코드 파일인 것을 나타내기 위해서(때문에), 파일명에 「. c」확장자(extension)를 부가하는 구문 규칙이 이용된다. NameComponent 객체에서는, 파일 확장자(extension)등의 구문 규칙을 사용하지 않고,kind 필드를 사용해 객체의 형태를 기술할 수 있다. kind 필드의 값의 예로서는,c_source,object_code,executable,postscript,"" 등의 캐릭터 라인이 있다. kind 필드가 빈 상태(empty)의 캐릭터 라인인 일도 있다

  이름에서는, 마지막 NameComponent 이외의 각 NameComponent 객체는 NamingContext 객체를 나타냅니다. 마지막 NameComponent 객체는 바인드 되고 있는 객체 참조를 나타냅니다. 이것은, 마지막 이름이 파일명으로, 그 전의 모든 이름이 디렉토리명을 나타내는 경로명의 형식과 닮아 있습니다.

• public final class Binding -- 이름을 객체 참조 또는 네이밍 문맥에 관련한 객체. Binding 객체에는 다음의 2 개의 필드가 있다
  1. binding_name - 바운드명을 나타내는 1 개(살) 또는 복수의 NameComponent 객체의 배열
  2. binding_type - 이름과 객체 참조의 바인딩인가, 이름과 네이밍 문맥의 바인딩인지를 나타내는 BindingType 객체

  NamingContext 인터페이스에는, 이름과 객체 참조 또는 이름과 네이밍 문맥의 바인드나 언바인드(unbind), 바인딩의 리스트의 취득, 바인딩의 해결 (이름을 지정하면(자),resolve 메소드가 그 이름에 바인드 되고 있는 객체를 돌려준다)을 위한 메소드가 있습니다.

• public final class BindingType -- 지정된 Binding 객체가, 이름과 (네이밍 문맥은 아니고) 객체 참조의 바인드인가, 혹은 이름과 네이밍 문맥의 바인드인지를 지정하는 객체

  BindingType 클래스는, 2 개의 메소드와 4 개의 정수로부터 됩니다. 그러한 정수중 2 개는 BindingType 객체로, 나머지의 2 개는 int 입니다.

  BindingType 객체는,Binding 클래스의 생성자 에 건네주거나 파라미터 또는 반환값으로서 사용하거나 할 수가 있습니다. BindingType 객체에는, 다음의 것이 있습니다.

  • public static final BindingType nobject -- 객체 참조와의 바인딩인 것을 나타낸다
  • public static final BindingType ncontext -- 네이밍 문맥과의 바인딩인 것을 나타낸다

  int 정수는,BindingType 객체를 작성하는 from_int 메소드로 지정하거나value 메소드의 반환값으로서 사용하거나 할 수가 있습니다. 이러한 정수에는 다음의 것이 있습니다.

  • public static final int _nobject
  • public static final int _ncontext
  from_int 메소드에 _nobject 또는 _ncontext 이외 아무것도 지정되지 않았던 경우는,org.omg.CORBA.BAD_PARAM 예외가 throw 됩니다.

  사용예를 다음에 나타냅니다.

  BindingType btObject = from_int(_nobject);
  BindingType btContext = from_int(_ncontext);
      

  변수 btObject 는, 객체 참조와의 바인딩을 나타내기 위해서(때문에) 초기화된 BindingType 객체를 참조합니다. 변수 btContext 는,NamingContext 객체와의 바인딩을 나타내기 위해서(때문에) 초기화된 BindingType 객체를 참조합니다.

  value 메소드는 _nobject 또는 _ncontext 를 돌려줍니다. 따라서 다음의 코드에서는, 변수 bt 에는 _nobject 또는 _ncontext 가 포함됩니다.

  int bt = BindingType.value();
      

홀더 클래스

OMG IDL 는, 조작으로부터 값을 돌려주기 위해서(때문에) OUT 파라미터 및 INOUT 파라미터를 사용합니다. OUT 파라미터 및 INOUT 파라미터를 가지지 않는 Java 프로그램 언어에 매핑 하는 것으로써, 각각의 형태에 홀더 클래스로 불리는 특수한 클래스가 작성됩니다. 홀더 클래스의 인스턴스는, 파라미터로서 Java 메소드에 건네줄 수가 있어 값을 value 필드에 대입할 수 있습니다. 이것에 의해, OUT 파라미터 또는 INOUT 파라미터의 기능을 완수할 수가 있습니다.

org.omg.CosNaming 패키지에서는, 다음의 홀더 클래스가 생성됩니다.

• NamingContextHolder
• BindingIteratorHolder
• BindingHolder
• BindingListHolder
• BindingTypeHolder
• NameComponentHolder
• NameHolder

org.omg.CORBA 패키지에서는, Java 의 기본형의 각각 붙어, 홀더 클래스 (IntHolder,ShortHolder,StringHolder 등)가 있습니다.

또,Name 클래스가 없는 경우에서도 NameHolder 클래스가 있습니다. 같이BindingList 클래스가 없는 경우에서도 BindingListHolder 가 있습니다. 이것은, OMG IDL 인터페이스에서는,Name 및 BindingList 가 typedef 이기 (위해)때문에입니다. IDL 의 typedef 로부터 Java 의 구조체에의 매핑은 할 수 없습니다만,typedef 가 순서용 또는 배열용인 경우는 홀더 클래스가 생성됩니다. Java 프로그램 언어에 매핑 되었을 경우는,Name 는 NameComponent 객체의 배열이 되어,BindingList 는 Binding 객체의 배열이 됩니다. 모든 홀더 클래스는, 2 개(살) 이상의 생성자 과 1 개의 필드를 가집니다.

• value 필드 -- OUT 파라미터 또는 INOUT 파라미터로서 사용되는 형태의 인스턴스. 예를 들어,NamingContextHolder 의 value 필드는 NamingContext 객체가 된다
• 디폴트 생성자 -- 형의 디폴트 값를 사용해 초기화된 홀더 객체를 새롭게 생성하는 생성자. 예를 들어, 디폴트 생성자 으로 생성된 새로운 BindingHolder 객체의 value 필드는 null 로 설정된다. 이것은 그 값이 객체의 디폴트 값이니까이다. 이 다른 디폴트 값로서는,boolean 의 false, numeric 형 및 char 형의 0, 객체 참조의 null 등이 있다
• 인스턴스로부터의 생성자 -- 지정된 인스턴스를 사용해 value 필드가 초기화된 홀더 객체를 새롭게 생성하는 생성자

사용자 정의형 (Java 클래스)의 홀더 클래스에는, 이 밖에 3 개의 메소드가 있습니다만, 어플리케이션 개발자가 직접 이러한 메소드를 사용할 것은 없습니다.

헬퍼 클래스

OMG IDL 인터페이스의 모든 사용자 정의형으로 생성되는 헬퍼 클래스는, 사용자 정의형의 조작에 필요한 static 메소드를 제공합니다.

헬퍼 클래스에는, 어플리케이션 프로그래머가 사용하는 메소드가 1 개만 있습니다. narrow 메소드입니다. IDL 인터페이스로부터 매핑 된 Java 인터페이스만이,narrow 메소드가 있는 헬퍼 클래스를 가집니다. 이 때문에,CosNaming 패키지에서는,NamingContextHelper 클래스와 BindingIteratorHelper 클래스에만 narrow 메소드가 있습니다.

• public static NamingContext narrow(org.omg.CORBA.Object obj) -- 지정된 CORBA 객체를 NamingContext 객체로 변환한다
• public static BindingIterator narrow(org.omg.CORBA.Object obj) -- 지정된 CORBA 객체를 BindingIterator 객체로 변환한다

org.omg.CosNaming.NamingContextPackage 패키지

이 패키지는,org.omg.CosNaming 패키지로 사용되는 예외와NotFound 예외의 이유를 제공하는 NotFoundReason 클래스의 Helper 클래스 및 Holder 클래스를 제공합니다.

다음의 예외의 Helper 클래스 및 Holder 클래스가 있습니다.

• AlreadyBound
• CannotProceed
• InvalidName
• NotEmpty
• NotFound

네임 서비스 호환성

Sun 의 CosNaming 패키지의 구현은, OMG COSNaming 스펙에 따르고 있습니다. 즉, Sun 의 네임 서비스의 API 는, OMG 가 제공하는 네임 서비스의 가이드 라인에 따라 구현됩니다. 따라서, Sun 이외의 벤더가 OMG 준거의 네임 서비스를 구현하고 있으면, Sun 의 CosNaming 의 구현과 Sun 이외의 벤더의 구현과의 사이에서의 변환이 가능합니다. 다만, 예외 캐릭터 라인의 상위 등, 네임 서비스를 구현하는 벤더에 의해 다소의 차이가 있는 것을 이해해 둘 필요가 있습니다.

Sun 이외의 네임 서비스를 사용할 때의 가이드

같은 벤더의 ORB 와 ORB 서비스를 사용하는 것을 추천합니다만, Sun 이외의 COSNaming 구현에 Sun 의 RMI-IIOP ORB 를 접속하는 일도 가능합니다. 다음의 스텝에 따릅니다.

1. Bootstrap 서버에 프로퍼티 파일을 작성해, 그 파일에 2 개의 엔트리를 작성합니다. 예를 들어, 이 프로퍼티 파일을 /tmp/services 라고 이름 붙여 그 파일에 NameService <Root Naming Context 의 Stringified IOR > 를 넣습니다.

   이것에 의해,NameService 와 사용하고 싶은 CosNaming 구현의 Root Naming Context 가 관련지을 수 있습니다.

2. 다음의 커멘드를 사용해, 스탠드얼론 Bootstrap 서버를 기동합니다.

         
   java -classpath $(CLASSPATH)
   com.sun.corba.ee.internal.CosNaming.BootstrapServer -InitialServicesFile
   "/tmp/services" [-ORBInitialPort port]
         
     

   커멘드의 마지막 꺽쇄묶음은, 포트 번호의 지정이 임의인 것을 나타냅니다.

어플리케이션이 org.omg.CORBA.ORB.resolve_initial_references 메소드를 호출하면(자), CORBA 프로세스가 Bootstrap Server 에 접속해 Root Naming Context 를 가져옵니다.

패키지의 스펙

• Interoperable Naming Service (ptc/00-08-07 )

관련 문서

CosNaming API 의 개요 및 사용예에 대해서는, 이하를 참조해 주세요.

• 「네임 서비스」

Java IDL 의 개요에 대해서는, 이하를 참조해 주세요.

• 「Java IDL 의 홈 페이지」

도입된 버젼:

JDK1. 3