ej.hoka.http.support

Class ParameterizedArgument

java.lang.Object

ej.hoka.http.support.CharacterSeparatedList

ej.hoka.http.support.ParameterizedArgument

Direct Known Subclasses:

ContentType, QualityArgument

public abstract class ParameterizedArgument
extends CharacterSeparatedList

Generic parser for parameterized arguments.

Example:

 text/xml ; charset=toto
 text/xml; q=0.2
 gzip; q=0.2
 

Field Summary

Fields

Modifier and Type	Field and Description
protected String	argument Current argument.
static char	PARAMETER_SEP Separator for the parameters: ';'.
static char	TOKEN_SEP Separator for the tokens: '='.

Fields inherited from class ej.hoka.http.support.CharacterSeparatedList

CR, currentString, HT, LF, separator, SP

Constructor Summary

Constructors

Constructor and Description
ParameterizedArgument() Creates a new instance of ParameterizedArgument with the default separator character of semicolon (";").

Method Summary

Modifier and Type	Method and Description
StringBuilder	generate(StringBuilder sb) Appends the current argument to the StringBuffer sb.
String	getArgument() Returns current argument.
protected abstract void	initializeNbParameters(int nbParameters) Initialize the number of parameters to read for this argument.
protected void	initializeNbTokens(int nbTokens) Initialize the number of tokens.
protected abstract void	newParameter(int id, int startKey, int stopKey, int startValue, int stopValue) Reads a new parameter.
protected void	newToken(int id, int start, int stop) Adds a new token to the array of tokens.

Methods inherited from class ej.hoka.http.support.CharacterSeparatedList

endParse, parse, parse

Methods inherited from class java.lang.Object

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

Field Detail

argument

@Nullable
protected String argument

Current argument.

PARAMETER_SEP

public static final char PARAMETER_SEP

Separator for the parameters: ';'.

See Also:

Constant Field Values

TOKEN_SEP

public static final char TOKEN_SEP

Separator for the tokens: '='.

See Also:

Constant Field Values

Constructor Detail

ParameterizedArgument

public ParameterizedArgument()

Creates a new instance of ParameterizedArgument with the default separator character of semicolon (";").

Method Detail

generate

public StringBuilder generate(StringBuilder sb)

Appends the current argument to the StringBuffer sb.

Specified by:

generate in class CharacterSeparatedList

Parameters:

sb - the StringBuffer to append the argument

Returns:

the StringBuffer with the appended argument.

getArgument

@Nullable
public String getArgument()

Returns current argument.

Returns:

current argument

initializeNbParameters

protected abstract void initializeNbParameters(int nbParameters)

Initialize the number of parameters to read for this argument. Subclasses should override this abstract method.

Parameters:

nbParameters - the number of parameters

initializeNbTokens

protected void initializeNbTokens(int nbTokens)

Initialize the number of tokens.

Specified by:

initializeNbTokens in class CharacterSeparatedList

Parameters:

nbTokens - the number of tokens this instance can handle.

newParameter

protected abstract void newParameter(int id,
                                     int startKey,
                                     int stopKey,
                                     int startValue,
                                     int stopValue)

Reads a new parameter. A key-value pair is parsed from the current string argument. The key part will be a substring from index startKey to index stopKey. The value part will be the substring from index startValue to index stopValue.

Parameters:

id - id for this parameter

startKey - the start index of searching the key substring in current argument

stopKey - the stop index of searching the key substring in current argument

startValue - start index of searching the value substring in current argument

stopValue - stop index of searching the value substring in current argument

See Also:

ContentType.newParameter(int, int, int, int, int), QualityArgument.newParameter(int, int, int, int, int)

newToken

protected void newToken(int id,
                        int start,
                        int stop)

Adds a new token to the array of tokens. The search will begin from the index start to the index stop.

Specified by:

newToken in class CharacterSeparatedList

Parameters:

id - the ID of the token

start - start index of parameter search in the current string

stop - end index of parameter search in the current string