패키지 javax.naming

네임 서비스에 액세스하기 위한 클래스 및 인터페이스를 제공합니다.

참조:
설명

인터페이스의 개요

Context	이 인터페이스는 이름으로부터 오브젝트에의 바인딩세트로부터 구성되는 네이밍 문맥을 나타냅니다.
Name	Name 인터페이스는 일반명, 즉 컴퍼넌트가 순서 붙이고 된 순차 순서를 나타냅니다.
NameParser	이 인터페이스는 계층 이름 공간의 이름의 구문을 구문 분석 하기 위해서 사용됩니다.
NamingEnumeration	이 인터페이스는 javax.naming 및 javax.naming.directory 패키지내의 메소드에 의해 돌려주어진 리스트를 열거하기 위해서 사용됩니다.
Referenceable	이 인터페이스는 Reference 를 그 자체에 제공할 수 있는 오브젝트에 의해 구현됩니다.

클래스의 개요

BinaryRefAddr	이 클래스는 통신 종단의 주소의 바이너리 형식을 나타냅니다.
Binding	이 클래스는 문맥의 이름과 오브젝트와의 바인딩을 나타냅니다.
CompositeName	이 클래스는 합성명을 나타냅니다.
CompoundName	이 클래스는 복합명을 나타냅니다.
InitialContext	이 클래스는 네이밍 조작을 실행하기 위한 개시 문맥입니다.
LinkRef	이 클래스는 참조를 나타냅니다.
NameClassPair	이 클래스는 문맥의 바인딩의 오브젝트명과 클래스명의 페어를 나타냅니다.
RefAddr	이 클래스는 통신단점의 주소를 나타냅니다.
Reference	이 클래스는 네이밍 및 디렉토리 시스템의 외부에서 검출되는 오브젝트에 대한 참조를 나타냅니다.
StringRefAddr	이 클래스는 통신단점의 주소를 캐릭터 라인 형식에서 나타냅니다.

예외의 개요

