OpenJDK 1.23 · javax.smartcardio.CardPermission · APIdia, the JavaDoc alternative

A permission for Smart Card operations. A CardPermission consists of the name of the card terminal the permission applies to and a set of actions that are valid for that terminal.

A CardPermission with a name of * applies to all card terminals. The actions string is a comma separated list of the actions listed below, or * to signify "all actions."

Individual actions are:

connect: connect to a card using CardTerminal.connect()
reset: reset the card using Card.disconnect(true)
exclusive: establish exclusive access to a card using Card#beginExclusive and endExclusive()
transmitControl: transmit a control command using Card.transmitControlCommand()
getBasicChannel: obtain the basic logical channel using Card#getBasicChannel
openLogicalChannel: open a new logical channel using Card#openLogicalChannel

Field Summary

Modifier and Type	Field and Description
private static final int	A_ALL
private static final int	A_CONNECT
private static final int	A_EXCLUSIVE
private static final int	A_GET_BASIC_CHANNEL
private static final int	A_OPEN_LOGICAL_CHANNEL
private static final int	A_RESET
private static final int	A_TRANSMIT_CONTROL
private final String	actions
private static final int[]	ARRAY_MASKS
private static final String[]	ARRAY_STRINGS
private transient int	mask
private static final String	S_ALL
private static final String	S_CONNECT
private static final String	S_EXCLUSIVE
private static final String	S_GET_BASIC_CHANNEL
private static final String	S_OPEN_LOGICAL_CHANNEL
private static final String	S_RESET
private static final String	S_TRANSMIT_CONTROL
private static final long	serialVersionUID Hides java.security.Permission.serialVersionUID.

Constructor Summary

Access	Constructor and Description
public	CardPermission(String the name of the card terminal, or `*` terminalName, String the action string (or null if the set of permitted actions is empty) actions) Constructs a new CardPermission with the specified actions.

Method Summary

Modifier and Type	Method and Description
public boolean	Returns: true if and only if the specified object is equal to this CardPermission equals(Object the object to be compared for equality with this CardPermission obj) Implements abstract java.security.Permission.equals. Compares the specified object with this CardPermission for equality.
private static String	getActions(int mask)
public String	Returns: the canonical string representation of the actions. getActions() Implements abstract java.security.Permission.getActions. Returns the canonical string representation of the actions.
private static int	getMask(String actions)
public int	Returns: the hash code value for this CardPermission object. hashCode() Implements abstract java.security.Permission.hashCode. Returns the hash code value for this CardPermission object.
public boolean	Returns: true if and only if this CardPermission object implies the specified permission. implies(Permission the permission to check against permission) Implements abstract java.security.Permission.implies. Checks if this CardPermission object implies the specified permission.
private void	readObject(ObjectInputStream s)
private void	writeObject(ObjectOutputStream s)

Inherited from java.security.Permission:: checkGuard getName newPermissionCollection toString

Field Detail

A_ALL	back to summary
private static final int A_ALL

A_CONNECT	back to summary
private static final int A_CONNECT

A_EXCLUSIVE	back to summary
private static final int A_EXCLUSIVE

A_GET_BASIC_CHANNEL	back to summary
private static final int A_GET_BASIC_CHANNEL

A_OPEN_LOGICAL_CHANNEL	back to summary
private static final int A_OPEN_LOGICAL_CHANNEL

A_RESET	back to summary
private static final int A_RESET

A_TRANSMIT_CONTROL	back to summary
private static final int A_TRANSMIT_CONTROL

actions	back to summary
private final String actions

ARRAY_MASKS	back to summary
private static final int[] ARRAY_MASKS

ARRAY_STRINGS	back to summary
private static final String[] ARRAY_STRINGS

mask	back to summary
private transient int mask

S_ALL	back to summary
private static final String S_ALL

S_CONNECT	back to summary
private static final String S_CONNECT

S_EXCLUSIVE	back to summary
private static final String S_EXCLUSIVE

S_GET_BASIC_CHANNEL	back to summary
private static final String S_GET_BASIC_CHANNEL

S_OPEN_LOGICAL_CHANNEL	back to summary
private static final String S_OPEN_LOGICAL_CHANNEL

S_RESET	back to summary
private static final String S_RESET

S_TRANSMIT_CONTROL	back to summary
private static final String S_TRANSMIT_CONTROL

