/*

 *  Copyright (c) 2005, 2018, 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.

 */

/**

 * Java™ Smart Card I/O API.

 *

 * This specification describes the Java Smart Card I/O API defined by

 * <a href="http://jcp.org/en/jsr/detail?id=268">JSR 268</a>.

 *

 * It defines a Java API for communication with Smart Cards

 * using ISO/IEC 7816-4 APDUs. It thereby allows Java applications to interact with

 * applications running on the Smart Card, to store and retrieve data

 * on the card, etc.

 *

 * <p>

 * The API is defined by classes in the package

 * <code>javax.smartcardio</code>. They can be classified as follows:

 *

 * <dl>

 * <dt>Classes describing the corresponding Smart Card structures

 * <dd>

 * <a href="ATR.html">ATR</a>,

 * <a href="CommandAPDU.html">CommandAPDU</a>,

 * <a href="ResponseAPDU.html">ResponseAPDU</a>

 *

 * <dt>Factory to obtain implementations

 * <dd>

 * <a href="TerminalFactory.html">TerminalFactory</a>

 *

 * <dt>Main classes for card and terminal functions

 * <dd>

 * <a href="CardTerminals.html">CardTerminals</a>,

 * <a href="CardTerminal.html">CardTerminal</a>,

 * <a href="Card.html">Card</a>,

 * <a href="CardChannel.html">CardChannel</a>

 *

 * <dt>Supporting permission and exception classes

 * <dd>

 * <a href="CardPermission.html">CardPermission</a>,

 * <a href="CardException.html">CardException</a>,

 * <a href="CardNotPresentException.html">CardNotPresentException</a>

 *

 * <dt>Service provider interface, not accessed directly by applications

 * <dd>

 * <a href="TerminalFactorySpi.html">TerminalFactorySpi</a>

 *

 * </dl>

 *

 *

 *

 * A simple example of using the API is:

 * <pre>

 *      // show the list of available terminals

 *      TerminalFactory factory = TerminalFactory.getDefault();

 *      List<CardTerminal> terminals = factory.terminals().list();

 *      System.out.println("Terminals: " + terminals);

 *      // get the first terminal

 *      CardTerminal terminal = terminals.get(0);

 *      // establish a connection with the card

 *      Card card = terminal.connect("T=0");

 *      System.out.println("card: " + card);

 *      CardChannel channel = card.getBasicChannel();

 *      ResponseAPDU r = channel.transmit(new CommandAPDU(c1));

 *      System.out.println("response: " + toString(r.getBytes()));

 *      // disconnect

 *      card.disconnect(false);

 * </pre>

 *

 * @since   1.6

 * @author  Andreas Sterbenz

 * @author  JSR 268 Expert Group

 */

package javax.smartcardio;