Class CardHolder

java.lang.Object

org.jpos.core.CardHolder

All Implemented Interfaces:

Serializable, Cloneable, Loggeable

public class CardHolder
extends Object
implements Cloneable, Serializable, Loggeable

Since:

jPOS 1.1 This class is called 'CardHolder', but a better name could have been 'Card' At some point we'll deprecate this one and create a new 'Card' class.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected String	exp	Expiration date (YYMM)
protected String	pan	Primary Account Number
protected String	securityCode	Optional security code (CVC, CVV, Locale ID, wse)
protected String	track1	Track1 Data
protected String	trailer	Track2 trailler

Constructor Summary

Constructors

Constructor	Description
CardHolder()	creates an empty CardHolder
CardHolder(String track2)	creates a new CardHolder based on track2
CardHolder(String pan, String exp)	creates a new CardHolder based on pan and exp
CardHolder(ISOMsg m)	Construct a CardHolder based on content received on field 35 (track2) or field 2 (PAN) + field 14 (EXP)

Method Summary

Modifier and Type	Method	Description
void	dump(PrintStream p, String indent)	dumps CardHolder basic information by default we do not dump neither track1/2 nor securityCode for security reasons.
boolean	equals(Object obj)
String	getBIN()	Get the traditional 6-digit BIN (Bank Issuer Number) from the PAN
String	getBIN(int len)	Get the first len digits from the PAN.
String	getEXP()	Get Expiration Date
String	getNameOnCard()
String	getPAN()
String	getSecurityCode()
String	getServiceCode()
String	getTrack1()
String	getTrack2()
String	getTrailer()
String	getTrailler()	Deprecated. use getTrailer()
int	hashCode()
boolean	hasSecurityCode()
boolean	hasTrack1()
boolean	hasTrack2()
boolean	isExpired()	Y2K compliant expiration check
boolean	isExpired(Date currentDate)	Y2K compliant expiration check
boolean	isValidCRC()
static boolean	isValidCRC(String p)
void	parseTrack2(String s)	extract pan/exp/trailler from track2
boolean	seemsManualEntry()
void	setEXP(String exp)	Set Expiration Date
void	setPAN(String pan)	Sets Primary Account Number
void	setSecurityCode(String securityCode)	assigns securityCode to this CardHolder object
void	setTrack1(String track1)
void	setTrailer(String trailer)
void	setTrailler(String trailer)	Deprecated. use setTrailer

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface Loggeable

dump

Field Details

pan

protected String pan

Primary Account Number

exp

protected String exp

Expiration date (YYMM)

trailer

protected String trailer

Track2 trailler

securityCode

protected String securityCode

Optional security code (CVC, CVV, Locale ID, wse)

track1

protected String track1

Track1 Data

Constructor Details

CardHolder

public CardHolder()

creates an empty CardHolder

CardHolder

public CardHolder(String track2)
           throws InvalidCardException

creates a new CardHolder based on track2

Parameters:

track2 - cards track2

Throws:

InvalidCardException

CardHolder

public CardHolder(String pan,
 String exp)
           throws InvalidCardException

creates a new CardHolder based on pan and exp

Throws:

InvalidCardException

CardHolder

public CardHolder(ISOMsg m)
           throws InvalidCardException

Construct a CardHolder based on content received on field 35 (track2) or field 2 (PAN) + field 14 (EXP)

Parameters:

m - an ISOMsg

Throws:

InvalidCardException

Method Details

parseTrack2

public void parseTrack2(String s)
                 throws InvalidCardException

extract pan/exp/trailler from track2

Parameters:

s - a valid track2

Throws:

InvalidCardException

setTrack1

public void setTrack1(String track1)

Parameters:

track1 - card's track1

getTrack1

public String getTrack1()

Returns:

the track1

hasTrack1

public boolean hasTrack1()

Returns:

true if we have a track1

getNameOnCard

public String getNameOnCard()

Returns:

the Name written on the card (from track1)

getTrack2

public String getTrack2()

Returns:

reconstructed track2 or null

hasTrack2

public boolean hasTrack2()

Returns:

true if we have a (may be valid) track2

setSecurityCode

public void setSecurityCode(String securityCode)

assigns securityCode to this CardHolder object

Parameters:

securityCode - Card's security code

getSecurityCode

public String getSecurityCode()

Returns:

securityCode (or null)

hasSecurityCode

public boolean hasSecurityCode()

Returns:

true if we have a security code

getTrailler

@Deprecated
public String getTrailler()

Deprecated.

use getTrailer()

Returns:

trailer (may be null)

setTrailler

@Deprecated
public void setTrailler(String trailer)

Deprecated.

use setTrailer

Set Card's trailer

Parameters:

trailer - Card's trailer

getTrailer

public String getTrailer()

setTrailer

public void setTrailer(String trailer)

setPAN

public void setPAN(String pan)
            throws InvalidCardException

Sets Primary Account Number

Parameters:

pan - Primary Account NUmber

Throws:

InvalidCardException

getPAN

public String getPAN()

Returns:

Primary Account Number

getBIN

public String getBIN(int len)

Get the first len digits from the PAN. Can be used for the newer 8-digit BINs, or some arbitrary length.

Returns:

len-digit bank issuer number

getBIN

public String getBIN()

Get the traditional 6-digit BIN (Bank Issuer Number) from the PAN

Returns:

6-digit bank issuer number

setEXP

public void setEXP(String exp)
            throws InvalidCardException

Set Expiration Date

Parameters:

exp - card expiration date

Throws:

InvalidCardException

getEXP

public String getEXP()

Get Expiration Date

Returns:

card expiration date

isExpired

public boolean isExpired()

Y2K compliant expiration check

Returns:

true if card is expired (or expiration is invalid)

isExpired

public boolean isExpired(Date currentDate)

Y2K compliant expiration check

Parameters:

currentDate - current system's date

Returns:

true if card is expired (or expiration is invalid)

isValidCRC

public boolean isValidCRC()

isValidCRC

public static boolean isValidCRC(String p)

dump

public void dump(PrintStream p,
 String indent)

dumps CardHolder basic information
by default we do not dump neither track1/2 nor securityCode for security reasons.

Specified by:

dump in interface Loggeable

Parameters:

p - a PrintStream usually suplied by Logger

indent - ditto

See Also:

• Loggeable

getServiceCode

public String getServiceCode()

Returns:

ServiceCode (if available) or a String with three blanks

seemsManualEntry

public boolean seemsManualEntry()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object