org.omg.CosNaming
인터페이스 NamingContextOperations

알려진 서브 인터페이스 목록 :

NamingContext, NamingContextExt, NamingContextExtOperations

알려진 구현 클래스 목록:

_NamingContextExtStub, _NamingContextImplBase, _NamingContextStub, NamingContextExtPOA, NamingContextPOA

public interface NamingContextOperations

네이밍 컨텍스트은 각각이 일의의 이름을 가지는 일련의 네임 바인딩을 포함하는 객체입니다. 다른 이름을 동시에 같은 컨텍스트 또는 다른 컨텍스트 으로 바인드 할 수 있습니다.

「CORBA COS Naming Specification」를 참조하십시오.

메서드 개요

void	bind_context (NameComponent [] n, NamingContext nc) 네이밍 컨텍스트 인 객체의 이름을 지정합니다.
NamingContext	bind_new_context (NameComponent [] n) 컨텍스트를 새롭게 작성해, 인수로서 지정된 이름에 그 컨텍스트를 바인드 합니다.
void	bind (NameComponent [] n, Object obj) 네이밍 컨텍스트에 이름과 객체의 바인딩을 작성합니다.
void	destroy () destroy는 네이밍 컨텍스트를 삭제합니다.
void	list (int how_many, BindingListHolder bl, BindingIteratorHolder bi) list를 사용하면, 클라이언트는 네이밍 컨텍스트 내의 일련의 바인딩을 차례차례로 취득할 수 있습니다.
NamingContext	new_context () 호출측의 컨텍스트과 같은 네임서버에 의해 구현되는 네이밍 컨텍스트를 리턴합니다.
void	rebind_context (NameComponent [] n, NamingContext nc) 이름이 이미 컨텍스트 으로 바인드 되고 있는 경우에서도, 네이밍 컨텍스트에 이름과 네이밍 컨텍스트 의 바인딩을 작성합니다.
void	rebind (NameComponent [] n, Object obj) 이름이 이미 컨텍스트 으로 바인드 되고 있는 경우에서도, 네이밍 컨텍스트에 이름과 객체의 바인딩을 작성합니다.
Object	resolve (NameComponent [] n) resolve는 지정된 컨텍스트 으로 이름에 바인드 되고 있는 객체를 취득합니다.
void	unbind (NameComponent [] n) unbind는 컨텍스트 으로부터 네임 바인딩을 삭제합니다.

메서드의 상세

bind

void bind(NameComponent [] n,
          Object  obj)
          throws NotFound,

                 CannotProceed,

                 InvalidName,

                 AlreadyBound 

네이밍 컨텍스트에 이름과 객체의 바인딩을 작성합니다. 이름 해석에 대해 복합명이 건네받았을 경우, bind를 사용해 바인드 되고 있는 네이밍 컨텍스트은 이름 해석에는 더해지지 않습니다.

파라미터:

n - 객체의 이름

obj - 지정된 이름에 바인드 되는 Object

예외:

NotFound - 이름으로 바인딩을 식별할 수 없는 경우

CannotProceed - 하등의 이유에 의해 구현이 중지되었을 경우. 다만 클라이언트는 리턴된 네이밍 컨텍스트 으로 처리를 속행할 수 있는 경우도 있다

InvalidName - 이름이 무효인 경우

AlreadyBound - 지정된 이름에 객체가 이미 바인드 되고 있는 경우

bind_context

void bind_context(NameComponent [] n,
                  NamingContext  nc)
                  throws NotFound,

                         CannotProceed,

                         InvalidName,

                         AlreadyBound 

네이밍 컨텍스트 인 객체의 이름을 지정합니다. 이름 해석에 대해 복합명이 건네받았을 경우, bind_context()를 사용해 바인드 되고 있는 네이밍 컨텍스트은 이름 해석에 참가합니다.

파라미터:

n - 객체의 이름

nc - 지정된 이름에 바인드 되는 NamingContect 객체

예외:

NotFound - 이름으로 바인딩을 식별할 수 없는 경우

CannotProceed - 하등의 이유에 의해 구현이 중지되었을 경우. 다만 클라이언트는 리턴된 네이밍 컨텍스트 으로 처리를 속행할 수 있는 경우도 있다

InvalidName - 이름이 무효인 경우

AlreadyBound - 지정된 이름에 객체가 이미 바인드 되고 있는 경우

rebind

void rebind(NameComponent [] n,
            Object  obj)
            throws NotFound,

                   CannotProceed,

                   InvalidName 

이름이 이미 컨텍스트 으로 바인드 되고 있는 경우에서도, 네이밍 컨텍스트에 이름과 객체의 바인딩을 작성합니다. 이름 해석에 대해 복합명이 건네받았을 경우, rebind를 사용해 바인드 되고 있는 네이밍 컨텍스트은 이름 해석에 참가하지 않습니다.

파라미터:

n - 객체의 이름

obj -

지정된 이름에 재바인드 되는 Object

예외:

NotFound - 이름으로 바인딩을 식별할 수 없는 경우

CannotProceed - 하등의 이유에 의해 구현이 중지되었을 경우. 다만 클라이언트는 리턴된 네이밍 컨텍스트 으로 처리를 속행할 수 있는 경우도 있다

