javax.naming
클래스 NamingException

java.lang.Object 
  |
  +--java.lang.Throwable 
        |
        +--java.lang.Exception 
              |
              +--javax.naming.NamingException

모든 구현 인터페이스:

Serializable

직계의 기존의 서브 클래스:

AttributeInUseException , AttributeModificationException , CannotProceedException , CommunicationException , ConfigurationException , ContextNotEmptyException , InsufficientResourcesException , InterruptedNamingException , InvalidAttributeIdentifierException , InvalidAttributesException , InvalidAttributeValueException , InvalidNameException , InvalidSearchControlsException , InvalidSearchFilterException , LimitExceededException , LinkException , NameAlreadyBoundException , NameNotFoundException , NamingSecurityException , NoInitialContextException , NoSuchAttributeException , NotContextException , OperationNotSupportedException , PartialResultException , ReferralException , SchemaViolationException , ServiceUnavailableException

public class NamingException

extends Exception

Context 및 DirContext 인터페이스에서의 조작에 의해 슬로우 되는 모든 예외의 슈퍼 클래스입니다. 실패의 성질이 서브 클래스의 이름으로 나타납니다. 이 예외는 조작이 실패한 위치, 해결이 마지막에 행해진 위치를 정확하게 가리키는 정보를 취득합니다.

• [해결명] - 해결된 이름의 일부분
• [해결 오브젝트] - 이름의 해결을 한 오브젝트
• [잔존 네임] - 해결되어 있지 않은 이름의 부분
• [설명] - 이름 해석이 실패한 이유를 설명하는 상세
• [루트 예외] - 이 네이밍 예외가 슬로우 되는 원인이 된 예외

null 는 이러한 어느 필드에도 받아들여집니다. null 는 상기와 같은 정보가 필드에 대해서 기록되지 않는 것을 의미합니다.

NamingException 인스턴스는 병렬 multi-thread 액세스에 대해서 동기화 되지 않습니다. 단일의 NamingException 인스턴스에 액세스 해 변경하려고 하는 복수의 thread에 의해, 오브젝트는 락 됩니다.

도입된 버젼:

1.3

관련 항목:

직렬화 된 형식

필드의 개요

protected Name	remainingName 미해결의 나머지의 이름을 포함합니다.
protected Name	resolvedName 정상적으로 해결된 이름의 부분을 포함합니다.
protected Object	resolvedObj 이름의 부분이 정상적으로 해결된 오브젝트를 포함합니다.
protected Throwable	rootException 이 NamingException 가 슬로우 되는 원인이 된 원의 예외를 포함합니다.

생성자의 개요

NamingException ()
NamingException 를 새롭게 구축합니다.

NamingException (String explanation)
NamingException 를 설명 첨부로 새롭게 구축합니다.

메소드의 개요

void	appendRemainingComponent (String name) 나머지의 이름의 마지막 컴퍼넌트로서 이름을 추가합니다.
void	appendRemainingName (Name name) 나머지의 이름의 마지막 컴퍼넌트로서 「이름」으로부터 컴퍼넌트를 추가합니다.
String	getExplanation () 이 예외에 관련한 설명을 검색합니다.
Name	getRemainingName () 이름의 나머지의 미해결 부분을 취득합니다.
Name	getResolvedName () 정상적으로 해결된 이름의 선두 부분을 검색합니다.
Object	getResolvedObj () 정상적으로 해결된 오브젝트를 검색합니다.
Throwable	getRootCause () 이 NamingException 의 근본적 원인이 있는 경우는 그 근본적 원인을 검색합니다.
void	printStackTrace () 이 예외의 스택 트레이스를 System.err 에 출력합니다.
void	printStackTrace (PrintStream ps) 이 예외의 스택 트레이스를 출력 스트림에 출력합니다.
void	printStackTrace (PrintWriter pw) 이 예외의 스택 트레이스를 프린트 라이터에 출력합니다.
void	setRemainingName (Name name) 이 예외의 [remainingName] 필드를 설정합니다.
void	setResolvedName (Name name) 이 예외의 [resolvedName] 필드를 설정합니다.
void	setResolvedObj (Object obj) 이 예외의 [resolvedObj] 필드를 설정합니다.
void	setRootCause (Throwable e) 이 NamingException 의 근본적 원인을 기록합니다.
String	toString () 이 예외의 캐릭터 라인 표현이 생성됩니다.
String	toString (boolean detail) 보다 상세한 캐릭터 라인 표현이 생성됩니다.

