JavaTM Platform
Standard Ed. 6

java.sql
클래스 SQLClientInfoException

java.lang.Object 
  상위를 확장 java.lang.Throwable 
      상위를 확장 java.lang.Exception 
          상위를 확장 java.sql.SQLException 
              상위를 확장 java.sql.SQLClientInfoException
모든 구현된 인터페이스:
Serializable , Iterable <Throwable >


public class SQLClientInfoException
extends SQLException

1 개(살) 이상의 클라이언트 정보 프로퍼티을 Connection 로 설정할 수 없었을 때에,SQLException 의 서브 클래스가 throw 됩니다. SQLClientInfoException 는,SQLException 로 제공되는 정보 외에, 설정되지 않았던 클라이언트 정보 프로퍼티의 리스트를 제공합니다. 일부의 데이타베이스에서는, 복수의 클라이언트 정보 프로퍼티을 원자적으로 설정하는 것이 허가되지 않습니다. 이러한 데이타베이스에서는,Connection.setClientInfo 메소드가 예외를 throw 했을 경우에서도, 클라이언트 정보 프로퍼티의 일부가 설정된 가능성이 있습니다. 설정되지 않았던 클라이언트 정보 프로퍼티의 리스트를 취득하기 위해서, 어플리케이션에서는 getFailedProperties 메소드를 사용할 수 있습니다. 프로퍼티은,Map<String, ClientInfoStatus> 를 적절한 SQLClientInfoException 생성자 에 건네주는 것으로 식별됩니다.  

도입된 버젼:
1.6
관련 항목:
ClientInfoStatus , Connection.setClientInfo(java.lang.String, java.lang.String) , 직렬화 된 형식

생성자 의 개요
SQLClientInfoException ()
          SQLClientInfoException 객체를 구축합니다.
SQLClientInfoException (Map <String ,ClientInfoStatus > failedProperties)
          지정된 failedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다.
SQLClientInfoException (Map <String ,ClientInfoStatus > failedProperties, Throwable  cause)
          지정된 causefailedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다.
SQLClientInfoException (String  reason, Map <String ,ClientInfoStatus > failedProperties)
          지정된 reasonfailedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다.
SQLClientInfoException (String  reason, Map <String ,ClientInfoStatus > failedProperties, Throwable  cause)
          지정된 reason,cause, 및 failedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다.
SQLClientInfoException (String  reason, String  SQLState, int vendorCode, Map <String ,ClientInfoStatus > failedProperties)
          지정된 reason,SQLState,vendorCode, 및 failedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다.
SQLClientInfoException (String  reason, String  SQLState, int vendorCode, Map <String ,ClientInfoStatus > failedProperties, Throwable  cause)
          지정된 reason,SQLState,cause,vendorCode, 및 failedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다.
SQLClientInfoException (String  reason, String  SQLState, Map <String ,ClientInfoStatus > failedProperties)
          지정된 reason,SQLState, 및 failedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다.
SQLClientInfoException (String  reason, String  SQLState, Map <String ,ClientInfoStatus > failedProperties, Throwable  cause)
          지정된 reason,SQLState,cause, 및 failedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다.
 
메소드의 개요
 Map <String ,ClientInfoStatus > getFailedProperties ()
          설정할 수 없었던 클라이언트 정보 프로퍼티의 리스트를 돌려줍니다.
 
클래스 java.sql. SQLException 로부터 상속된 메소드
getErrorCode , getNextException , getSQLState , iterator , setNextException
 
클래스 java.lang. Throwable 로부터 상속된 메소드
fillInStackTrace , getCause , getLocalizedMessage , getMessage , getStackTrace , initCause , printStackTrace , printStackTrace , printStackTrace , setStackTrace , toString
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait
 

생성자 의 상세

SQLClientInfoException

public SQLClientInfoException()
SQLClientInfoException 객체를 구축합니다. reason,SQLState, 및 failedProperties 리스트는 null 에 초기화되어 벤더 코드는 0 에 초기화됩니다. cause 는 초기화되지 않습니다. Throwable.initCause(java.lang.Throwable) 메소드를 호출하는 것에 의해, 나중에 이것을 초기화할 수 있습니다.  