AuthenticationException	이 예외는 네이밍 서비스 또는 디렉토리 서비스에 액세스 할 때에 인증 에러가 발생했을 경우에 슬로우 됩니다.
AuthenticationNotSupportedException	이 예외는 요구된 인증의 특정의 후레이바가 서포트되어 있지 않은 경우에 슬로우 됩니다.
CannotProceedException	이 예외는 오퍼레이션을 더 이상 진행되지 않는 이름의 포인트에 오퍼레이션이 달한 것을 나타내기 위해서(때문에) 슬로우 됩니다.
CommunicationException	이 예외는 클라이언트가 디렉토리 서비스 또는 네이밍 서비스와 통신할 수 없는 경우에 슬로우 됩니다.
ConfigurationException	이 예외는 구성상의 문제가 있는 경우에 슬로우 됩니다.
ContextNotEmptyException	이 예외는 하늘이 아닌 문맥을 파기하려고 했을 경우에 슬로우 됩니다.
InsufficientResourcesException	이 예외는 요구된 오퍼레이션을 완료하기 위해서 리소스를 이용할 수 없는 경우에 슬로우 됩니다.
InterruptedNamingException	이 예외는 네이밍 조작의 호출이 끼어들어졌을 경우에 슬로우 됩니다.
InvalidNameException	이 예외는 지정된 이름이 네이밍 시스템의 네이밍 구문과 일치하지 않는 것을 나타냅니다.
LimitExceededException	이 예외는 유저 또는 시스템으로 지정된 제한에 의해 메소드가 이상종료(ABEND) 했을 경우에 슬로우 됩니다.
LinkException	이 예외는 링크의 해결중에 발견된 문제를 설명하기 위해서 사용됩니다.
LinkLoopException	이 예외는 링크를 해결하려고 해 루프가 검출되었을 때, 또는 링크 카운트의 고유의 구현으로 제한에 이르렀을 때에 슬로우 됩니다.
MalformedLinkException	이 예외는 링크를 해결 또는 구축할 경우에 무효인 링크가 발견되었을 경우에 슬로우 됩니다.
NameAlreadyBoundException	이 예외는 이름이 벌써 다른 오브젝트에 바인드 되고 있기 위해서(때문에), 바인딩을 추가할 수 없는 것을 나타내는 메소드에 의해 슬로우 됩니다.
NameNotFoundException	이 예외는 바인드되어 있지 않기 위해(때문에), 이름의 컴퍼넌트를 해결할 수 없는 경우에 슬로우 됩니다.
NamingException	Context 및 DirContext 인터페이스에서의 조작에 의해 슬로우 되는 모든 예외의 슈퍼 클래스입니다.
NamingSecurityException	Context 및 DirContext 인터페이스에서의 조작에 의해 슬로우 되는 시큐러티에 관련하는 예외의 슈퍼 클래스입니다.
NoInitialContextException	이 예외는 초기 문맥 구현을 작성할 수 없는 경우에 슬로우 됩니다.
NoPermissionException	이 예외는 클라이언트가 액세스권을 갖지 않는 조작을 실행하려고 하면(자) 슬로우 됩니다.
NotContextException	네이밍 조작을 계속하기 위해서 문맥이 필요한 지점에서, 해결된 오브젝트가 문맥이 아닌 경우에, 이 예외는 슬로우 됩니다.
OperationNotSupportedException	문맥 구현이 불려 간 조작을 서포트하지 않는 경우에, 이 예외는 슬로우 됩니다.
PartialResultException	이 예외는 현재 돌려주어지고 있는 결과, 또는 지금까지 돌려주어진 결과가 부분적인 것, 및 조작을 완료할 수 없는 것을 나타내기 위해서(때문에) 슬로우 됩니다.
ReferralException	이 abstract 클래스는 LDAP v3 서버에 의해 돌려주어지는 경우등의참조에 응답해 생성되는 참조 예외를 나타내는데 사용됩니다.
ServiceUnavailableException	이 예외는 디렉토리 서비스 또는 네임 서비스와의 통신을 시도한 결과, 그 서비스를 이용할 수 없는 경우에 슬로우 됩니다.
SizeLimitExceededException	이 예외는 메소드가 사이즈 관련의 제한을 넘는 결과를 생성했을 경우에 슬로우 됩니다.
TimeLimitExceededException	이 예외는 메소드가 지정된 제한 시간내에 종료하지 않는 경우에 슬로우 됩니다.

패키지 javax.naming 의 설명

네임 서비스에 액세스하기 위한 클래스 및 인터페이스를 제공합니다.

이 패키지는 Java Naming and Directory Interface^TM (JNDI)의 네이밍 조작을 정의합니다. JNDI 는 Java 프로그램 언어로 작성된 어플리케이션에 네이밍 기능 및 디렉토리 기능을 제공합니다. JNDI 는 특정의 네이밍 또는 디렉토리 서비스 구현으로부터 독립해 설계되고 있습니다. 이 때문에, 새로운 서비스 및 벌써 배치되고 있는 여러가지 서비스에, 공통의 방법으로 액세스 할 수 있습니다.

문맥

이 패키지는 Context 인터페이스로 나타내지는 문맥의 개념을 정의합니다. 문맥은 오브젝트에 대한 이름의바인딩세트로 구성됩니다. Context 는 오브젝트의 검색, 바인딩, 바인딩 해제, 이름의 변경, 및 서브 문맥의 작성과 파기를 실행하기 위한 코어 인터페이스입니다.

lookup() 는 가장 빈번하게 사용되는 조작입니다. 검색하는 오브젝트의 이름에 lookup() 를 지정하면(자), 그 이름에 바인드 되고 있는 오브젝트가 돌려주어집니다. 이 예로서 프린터를 검색해, 출력하는 프린터 오브젝트에 문서를 송신하는 코드를 다음에 나타냅니다.

Printer printer = (Printer) ctx.lookup("treekiller");
printer.print(report);

이름