클래스 java.lang. Throwable 에서 상속받은 메소드

fillInStackTrace , getCause , getLocalizedMessage , getMessage , getStackTrace , initCause , setStackTrace

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

필드의 상세

resolvedName

protected Name  resolvedName

정상적으로 해결된 이름의 부분을 포함합니다. 이것은 합성명으로, null 를 지정할 수 있습니다. 이 필드는 constructor 에 의해 초기화됩니다. get 메소드 및 set 메소드에 의해 이 필드에 액세스 해, 처리합니다.

관련 항목:

getResolvedName() , setResolvedName(javax.naming.Name)

resolvedObj

protected Object  resolvedObj

이름의 부분이 정상적으로 해결된 오브젝트를 포함합니다. null 를 지정할 수 있습니다. 이 필드는 constructor 에 의해 초기화됩니다. get 메소드 및 set 메소드에 의해 이 필드에 액세스 해, 처리합니다.

관련 항목:

getResolvedObj() , setResolvedObj(java.lang.Object)

remainingName

protected Name  remainingName

미해결의 나머지의 이름을 포함합니다. 이것은 합성명으로, null 를 지정할 수 있습니다. 이 필드는 constructor 에 의해 초기화됩니다. get, set, 「append」메소드에 의해 이 필드에 액세스 해, 처리합니다.

관련 항목:

getRemainingName() , setRemainingName(javax.naming.Name) , appendRemainingName(javax.naming.Name) , appendRemainingComponent(java.lang.String)

rootException

protected Throwable  rootException

이 NamingException 가 슬로우 되는 원인이 된 원의 예외를 포함합니다. 이 필드는 원의 예외로부터 취득 가능한 추가 정보가 있는 경우나, NamingException 의 서브 클래스에 MAP 할 수 없는 원의 예외가 있는 경우로 설정됩니다. null 를 지정할 수 있습니다. 이 필드는 constructor 에 의해 초기화됩니다. get 및 set 메소드에 의해 이 필드에 액세스 해, 처리합니다.

관련 항목:

getRootCause() , setRootCause(java.lang.Throwable)

생성자의 상세

NamingException

public NamingException(String  explanation)

NamingException 를 설명 첨부로 새롭게 구축합니다. 지정되어 있지 않은 필드는 모두 null 로 설정됩니다.

파라미터:

explanation - null 의 가능성이 있는 이 예외에 관한 추가의 상세 정보를 포함한 캐릭터 라인

관련 항목:

Throwable.getMessage()

NamingException

public NamingException()

NamingException 를 새롭게 구축합니다. 필드는 모두 null 로 설정됩니다.

메소드의 상세

getResolvedName

public Name  getResolvedName()

정상적으로 해결된 이름의 선두 부분을 검색합니다.

반환값:

정상적으로 해결된 이름의 부분. 합성명이다. null 의 경우는 [resolved name] 필드가 설정되어 있지 않은 것을 나타내는

관련 항목:

getResolvedObj() , setResolvedName(javax.naming.Name)

getRemainingName

public Name  getRemainingName()

이름의 나머지의 미해결 부분을 취득합니다.

반환값:

해결되어 있지 않은 이름의 부분. 합성명이다. null 의 경우는 [remainingName] 필드가 설정되어 있지 않은 것을 나타내는

관련 항목:

setRemainingName(javax.naming.Name) , appendRemainingName(javax.naming.Name) , appendRemainingComponent(java.lang.String)

getResolvedObj

