JavaTM Platform
Standard Ed. 6

javax.naming
클래스 LinkException

java.lang.Object 
  상위를 확장 java.lang.Throwable 
      상위를 확장 java.lang.Exception 
          상위를 확장 javax.naming.NamingException 
              상위를 확장 javax.naming.LinkException
모든 구현된 인터페이스:
Serializable
직계의 기존의 서브 클래스:
LinkLoopException , MalformedLinkException


public class LinkException
extends NamingException

이 예외는, 링크의 해결중에 발견된 문제를 설명하기 위해서 사용됩니다. 링크에 관한 문제를 특정하기 위해서, 기본의 NamingException 에 정보가 추가됩니다.

NamingException 로 이름 해석 정보가 받아들여지는 방법과 같게, LinkException 에서는, 링크를 해결할 때에 발견된 문제를 특정하는 링크명 해결 정보가 받아들여집니다. 이러한 필드를 모두 null 로 할 수도 있습니다.

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

도입된 버젼:
1.3
관련 항목:
Context.lookupLink(javax.naming.Name) , LinkRef , 직렬화 된 형식

필드의 개요
protected  String linkExplanation
          링크의 해결이 실패한 이유의 예외를 포함합니다.
protected  Name linkRemainingName
          미해결의 나머지의 링크를 포함합니다.
protected  Name linkResolvedName
          정상적으로 해결된 링크의 부분을 포함합니다.
protected  Object linkResolvedObj
          링크의 부분이 정상적으로 해결된 객체를 포함합니다.
 
클래스 javax.naming. NamingException 로부터 상속된 필드
remainingName , resolvedName , resolvedObj , rootException
 
생성자 의 개요
LinkException ()
          LinkException 의 새로운 인스턴스를 구축합니다.
LinkException (String  explanation)
          설명 첨부로 LinkException 의 새로운 인스턴스를 구축합니다.
 
메소드의 개요
 String getLinkExplanation ()
          링크의 해결중에 발견된 문제에 관련하는 설명을 가져옵니다.
 Name getLinkRemainingName ()
          링크명의 나머지의 미해결 부분을 가져옵니다.
 Name getLinkResolvedName ()
          정상적으로 해결된 링크의 선두 부분을 가져옵니다.
 Object getLinkResolvedObj ()
          정상적으로 해결된 객체를 가져옵니다.
 void setLinkExplanation (String  msg)
          링크의 해결중에 발견된 문제에 관련하는 설명을 설정합니다.
 void setLinkRemainingName (Name  name)
          이 예외의 [linkRemainingName] 필드를 설정합니다.
 void setLinkResolvedName (Name  name)
          이 예외의 [linkResolvedName] 필드를 설정합니다.
 void setLinkResolvedObj (Object  obj)
          이 예외의 [linkResolvedObj] 필드를 설정합니다.
 String toString ()
          이 예외의 캐릭터 라인 표현이 생성됩니다.
 String toString (boolean detail)
          이 예외의 캐릭터 라인 표현이 생성됩니다.
 
클래스 javax.naming. NamingException 로부터 상속된 메소드
appendRemainingComponent , appendRemainingName , getCause , getExplanation , getRemainingName , getResolvedName , getResolvedObj , getRootCause , initCause , setRemainingName , setResolvedName , setResolvedObj , setRootCause
 
클래스 java.lang. Throwable 로부터 상속된 메소드
fillInStackTrace , getLocalizedMessage , getMessage , getStackTrace , printStackTrace , printStackTrace , printStackTrace , setStackTrace
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait
 

필드의 상세

linkResolvedName

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

관련 항목:
getLinkResolvedName() , setLinkResolvedName(javax.naming.Name)

linkResolvedObj

protected Object  linkResolvedObj
링크의 부분이 정상적으로 해결된 객체를 포함합니다. null 도 가능 이 필드는 생성자 에 의해 초기화됩니다. get 메소드 및 set 메소드에 의해 이 필드에 액세스 해, 처리합니다.

관련 항목:
getLinkResolvedObj() , setLinkResolvedObj(java.lang.Object)

linkRemainingName

protected Name  linkRemainingName
미해결의 나머지의 링크를 포함합니다. 이것은 합성명으로, null 를 지정할 수 있습니다. 이 필드는 생성자 에 의해 초기화됩니다. get 메소드 및 set 메소드에 의해 이 필드에 액세스 해, 처리합니다.

관련 항목:
getLinkRemainingName() , setLinkRemainingName(javax.naming.Name)

linkExplanation

protected String  linkExplanation
링크의 해결이 실패한 이유의 예외를 포함합니다. null 도 가능 이 필드는 생성자 에 의해 초기화됩니다. get 메소드 및 set 메소드에 의해 이 필드에 액세스 해, 처리합니다.

관련 항목:
getLinkExplanation() , setLinkExplanation(java.lang.String)
생성자 의 상세

LinkException

public LinkException(String  explanation)
설명 첨부로 LinkException 의 새로운 인스턴스를 구축합니다. 다른 필드는 모두 null 에 초기화됩니다.