Context 인터페이스내의 모든 네이밍 메소드에, 2 개의 overload가 있습니다. 1 kr은 Name 인수를 받아들이는 overload로, 이제(벌써) 1 kr은 캐릭터 라인명을 받아들이는 overload입니다. Name 는 일반명을 나타내는 (복수의 컴퍼넌트가 있는 경우는 제로로부터 순서 붙이고 된다) 인터페이스입니다. 이러한 메소드의 경우, 복수의 이름 공간에 걸치는 이름을 사용해 오브젝트에 이름을 붙이기 위해서(때문에),Name 를 사용해합성명 (CompositeName)을 나타낼 수 있습니다.

Name 를 받아들이는 overload는 어플리케이션으로 이름의 처리 (이름의 작성, 컴퍼넌트의 비교등)를 실시하는 경우에 편리합니다. 1 개의 이름으로 단순하게 읽어들여, 대응하는 오브젝트를 검색하는 등의 단순한 어플리케이션으로, 캐릭터 라인명을 받아들이는 overload는 보다 도움이 됩니다.

바인딩

Binding 클래스는 오브젝트에 대한 이름의 바인딩을 나타냅니다. 이 클래스는 바인드 된 오브젝트의 이름, 오브젝트의 클래스의 이름, 및 오브젝트 자체가 저장되는 1 개의 타풀 (조)입니다.

실제,Binding 클래스는 오브젝트의 이름과 오브젝트의 클래스명만으로 구성되는 NameClassPair 의 서브 클래스입니다. NameClassPair 는 오브젝트의 클래스에 관한 정보만이 필요해, 오브젝트를 취득하는데 불필요한 수고를 들이고 싶지 않은 경우에 편리합니다.

참조

오브젝트는 네이밍 및 디렉토리 서비스에 다른 방법으로 저장됩니다. 오브젝트 기억이 Java 오브젝트의 저장을 서포트하고 있는 경우, 오브젝트의 직렬화 된 형식에서의 저장이 서포트됩니다. 다만, Java 오브젝트의 저장을 서포트하지 않는 네이밍 및 디렉토리 서비스도 있습니다. 게다가 디렉토리내의 몇개의 오브젝트에서는 Java 프로그램이 그러한 오브젝트에 액세스 하는 어플리케이션의 1 그룹에 포함되지 않습니다. 이 경우, 직렬화 된 Java 오브젝트는 가장 적절한 표현으로는 되지 않습니다. JNDI 는 오브젝트의 카피의 구축 방법에 관한 정보가 저장되는 Reference 클래스에서 나타내지는참조를 정의합니다. JNDI 는 참조의 검색처를, 디렉토리로부터 이 참조가 나타내는 Java 오브젝트에 변경하려고 합니다. 그 결과, JNDI 클라이언트는 디렉토리내에 저장되는 내용이 Java 오브젝트이라고 간주합니다.

초기 문맥

JNDI 에서는 모든 네이밍 및 디렉토리 조작은 문맥에 관련해 실행됩니다. 절대적인 루트는 없습니다. 따라서, JNDI 는 네이밍 및 디렉토리 조작의 개시 지점을 지정하는초기 문맥,InitialContext 를 정의합니다. 한 번 초기 문맥을 지정하면(자), 다른 문맥이나 오브젝트를 참조하는 경우도 그 초기 문맥을 사용할 수 있습니다.

예외

JNDI 는 네이밍 및 디렉토리 조작을 실행하는 과정에서 슬로우 할 수 있는 예외의 클래스 계층을 정의합니다. 이 클래스 계층 루트는 NamingException 입니다. 특정의 예외를 취급하는 프로그램에서는 그 예외의 대응하는 서브 클래스를 캐치 할 수 있습니다. 그 이외의 경우, 프로그램에서는 NamingException 를 캐치 합니다.

패키지의 사양

Java technology web 사이트에서는 다음의 문서를 참조할 수 있습니다.

• 「JNDI API Document」(Postscript)
• 「JNDI API Document」(PDF)

관련 항목

튜토리얼, 예, 및 개요에 대해서는 다음을 참조합니다.

• 「The JNDI Tutorial」
• 례
• 「Executive Summary」(Postscript)
• 「Executive Summary」(PDF)

도입된 버젼:

1.3