public Object  getResolvedObj()

정상적으로 해결된 오브젝트를 검색합니다. 이것은 해결된 이름이 바인드 되고 있는 오브젝트입니다.

반환값:

지금까지 해결된 null 오브젝트의 경우가 있다. null 는 [resolvedObj] 필드가 설정되어 있지 않은 것을 나타내는

관련 항목:

getResolvedName() , setResolvedObj(java.lang.Object)

getExplanation

public String  getExplanation()

이 예외에 관련한 설명을 검색합니다.

반환값:

null 의 가능성이 있는 이 예외에 대해 설명하는 상세 캐릭터 라인. null 의 경우, 이 예외에는 상세 메세지는 없는

관련 항목:

Throwable.getMessage()

setResolvedName

public void setResolvedName(Name  name)

이 예외의 [resolvedName] 필드를 설정합니다.

name 는 합성명입니다. 복합명 또는 캐릭터 라인을 사용해 이 필드를 설정하는 경우는 복합명을 캐릭터 라인화하고 나서, 그 캐릭터 라인을 사용해 단일의 컴퍼넌트를 포함한 합성명을 작성할 필요가 있습니다. 그 결과 나타난 합성명을 사용해, 이 메소드를 호출할 수가 있습니다.

name 의 카피가 작성 및 저장됩니다. 그 후 name 를 변경해도 이 NamingException 의 카피에는 영향을 주지 않고 역의 경우도 같습니다.

파라미터:

name - null 의 가능성이 있는 해결명을 설정하는 이름. null 의 경우,[resolvedName] 필드는 null 로 설정되는

관련 항목:

getResolvedName()

setRemainingName

public void setRemainingName(Name  name)

이 예외의 [remainingName] 필드를 설정합니다.

name 는 합성명입니다. 복합명 또는 캐릭터 라인을 사용해 이 필드를 설정하는 경우는 복합명을 캐릭터 라인화하고 나서, 그 캐릭터 라인을 사용해 단일의 컴퍼넌트를 포함한 합성명을 작성할 필요가 있습니다. 그 결과 나타난 합성명을 사용해, 이 메소드를 호출할 수가 있습니다.

name 의 카피가 작성 및 저장됩니다. 그 후 name 를 변경해도 이 NamingException 의 카피에는 영향을 주지 않고 역의 경우도 같습니다.

파라미터:

name - null 의 가능성이 있는 잔존명으로 설정하는 이름. null 의 경우,[remainingName] 필드는 null 로 설정되는

관련 항목:

getRemainingName() , appendRemainingName(javax.naming.Name) , appendRemainingComponent(java.lang.String)

setResolvedObj

public void setResolvedObj(Object  obj)

이 예외의 [resolvedObj] 필드를 설정합니다.

파라미터:

obj - null 의 가능성이 있는 해결 오브젝트로 설정하는 오브젝트. null 의 경우,[resolvedObj] 필드는 null 로 설정되는

관련 항목:

getResolvedObj()

appendRemainingComponent

public void appendRemainingComponent(String  name)

나머지의 이름의 마지막 컴퍼넌트로서 이름을 추가합니다.

파라미터:

name - 추가하는 컴퍼넌트. 이름이 null 의 경우, 이 메소드는 기능하지 않는

관련 항목:

setRemainingName(javax.naming.Name) , getRemainingName() , appendRemainingName(javax.naming.Name)

appendRemainingName

public void appendRemainingName(Name  name)

나머지의 이름의 마지막 컴퍼넌트로서 「이름」으로부터 컴퍼넌트를 추가합니다.

name 는 합성명입니다. 복합명을 추가하는 경우는 복합명을 캐릭터 라인화하고 나서, String 파라미터를 받아들이는 overload 된 형식을 호출합니다.

그 후 name 를 변경해도, 이 NamingException 의 [remaining field] 필드에는 영향을 주지 않고 역의 경우도 같습니다.

파라미터:

