org.jpos.core
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 represents a CardHolder

Version:

$Id$

Author:

apr@cs.com.uy

See Also:

Serialized Form

Field Summary

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	trailler Track2 trailler

Constructor Summary

CardHolder()
creates an empty CardHolder

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

CardHolder(String track2)
creates a new CardHolder based on track2

CardHolder(String pan, String exp)
creates a new CardHolder based on pan and exp

Method Summary

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) compares two cardholder object based on PAN and EXP
String	getBIN() Get Bank Issuer Number
String	getEXP() Get Expiration Date
String	getNameOnCard()
String	getPAN()
String	getSecurityCode()
String	getServiceCode()
String	getTrack1()
String	getTrack2()
String	getTrailler()
boolean	hasSecurityCode()
boolean	hasTrack1()
boolean	hasTrack2()
boolean	isExpired() 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	setTrailler(String trailler) Set Trailler (used by OR-mapping stuff)

Methods inherited from class java.lang.Object

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

Field Detail

pan

protected String pan

Primary Account Number

exp

protected String exp

Expiration date (YYMM)

trailler

protected String trailler

Track2 trailler

securityCode

protected String securityCode

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

track1

protected String track1

Track1 Data

Constructor Detail

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

Parameters:

track2 - cards track2

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 Detail

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 -

getSecurityCode

public String getSecurityCode()

Returns:

securityCode (or null)

hasSecurityCode

public boolean hasSecurityCode()

Returns:

true if we have a security code

getTrailler

public String getTrailler()

Returns:

trailler (may be null)

setTrailler

public void setTrailler(String trailler)

Set Trailler (used by OR-mapping stuff)

Parameters:

trailler -

setPAN

public void setPAN(String pan)
            throws InvalidCardException

Sets Primary Account Number

Parameters:

pan -

Throws:

InvalidCardException

getPAN

public String getPAN()

Returns:

Primary Account Number

getBIN

public String getBIN()

Get Bank Issuer Number

Returns:

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 invalid exp)

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()

equals

public boolean equals(Object obj)

compares two cardholder object
based on PAN and EXP

Overrides:

equals in class Object

Parameters:

obj - a CardHolder instance

Returns:

true if pan and exp matches