Class PosCapability.Builder

java.lang.Object

org.jpos.iso.PosCapability.Builder

Enclosing class:

PosCapability

public static final class PosCapability.Builder
extends Object

Fluent builder for PosCapability.

All numeric capacity fields default to 0 (not capable). Track 3 rewrite and card capture default to false. PIN input length defaults to 0. Reading and verification capability bits default to all-zero (no capabilities declared).

Method Summary

Modifier and Type	Method	Description
PosCapability.Builder	approvalCodeLength(int length)	Sets the maximum approval code length (sub-field 27-3, N1, range 0–9).
PosCapability	build()	Builds the PosCapability.
PosCapability.Builder	cardAcceptorDisplayLength(int length)	Sets the maximum card acceptor display data length (sub-field 27-7, N3, range 0–999).
PosCapability.Builder	cardAcceptorReceiptLength(int length)	Sets the maximum card acceptor receipt data length (sub-field 27-5, N3, range 0–999).
PosCapability.Builder	cardCaptureCapable(boolean capable)	Sets the card capture capability (sub-field 27-10).
PosCapability.Builder	cardholderDisplayLength(int length)	Sets the maximum cardholder display data length (sub-field 27-6, N3, range 0–999).
PosCapability.Builder	cardholderReceiptLength(int length)	Sets the maximum cardholder receipt data length (sub-field 27-4, N3, range 0–999).
PosCapability.Builder	iccScriptDataLength(int length)	Sets the maximum ICC scripts data length (sub-field 27-8, N3, range 0–999).
PosCapability.Builder	pinInputLength(int length)	Sets the maximum PIN input length capability (sub-field 27-11, binary, range 0–255).
PosCapability.Builder	readingCapability(PosDataCode.ReadingMethod method)	Sets a card reading capability bit (sub-field 27-1).
PosCapability.Builder	track3RewriteCapable(boolean capable)	Sets the track 3 magnetic stripe rewrite capability (sub-field 27-9).
PosCapability.Builder	verificationCapability(PosDataCode.VerificationMethod method)	Sets a cardholder verification capability bit (sub-field 27-2).

Methods inherited from class Object

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

Method Details

readingCapability

public PosCapability.Builder readingCapability(PosDataCode.ReadingMethod method)

Sets a card reading capability bit (sub-field 27-1). Multiple capabilities may be set by calling this method repeatedly.

Parameters:

method - the reading method to declare as supported

Returns:

this builder

verificationCapability

public PosCapability.Builder verificationCapability(PosDataCode.VerificationMethod method)

Sets a cardholder verification capability bit (sub-field 27-2). Multiple capabilities may be set by calling this method repeatedly.

Parameters:

method - the verification method to declare as supported

Returns:

this builder

approvalCodeLength

public PosCapability.Builder approvalCodeLength(int length)

Sets the maximum approval code length (sub-field 27-3, N1, range 0–9).

Parameters:

length - approval code length

Returns:

this builder

Throws:

IllegalArgumentException - if length is outside 0–9

cardholderReceiptLength

public PosCapability.Builder cardholderReceiptLength(int length)

Sets the maximum cardholder receipt data length (sub-field 27-4, N3, range 0–999).

Parameters:

length - receipt length; 0 = not capable

Returns:

this builder

Throws:

IllegalArgumentException - if length is outside 0–999

cardAcceptorReceiptLength

public PosCapability.Builder cardAcceptorReceiptLength(int length)

Sets the maximum card acceptor receipt data length (sub-field 27-5, N3, range 0–999).

Parameters:

length - receipt length; 0 = not capable

Returns:

this builder

Throws:

IllegalArgumentException - if length is outside 0–999

cardholderDisplayLength

public PosCapability.Builder cardholderDisplayLength(int length)

Sets the maximum cardholder display data length (sub-field 27-6, N3, range 0–999).

Parameters:

length - display length; 0 = not capable

Returns:

this builder

Throws:

IllegalArgumentException - if length is outside 0–999

cardAcceptorDisplayLength

public PosCapability.Builder cardAcceptorDisplayLength(int length)

Sets the maximum card acceptor display data length (sub-field 27-7, N3, range 0–999).

Parameters:

length - display length; 0 = not capable

Returns:

this builder

Throws:

IllegalArgumentException - if length is outside 0–999

iccScriptDataLength

public PosCapability.Builder iccScriptDataLength(int length)

Sets the maximum ICC scripts data length (sub-field 27-8, N3, range 0–999).

Parameters:

length - ICC script length in bytes; 0 = not capable

Returns:

this builder

Throws:

IllegalArgumentException - if length is outside 0–999

track3RewriteCapable

public PosCapability.Builder track3RewriteCapable(boolean capable)

Sets the track 3 magnetic stripe rewrite capability (sub-field 27-9).

Parameters:

capable - true if the terminal can rewrite track 3

Returns:

this builder

cardCaptureCapable

public PosCapability.Builder cardCaptureCapable(boolean capable)

Sets the card capture capability (sub-field 27-10).

Parameters:

capable - true if the terminal can capture (retain) cards

Returns:

this builder

pinInputLength

public PosCapability.Builder pinInputLength(int length)

Sets the maximum PIN input length capability (sub-field 27-11, binary, range 0–255).

Parameters:

length - maximum PIN length the PIN pad accepts

Returns:

this builder

Throws:

IllegalArgumentException - if length is outside 0–255

build

public PosCapability build()

Builds the PosCapability.

Returns:

a new PosCapability backed by a copy of the accumulated state