fabricante.externo.tarjetas

Class TarjetaMonedero

java.lang.Object

fabricante.externo.tarjetas.TarjetaMonedero

public class TarjetaMonedero
extends java.lang.Object

Gestión de una tarjeta monedero de ProveedorTarjetas inc.
Facilita su emisión, carga, descuento y la consulta de su saldo.
Por razones de seguridad, las operaciones que modifican el saldo requieren diferentes credenciales para su aumento o disminución.

Author:

ProveedorTarjetas inc.

Constructor Summary

Constructors

Constructor and Description
TarjetaMonedero(java.lang.String credencial) Inicialización con saldo cero.
TarjetaMonedero(java.lang.String credencial, double saldoInicial) Inicialización con el saldo indicado.

Method Summary

Modifier and Type	Method and Description
void	descontarDelSaldo(java.lang.String credencial, double cantidad) Carga el pago de la cantidad indicada.
double	getSaldoActual() Valor del saldo actual.
void	recargaSaldo(java.lang.String credencial, double cantidad) Aumenta el saldo actual en la cantidad indicada

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TarjetaMonedero

public TarjetaMonedero(java.lang.String credencial)

Inicialización con saldo cero.

Parameters:

credencial: - Aportada por el código cliente por razones de seguridad para obtener el permiso de emisión de la tarjeta.

Throws:

java.lang.IllegalArgumentException - La credencial que aporta el código cliente no es correcta.

TarjetaMonedero

public TarjetaMonedero(java.lang.String credencial,
                       double saldoInicial)

Inicialización con el saldo indicado.

Parameters:

credencial: - Aportada por el código cliente por razones de seguridad para obtener el permiso de emisión de la tarjeta.

saldoInicial: - Cantidad correspondiente a la primera carga de saldo en la tarjeta. El saldo inicial no puede ser negativo.

Throws:

java.lang.IllegalArgumentException - La credencial que aporta el código cliente no es correcta.

java.lang.IllegalArgumentException - El saldoInicial es negativo.

Method Detail

getSaldoActual

public double getSaldoActual()

Valor del saldo actual.

Returns:

Saldo, que no puede ser negativo.

recargaSaldo

public void recargaSaldo(java.lang.String credencial,
                         double cantidad)

Aumenta el saldo actual en la cantidad indicada

Parameters:

credencial: - Aportada por el código cliente por razones de seguridad para obtener el permiso de recarga.

cantidad: - cantidad que carga en la tarjeta, que debe ser positiva.

Throws:

java.lang.IllegalArgumentException - La credencial que aporta el cliente para cargar saldo no es correcta.

java.lang.IllegalArgumentException - La cantidad a cargar es menor o igual que cero.

descontarDelSaldo

public void descontarDelSaldo(java.lang.String credencial,
                              double cantidad)

Carga el pago de la cantidad indicada.

Parameters:

credencial: - Aportada por el código cliente por razones de seguridad para obtener el permiso necesario para descontar saldo.

cantidad: - Importe a descontar de la tarjeta. Debe ser positiva y menor que el saldo actual de la tarjeta.

Throws:

java.lang.IllegalArgumentException - La credencial que aporta el cliente para descontar saldo de la tarjeta no es correcta.

java.lang.IllegalArgumentException - La cantidad es mayor que el saldo actual.

java.lang.IllegalArgumentException - La cantidad es menor o igual que cero.