InvalidName - 이름이 무효인 경우

rebind_context

void rebind_context(NameComponent [] n,
                    NamingContext  nc)
                    throws NotFound,

                           CannotProceed,

                           InvalidName 

이름이 이미 컨텍스트 으로 바인드 되고 있는 경우에서도, 네이밍 컨텍스트에 이름과 네이밍 컨텍스트 의 바인딩을 작성합니다. 이름 해석에 대해 복합명이 건네받았을 경우, rebind_context()를 사용해 바인드 되고 있는 네이밍 컨텍스트은 이름 해석에 참가합니다.

파라미터:

n - 객체의 이름

nc - 지정된 이름에 재바인드 되는 NamingContect 객체

예외:

NotFound - 이름으로 바인딩을 식별할 수 없는 경우

CannotProceed - 하등의 이유에 의해 구현이 중지되었을 경우. 다만 클라이언트는 리턴된 네이밍 컨텍스트 으로 처리를 속행할 수 있는 경우도 있다

InvalidName - 이름이 무효인 경우

resolve

Object  resolve(NameComponent [] n)
               throws NotFound,

                      CannotProceed,

                      InvalidName 

resolve는 지정된 컨텍스트 으로 이름에 바인드 되고 있는 객체를 취득합니다. 지정된 이름은 바인드 된 이름과 완전하게 일치하고 있을 필요가 있습니다. 네임 서비스는 객체의 형태를 돌려주지 않습니다. 적절한 형태에의 객체의 「네로우 변환」은 클라이언트측에서 실시할 필요가 있습니다. 즉, 보통 클라이언트는 Object 로부터 리턴된 객체를 보다 특수화 된 인터페이스에 캐스트 합니다.

파라미터:

n - 객체의 이름

예외:

NotFound - 이름으로 바인딩을 식별할 수 없는 경우

CannotProceed - 하등의 이유에 의해 구현이 중지되었을 경우. 다만 클라이언트는 리턴된 네이밍 컨텍스트 으로 처리를 속행할 수 있는 경우도 있다

InvalidName - 이름이 무효인 경우

unbind

void unbind(NameComponent [] n)
            throws NotFound,

                   CannotProceed,

                   InvalidName 

unbind는 컨텍스트 으로부터 네임 바인딩을 삭제합니다.

파라미터:

n - 객체의 이름

예외:

NotFound - 이름으로 바인딩을 식별할 수 없는 경우

CannotProceed - 하등의 이유에 의해 구현이 중지되었을 경우. 다만 클라이언트는 리턴된 네이밍 컨텍스트 으로 처리를 속행할 수 있는 경우도 있다

InvalidName - 이름이 무효인 경우

list

void list(int how_many,
          BindingListHolder  bl,
          BindingIteratorHolder  bi)

list를 사용하면, 클라이언트는 네이밍 컨텍스트 내의 일련의 바인딩을 차례차례로 취득할 수 있습니다.

list는 바인딩 리스트 bl 내의, 지정된 수를 최대 수라고의해 바인딩을 리턴합니다.

• 네이밍 컨텍스트에 여분의 바인딩이 있는 경우, list는 여분의 바인딩의 바인딩 반복자를 돌려준다
• 네이밍 컨텍스트에 여분의 바인딩이 없는 경우, 바인딩 반복자는 nil 객체 참조

파라미터:

how_many - 리턴된 바인딩의 최대수

bl - 리턴된 바인딩의 리스트

bi - 리턴된 바인딩 반복자

new_context

NamingContext  new_context()

호출측의 컨텍스트과 같은 네임서버에 의해 구현되는 네이밍 컨텍스트를 리턴합니다. 새로운 컨텍스트은 어느 이름에도 바인드 되지 않습니다.

bind_new_context

NamingContext  bind_new_context(NameComponent [] n)
                               throws NotFound,

                                      AlreadyBound,

                                      CannotProceed,

                                      InvalidName 

컨텍스트를 새롭게 작성해, 인수로서 지정된 이름에 그 컨텍스트를 바인드 합니다. 새롭게 작성된 컨텍스트은 바인드 된 컨텍스트과 같은 네임서버에 의해 구현됩니다. 즉, 마지막 컴퍼넌트를 제외한, 이름 인수에 의해 나타나는 컨텍스트를 구현하는 네임서버입니다.

파라미터:

n - 객체의 이름

예외:

NotFound - 이름으로 바인딩을 식별할 수 없는 경우

AlreadyBound - 지정된 이름에 객체가 이미 바인드 되고 있는 경우

CannotProceed - 하등의 이유에 의해 구현이 중지되었을 경우. 다만 클라이언트는 리턴된 네이밍 컨텍스트 으로 처리를 속행할 수 있는 경우도 있다

InvalidName - 이름이 무효인 경우

destroy

void destroy()
             throws NotEmpty 

destroy는 네이밍 컨텍스트를 삭제합니다. 네이밍 컨텍스트에 바인딩이 있는 경우는 NotEmpty 예외가 발생 됩니다.

예외:

NotEmpty - Naming Context에 바인딩이 있는 경우