패키지 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 툴을 실행하는 것으로써 생성되고 있습니다.

패키지의 사양

CORBA 정식적 사양 가운데, Java 2 Platform, Standard Edition, v. 1.4 ORB가 준거하고 있는 섹션에 대해서는 「J2SE 1.4 로 지원하는 CORBA 정식적 사양」을 참조하십시오.

인터페이스

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

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

• NamingContext
• BindingIterator

이 2개의 인터페이스는 이름과 객체 참조의 바인드와 안바인드, 바인드 된 객체 참조의 취득 및 바인딩을 리스트로부터 차례차례로 돌려주기 위한 수단을 제공합니다. 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 필드가 비어있는 캐릭터 라인인 일도 있다

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

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

  NamingContext인터페이스에는 이름과 객체 참조 또는 이름과 네이밍 컨텍스트 의 바인드나 안바인드, 바인딩의 리스트의 취득, 바인딩의 해결 (이름을 지정하면, 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 예외가 발생 됩니다.

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

   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 객체가 된다
• 디폴트 생성자 -- 형의 기본값을 사용해 초기화된 홀더 객체를 새롭게 생성하는 constructor　 　. 예를 들어 디폴트 생성자 으로 생성된 새로운 BindingHolder 객체의 value 필드는 null로 설정된다. 이것은 그 값이 객체의 기본값이니까이다. 이 다른 기본값 로서는 boolean false, numeric 형 및 char 형의 0, 객체 참조의 null 등이 있다
• 인스턴스로부터의 생성자 -- 지정된 인스턴스를 사용해 value 필드가 초기화된 홀더 객체를 새롭게 생성하는 constructor　 　

사용자 정의형 (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 NamingContext를 취득합니다.

패키지의 사양

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

관련 문서

CosNaming API 개요 및 사용예에 대해서는 다음의 문서를 참조하십시오.

• 「네임 서비스」

Java IDL 개요에 대해서는 다음의 문서를 참조하십시오.

• Java IDL 홈 페이지

도입된 버전 :

JDK1. 3