org.jscsi.target.settings.entry

Class NumericalRangeEntry

java.lang.Object

org.jscsi.target.settings.entry.Entry

org.jscsi.target.settings.entry.NumericalRangeEntry

public final class NumericalRangeEntry
extends Entry

An Entry sub-class used for negotiating integer parameters which require the iSCSI initiator to offer an interval from which the target must choose the final value. Thereby the key=value format differs from that required by the NumericalEntry class, for which value is a single integer. The value part expected by this class looks like 1024~2048, however the response value will again be a single integer from the given range.

Currently this Entry sub-class is only used for two parameters - IFMarkInt and OFMarkInt. However, since the jSCSI Target does not support stream markers ( IFMarker=No and OFMarker=No), the correct response value to IFMarkInt and OFMarkInt keys must be Irrelevant. This behavior is part of the Entry.negotiate(org.jscsi.target.TargetServer, org.jscsi.parser.login.LoginStage, boolean, boolean, String, String, java.util.Collection) method, which will lead to correct responses without having to check for additional constraints (the presence and value of IFMarker and OFMarker key=value pairs.

Author:

Andreas Ergenzinger

Field Summary

Fields inherited from class org.jscsi.target.settings.entry.Entry

alreadyNegotiated, keySet, negotiationStatus, negotiationType, use, value

Constructor Summary

Constructors

Constructor and Description
NumericalRangeEntry(KeySet keySet, Use use, NegotiationStatus negotiationStatus, int negotiationValue, NumericalValueRange protocolValueRange, Object defaultValue) The NumericalRangeEntry constructor.

Method Summary

Methods

Modifier and Type	Method and Description
Entry	copy() Returns an exact copy of this Entry.
Integer	getIntegerValue() Returns the negotiated (or default) value as an Integer.
protected boolean	inProtocolValueRange(Object values) This method is used for checking if a sub-class-specific Object, representing a single, a range, or a list of values sent by the initiator, is illegal, according to the iSCSI standard.
protected Object	parseOffer(TargetServer target, String values) Parses the passed String parameter and returns a sub-class-specific Object which represents the the specified value part a key=value pair.
protected void	processDeclaration(Object values) Receives a sub-class-specific Object, representing a legal parameter value declared by the initiator and accepts it as the new Entry.value.
protected String	processNegotiation(Object values) Receives a sub-class-specific Object, representing a list, a range, or a single legal parameter value offered by the initiator and tries to select a value from that offer.

Methods inherited from class org.jscsi.target.settings.entry.Entry

checkAccepted, getBooleanValue, getNegotiationStatus, getStringValue, matchKey, negotiate, resetAlreadyNegotiated

Methods inherited from class java.lang.Object

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

Constructor Detail

NumericalRangeEntry

public NumericalRangeEntry(KeySet keySet,
                   Use use,
                   NegotiationStatus negotiationStatus,
                   int negotiationValue,
                   NumericalValueRange protocolValueRange,
                   Object defaultValue)

The NumericalRangeEntry constructor.

Parameters:

keySet - contains all relevant keys

use - determines under which circumstances the parameter may be negotiated

negotiationStatus - indicates whether there is a default value or if the parameter must be negotiated

negotiationValue - the value the jSCSI Target would like to use

protocolValueRange - specifies the boundaries into which any RFC-conform value range proposed by the iSCSI initiator must fall

defaultValue - the default value or null

Method Detail

inProtocolValueRange

protected boolean inProtocolValueRange(Object values)

Description copied from class: Entry

This method is used for checking if a sub-class-specific Object, representing a single, a range, or a list of values sent by the initiator, is illegal, according to the iSCSI standard.

Specified by:

inProtocolValueRange in class Entry

Parameters:

values - a sub-class-specific Object, representing a single, a range, or a list of values sent by the initiator

Returns:

false if the iSCSI standard has been violated, true if not

parseOffer

protected Object parseOffer(TargetServer target,
                String values)

Description copied from class: Entry

Parses the passed String parameter and returns a sub-class-specific Object which represents the the specified value part a key=value pair.

Specified by:

parseOffer in class Entry

values - the value part of a key=value pair

Returns:

sub-class-specific Object or null if the parameter violated the expected format

processDeclaration

protected void processDeclaration(Object values)

Description copied from class: Entry

Receives a sub-class-specific Object, representing a legal parameter value declared by the initiator and accepts it as the new Entry.value.

Specified by:

processDeclaration in class Entry

Parameters:

values - sub-class-specific representation of a single value declared by the initiator

processNegotiation

protected String processNegotiation(Object values)

Description copied from class: Entry

Receives a sub-class-specific Object, representing a list, a range, or a single legal parameter value offered by the initiator and tries to select a value from that offer. If none of the offered values is supported by the jSCSI Target, null is returned, otherwise the selection is accepted as the new Entry.value and returned as a String. Entry.value.

Specified by:

processNegotiation in class Entry

Parameters:

values - a sub-class-specific Object, representing a list, a range, or a single legal parameter value offered by the initiator

Returns:

the final, negotiated value or null, if the initiator's offer does not overlap with the values supported by the jSCSI Target

getIntegerValue

public Integer getIntegerValue()

Description copied from class: Entry

Returns the negotiated (or default) value as an Integer.

Overrides:

getIntegerValue in class Entry

Returns:

the negotiated (or default) value as an Integer

copy

public Entry copy()

Description copied from class: Entry

Returns an exact copy of this Entry.

Specified by:

copy in class Entry

Returns:

a copy of this Entry.