도입된 버젼:
1.6

SQLClientInfoException

public SQLClientInfoException(Map <String ,ClientInfoStatus > failedProperties)
지정된 failedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다. reasonSQLStatenull 에 초기화되어 벤더 코드는 0 에 초기화됩니다. cause 는 초기화되지 않습니다. Throwable.initCause(java.lang.Throwable) 메소드를 호출하는 것에 의해, 나중에 이것을 초기화할 수 있습니다.  

파라미터:
failedProperties - 설정할 수 없었던 프로퍼티치를 포함한 Map. Map 의 키에는 설정할 수 없었던 클라이언트 정보 프로퍼티의 이름이 포함되어 값에는 ClientInfoStatus 로 정의된 이유 코드중 한쪽이 포함된다

도입된 버젼:
1.6

SQLClientInfoException

public SQLClientInfoException(Map <String ,ClientInfoStatus > failedProperties,
                              Throwable  cause)
지정된 causefailedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다. reasoncause==null 의 경우에 null 에 초기화되어cause! =null 의 경우에 cause.toString() 에 초기화되어 벤더 코드는 0 에 초기화됩니다.

파라미터:
failedProperties - 설정할 수 없었던 프로퍼티치를 포함한 Map. Map 의 키에는 설정할 수 없었던 클라이언트 정보 프로퍼티의 이름이 포함되어 값에는 ClientInfoStatus 로 정의된 이유 코드중 한쪽이 포함되는
cause - (나중에 getCause() 메소드로 취득하기 위해서 보존된다). null 치가 허가되고 있어 원인이 존재하지 않는가 불명한 것을 나타낸다

도입된 버젼:
1.6

SQLClientInfoException

public SQLClientInfoException(String  reason,
                              Map <String ,ClientInfoStatus > failedProperties)
지정된 reasonfailedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다. SQLStatenull 에 초기화되어 벤더 코드는 0 에 초기화됩니다. cause 는 초기화되지 않습니다. Throwable.initCause(java.lang.Throwable) 메소드를 호출하는 것에 의해, 나중에 이것을 초기화할 수 있습니다.  

파라미터:
reason - 예외의 설명
failedProperties - 설정할 수 없었던 프로퍼티치를 포함한 Map. Map 의 키에는 설정할 수 없었던 클라이언트 정보 프로퍼티의 이름이 포함되어 값에는 ClientInfoStatus 로 정의된 이유 코드중 한쪽이 포함된다

도입된 버젼:
1.6

SQLClientInfoException

public SQLClientInfoException(String  reason,
                              Map <String ,ClientInfoStatus > failedProperties,
                              Throwable  cause)
지정된 reason,cause, 및 failedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다. SQLStatenull 에 초기화되어 벤더 코드는 0 에 초기화됩니다.  

파라미터:
reason - 예외의 설명
failedProperties - 설정할 수 없었던 프로퍼티치를 포함한 Map. Map 의 키에는 설정할 수 없었던 클라이언트 정보 프로퍼티의 이름이 포함되어 값에는 ClientInfoStatus 로 정의된 이유 코드중 한쪽이 포함되는
cause - 이 SQLException 의 기가 되는 원인 (나중에 getCause() 메소드로 취득하기 위해서 보존된다). null 치가 허가되고 있어 원인이 존재하지 않는가 불명한 것을 나타낸다

도입된 버젼:
1.6

SQLClientInfoException

public SQLClientInfoException(String  reason,
                              String  SQLState,
                              Map <String ,ClientInfoStatus > failedProperties)
지정된 reason,SQLState, 및 failedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다. cause 는 초기화되지 않습니다. Throwable.initCause(java.lang.Throwable) 메소드를 호출하는 것에 의해, 나중에 이것을 초기화할 수 있습니다. 벤더 코드는 0 에 초기화됩니다.  

