Class LinkException

public class LinkException
extends NamingException

이 예외는 링크를 해석(resolve)하는 동안 만난 문제를 설명하는 데 사용돼요. 기본 NamingException에 링크 문제를 정확히 집기 위한 추가 정보가 더해져요. NamingException이 이름 해석 정보를 포착하는 것과 유사하게, LinkException은 링크를 해석하는 동안 만난 문제를 정확히 집는 "링크" 이름 해석 정보를 포착해요. 이 필드들은 모두 null일 수 있어요.

링크 해석 이름(Link Resolved Name). 해석된 링크 이름의 일부.
링크 해석 객체(Link Resolved Object). 링크 이름의 해석이 진행된 객체.
링크 나머지 이름(Link Remaining Name). 해석되지 않은 링크 이름의 일부.
링크 설명(Link Explanation). 링크 해석이 왜 실패했는지 설명하는 세부 정보.

LinkException 인스턴스는 동시 다중 스레드 접근에 대해 동기화되지 않아요. 단일 LinkException 인스턴스에 접근·수정하려는 여러 스레드는 객체를 잠가야 해요.

linkResolvedName

protected Name linkResolvedName

성공적으로 해석된 링크의 일부를 담아요. 복합 이름(composite name)이고 null일 수 있어요. 이 필드는 생성자에 의해 초기화돼요. 이 필드에는 get/set 메서드로 접근·조작해야 해요.

See Also: getLinkResolvedName(), setLinkResolvedName(javax.naming.Name)

linkResolvedObj

protected Object linkResolvedObj

링크의 일부 해석이 성공한 객체를 담아요. null일 수 있어요. 이 필드는 생성자에 의해 초기화돼요. 이 필드에는 get/set 메서드로 접근·조작해야 해요.

See Also: getLinkResolvedObj(), setLinkResolvedObj(java.lang.Object)

linkRemainingName

protected Name linkRemainingName

아직 해석되지 않은 나머지 링크 이름을 담아요. 복합 이름이고 null일 수 있어요. 이 필드는 생성자에 의해 초기화돼요. 이 필드에는 get/set 메서드로 접근·조작해야 해요.

See Also: getLinkRemainingName(), setLinkRemainingName(javax.naming.Name)

linkExplanation

protected String linkExplanation

링크 해석이 왜 실패했는지의 예외를 담아요. null일 수 있어요. 이 필드는 생성자에 의해 초기화돼요. 이 필드에는 get/set 메서드로 접근·조작해야 해요.

See Also: getLinkExplanation(), setLinkExplanation(java.lang.String)

LinkException

public LinkException(String explanation)

설명(explanation)을 가진 LinkException의 새 인스턴스를 생성해요. 다른 모든 필드는 null로 초기화돼요.

Parameters: explanation - 이 예외에 대한 추가 세부 정보를 담은, null일 수 있는 문자열
See Also: Throwable.getMessage()

LinkException

public LinkException()

LinkException의 새 인스턴스를 생성해요. 링크 관련/무관한 모든 필드는 null로 초기화돼요.

getLinkResolvedName

public Name getLinkResolvedName()

성공적으로 해석된 링크 이름의 선두 부분을 가져와요.

Returns: 성공적으로 해석된 링크 이름의 일부. 복합 이름이에요. null일 수 있으며, 이는 링크 해석 이름 필드가 설정되지 않았음을 의미해요
See Also: getLinkResolvedObj(), setLinkResolvedName(javax.naming.Name)

getLinkRemainingName

public Name getLinkRemainingName()

링크 이름의 남은 미해석 부분을 가져와요.

Returns: 해석되지 않은 링크 이름의 일부. 복합 이름이에요. null일 수 있으며, 이는 링크 나머지 이름 필드가 설정되지 않았음을 의미해요
See Also: setLinkRemainingName(javax.naming.Name)

getLinkResolvedObj

public Object getLinkResolvedObj()

해석이 성공한 객체를 가져와요. 해석된 링크 이름이 바인딩된 객체예요.

