MSRTrackData (CloudPOSSDK)

```
public interface MSRTrackData
```
The MSRTrackData interface represents the data object of a track from a Magnetic Stripe Reader (MSR) device. This interface provides methods to retrieve raw track data and error information specific to individual tracks.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`LRC_ERROR` Error constant indicating an LRC (Longitudinal Redundancy Check) error detected in the track data.
`static int`	`NO_DATA` Error constant indicating that no track data was found, only sentinel characters were present.
`static int`	`NO_ERROR` Error constant indicating that no errors were encountered during the track reading process.
`static int`	`NO_STRIPE` Represents an error where no encoded track signal is detected on the magnetic stripe.
`static int`	`NON_SPECIFIC_ERROR` Error constant indicating a non-specific error encountered during the track reading process.
`static int`	`PARITY_ERROR` Error constant indicating a parity error detected in one or more characters of the track data.
`static int`	`READ_ERROR` Error constant indicating that a read error occurred due to one or more invalid or corrupt characters in the track data.
`static int`	`TRACK_NO_0` Track number 0.
`static int`	`TRACK_NO_1` Track number 1.
`static int`	`TRACK_NO_2` Track number 2.
`static int`	`TRACK_NOT_SUPPORTED` Error constant indicating that the MSR could not read the track because it is not supported by the reader.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`byte[]`	`getTrackData(int trackNo)` Retrieves a buffer containing the raw data read from a specified track.
`int`	`getTrackError(int trackNo)` Returns the error status for a specific track.

- Field Detail
  - TRACK_NO_0
```
static final int TRACK_NO_0
```
    Track number 0.
    
    See Also:
    
    Constant Field Values
  - TRACK_NO_1
```
static final int TRACK_NO_1
```
    Track number 1.
    
    See Also:
    
    Constant Field Values
  - TRACK_NO_2
```
static final int TRACK_NO_2
```
    Track number 2.
    
    See Also:
    
    Constant Field Values
  - NO_ERROR
```
static final int NO_ERROR
```
    Error constant indicating that no errors were encountered during the track reading process. This constant signifies a successful read operation where the track data was obtained without any issues.
    This error constant is returned by getTrackError() when the track is read successfully without any errors.
    
    See Also:
    
    Constant Field Values
  - NON_SPECIFIC_ERROR
```
static final int NON_SPECIFIC_ERROR
```
    Error constant indicating a non-specific error encountered during the track reading process. This error is used to signify a track read error that does not fall into any of the other predefined categories. It represents a general error case where the specific nature of the problem is not identified.
    This error constant is returned by getTrackError() when a general, unspecified error occurs while reading the track data.
    
    See Also:
    
    Constant Field Values
  - TRACK_NOT_SUPPORTED
```
static final int TRACK_NOT_SUPPORTED
```
    Error constant indicating that the MSR could not read the track because it is not supported by the reader. This error occurs when an attempt is made to read a track that the MSR device is not equipped to handle, possibly due to hardware limitations or configuration settings.
    This error constant is returned by getTrackError() when it encounters a track that is not supported by the reader.
    
    See Also:
    
    Constant Field Values
  - READ_ERROR
```
static final int READ_ERROR
```
    Error constant indicating that a read error occurred due to one or more invalid or corrupt characters in the track data. This error typically signifies issues in the data encoding or corruption during the reading process, leading to characters that cannot be accurately interpreted.
    This error constant is returned by getTrackError() when such a read error is encountered in the track data.
    
    See Also:
    
    Constant Field Values
  - PARITY_ERROR
```
static final int PARITY_ERROR
```
    Error constant indicating a parity error detected in one or more characters of the track data. A parity error occurs when the parity bit of a character does not match its expected value, which is typically used to check for errors in data transmission or storage.
    This error constant is returned by getTrackError() when a parity error is detected in the track data.
    
    See Also:
    
    Constant Field Values
  - LRC_ERROR
```
static final int LRC_ERROR
```
    Error constant indicating an LRC (Longitudinal Redundancy Check) error detected in the track data. This error occurs when the LRC, which is used for error checking, does not match the data on the track, implying a potential data integrity issue or corruption in the track data.
    This error constant is returned by getTrackError() when an LRC error is encountered during track data reading.
    
    See Also:
    
    Constant Field Values
  - NO_DATA
```
static final int NO_DATA
```
    Error constant indicating that no track data was found, only sentinel characters were present. This scenario occurs when a track on the magnetic stripe is read, but it contains no meaningful data, just the sentinel markers.
    This error constant is returned by getTrackError() to indicate the absence of track data.
    
    See Also:
    
    Constant Field Values
  - NO_STRIPE
```
static final int NO_STRIPE
```
    Represents an error where no encoded track signal is detected on the magnetic stripe. This situation occurs when neither data nor sentinel characters are present on the track.
    This error constant is returned by getTrackError() when it encounters such a scenario.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getTrackData
```
byte[] getTrackData(int trackNo)
```
    Retrieves a buffer containing the raw data read from a specified track.
    References: ISO 7811-2 and JIS X 6302.
    Track 1 (ISO and JIS Type I cards): - ISO format: Up to 79 bytes of 6-bit alphanumeric characters. Start sentinel 0x05, end sentinel (before LRC) 0x1F. - JIS Type I (Format A, B, C): Similar to ISO Track 1 with the same character set, sentinels, and character limit. Format C (similar to JIS II) has up to 72 bytes of 7-bit characters with 0x7F as start and end sentinels.
    Track 2 (ISO and JIS Type I cards): - Up to 40 bytes of 4-bit numeric characters. Begins with 0x0B, ends with 0x0F before the LRC.
    Track 3 (ISO and JIS Type I cards): - ISO format: Up to 107 bytes of 4-bit numeric characters, including control characters and an LRC. - JIS Type I: May have the same format as ISO Track 3 or as Track 1 Format C (JIS II card format).
    
    Returns:
    
    The data buffer containing the track data.
  - getTrackError
```
int getTrackError(int trackNo)
```
    Returns the error status for a specific track. This method provides detailed error information which is specific to each track. Common errors across all tracks are reported in the readData completion event status.
    
    Parameters:
    
    trackNo - The track number for which to retrieve the error status.
    
    Returns:
    
    An error constant indicating the nature of the track read error, if any.
    
    See Also:
    
    NO_ERROR, NON_SPECIFIC_ERROR, TRACK_NOT_SUPPORTED, READ_ERROR, PARITY_ERROR, LRC_ERROR, NO_DATA, NO_STRIPE

Interface MSRTrackData

Field Summary

Method Summary

Field Detail

TRACK_NO_0

TRACK_NO_1

TRACK_NO_2

NO_ERROR

NON_SPECIFIC_ERROR

TRACK_NOT_SUPPORTED

READ_ERROR

PARITY_ERROR

LRC_ERROR

NO_DATA

NO_STRIPE

Method Detail

getTrackData

getTrackError