org.dvb.net.ca

Class CAPermission

java.lang.Object

java.security.Permission

java.security.BasicPermission

org.dvb.net.ca.CAPermission

All Implemented Interfaces:

Serializable, Guard

public class CAPermission
extends BasicPermission

This class is for CA permissions. A CAPermission contains a name, but no actions list.

A CAPermission contains a range of CA system ids and a specific permission for that range of CA system ids. Instead of a range of CA system ids, the CAPermission can also refer to a single CA system id.

The name has the following syntax:

CASystemIdRange ":" Permission

where CASystemIdRange = CASystemId [ "-" CASystemId ] | "*"
and Permission = "MMI" | "buy" | "entitlementInfo" | "messagePassing" | "*"

Examples:

• 0x1200-0x120A:buy (The permission to buy entitlement for all the CA systems with ids between 0x1200 and 0x120A inclusive.)
• 0x1201:entitlementInfo (The permission to get entitlement information for the CA system with id 0x1201)
• 0x120d:* (This wildcard expresses all the permissions for the CA system with id 0x120d).

Note: The CASystemId is expressed as a hexadecimal value.

The permission "MMI" corresponds with the SecurityException on CAModuleManager.addMMIListener(). The permission "buy" corresponds with the SecurityException on CAModule.buyEntitlement(). The permission "entitlementInfo" corresponds with the SecurityException on CAModule.queryEntitlement() and CAModule.listEntitlements(). The permission "messagePassing" corresponds with CAModule.openMessageSession(MessageListener)

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CAPermission(String name) Creates a new CAPermission with the specified name.
CAPermission(String name, String actions) Creates a new CAPermission object with the specified name.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	implies(Permission p) Checks if the specified permission is "implied" by this object.

Methods inherited from class java.security.BasicPermission

equals, getActions, hashCode, newPermissionCollection

Methods inherited from class java.security.Permission

checkGuard, getName, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CAPermission

public CAPermission(String name)

Creates a new CAPermission with the specified name. The name is the symbolic name of the CAPermission.

Parameters:

name - the name of the CAPermission

CAPermission

public CAPermission(String name,
            String actions)

Creates a new CAPermission object with the specified name. The name is the symbolic name of the CAPermission, and the actions String is unused and should be null. This constructor exists for use by the Policy object to instantiate new Permission objects.

Parameters:

name - the name of the CAPermission

actions - should be null.

Method Detail

implies

public boolean implies(Permission p)

Checks if the specified permission is "implied" by this object.

Overrides:

implies in class BasicPermission

Parameters:

p - the permission to check against.

Returns:

true if the passed permission is equal to or implied by this permission, false otherwise.