SQLFeatureNotSupportedException (Java Platform SE 6)

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.sql.SQLException
              java.sql.SQLNonTransientException
                  java.sql.SQLFeatureNotSupportedException

All Implemented Interfaces:: Serializable, Iterable<Throwable>

public class SQLFeatureNotSupportedException
extends SQLNonTransientException
extends SQLNonTransientException

The subclass of SQLException thrown when the SQLState class value is '0A' ( the value is 'zero' A). This indicates that the JDBC driver does not support an optional JDBC feature. Optional JDBC features can fall into the fallowing categories:

no support for an optional feature
no support for an optional overloaded method
no support for an optional mode for a method. The mode for a method is determined based on constants passed as parameter values to a method

Since:: 1.6
See Also:: Serialized Form

Constructor Summary
`SQLFeatureNotSupportedException()` Constructs a `SQLFeatureNotSupportedException` object.
`SQLFeatureNotSupportedException(String reason)` Constructs a `SQLFeatureNotSupportedException` object with a given `reason`.
`SQLFeatureNotSupportedException(String reason, String SQLState)` Constructs a `SQLFeatureNotSupportedException` object with a given `reason` and `SQLState`.
`SQLFeatureNotSupportedException(String reason, String SQLState, int vendorCode)` Constructs a `SQLFeatureNotSupportedException` object with a given `reason`, `SQLState` and `vendorCode`.
`SQLFeatureNotSupportedException(String reason, String SQLState, int vendorCode, Throwable cause)` Constructs a `SQLFeatureNotSupportedException` object with a given `reason`, `SQLState`, `vendorCode` and `cause`.
`SQLFeatureNotSupportedException(String reason, String SQLState, Throwable cause)` Constructs a `SQLFeatureNotSupportedException` object with a given `reason`, `SQLState` and `cause`.
`SQLFeatureNotSupportedException(String reason, Throwable cause)` Constructs a `SQLFeatureNotSupportedException` object with a given `reason` and `cause`.
`SQLFeatureNotSupportedException(Throwable cause)` Constructs a `SQLFeatureNotSupportedException` object with a given `cause`.

Method Summary

Methods inherited from class java.sql.SQLException
`getErrorCode, getNextException, getSQLState, iterator, setNextException`

Methods inherited from class java.lang.Throwable
`fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Constructor Detail

SQLFeatureNotSupportedException

public SQLFeatureNotSupportedException()

Constructs a SQLFeatureNotSupportedException object. The reason, SQLState are initialized to null and the vendor code is initialized to 0. The cause is not initialized, and may subsequently be initialized by a call to the Throwable.initCause(java.lang.Throwable) method.

Since:: 1.6

SQLFeatureNotSupportedException

public SQLFeatureNotSupportedException(String reason)

Constructs a SQLFeatureNotSupportedException object with a given reason. The SQLState is initialized to null and the vender code is initialized to 0. The cause is not initialized, and may subsequently be initialized by a call to the Throwable.initCause(java.lang.Throwable) method.

Parameters:: reason - a description of the exception
Since:: 1.6

SQLFeatureNotSupportedException

public SQLFeatureNotSupportedException(String reason,
                                       String SQLState)

Constructs a SQLFeatureNotSupportedException object with a given reason and SQLState. The cause is not initialized, and may subsequently be initialized by a call to the Throwable.initCause(java.lang.Throwable) method. The vendor code is initialized to 0.

Parameters:: reason - a description of the exception; SQLState - an XOPEN or SQL:2003 code identifying the exception
Since:: 1.6

SQLFeatureNotSupportedException

public SQLFeatureNotSupportedException(String reason,
                                       String SQLState,
                                       int vendorCode)

Constructs a SQLFeatureNotSupportedException object with a given reason, SQLState and vendorCode. The cause is not initialized, and may subsequently be initialized by a call to the Throwable.initCause(java.lang.Throwable) method.

Parameters:: reason - a description of the exception; SQLState - an XOPEN or SQL:2003 code identifying the exception; vendorCode - a database vendor specific exception code
Since:: 1.6

SQLFeatureNotSupportedException

public SQLFeatureNotSupportedException(Throwable cause)

Constructs a SQLFeatureNotSupportedException object with a given cause. The SQLState is initialized to null and the vendor code is initialized to 0. The reason is initialized to null if cause==null or to cause.toString() if cause!=null.

Parameters:: cause - the underlying reason for this SQLException (which is saved for later retrieval bythe getCause() method); may be null indicating the cause is non-existent or unknown.
Since:: 1.6

SQLFeatureNotSupportedException

public SQLFeatureNotSupportedException(String reason,
                                       Throwable cause)

Constructs a SQLFeatureNotSupportedException object with a given reason and cause. The SQLState is initialized to null and the vendor code is initialized to 0.

Parameters:: reason - a description of the exception.; cause - the underlying reason for this SQLException (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.
Since:: 1.6

SQLFeatureNotSupportedException

public SQLFeatureNotSupportedException(String reason,
                                       String SQLState,
                                       Throwable cause)

Constructs a SQLFeatureNotSupportedException object with a given reason, SQLState and cause. The vendor code is initialized to 0.

Parameters:: reason - a description of the exception.; SQLState - an XOPEN or SQL:2003 code identifying the exception; cause - the (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.
Since:: 1.6

SQLFeatureNotSupportedException

public SQLFeatureNotSupportedException(String reason,
                                       String SQLState,
                                       int vendorCode,
                                       Throwable cause)

Constructs a SQLFeatureNotSupportedException object with a given reason, SQLState, vendorCode and cause.

Parameters:: reason - a description of the exception; SQLState - an XOPEN or SQL:2003 code identifying the exception; vendorCode - a database vendor-specific exception code; cause - the underlying reason for this SQLException (which is saved for later retrieval by the getCause() method); may be null indicating the cause is non-existent or unknown.
Since:: 1.6

Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.