Package oracle.jdbc

Enum Class OracleResultSet.AuthorizationIndicator

java.lang.Object
java.lang.Enum<OracleResultSet.AuthorizationIndicator>
oracle.jdbc.OracleResultSet.AuthorizationIndicator
All Implemented Interfaces:
Serializable, Comparable<OracleResultSet.AuthorizationIndicator>, Constable
Enclosing interface:
OracleResultSet
public static enum OracleResultSet.AuthorizationIndicator extends Enum<OracleResultSet.AuthorizationIndicator>
eXtensible Data Security (XDS) authorization indicator.

  • Enum Constant Details

    • NONE

      public static final OracleResultSet.AuthorizationIndicator NONE
      The access to the data is authorized. Note that for a table that doesn't have any security attribute the access to the data is always authorized.

    • UNAUTHORIZED

      public static final OracleResultSet.AuthorizationIndicator UNAUTHORIZED
      The access to the data isn't authorized (data is hidden).
      The authorization indicator is evaluated based on the enabled attribute security policy when the column value is retrieved. If a base table column value is not authorized to the user, a null value will be returned to the application along with the authentication indicator, AuthorizationIndicator.UNAUTHORIZED. If there is a column expression on top of the unauthorized base column(s), the evaluated value will be returned to the application along with the AuthorizationIndicator.UNAUTHORIZED indicator. Application should examine authorization indicator before interpreting the returned data.

    • UNKNOWN

      public static final OracleResultSet.AuthorizationIndicator UNKNOWN
      Part of the value returned for this column may be hidden.
      Sometimes, the authorization indicator for a select item cannot be determined due to functionality limitations or performance constrains of the server. For example, this is possible when column expression is involved in the query and the server cannot or would not compute whether the top operator is supposed to be authorized. In such case authorization indicator, AuthorizationIndicator.UNKNOWN will be returned to the application and the returned value can be null or not null depending on how the column expression operates on the underlying column value.
      Note that the server can always determine whether an underlying table data column value is authorized to the user. If it is not authorized, a null value is always returned for further column expression evaluation, which can then result in a null or a non-null value. Therefore, if the application sees an "unknown" authorization indicator, it should determine whether the returned value should be access. If the query and its column expressions are designed to handle unauthorized nulls from the underlying columns, then the application can use the returned value. Otherwise, the application may have to take appropriate actions for the returned value, which be not be the expected results.

  • Method Details

    • values

      public static OracleResultSet.AuthorizationIndicator[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared

    • valueOf

      public static OracleResultSet.AuthorizationIndicator valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null