Returns: 지금까지 해석된, null일 수 있는 객체. null이면 링크 해석 객체 필드가 설정되지 않았음을 의미해요
See Also: getLinkResolvedName(), setLinkResolvedObj(java.lang.Object)

getLinkExplanation

public String getLinkExplanation()

링크를 해석할 때 만난 문제와 연관된 설명을 가져와요.

Returns: 링크 해석 문제에 대해 더 설명하는, null일 수 있는 세부 문자열. null이면 이 예외에 대한 링크 세부 메시지가 없다는 뜻
See Also: setLinkExplanation(java.lang.String)

setLinkExplanation

public void setLinkExplanation(String msg)

링크를 해석할 때 만난 문제와 연관된 설명을 설정해요.

Parameters: msg - 링크 해석 문제에 대해 더 설명하는, null일 수 있는 세부 문자열. null이면 세부 정보가 기록되지 않는다는 뜻
See Also: getLinkExplanation()

setLinkResolvedName

public void setLinkResolvedName(Name name)

이 예외의 해석된 링크 이름 필드를 설정해요. name은 복합 이름이에요. 이 필드를 복합 이름(compound name)이나 문자열로 설정하려면 복합 이름을 "문자열화(stringify)"하고 그 문자열로 단일 구성 요소를 가진 복합 이름을 만들어야 해요. 그런 다음 결과 복합 이름으로 이 메서드를 호출할 수 있어요. name의 복사본이 만들어지고 저장돼요. 이후의 name 변경은 이 NamingException 안의 복사본에 영향을 주지 않고 그 반대도 마찬가지예요.

Parameters: name - 해석된 링크 이름으로 설정할 이름. null일 수 있음. null이면 링크 해석 이름 필드를 null로 설정
See Also: getLinkResolvedName()

setLinkRemainingName

public void setLinkRemainingName(Name name)

이 예외의 나머지 링크 이름 필드를 설정해요. name은 복합 이름이에요. 이 필드를 복합 이름이나 문자열로 설정하려면 복합 이름을 "문자열화"하고 그 문자열로 단일 구성 요소를 가진 복합 이름을 만들어야 해요. 그런 다음 결과 복합 이름으로 이 메서드를 호출할 수 있어요. name의 복사본이 만들어지고 저장돼요. 이후의 name 변경은 이 NamingException 안의 복사본에 영향을 주지 않고 그 반대도 마찬가지예요.

Parameters: name - 나머지 링크 이름으로 설정할 이름. null일 수 있음. null이면 나머지 이름 필드를 null로 설정
See Also: getLinkRemainingName()

setLinkResolvedObj

public void setLinkResolvedObj(Object obj)

이 예외의 링크 해석 객체 필드를 설정해요. 링크 이름의 마지막으로 성공적으로 해석된 객체를 나타내요.

Parameters: obj - 링크 해석 객체로 설정할 객체. null일 수 있음. null이면 링크 해석 객체 필드를 null로 설정
See Also: getLinkResolvedObj()

toString

public String toString()

이 예외의 문자열 표현을 생성해요. 이 문자열은 NamingException 정보와 링크의 나머지 이름으로 구성돼요. 이 문자열은 디버깅용이며 프로그래밍 방식으로 해석하도록 만들어진 것이 아니에요.

Overrides: NamingException 클래스의 toString
Returns: 이 링크 예외의, null이 아닌 문자열 표현

toString

public String toString(boolean detail)

이 예외의 문자열 표현을 생성해요. 이 문자열은 NamingException 정보와 링크 해석의 추가 정보로 구성돼요. 'detail'이 true이면 문자열은 링크 해석 객체에 대한 정보도 포함해요. false이면 이 메서드는 매개변수를 받지 않는 toString() 형태와 같아요. 이 문자열은 디버깅용이며 프로그래밍 방식으로 해석하도록 만들어진 것이 아니에요.

Overrides: NamingException 클래스의 toString
Parameters: detail - true이면 링크 해석 객체에 대한 정보를 추가
Returns: 이 링크 예외의, null이 아닌 문자열 표현