serialVersionUID	back to summary
private static final long serialVersionUID Hides java.security.Permission.serialVersionUID.

Constructor Detail

CardPermission back to summary

CardPermission	back to summary
public CardPermission(String terminalName, String actions) Constructs a new CardPermission with the specified actions. `terminalName` is the name of a CardTerminal or `` if this permission applies to all terminals. `actions` contains a comma-separated list of the individual actions or `` to signify all actions. For more information, see the documentation at the top of this class. Parameters terminalName:String the name of the card terminal, or `*` actions:String the action string (or null if the set of permitted actions is empty) Exceptions NullPointerException: if terminalName is null IllegalArgumentException: if actions is an invalid actions specification

public CardPermission(String terminalName, String actions)

Constructs a new CardPermission with the specified actions. terminalName is the name of a CardTerminal or * if this permission applies to all terminals. actions contains a comma-separated list of the individual actions or * to signify all actions. For more information, see the documentation at the top of this class.

Parameters

terminalName:String: the name of the card terminal, or *
actions:String: the action string (or null if the set of permitted actions is empty)

Exceptions

NullPointerException:: if terminalName is null
IllegalArgumentException:: if actions is an invalid actions specification

Method Detail

equals back to summary

equals	back to summary
public boolean equals(Object obj) Implements abstract java.security.Permission.equals. Compares the specified object with this CardPermission for equality. This CardPermission is equal to another Object `object`, if and only if `object` is an instance of CardPermission, `this.getName()` is equal to `((CardPermission)object).getName()`, and `this.getActions()` is equal to `((CardPermission)object).getActions()`. Parameters obj:Object the object to be compared for equality with this CardPermission Returns:boolean true if and only if the specified object is equal to this CardPermission

public boolean equals(Object obj)

Implements abstract java.security.Permission.equals.

Compares the specified object with this CardPermission for equality. This CardPermission is equal to another Object object, if and only if

object is an instance of CardPermission,
this.getName() is equal to ((CardPermission)object).getName(), and
this.getActions() is equal to ((CardPermission)object).getActions().

Parameters

obj:Object: the object to be compared for equality with this CardPermission

Returns:boolean

true if and only if the specified object is equal to this CardPermission

getActions	back to summary
private static String getActions(int mask)

getActions back to summary

getActions	back to summary
public String getActions() Implements abstract java.security.Permission.getActions. Returns the canonical string representation of the actions. It is `*` to signify all actions defined by this class or the string concatenation of the comma-separated, lexicographically sorted list of individual actions. Returns:String the canonical string representation of the actions.

public String getActions()

Implements abstract java.security.Permission.getActions.

Returns the canonical string representation of the actions. It is * to signify all actions defined by this class or the string concatenation of the comma-separated, lexicographically sorted list of individual actions.

Returns:String: the canonical string representation of the actions.

getMask	back to summary
private static int getMask(String actions)

hashCode	back to summary
public int hashCode() Implements abstract java.security.Permission.hashCode. Returns the hash code value for this CardPermission object. Returns:int the hash code value for this CardPermission object.

hashCode

back to summary

public int hashCode()

Implements abstract java.security.Permission.hashCode.

Returns the hash code value for this CardPermission object.

Returns:int: the hash code value for this CardPermission object.

implies back to summary

implies	back to summary
public boolean implies(Permission permission) Implements abstract java.security.Permission.implies. Checks if this CardPermission object implies the specified permission. That is the case, if and only if `permission` is an instance of CardPermission, `permission`'s actions are a proper subset of this object's actions, and this object's `getName()` method is either `*` or equal to `permission`'s `name`. Parameters permission:Permission the permission to check against Returns:boolean true if and only if this CardPermission object implies the specified permission.

public boolean implies(Permission permission)

Implements abstract java.security.Permission.implies.

Checks if this CardPermission object implies the specified permission. That is the case, if and only if

permission is an instance of CardPermission,
permission's actions are a proper subset of this object's actions, and
this object's getName() method is either * or equal to permission's name.

Parameters

permission:Permission: the permission to check against

Returns:boolean

true if and only if this CardPermission object implies the specified permission.

readObject	back to summary
private void readObject(ObjectInputStream s) throws IOException, ClassNotFoundException

writeObject	back to summary
private void writeObject(ObjectOutputStream s) throws IOException

public Class CardPermission

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail