us.fatehi.magnetictrack.bankcard

Class Track1FormatB

java.lang.Object

us.fatehi.magnetictrack.BaseTrackData

us.fatehi.magnetictrack.bankcard.BaseBankCardTrackData

us.fatehi.magnetictrack.bankcard.Track1FormatB

All Implemented Interfaces:

Serializable, TrackData

public class Track1FormatB
extends BaseBankCardTrackData

Parses, and represents a card's track 1 data, in format "B". From Wikipedia - ISO/IEC 7813
The Track 1 structure is specified as:

1. STX: Start sentinel "%"
2. FC: Format code "B" (The format described here. Format "A" is reserved for proprietary use.)
3. PAN: Primary Account Number, up to 19 digits
4. FS: Separator "^"
5. NM: Name, 2 to 26 characters (including separators, where appropriate, between surname, first name etc.)
6. FS: Separator "^"
7. ED: Expiration data, 4 digits or "^"
8. SC: Service code, 3 digits or "^"
9. DD: Discretionary data, balance of characters
10. ETX: End sentinel "?"
11. LRC: Longitudinal redundancy check, calculated according to ISO/IEC 7811-2

The maximum record length is 79 alphanumeric characters.

See Also:

Wikipedia - ISO/IEC 7813, Serialized Form

Method Summary

Methods

Modifier and Type	Method and Description
boolean	exceedsMaximumLength() Whether the track data exceeds the maximum length allowed.
static Track1FormatB	from(String rawTrackData) Parses magnetic track 1 format B data into a Track1FormatB object.
ExpirationDate	getExpirationDate() Gets the card expiration date.
String	getFormatCode() Gets the track 1 format code, usually "B".
Name	getName() Gets the cardholder's name.s
PrimaryAccountNumber	getPrimaryAccountNumber() Gets the primary account number for the card.
ServiceCode	getServiceCode() Gets the card service code.
boolean	hasExpirationDate() Checks whether the card expiration date is available.
boolean	hasFormatCode() Checks whether the format code is available.
boolean	hasName() Checks whether the cardholder's name is available.
boolean	hasPrimaryAccountNumber() Checks whether the primary account number for the card is available.
boolean	hasServiceCode() Checks whether the card service code is available.

Methods inherited from class us.fatehi.magnetictrack.bankcard.BaseBankCardTrackData

getDiscretionaryData, hasDiscretionaryData

Methods inherited from class us.fatehi.magnetictrack.BaseTrackData

getRawTrackData, hasRawTrackData, toString

Methods inherited from class java.lang.Object

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

Method Detail

from

public static Track1FormatB from(String rawTrackData)

Parses magnetic track 1 format B data into a Track1FormatB object.

Parameters:

rawTrackData - Raw track data as a string. Can include newlines, and other tracks as well.

Returns:

A Track1FormatB instance, corresponding to the parsed data.

exceedsMaximumLength

public boolean exceedsMaximumLength()

Description copied from interface: TrackData

Whether the track data exceeds the maximum length allowed.

Returns:

True if too long

See Also:

TrackData.exceedsMaximumLength()

getExpirationDate

public ExpirationDate getExpirationDate()

Gets the card expiration date.

Returns:

Card expiration date.

getFormatCode

public String getFormatCode()

Gets the track 1 format code, usually "B".

Returns:

Track 1 format code, usually "B"

getName

public Name getName()

Gets the cardholder's name.s

Returns:

Cardholder's name

getPrimaryAccountNumber

public PrimaryAccountNumber getPrimaryAccountNumber()

Gets the primary account number for the card.

Returns:

Primary account number.

getServiceCode

public ServiceCode getServiceCode()

Gets the card service code.

Returns:

Card service code.

hasExpirationDate

public boolean hasExpirationDate()

Checks whether the card expiration date is available.

Returns:

True if the card expiration date is available.

hasFormatCode

public boolean hasFormatCode()

Checks whether the format code is available.

Returns:

True if the format code is available.

hasName

public boolean hasName()

Checks whether the cardholder's name is available.

Returns:

True if the cardholder's name is available.

hasPrimaryAccountNumber

public boolean hasPrimaryAccountNumber()

Checks whether the primary account number for the card is available.

Returns:

True if the primary account number for the card is available.

hasServiceCode

public boolean hasServiceCode()

Checks whether the card service code is available.

Returns:

True if the card service code is available.