org.jscsi.parser

Class InitiatorMessageParser

java.lang.Object

org.jscsi.parser.AbstractMessageParser

org.jscsi.parser.InitiatorMessageParser

Direct Known Subclasses:

DataOutParser, LoginRequestParser, LogoutRequestParser, NOPOutParser, SCSICommandParser, SNACKRequestParser, TaskManagementFunctionRequestParser, TextRequestParser

public abstract class InitiatorMessageParser
extends AbstractMessageParser

InitiatorMessageParser

This abstract class is the base class of all initiator message parsers defined in the iSCSI Protocol (RFC3720). This class defines some methods, which are common in all parsers to simplify the parsing process.

Author:

Volker Wildi

Field Summary

Fields

Modifier and Type	Field and Description
protected int	commandSequenceNumber Command Sequence Number.
protected int	expectedStatusSequenceNumber Expected Status Sequence Number.

Fields inherited from class org.jscsi.parser.AbstractMessageParser

logicalUnitNumber, protocolDataUnit

Constructor Summary

Constructors

Constructor and Description
InitiatorMessageParser(ProtocolDataUnit initProtocolDataUnit) Default constructor, creates a new, empty LogoutRequestParser object.

Method Summary

Methods

Modifier and Type	Method and Description
void	clear() This method sets all settings to their initial values.
protected void	deserializeBytes1to3(int line) Parse the bytes 1 till 3 in the Basic Header Segment.
protected void	deserializeBytes20to23(int line) Parse the bytes 20 till 23 in the Basic Header Segment.
protected void	deserializeBytes24to27(int line) Parse the bytes 24 till 27 in the Basic Header Segment.
protected void	deserializeBytes28to31(int line) Parse the bytes 28 till 31 in the Basic Header Segment.
protected void	deserializeBytes32to35(int line) Parse the bytes 32 till 35 in the Basic Header Segment.
protected void	deserializeBytes36to39(int line) Parse the bytes 36 till 39 in the Basic Header Segment.
protected void	deserializeBytes40to43(int line) Parse the bytes 40 till 43 in the Basic Header Segment.
protected void	deserializeBytes44to47(int line) Parse the bytes 44 till 47 in the Basic Header Segment.
int	getCommandSequenceNumber() Returns the Command Sequence Number of this InitiatorMessageParser object.
int	getExpectedStatusSequenceNumber() Returns the Expected Status Sequence Number of this InitiatorMessageParser object.
String	getShortInfo() Returns the short version of the used sequence numbers of this parser instance.
boolean	incrementSequenceNumber() This AbstractMessageParser instance affects the incrementation of the Command Sequence Number.
protected int	serializeBytes1to3() Serializes the bytes 1 till 3 in the Basic Header Segment.
protected int	serializeBytes20to23() Serializes the bytes 20 till 23 in the Basic Header Segment.
protected int	serializeBytes24to27() Serializes the bytes 24 till 27 in the Basic Header Segment.
protected int	serializeBytes28to31() Serializes the bytes 28 till 31 in the Basic Header Segment.
protected int	serializeBytes32to35() Serializes the bytes 32 till 35 in the Basic Header Segment.
protected int	serializeBytes36to39() Serializes the bytes 36 till 39 in the Basic Header Segment.
protected int	serializeBytes40to43() Serializes the bytes 40 till 43 in the Basic Header Segment.
protected int	serializeBytes44to47() Serializes the bytes 44 till 47 in the Basic Header Segment.
void	setCommandSequenceNumber(int initCmdSN) Sets the Command Sequence Number of this InitiatorMessageParser object to the given value.
void	setExpectedStatusSequenceNumber(int initExpStatSN) Sets the Expected Status Sequence Number of this InitiatorMessageParser object to the given value.
String	toString() This method concatenate all the fields of a derived parser to allow an easy generation of debug informations.

Methods inherited from class org.jscsi.parser.AbstractMessageParser

canContainAdditionalHeaderSegments, canHaveDigests, checkIntegrity, deserializeBytes12to15, deserializeBytes8to11, getDataSegmentFormat, getLogicalUnitNumber, serializeBytes12to15, serializeBytes8to11, setLogicalUnitNumber

Methods inherited from class java.lang.Object

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

Field Detail

commandSequenceNumber

protected int commandSequenceNumber

Command Sequence Number.

Enables ordered delivery across multiple connections in a single session.

expectedStatusSequenceNumber

protected int expectedStatusSequenceNumber

Expected Status Sequence Number.

Command responses up to expectedStatusSequenceNumber - 1 (mod 2**32) have been received (acknowledges status) on the connection.

Constructor Detail

InitiatorMessageParser

public InitiatorMessageParser(ProtocolDataUnit initProtocolDataUnit)

Default constructor, creates a new, empty LogoutRequestParser object.

Parameters:

initProtocolDataUnit - The reference ProtocolDataUnit instance, which contains this InitiatorMessageParser object.

Method Detail

getShortInfo

public String getShortInfo()

Returns the short version of the used sequence numbers of this parser instance.

Specified by:

getShortInfo in class AbstractMessageParser

Returns:

The string with all needed sequence numbers.

toString

public String toString()

This method concatenate all the fields of a derived parser to allow an easy generation of debug informations.

Overrides:

toString in class AbstractMessageParser

Returns:

The debug formatted string.

clear

public void clear()

This method sets all settings to their initial values.

Overrides:

clear in class AbstractMessageParser

incrementSequenceNumber

public boolean incrementSequenceNumber()

This AbstractMessageParser instance affects the incrementation of the Command Sequence Number.

Specified by:

incrementSequenceNumber in class AbstractMessageParser

Returns:

true, if the counter has to be incremented. Else false.

getCommandSequenceNumber

public final int getCommandSequenceNumber()

Returns the Command Sequence Number of this InitiatorMessageParser object.

Returns:

The Command Sequence Number.

getExpectedStatusSequenceNumber

public final int getExpectedStatusSequenceNumber()

Returns the Expected Status Sequence Number of this InitiatorMessageParser object.

Returns:

The Expected Status Sequence Number.

setCommandSequenceNumber

public void setCommandSequenceNumber(int initCmdSN)

Sets the Command Sequence Number of this InitiatorMessageParser object to the given value.

Parameters:

initCmdSN - The new Command Sequence Number.

setExpectedStatusSequenceNumber

public final void setExpectedStatusSequenceNumber(int initExpStatSN)

Sets the Expected Status Sequence Number of this InitiatorMessageParser object to the given value.

Parameters:

initExpStatSN - The new Expected Status Sequence Number.

deserializeBytes1to3

protected void deserializeBytes1to3(int line)
                             throws InternetSCSIException

Parse the bytes 1 till 3 in the Basic Header Segment.

Specified by:

deserializeBytes1to3 in class AbstractMessageParser

Parameters:

line - The actual line

Throws:

InternetSCSIException - If any violation of the iSCSI-Standard emerge.

deserializeBytes20to23

protected void deserializeBytes20to23(int line)
                               throws InternetSCSIException

Parse the bytes 20 till 23 in the Basic Header Segment.

Specified by:

deserializeBytes20to23 in class AbstractMessageParser

Parameters:

line - The actual line

Throws:

InternetSCSIException - If any violation of the iSCSI-Standard emerge.

deserializeBytes24to27

protected final void deserializeBytes24to27(int line)
                                     throws InternetSCSIException

Parse the bytes 24 till 27 in the Basic Header Segment.

Specified by:

deserializeBytes24to27 in class AbstractMessageParser

Parameters:

line - The actual line

Throws:

InternetSCSIException - If any violation of the iSCSI-Standard emerge.

deserializeBytes28to31

protected final void deserializeBytes28to31(int line)
                                     throws InternetSCSIException

Parse the bytes 28 till 31 in the Basic Header Segment.

Specified by:

deserializeBytes28to31 in class AbstractMessageParser

Parameters:

line - The actual line

Throws:

InternetSCSIException - If any violation of the iSCSI-Standard emerge.

deserializeBytes32to35

protected void deserializeBytes32to35(int line)
                               throws InternetSCSIException

Parse the bytes 32 till 35 in the Basic Header Segment.

Specified by:

deserializeBytes32to35 in class AbstractMessageParser

Parameters:

line - The actual line

Throws:

InternetSCSIException - If any violation of the iSCSI-Standard emerge.

deserializeBytes36to39

protected void deserializeBytes36to39(int line)
                               throws InternetSCSIException

Parse the bytes 36 till 39 in the Basic Header Segment.

Specified by:

deserializeBytes36to39 in class AbstractMessageParser

Parameters:

line - The actual line

Throws:

InternetSCSIException - If any violation of the iSCSI-Standard emerge.

deserializeBytes40to43

protected void deserializeBytes40to43(int line)
                               throws InternetSCSIException

Parse the bytes 40 till 43 in the Basic Header Segment.

Specified by:

deserializeBytes40to43 in class AbstractMessageParser

Parameters:

line - The actual line

Throws:

InternetSCSIException - If any violation of the iSCSI-Standard emerge.

deserializeBytes44to47

protected void deserializeBytes44to47(int line)
                               throws InternetSCSIException

Parse the bytes 44 till 47 in the Basic Header Segment.

Specified by:

deserializeBytes44to47 in class AbstractMessageParser

Parameters:

line - The actual line

Throws:

InternetSCSIException - If any violation of the iSCSI-Standard emerge.

serializeBytes1to3

protected int serializeBytes1to3()

Serializes the bytes 1 till 3 in the Basic Header Segment.

Specified by:

serializeBytes1to3 in class AbstractMessageParser

Returns:

The serialized byte representation.

serializeBytes20to23

protected int serializeBytes20to23()

Serializes the bytes 20 till 23 in the Basic Header Segment.

Specified by:

serializeBytes20to23 in class AbstractMessageParser

Returns:

The serialized byte representation.

serializeBytes24to27

protected int serializeBytes24to27()

Serializes the bytes 24 till 27 in the Basic Header Segment.

Specified by:

serializeBytes24to27 in class AbstractMessageParser

Returns:

The serialized byte representation.

serializeBytes28to31

protected int serializeBytes28to31()

Serializes the bytes 28 till 31 in the Basic Header Segment.

Specified by:

serializeBytes28to31 in class AbstractMessageParser

Returns:

The serialized byte representation.

serializeBytes32to35

protected int serializeBytes32to35()

Serializes the bytes 32 till 35 in the Basic Header Segment.

Specified by:

serializeBytes32to35 in class AbstractMessageParser

Returns:

The serialized byte representation.

serializeBytes36to39

protected int serializeBytes36to39()

Serializes the bytes 36 till 39 in the Basic Header Segment.

Specified by:

serializeBytes36to39 in class AbstractMessageParser

Returns:

The serialized byte representation.

serializeBytes40to43

protected int serializeBytes40to43()

Serializes the bytes 40 till 43 in the Basic Header Segment.

Specified by:

serializeBytes40to43 in class AbstractMessageParser

Returns:

The serialized byte representation.

serializeBytes44to47

protected int serializeBytes44to47()

Serializes the bytes 44 till 47 in the Basic Header Segment.

Specified by:

serializeBytes44to47 in class AbstractMessageParser

Returns:

The serialized byte representation.