Class SmartcardIoConnection
java.lang.Object
es.gob.jmulticard.connection.AbstractApduConnectionIso7816
es.gob.jmulticard.jse.smartcardio.SmartcardIoConnection
- All Implemented Interfaces:
ApduConnection
Conexión con lector de tarjetas inteligentes implementado sobre
JSR-268 SmartCard I/O.
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate javax.smartcardio.Cardprivate javax.smartcardio.CardChannelprivate static final booleanprivate booleanprivate static final Loggerprivate static final intTamaño máximo de las APDU.private ApduConnectionProtocolprivate static final StringConstante para la indicación de que se ha detectado un reinicio del canal con la tarjeta.private static final StringPropiedad del sistema con la que configurar que se ignoren los lectores de tarjeta que se reconozcan como lectores virtuales.(package private) List<javax.smartcardio.CardTerminal> private int -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidclose()Cierra la conexión con la tarjeta inteligente actualmente insertada en el lector.intObtiene el tamaño máximo de APDU que se puede enviar sin necesidad de hacer una envoltura.Devuelve el protocolo de conexión con la tarjeta usado actualmente.Recupera la conexión subyacente utilizada por la conexión.getTerminalInfo(int terminal) Devuelve información sobre un terminal.private List<javax.smartcardio.CardTerminal> long[]getTerminals(boolean onlyWithCardPresent) Devuelve todos los lectores de tarjetas presentes en el sistema.internalTransmit(byte[] command) Transmite una APDU.booleanIndica si la conexión con la tarjeta se ha establecido en modo exclusivo o no.booleanisOpen()Indica si la conexión está abierta o no.private static booleanisVirtual(javax.smartcardio.CardTerminal terminal) Identifica si se trata de un lector de tarjetas virtual.voidopen()Abre la conexión con la tarjeta inteligente actualmente insertada en el lector.byte[]reset()Reinicializa la conexión con la tarjeta inteligente.voidsetExclusiveUse(boolean ex) Establece si la conexión se debe abrir en modo exclusivo.voidEstablece el protocolo de conexión con la tarjeta.voidsetTerminal(int terminalN) Establece el lector de tarjetas que se usará para la conexión.toString()Methods inherited from class AbstractApduConnectionIso7816
transmit
-
Field Details
-
DEBUG
private static final boolean DEBUG- See Also:
-
MAX_APDU_SIZE
private static final int MAX_APDU_SIZETamaño máximo de las APDU. Por encima de este tamaño, se hace automáticamente una envoltura en varias APDU.- See Also:
-
SCARD_W_RESET_CARD
Constante para la indicación de que se ha detectado un reinicio del canal con la tarjeta.- See Also:
-
SYSTEM_PROPERTY_IGNORE_VIRTUAL_READERS
Propiedad del sistema con la que configurar que se ignoren los lectores de tarjeta que se reconozcan como lectores virtuales.- See Also:
-
LOGGER
-
terminalNumber
private int terminalNumber -
cardChannel
private javax.smartcardio.CardChannel cardChannel -
card
private javax.smartcardio.Card card -
exclusive
private boolean exclusive -
protocol
-
terminales
List<javax.smartcardio.CardTerminal> terminales
-
-
Constructor Details
-
SmartcardIoConnection
public SmartcardIoConnection()Constructor por defecto.
-
-
Method Details
-
toString
-
close
Description copied from interface:ApduConnectionCierra la conexión con la tarjeta inteligente actualmente insertada en el lector.- Throws:
ApduConnectionException- Cuando ocurre cualquier problema cerrando la conexión.- See Also:
-
getTerminalInfo
Devuelve información sobre un terminal.- Parameters:
terminal- Número de terminal que se desea obtener información.- Returns:
- Una descripción del terminal especificado.
- Throws:
ApduConnectionException- Cuando ocurren problemas en la conexión con los lectores.
-
getTerminals
-
isVirtual
private static boolean isVirtual(javax.smartcardio.CardTerminal terminal) Identifica si se trata de un lector de tarjetas virtual.- Parameters:
terminal- Lector de tarjetas.- Returns:
truesi se trata de un lector virtual,falseen caso contrario.
-
getTerminals
Description copied from interface:ApduConnectionDevuelve todos los lectores de tarjetas presentes en el sistema.- Parameters:
onlyWithCardPresent- Para indicar que sólo devuelva lectores que tengan una tarjeta insertada.- Returns:
- Una lista con los identificadores de lectores de tarjetas conectados.
- Throws:
ApduConnectionException- Cuando ocurran problemas en la conexión con los lectores.
-
isOpen
public boolean isOpen()Description copied from interface:ApduConnectionIndica si la conexión está abierta o no.- Returns:
truesi la conexión esta abierta,falsesi está cerrada.
-
open
Description copied from interface:ApduConnectionAbre la conexión con la tarjeta inteligente actualmente insertada en el lector.- Throws:
ApduConnectionException- Cuando ocurre cualquier problema abriendo la conexión.- See Also:
-
reset
Description copied from interface:ApduConnectionReinicializa la conexión con la tarjeta inteligente.- Returns:
- Respuesta al reset (ATR) de la tarjeta.
- Throws:
ApduConnectionException- Cuando ocurre cualquier problema reinicializando la conexión.
-
setExclusiveUse
public void setExclusiveUse(boolean ex) Establece si la conexión se debe abrir en modo exclusivo. Solo puede establecerse si la conexión aun no ha sido abierta.- Parameters:
ex-truepara abrir la conexión en modo exclusivo,falsepara abrirla en modo no exclusivo.
-
setProtocol
Establece el protocolo de conexión con la tarjeta. Por defecto, si no se establece ninguno, se indica * para que sea el API subyancente el que detecte el apropiado.- Parameters:
p- Protocolo de conexión con la tarjeta.
-
setTerminal
public void setTerminal(int terminalN) Description copied from interface:ApduConnectionEstablece el lector de tarjetas que se usará para la conexión. Si se cambia el terminal estando la conexión ya abierta, se intentará reabrirla con el nuevo terminal.- Parameters:
terminalN- Número de terminal que se desea pase a ser el actual.
-
internalTransmit
Description copied from class:AbstractApduConnectionIso7816Transmite una APDU.- Specified by:
internalTransmitin classAbstractApduConnectionIso7816- Parameters:
command- Comando APDU a transmitir.- Returns:
- APDU de respuesta.
- Throws:
ApduConnectionException- Si hay cualquier problema durante el envío.
-
getProtocol
Devuelve el protocolo de conexión con la tarjeta usado actualmente.- Returns:
- Un objeto de tipo enumerado
ConnectionProtocol.
-
isExclusiveUse
public boolean isExclusiveUse()Indica si la conexión con la tarjeta se ha establecido en modo exclusivo o no.- Returns:
truesi la conexión está establecida en modo exclusivo.
-
getSubConnection
Description copied from interface:ApduConnectionRecupera la conexión subyacente utilizada por la conexión.- Returns:
- Conexión subyacente con la tarjeta o
nullsi esta conexión es ya la de más bajo nivel.
-
getMaxApduSize
public int getMaxApduSize()Description copied from class:AbstractApduConnectionIso7816Obtiene el tamaño máximo de APDU que se puede enviar sin necesidad de hacer una envoltura.- Specified by:
getMaxApduSizein classAbstractApduConnectionIso7816- Returns:
- Tamaño máximo (en octetos) de APDU que se puede enviar sin necesidad de hacer una envoltura.
-