Instances of this class are immutable. Where data is passed in or out
- * via byte arrays, defensive cloning is performed.
- *
- * @see Card#getATR
- *
- * @since 1.6
- * @author Andreas Sterbenz
- * @author JSR 268 Expert Group
- */
-public final class ATR implements java.io.Serializable {
-
- private static final long serialVersionUID = 6695383790847736493L;
-
- private byte[] atr;
-
- private transient int startHistorical, nHistorical;
-
- /**
- * Constructs an ATR from a byte array.
- *
- * @param atr the byte array containing the answer-to-reset bytes
- * @throws NullPointerException if atr is null
- */
- public ATR(byte[] atr) {
- this.atr = atr.clone();
- parse();
- }
-
- private void parse() {
- if (atr.length < 2) {
- return;
- }
- if ((atr[0] != 0x3b) && (atr[0] != 0x3f)) {
- return;
- }
- int t0 = (atr[1] & 0xf0) >> 4;
- int n = atr[1] & 0xf;
- int i = 2;
- while ((t0 != 0) && (i < atr.length)) {
- if ((t0 & 1) != 0) {
- i++;
- }
- if ((t0 & 2) != 0) {
- i++;
- }
- if ((t0 & 4) != 0) {
- i++;
- }
- if ((t0 & 8) != 0) {
- if (i >= atr.length) {
- return;
- }
- t0 = (atr[i++] & 0xf0) >> 4;
- } else {
- t0 = 0;
- }
- }
- int k = i + n;
- if ((k == atr.length) || (k == atr.length - 1)) {
- startHistorical = i;
- nHistorical = n;
- }
- }
-
- /**
- * Returns a copy of the bytes in this ATR.
- *
- * @return a copy of the bytes in this ATR.
- */
- public byte[] getBytes() {
- return atr.clone();
- }
-
- /**
- * Returns a copy of the historical bytes in this ATR.
- * If this ATR does not contain historical bytes, an array of length
- * zero is returned.
- *
- * @return a copy of the historical bytes in this ATR.
- */
- public byte[] getHistoricalBytes() {
- byte[] b = new byte[nHistorical];
- System.arraycopy(atr, startHistorical, b, 0, nHistorical);
- return b;
- }
-
- /**
- * Returns a string representation of this ATR.
- *
- * @return a String representation of this ATR.
- */
- public String toString() {
- return "ATR: " + atr.length + " bytes";
- }
-
- /**
- * Compares the specified object with this ATR for equality.
- * Returns true if the given object is also an ATR and its bytes are
- * identical to the bytes in this ATR.
- *
- * @param obj the object to be compared for equality with this ATR
- * @return true if the specified object is equal to this ATR
- */
- public boolean equals(Object obj) {
- if (this == obj) {
- return true;
- }
- if (obj instanceof ATR == false) {
- return false;
- }
- ATR other = (ATR)obj;
- return Arrays.equals(this.atr, other.atr);
- }
-
- /**
- * Returns the hash code value for this ATR.
- *
- * @return the hash code value for this ATR.
- */
- public int hashCode() {
- return Arrays.hashCode(atr);
- }
-
- private void readObject(java.io.ObjectInputStream in)
- throws java.io.IOException, ClassNotFoundException {
- atr = (byte[])in.readUnshared();
- parse();
- }
-
-}
diff --git a/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/Card.java b/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/Card.java
deleted file mode 100644
index b3b7fdc4f..000000000
--- a/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/Card.java
+++ /dev/null
@@ -1,167 +0,0 @@
-/*
- * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved.
- * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
- *
- * This code is free software; you can redistribute it and/or modify it
- * under the terms of the GNU General Public License version 2 only, as
- * published by the Free Software Foundation. Oracle designates this
- * particular file as subject to the "Classpath" exception as provided
- * by Oracle in the LICENSE file that accompanied this code.
- *
- * This code is distributed in the hope that it will be useful, but WITHOUT
- * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
- * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
- * version 2 for more details (a copy is included in the LICENSE file that
- * accompanied this code).
- *
- * You should have received a copy of the GNU General Public License version
- * 2 along with this work; if not, write to the Free Software Foundation,
- * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
- *
- * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
- * or visit www.oracle.com if you need additional information or have any
- * questions.
- */
-
-package org.sufficientlysecure.keychain.securitytoken.smartcardio;
-
-import java.nio.ByteBuffer;
-
-/**
- * A Smart Card with which a connection has been established. Card objects
- * are obtained by calling {@link CardTerminal#connect CardTerminal.connect()}.
- *
- * @see CardTerminal
- *
- * @since 1.6
- * @author Andreas Sterbenz
- * @author JSR 268 Expert Group
-*/
-public abstract class Card {
-
- /**
- * Constructs a new Card object.
- *
- *
This constructor is called by subclasses only. Application should
- * call the {@linkplain CardTerminal#connect CardTerminal.connect()}
- * method to obtain a Card
- * object.
- */
- protected Card() {
- // empty
- }
-
- /**
- * Returns the ATR of this card.
- *
- * @return the ATR of this card.
- */
- public abstract ATR getATR();
-
- /**
- * Returns the protocol in use for this card.
- *
- * @return the protocol in use for this card, for example "T=0" or "T=1"
- */
- public abstract String getProtocol();
-
- /**
- * Returns the CardChannel for the basic logical channel. The basic
- * logical channel has a channel number of 0.
- *
- * @throws SecurityException if a SecurityManager exists and the
- * caller does not have the required
- * {@linkplain CardPermission permission}
- * @throws IllegalStateException if this card object has been disposed of
- * via the {@linkplain #disconnect disconnect()} method
- */
- public abstract CardChannel getBasicChannel();
-
- /**
- * Opens a new logical channel to the card and returns it. The channel is
- * opened by issuing a MANAGE CHANNEL command that should use
- * the format [00 70 00 00 01].
- *
- * @throws SecurityException if a SecurityManager exists and the
- * caller does not have the required
- * {@linkplain CardPermission permission}
- * @throws CardException is a new logical channel could not be opened
- * @throws IllegalStateException if this card object has been disposed of
- * via the {@linkplain #disconnect disconnect()} method
- */
- public abstract CardChannel openLogicalChannel() throws CardException;
-
- /**
- * Requests exclusive access to this card.
- *
- *
Once a thread has invoked beginExclusive, only this
- * thread is allowed to communicate with this card until it calls
- * endExclusive. Other threads attempting communication
- * will receive a CardException.
- *
- *
Applications have to ensure that exclusive access is correctly
- * released. This can be achieved by executing
- * the beginExclusive() and endExclusive calls
- * in a try ... finally block.
- *
- * @throws SecurityException if a SecurityManager exists and the
- * caller does not have the required
- * {@linkplain CardPermission permission}
- * @throws CardException if exclusive access has already been set
- * or if exclusive access could not be established
- * @throws IllegalStateException if this card object has been disposed of
- * via the {@linkplain #disconnect disconnect()} method
- */
- public abstract void beginExclusive() throws CardException;
-
- /**
- * Releases the exclusive access previously established using
- * beginExclusive.
- *
- * @throws SecurityException if a SecurityManager exists and the
- * caller does not have the required
- * {@linkplain CardPermission permission}
- * @throws IllegalStateException if the active Thread does not currently have
- * exclusive access to this card or
- * if this card object has been disposed of
- * via the {@linkplain #disconnect disconnect()} method
- * @throws CardException if the operation failed
- */
- public abstract void endExclusive() throws CardException;
-
- /**
- * Transmits a control command to the terminal device.
- *
- *
This can be used to, for example, control terminal functions like - * a built-in PIN pad or biometrics. - * - * @param controlCode the control code of the command - * @param command the command data - * - * @throws SecurityException if a SecurityManager exists and the - * caller does not have the required - * {@linkplain CardPermission permission} - * @throws NullPointerException if command is null - * @throws CardException if the card operation failed - * @throws IllegalStateException if this card object has been disposed of - * via the {@linkplain #disconnect disconnect()} method - */ - public abstract byte[] transmitControlCommand(int controlCode, - byte[] command) throws CardException; - - /** - * Disconnects the connection with this card. After this method returns, - * calling methods on this object or in CardChannels associated with this - * object that require interaction with the card will raise an - * IllegalStateException. - * - * @param reset whether to reset the card after disconnecting. - * - * @throws CardException if the card operation failed - * @throws SecurityException if a SecurityManager exists and the - * caller does not have the required - * {@linkplain CardPermission permission} - */ - public abstract void disconnect(boolean reset) throws CardException; - -} diff --git a/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/CardChannel.java b/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/CardChannel.java deleted file mode 100644 index 243c171bd..000000000 --- a/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/CardChannel.java +++ /dev/null @@ -1,184 +0,0 @@ -/* - * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved. - * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. - * - * This code is free software; you can redistribute it and/or modify it - * under the terms of the GNU General Public License version 2 only, as - * published by the Free Software Foundation. Oracle designates this - * particular file as subject to the "Classpath" exception as provided - * by Oracle in the LICENSE file that accompanied this code. - * - * This code is distributed in the hope that it will be useful, but WITHOUT - * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or - * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License - * version 2 for more details (a copy is included in the LICENSE file that - * accompanied this code). - * - * You should have received a copy of the GNU General Public License version - * 2 along with this work; if not, write to the Free Software Foundation, - * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. - * - * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA - * or visit www.oracle.com if you need additional information or have any - * questions. - */ - -package org.sufficientlysecure.keychain.securitytoken.smartcardio; - -import java.nio.*; - -/** - * A logical channel connection to a Smart Card. It is used to exchange APDUs - * with a Smart Card. - * A CardChannel object can be obtained by calling the method - * {@linkplain Card#getBasicChannel} or {@linkplain Card#openLogicalChannel}. - * - * @see Card - * @see CommandAPDU - * @see ResponseAPDU - * - * @since 1.6 - * @author Andreas Sterbenz - * @author JSR 268 Expert Group - */ -public abstract class CardChannel { - - /** - * Constructs a new CardChannel object. - * - *
This constructor is called by subclasses only. Application should - * call the {@linkplain Card#getBasicChannel} and - * {@linkplain Card#openLogicalChannel} methods to obtain a CardChannel - * object. - */ - protected CardChannel() { - // empty - } - - /** - * Returns the Card this channel is associated with. - * - * @return the Card this channel is associated with - */ - public abstract Card getCard(); - - /** - * Returns the channel number of this CardChannel. A channel number of - * 0 indicates the basic logical channel. - * - * @return the channel number of this CardChannel. - * - * @throws IllegalStateException if this channel has been - * {@linkplain #close closed} or if the corresponding Card has been - * {@linkplain Card#disconnect disconnected}. - */ - public abstract int getChannelNumber(); - - /** - * Transmits the specified command APDU to the Smart Card and returns the - * response APDU. - * - *
The CLA byte of the command APDU is automatically adjusted to - * match the channel number of this CardChannel. - * - *
Note that this method cannot be used to transmit
- * MANAGE CHANNEL APDUs. Logical channels should be managed
- * using the {@linkplain Card#openLogicalChannel} and {@linkplain
- * CardChannel#close CardChannel.close()} methods.
- *
- *
Implementations should transparently handle artifacts - * of the transmission protocol. - * For example, when using the T=0 protocol, the following processing - * should occur as described in ISO/IEC 7816-4: - * - *
if the response APDU has an SW1 of 61, the
- * implementation should issue a GET RESPONSE command
- * using SW2 as the Lefield.
- * This process is repeated as long as an SW1 of 61 is
- * received. The response body of these exchanges is concatenated
- * to form the final response body.
- *
- *
if the response APDU is 6C XX, the implementation
- * should reissue the command using XX as the
- * Le field.
- *
The ResponseAPDU returned by this method is the result
- * after this processing has been performed.
- *
- * @param command the command APDU
- * @return the response APDU received from the card
- *
- * @throws IllegalStateException if this channel has been
- * {@linkplain #close closed} or if the corresponding Card has been
- * {@linkplain Card#disconnect disconnected}.
- * @throws IllegalArgumentException if the APDU encodes a
- * MANAGE CHANNEL command
- * @throws NullPointerException if command is null
- * @throws CardException if the card operation failed
- */
- public abstract ResponseAPDU transmit(CommandAPDU command) throws CardException;
-
- /**
- * Transmits the command APDU stored in the command ByteBuffer and receives
- * the reponse APDU in the response ByteBuffer.
- *
- *
The command buffer must contain valid command APDU data starting
- * at command.position() and the APDU must be
- * command.remaining() bytes long.
- * Upon return, the command buffer's position will be equal
- * to its limit; its limit will not have changed. The output buffer
- * will have received the response APDU bytes. Its position will have
- * advanced by the number of bytes received, which is also the return
- * value of this method.
- *
- *
The CLA byte of the command APDU is automatically adjusted to - * match the channel number of this CardChannel. - * - *
Note that this method cannot be used to transmit
- * MANAGE CHANNEL APDUs. Logical channels should be managed
- * using the {@linkplain Card#openLogicalChannel} and {@linkplain
- * CardChannel#close CardChannel.close()} methods.
- *
- *
See {@linkplain #transmit transmit()} for a discussion of the handling
- * of response APDUs with the SW1 values 61 or 6C.
- *
- * @param command the buffer containing the command APDU
- * @param response the buffer that shall receive the response APDU from
- * the card
- * @return the length of the received response APDU
- *
- * @throws IllegalStateException if this channel has been
- * {@linkplain #close closed} or if the corresponding Card has been
- * {@linkplain Card#disconnect disconnected}.
- * @throws NullPointerException if command or response is null
- * @throws ReadOnlyBufferException if the response buffer is read-only
- * @throws IllegalArgumentException if command and response are the
- * same object, if response may not have
- * sufficient space to receive the response APDU
- * or if the APDU encodes a MANAGE CHANNEL command
- * @throws CardException if the card operation failed
- */
- public abstract int transmit(ByteBuffer command, ByteBuffer response)
- throws CardException;
-
- /**
- * Closes this CardChannel. The logical channel is closed by issuing
- * a MANAGE CHANNEL command that should use the format
- * [xx 70 80 0n] where n is the channel number
- * of this channel and xx is the CLA
- * byte that encodes this logical channel and has all other bits set to 0.
- * After this method returns, calling other
- * methods in this class will raise an IllegalStateException.
- *
- *
Note that the basic logical channel cannot be closed using this
- * method. It can be closed by calling {@link Card#disconnect}.
- *
- * @throws CardException if the card operation failed
- * @throws IllegalStateException if this CardChannel represents a
- * connection the basic logical channel
- */
- public abstract void close() throws CardException;
-
-}
diff --git a/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/CardException.java b/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/CardException.java
deleted file mode 100644
index 23d02e24e..000000000
--- a/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/CardException.java
+++ /dev/null
@@ -1,68 +0,0 @@
-/*
- * Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved.
- * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
- *
- * This code is free software; you can redistribute it and/or modify it
- * under the terms of the GNU General Public License version 2 only, as
- * published by the Free Software Foundation. Oracle designates this
- * particular file as subject to the "Classpath" exception as provided
- * by Oracle in the LICENSE file that accompanied this code.
- *
- * This code is distributed in the hope that it will be useful, but WITHOUT
- * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
- * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
- * version 2 for more details (a copy is included in the LICENSE file that
- * accompanied this code).
- *
- * You should have received a copy of the GNU General Public License version
- * 2 along with this work; if not, write to the Free Software Foundation,
- * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
- *
- * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
- * or visit www.oracle.com if you need additional information or have any
- * questions.
- */
-
-package org.sufficientlysecure.keychain.securitytoken.smartcardio;
-
-/**
- * Exception for errors that occur during communication with the
- * Smart Card stack or the card itself.
- *
- * @since 1.6
- * @author Andreas Sterbenz
- * @author JSR 268 Expert Group
- */
-public class CardException extends Exception {
-
- private static final long serialVersionUID = 7787607144922050628L;
-
- /**
- * Constructs a new CardException with the specified detail message.
- *
- * @param message the detail message
- */
- public CardException(String message) {
- super(message);
- }
-
- /**
- * Constructs a new CardException with the specified cause and a detail message
- * of (cause==null ? null : cause.toString()).
- *
- * @param cause the cause of this exception or null
- */
- public CardException(Throwable cause) {
- super(cause);
- }
-
- /**
- * Constructs a new CardException with the specified detail message and cause.
- *
- * @param message the detail message
- * @param cause the cause of this exception or null
- */
- public CardException(String message, Throwable cause) {
- super(message, cause);
- }
-}
diff --git a/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/CardNotPresentException.java b/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/CardNotPresentException.java
deleted file mode 100644
index 3b8289b75..000000000
--- a/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/CardNotPresentException.java
+++ /dev/null
@@ -1,68 +0,0 @@
-/*
- * Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved.
- * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
- *
- * This code is free software; you can redistribute it and/or modify it
- * under the terms of the GNU General Public License version 2 only, as
- * published by the Free Software Foundation. Oracle designates this
- * particular file as subject to the "Classpath" exception as provided
- * by Oracle in the LICENSE file that accompanied this code.
- *
- * This code is distributed in the hope that it will be useful, but WITHOUT
- * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
- * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
- * version 2 for more details (a copy is included in the LICENSE file that
- * accompanied this code).
- *
- * You should have received a copy of the GNU General Public License version
- * 2 along with this work; if not, write to the Free Software Foundation,
- * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
- *
- * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
- * or visit www.oracle.com if you need additional information or have any
- * questions.
- */
-
-package org.sufficientlysecure.keychain.securitytoken.smartcardio;
-
-/**
- * Exception thrown when an application tries to establish a connection with a
- * terminal that has no card present.
- *
- * @since 1.6
- * @author Andreas Sterbenz
- * @author JSR 268 Expert Group
- */
-public class CardNotPresentException extends CardException {
-
- private final static long serialVersionUID = 1346879911706545215L;
-
- /**
- * Constructs a new CardNotPresentException with the specified detail message.
- *
- * @param message the detail message
- */
- public CardNotPresentException(String message) {
- super(message);
- }
-
- /**
- * Constructs a new CardNotPresentException with the specified cause and a detail message
- * of (cause==null ? null : cause.toString()).
- *
- * @param cause the cause of this exception or null
- */
- public CardNotPresentException(Throwable cause) {
- super(cause);
- }
-
- /**
- * Constructs a new CardNotPresentException with the specified detail message and cause.
- *
- * @param message the detail message
- * @param cause the cause of this exception or null
- */
- public CardNotPresentException(String message, Throwable cause) {
- super(message, cause);
- }
-}
diff --git a/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/CardPermission.java b/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/CardPermission.java
deleted file mode 100644
index 8731fa467..000000000
--- a/OpenKeychain/src/main/java/org/sufficientlysecure/keychain/securitytoken/smartcardio/CardPermission.java
+++ /dev/null
@@ -1,301 +0,0 @@
-/*
- * Copyright (c) 2005, 2006, Oracle and/or its affiliates. All rights reserved.
- * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
- *
- * This code is free software; you can redistribute it and/or modify it
- * under the terms of the GNU General Public License version 2 only, as
- * published by the Free Software Foundation. Oracle designates this
- * particular file as subject to the "Classpath" exception as provided
- * by Oracle in the LICENSE file that accompanied this code.
- *
- * This code is distributed in the hope that it will be useful, but WITHOUT
- * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
- * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
- * version 2 for more details (a copy is included in the LICENSE file that
- * accompanied this code).
- *
- * You should have received a copy of the GNU General Public License version
- * 2 along with this work; if not, write to the Free Software Foundation,
- * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
- *
- * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
- * or visit www.oracle.com if you need additional information or have any
- * questions.
- */
-
-package org.sufficientlysecure.keychain.securitytoken.smartcardio;
-
-import java.io.*;
-
-import java.security.Permission;
-
-/**
- * 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: - *
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 {@linkplain CardPermission
- * class}.
- *
- * @param terminalName the name of the card terminal, or *
- * @param actions the action string (or null if the set of permitted
- * actions is empty)
- *
- * @throws NullPointerException if terminalName is null
- * @throws IllegalArgumentException if actions is an invalid actions
- * specification
- */
- public CardPermission(String terminalName, String actions) {
- super(terminalName);
- if (terminalName == null) {
- throw new NullPointerException();
- }
- mask = getMask(actions);
- }
-
- private static int getMask(String actions) {
- if ((actions == null) || (actions.length() == 0)) {
- throw new IllegalArgumentException("actions must not be empty");
- }
-
- // try exact matches for simple actions first
- for (int i = 0; i < ARRAY_STRINGS.length; i++) {
- if (actions == ARRAY_STRINGS[i]) {
- return ARRAY_MASKS[i];
- }
- }
-
- if (actions.endsWith(",")) {
- throw new IllegalArgumentException("Invalid actions: '" + actions + "'");
- }
- int mask = 0;
- String[] split = actions.split(",");
- outer:
- for (String s : split) {
- for (int i = 0; i < ARRAY_STRINGS.length; i++) {
- if (ARRAY_STRINGS[i].equalsIgnoreCase(s)) {
- mask |= ARRAY_MASKS[i];
- continue outer;
- }
- }
- throw new IllegalArgumentException("Invalid action: '" + s + "'");
- }
-
- return mask;
- }
-
- private static String getActions(int mask) {
- if (mask == A_ALL) {
- return S_ALL;
- }
- boolean first = true;
- StringBuilder sb = new StringBuilder();
- for (int i = 0; i < ARRAY_MASKS.length; i++) {
- int action = ARRAY_MASKS[i];
- if ((mask & action) == action) {
- if (first == false) {
- sb.append(",");
- } else {
- first = false;
- }
- sb.append(ARRAY_STRINGS[i]);
- }
- }
- return sb.toString();
- }
-
-
- /**
- * 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.
- *
- * @return the canonical string representation of the actions.
- */
- public String getActions() {
- if (actions == null) {
- actions = getActions(mask);
- }
- return actions;
- }
-
- /**
- * 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.
- *
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().