파라미터:
reason - 예외의 설명
SQLState - 예외를 식별하는 XOPEN 코드 또는 SQL:2003 코드
failedProperties - 설정할 수 없었던 프로퍼티치를 포함한 Map. Map 의 키에는 설정할 수 없었던 클라이언트 정보 프로퍼티의 이름이 포함되어 값에는 ClientInfoStatus 로 정의된 이유 코드중 한쪽이 포함된다

도입된 버젼:
1.6

SQLClientInfoException

public SQLClientInfoException(String  reason,
                              String  SQLState,
                              Map <String ,ClientInfoStatus > failedProperties,
                              Throwable  cause)
지정된 reason,SQLState,cause, 및 failedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다. 벤더 코드는 0 에 초기화됩니다.  

파라미터:
reason - 예외의 설명
SQLState - 예외를 식별하는 XOPEN 코드 또는 SQL:2003 코드
failedProperties - 설정할 수 없었던 프로퍼티치를 포함한 Map. Map 의 키에는 설정할 수 없었던 클라이언트 정보 프로퍼티의 이름이 포함되어 값에는 ClientInfoStatus 로 정의된 이유 코드중 한쪽이 포함되는
cause - 이 SQLException 의 기가 되는 원인 (나중에 getCause() 메소드로 취득하기 위해서 보존된다). null 치가 허가되고 있어 원인이 존재하지 않는가 불명한 것을 나타낸다

도입된 버젼:
1.6

SQLClientInfoException

public SQLClientInfoException(String  reason,
                              String  SQLState,
                              int vendorCode,
                              Map <String ,ClientInfoStatus > failedProperties)
지정된 reason,SQLState,vendorCode, 및 failedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다. cause 는 초기화되지 않습니다. Throwable.initCause(java.lang.Throwable) 메소드를 호출하는 것에 의해, 나중에 이것을 초기화할 수 있습니다.  

파라미터:
reason - 예외의 설명
SQLState - 예외를 식별하는 XOPEN 코드 또는 SQL:2003 코드
vendorCode - 데이타베이스 벤더 고유의 예외 코드
failedProperties - 설정할 수 없었던 프로퍼티치를 포함한 Map. Map 의 키에는 설정할 수 없었던 클라이언트 정보 프로퍼티의 이름이 포함되어 값에는 ClientInfoStatus 로 정의된 이유 코드중 한쪽이 포함된다

도입된 버젼:
1.6

SQLClientInfoException

public SQLClientInfoException(String  reason,
                              String  SQLState,
                              int vendorCode,
                              Map <String ,ClientInfoStatus > failedProperties,
                              Throwable  cause)
지정된 reason,SQLState,cause,vendorCode, 및 failedProperties 로 초기화된 SQLClientInfoException 객체를 구축합니다.  

파라미터:
reason - 예외의 설명
SQLState - 예외를 식별하는 XOPEN 코드 또는 SQL:2003 코드
vendorCode - 데이타베이스 벤더 고유의 예외 코드
failedProperties - 설정할 수 없었던 프로퍼티치를 포함한 Map. Map 의 키에는 설정할 수 없었던 클라이언트 정보 프로퍼티의 이름이 포함되어 값에는 ClientInfoStatus 로 정의된 이유 코드중 한쪽이 포함되는
cause - 이 SQLException 의 기가 되는 원인 (나중에 getCause() 메소드로 취득하기 위해서 보존된다). null 치가 허가되고 있어 원인이 존재하지 않는가 불명한 것을 나타낸다

도입된 버젼:
1.6
메소드의 상세

getFailedProperties

public Map <String ,ClientInfoStatus > getFailedProperties()
설정할 수 없었던 클라이언트 정보 프로퍼티의 리스트를 돌려줍니다. Map 의 키에는 설정할 수 없었던 클라이언트 정보 프로퍼티의 이름이 포함되어 값에는 ClientInfoStatus 로 정의된 이유 코드중 한쪽이 포함됩니다.  

반환값:
설정할 수 없었던 클라이언트 정보 프로퍼티이 포함된 Map 리스트

도입된 버젼:
1.6

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 도 참조해 주세요.