파라미터:
explanation - null 의 가능성이 있는, 이 예외에 관한 추가의 상세 정보를 포함한 캐릭터 라인
관련 항목:
Throwable.getMessage()

LinkException

public LinkException()
LinkException 의 새로운 인스턴스를 구축합니다. 링크에 관련하지 않는, 및 링크에 관련하는 필드는 모두 null 에 초기화됩니다.

메소드의 상세

getLinkResolvedName

public Name  getLinkResolvedName()
정상적으로 해결된 링크의 선두 부분을 가져옵니다.

반환값:
정상적으로 해결된 링크명의 부분. 합성명이다. null 를 지정할 수 있어 그 경우는 [linkResolvedName (링크 해결명)] 필드가 설정되어 있지 않은 것을 나타내는
관련 항목:
getLinkResolvedObj() , setLinkResolvedName(javax.naming.Name)

getLinkRemainingName

public Name  getLinkRemainingName()
링크명의 나머지의 미해결 부분을 가져옵니다.

반환값:
해결되어 있지 않은 링크명의 부분. 합성명이다. null 의 경우는,[linkRemainingName (링크 잔존명)] 필드가 설정되어 있지 않은 것을 나타내는
관련 항목:
setLinkRemainingName(javax.naming.Name)

getLinkResolvedObj

public Object  getLinkResolvedObj()
정상적으로 해결된 객체를 가져옵니다. 이것은, 해결된 링크명이 바인드 되고 있는 객체입니다.

반환값:
지금까지 해결된 null 의 가능성이 있는 객체. null 의 경우,[linkResolvedObj (링크 해결 객체)] 필드는 설정되어 있지 않은 것을 나타내는
관련 항목:
getLinkResolvedName() , setLinkResolvedObj(java.lang.Object)

getLinkExplanation

public String  getLinkExplanation()
링크의 해결중에 발견된 문제에 관련하는 설명을 가져옵니다.

반환값:
null 의 가능성이 있는, 링크를 해결하는 문제에 대해 설명하는 상세 캐릭터 라인. null 의 경우, 이 예외에는 링크 상세 메세지는 없는
관련 항목:
setLinkExplanation(java.lang.String)

setLinkExplanation

public void setLinkExplanation(String  msg)
링크의 해결중에 발견된 문제에 관련하는 설명을 설정합니다.

파라미터:
msg - null 의 가능성이 있는, 링크를 해결하는 문제에 대해 설명하는 상세 캐릭터 라인 null 의 경우, 상세 메세지는 기록되지 않는 것을 나타내는
관련 항목:
getLinkExplanation()

setLinkResolvedName

public void setLinkResolvedName(Name  name)
이 예외의 [linkResolvedName] 필드를 설정합니다.

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

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

파라미터:
name - 해결된 링크명이 설정되는 이름. null 를 지정할 수 있다. null 의 경우,[linkResolvedName] 필드는 null 로 설정되는
관련 항목:
getLinkResolvedName()

setLinkRemainingName

public void setLinkRemainingName(Name  name)
이 예외의 [linkRemainingName] 필드를 설정합니다.

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

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

파라미터:
name - 나머지의 링크명이 설정되는 이름. null 를 지정할 수 있다. null 의 경우, remainingName 필드는 null 로 설정되는
관련 항목:
getLinkRemainingName()

setLinkResolvedObj

public void setLinkResolvedObj(Object  obj)
이 예외의 [linkResolvedObj] 필드를 설정합니다. 이것은, 링크명의 마지막에 해결된 객체를 나타내고 있습니다.

파라미터:
obj - 링크가 해결된 객체가 설정되는 이름. null 를 지정할 수 있다. null 의 경우,[linkResolvedObj] 필드는 null 로 설정되는
관련 항목:
getLinkResolvedObj()

toString

public String  toString()
이 예외의 캐릭터 라인 표현이 생성됩니다. 이 캐릭터 라인은 NamingException 정보, 및 링크의 나머지의 이름으로 구성됩니다. 이 캐릭터 라인은 디버그에 사용되어 프로그램에 의해 해석될 것은 없습니다.

오버라이드(override):
클래스 NamingException 내의 toString
반환값:
이 링크 예외의 null 이외의 캐릭터 라인 표현

toString

public String  toString(boolean detail)
이 예외의 캐릭터 라인 표현이 생성됩니다. 이 캐릭터 라인은 NamingException 정보, 및 링크를 해결하는 추가 정보로 구성됩니다. 「detail」가 true 의 경우, 캐릭터 라인에는 링크가 해결된 객체에 관한 정보도 포함됩니다. false 의 경우, 이 메소드는 파라미터를 받지 않는 toString() 형식과 같습니다. 이 캐릭터 라인은 디버그에 사용되어 프로그램에 의해 해석될 것은 없습니다.

오버라이드(override):
클래스 NamingException 내의 toString
파라미터:
detail - true 의 경우, 링크가 해결된 객체에 관한 정보가 추가된다
반환값:
이 링크 예외의 null 이외의 캐릭터 라인 표현

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.