eu.bandm.tools.util

Class PostAndUrlReader

java.lang.Object

eu.bandm.tools.util.PostAndUrlReader

public class PostAndUrlReader
extends Object

Decodes key/value pairs, as they occur in http connections, and stores them to a map. Two methods are provided, one for "get" url-encoded paremeters, one for "post" parameters which come with the "method body". Both use the same encoding mechanism, which is called "url encoding" by practioneers (because in URLs it is VISIBLE !-) Additionally there are primitive uri decoding functions which are RESTRICTED as they do not allow the encoding of syntactically relevant characters, but sufficient for our current applications.

Field Summary

Fields

Modifier and Type	Field and Description
static int	AMP
static int	BLANK
protected int	c
static int	ch_0
static int	ch_9
static int	ch_a
static int	ch_A
static int	ch_f
static int	ch_F
static Map<String,String>	emptyMap
static int	eof
static int	EQ
protected int	expected
protected InputStream	in
static int	PERC
static int	PLUS
static int	QUEST

Constructor Summary

Constructors

Constructor and Description
PostAndUrlReader()

Method Summary

Modifier and Type	Method and Description
protected int	hexdigit(int c)
Map<String,String>	read(InputStream in, int maxNum) Decodes key/value pairs from an http connection message body, as with a "post" method, and stores them to a map.
protected void	readC()
protected void	readCC()
Map<String,String>	readUrl(String url) Decodes key/value pairs from an http connection url value, as with the "get" method, and stores them to a map.

Methods inherited from class java.lang.Object

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

Field Detail

QUEST

public static final int QUEST

See Also:

Constant Field Values

BLANK

public static final int BLANK

See Also:

Constant Field Values

PERC

public static final int PERC

See Also:

Constant Field Values

PLUS

public static final int PLUS

See Also:

Constant Field Values

AMP

public static final int AMP

See Also:

Constant Field Values

EQ

public static final int EQ

See Also:

Constant Field Values

ch_A

public static final int ch_A

See Also:

Constant Field Values

ch_F

public static final int ch_F

See Also:

Constant Field Values

ch_a

public static final int ch_a

See Also:

Constant Field Values

ch_f

public static final int ch_f

See Also:

Constant Field Values

ch_0

public static final int ch_0

See Also:

Constant Field Values

ch_9

public static final int ch_9

See Also:

Constant Field Values

eof

public static final int eof

See Also:

Constant Field Values

c

protected int c

expected

protected int expected

in

protected InputStream in

emptyMap

public static final Map<String,String> emptyMap

Constructor Detail

PostAndUrlReader

public PostAndUrlReader()

Method Detail

hexdigit

protected int hexdigit(int c)
                throws IOException

Throws:

IOException

readCC

protected void readCC()
               throws IOException

Throws:

IOException

readC

protected void readC()
              throws IOException

Throws:

IOException

readUrl

public Map<String,String> readUrl(String url)
                           throws IOException

Decodes key/value pairs from an http connection url value, as with the "get" method, and stores them to a map. The COMPLETE url is expected and analyzed behind the lead-in character QUEST. This may be totally absent, then an empty map is returned.

Throws:

IOException

read

public Map<String,String> read(InputStream in,
                               int maxNum)
                        throws IOException

Decodes key/value pairs from an http connection message body, as with a "post" method, and stores them to a map. The stream must be provided, and the maximum number of octets to be read. When the stream is closed or this number is reached, the map is returned as constructed so far.

Throws:

IOException