name - null 의 가능성이 있는 추가하는 순서 첨부 컴퍼넌트를 포함한 캐릭터 라인. 이름이 null 의 경우, 이 메소드는 기능하지 않는

관련 항목:

setRemainingName(javax.naming.Name) , getRemainingName() , appendRemainingComponent(java.lang.String)

getRootCause

public Throwable  getRootCause()

이 NamingException 의 근본적 원인이 있는 경우는 그 근본적 원인을 검색합니다. 네이밍 예외의 근본적 원인은 서비스 프로바이더가 호출해 측에 대해 이름 이외에 관련하는 예외를 나타낼 때 사용됩니다만, 동시에 NamingException 구조를 사용해 네이밍 조작 처리의 완료 상황을 나타내는 경우에도 사용됩니다.

반환값:

null 의 가능성이 있는 이 네이밍 예외의 원인이 된 예외. null 의 경우는 이 네이밍 예외에 대해서 근본적 원인이 설정되어 있지 않은 것을 나타내는

관련 항목:

setRootCause(java.lang.Throwable) , rootException

setRootCause

public void setRootCause(Throwable  e)

이 NamingException 의 근본적 원인을 기록합니다. e 가 this 의 경우, 이 메소드는 기능하지 않습니다.

파라미터:

e - null 의 가능성이 있는 실패하는 네이밍 조작의 원인이 된 예외. null 의 경우는 이 네이밍 예외에 대해서 근본적 원인이 없는 것을 나타내는

관련 항목:

getRootCause() , rootException

toString

public String  toString()

이 예외의 캐릭터 라인 표현이 생성됩니다. 캐릭터 라인 표현은 이 예외의 클래스명, 그 상세 메세지로 구성됩니다. 근본적 원인이 있는 경우는 근본적 원인을 가지는 예외의 캐릭터 라인 표현과 그 후에 계속되는 나머지의 이름 (null 가 아닌 경우)으로 구성됩니다. 이 캐릭터 라인은 디버그를 위해서(때문에) 사용되어 프로그램에 의해 해석될 것은 없습니다.

오버라이드(override):

클래스 Throwable 내의 toString

반환값:

이 예외의 캐릭터 라인 표현이 저장되는 null 이외의 캐릭터 라인

toString

public String  toString(boolean detail)

보다 상세한 캐릭터 라인 표현이 생성됩니다. 이 캐릭터 라인 표현은 파라미터를 취하지 않는 toString()에 의해 돌려주어지는 정보와 해결된 오브젝트의 캐릭터 라인 표현 (null 가 아닌 경우)으로 구성됩니다. 이 캐릭터 라인은 디버그에 사용되어 프로그램에 의해 해석될 것은 없습니다.

파라미터:

detail - true 의 경우, 다른 정보 이외에 해결된 오브젝트에 관한 상세를 포함한다

반환값:

캐릭터 라인 표현이 저장되는 null 이외의 캐릭터 라인

printStackTrace

public void printStackTrace()

이 예외의 스택 트레이스를 System.err 에 출력합니다. 이 예외에 루트 예외가 없는 경우, 루트 예외의 스택 트레이스가 대신에 출력됩니다.

오버라이드(override):

클래스 Throwable 내의 printStackTrace

printStackTrace

public void printStackTrace(PrintStream  ps)

이 예외의 스택 트레이스를 출력 스트림에 출력합니다. 이 예외에 루트 예외가 있는 경우, 루트 예외의 스택 트레이스가 대신에 출력됩니다.

오버라이드(override):

클래스 Throwable 내의 printStackTrace

파라미터:

ps - 출력처의 null 이외의 출력 스트림

printStackTrace

public void printStackTrace(PrintWriter  pw)

이 예외의 스택 트레이스를 프린트 라이터에 출력합니다. 이 예외에 루트 예외가 있는 경우, 루트 예외의 스택 트레이스가 대신에 출력됩니다.

오버라이드(override):

클래스 Throwable 내의 printStackTrace

파라미터:

pw - 출력처의 null 이외의 프린트 라이터