com.sun.dtv.transport
Class ConditionalAccessDeniedException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          com.sun.dtv.transport.ConditionalAccessDeniedException

All Implemented Interfaces:

Serializable

public class ConditionalAccessDeniedException

extends Exception

This class is thrown by Filtering APIs when access is requested to information which is scrambled and to which access is not permitted by the security system.

See Also:

Serialized Form

Field Summary

static int	COMMERCIAL_DIALOG user dialog needed for payment.
static int	FREE_PREVIEW_DIALOG user dialog needed to explain about free preview.
static int	GEOGRAPHICAL_BLACKOUT not allowed for geographical reasons.
static int	MATURITY_RATING user does not have suitable maturity.
static int	MATURITY_RATING_DIALOG user dialog needed for maturity.
static int	NO_ENTITLEMENT user does not have an entitlement.
static int	NOT_POSSIBLE access possible under certain conditions.
static int	NOT_POSSIBLE_TECHNICAL not allowed for some technical reason.
static int	OTHER Some other reason.
static int	POSSIBLE access not possible.
static int	TECHNICAL_DIALOG user dialog needed for technical purposes.

Constructor Summary

ConditionalAccessDeniedException()
Constructs a ConditionalAccessDeniedException with no detail message.

ConditionalAccessDeniedException(String s)
Constructs a ConditionalAccessDeniedException with the specified detail message.

Method Summary

int	getReason(int index) Returns the reason(s) why descrambling was not possible.
Object[]	getSources() This method returns an array containing either a single Service object or a set of ElementaryStreams that could not be descrambled.

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

Field Detail

POSSIBLE

public static final int POSSIBLE

access not possible.

See Also:

Constant Field Values

NOT_POSSIBLE

public static final int NOT_POSSIBLE

access possible under certain conditions.

See Also:

Constant Field Values

COMMERCIAL_DIALOG

public static final int COMMERCIAL_DIALOG

user dialog needed for payment.

See Also:

Constant Field Values

MATURITY_RATING_DIALOG

public static final int MATURITY_RATING_DIALOG

user dialog needed for maturity.

See Also:

Constant Field Values

MATURITY_RATING

public static final int MATURITY_RATING

user does not have suitable maturity.

See Also:

Constant Field Values

NO_ENTITLEMENT

public static final int NO_ENTITLEMENT

user does not have an entitlement.

See Also:

Constant Field Values

FREE_PREVIEW_DIALOG

public static final int FREE_PREVIEW_DIALOG

user dialog needed to explain about free preview.

See Also:

Constant Field Values

GEOGRAPHICAL_BLACKOUT

public static final int GEOGRAPHICAL_BLACKOUT

not allowed for geographical reasons.

See Also:

Constant Field Values

TECHNICAL_DIALOG

public static final int TECHNICAL_DIALOG

user dialog needed for technical purposes.

See Also:

Constant Field Values

NOT_POSSIBLE_TECHNICAL

public static final int NOT_POSSIBLE_TECHNICAL

not allowed for some technical reason.

See Also:

Constant Field Values

OTHER

public static final int OTHER

Some other reason.

See Also:

Constant Field Values

Constructor Detail

ConditionalAccessDeniedException

public ConditionalAccessDeniedException()

Constructs a ConditionalAccessDeniedException with no detail message.

ConditionalAccessDeniedException

public ConditionalAccessDeniedException(String s)

Constructs a ConditionalAccessDeniedException with the specified detail message.

Parameters:

s - the detail message.

Method Detail

getReason

public int getReason(int index)
              throws IndexOutOfBoundsException

Returns the reason(s) why descrambling was not possible.

Parameters:

index - shall refer to the Service or one elementary stream in the set returned by getSources().

Returns:

the reason for the not authorized exception. The reason is a bitwise OR of either POSSIBLE or NOT_POSSIBLE with another reason code.

Throws:

IndexOutOfBoundsException - This exception will be thrown where index is beyond the size of the array returned by getSources.

See Also:

getSources()

getSources

public Object[] getSources()

This method returns an array containing either a single Service object or a set of ElementaryStreams that could not be descrambled.

Returns:

the set of Service or ElementaryStream objects that could not be descrambled