oracle.jdbc
Enum OracleResultSet.AuthorizationIndicator

java.lang.Object
  java.lang.Enum<OracleResultSet.AuthorizationIndicator>
      oracle.jdbc.OracleResultSet.AuthorizationIndicator

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<OracleResultSet.AuthorizationIndicator>

Enclosing interface:

OracleResultSet

public static enum OracleResultSet.AuthorizationIndicator
extends java.lang.Enum<OracleResultSet.AuthorizationIndicator>

eXtensible Data Security (XDS) authorization indicator.

Enum Constant Summary

NONE
The access to the data is authorized.

UNAUTHORIZED
The access to the data isn't authorized (data is hidden).

UNKNOWN
Part of the value returned for this column may be hidden.

Method Summary

static OracleResultSet.AuthorizationIndicator	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static OracleResultSet.AuthorizationIndicator[]	values() Returns an array containing the constants of this enum type, in the order they're declared.

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

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 indictor, it should determine whether or not 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 Detail

values

public static final OracleResultSet.AuthorizationIndicator[] values()

Returns an array containing the constants of this enum type, in the order they're declared. This method may be used to iterate over the constants as follows:

for(OracleResultSet.AuthorizationIndicator c : OracleResultSet.AuthorizationIndicator.values())
        System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they're declared

valueOf

public static OracleResultSet.AuthorizationIndicator valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (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:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name