Main Page | Class Hierarchy | Alphabetical List | Class List | File List | Class Members | File Members | Related Pages

HttpTokens Class Reference

Inheritance diagram for HttpTokens:

IWritable HttpHeaders HttpParams HttpMutableHeaders HttpMutableParams List of all members.

Public Member Functions

 this (char seperator, bool inclusive=false)
 this (HttpTokens source)
void parse (IBuffer input)
void parse (char[] content)
void reset ()
bool isParsed ()
void setParsed (bool parsed)
char[] get (char[] name)
int getInt (char[] name)
long getDate (char[] name)
int opApply (int(*dg)(inout HttpToken))
void write (IWriter writer)
private bool split (Token t, inout HttpToken element)
FilteredTokens createFilter (char[] match)
char[] toOutputString ()

Static Public Member Functions

 this ()

Protected Member Functions

void setOutputBuffer (IBuffer output)
IBuffer getOutputBuffer ()
void add (char[] name, void(*dg)(IBuffer))
void add (char[] name, char[] value)
void addInt (char[] name, int value)
void addDate (char[] name, long value)

Protected Attributes

TokenStack stack

Private Attributes

IBuffer input
IBuffer output
bool parsed
bool inclusive
char seperator
char[1] sepString

Static Private Attributes

char[] emptyString

Detailed Description

Maintains a set of HTTP tokens. These tokens include headers, query- parameters, and anything else vaguely similar. Both input and output are supported, though a subclass may choose to expose as read-only.

All tokens are mapped directly onto a buffer, so there is no memory allocation or copying involved.

Note that this class does not support deleting tokens. Supporting such operations require a different approach, such as mapping the tokens into a temporary buffer, and then setting token content in the stack to be null when it is deleted. This could be implemented as a wrapper upon the subclasses of HttpToken.

Definition at line 78 of file HttpTokens.d.


Member Function Documentation

this  )  [inline, static]
 

Setup an empty character array for later assignment.

Reimplemented in HttpHeaders, HttpHeaders, HttpParams, and HttpParams.

Definition at line 96 of file HttpTokens.d.

References emptyString.

this char  seperator,
bool  inclusive = false
[inline]
 

Construct a set of tokens based upon the given delimeter, and an indication of whether said delimeter should be considered part of the left side (effectively the name).

The latter is useful with headers, since the seperating ':' character should really be considered part of the name for purposes of subsequent token matching.

Definition at line 113 of file HttpTokens.d.

References inclusive, seperator, sepString, and TokenStack.

this HttpTokens  source  )  [inline]
 

Clone a source set of HttpTokens

Definition at line 133 of file HttpTokens.d.

References TokenStack::clone(), inclusive, seperator, and sepString.

void parse IBuffer  input  ) 
 

Read all tokens. Everything is mapped rather than being allocated & copied

Reimplemented in HttpHeaders, and HttpParams.

Referenced by parse().

void parse char[]  content  )  [inline]
 

Parse an input string.

Definition at line 159 of file HttpTokens.d.

References parse(), and IBuffer::setValidContent().

void reset  )  [inline]
 

Reset this set of tokens.

Definition at line 171 of file HttpTokens.d.

References IBuffer::clear(), and TokenStack::reset().

Referenced by HttpRequest::reset(), and HttpClient::reset().

bool isParsed  )  [inline]
 

Have tokens been parsed yet?

Definition at line 187 of file HttpTokens.d.

Referenced by HttpRequest::getInputParameters().

void setParsed bool  parsed  )  [inline]
 

Indicate whether tokens have been parsed or not.

Definition at line 198 of file HttpTokens.d.

Referenced by HttpParams::parse(), and HttpHeaders::parse().

char [] get char[]  name  )  [inline]
 

Return the value of the provided header, or null if the header does not exist

Definition at line 210 of file HttpTokens.d.

References TokenStack::findToken(), split(), and HttpToken::value.

Referenced by AdminServlet::addLogger(), getDate(), getInt(), AdminServlet::service(), and AdminServlet::setLoggerLevel().

int getInt char[]  name  )  [inline]
 

Return the integer value of the provided header, or -1 if the header does not exist

Definition at line 230 of file HttpTokens.d.

References get().

Referenced by AdminServlet::addLogger().

long getDate char[]  name  )  [inline]
 

Return the date value of the provided header, or -1 if the header does not exist

Definition at line 246 of file HttpTokens.d.

References get().

int opApply int(*  dg)(inout HttpToken)  )  [inline]
 

Iterate over the set of tokens

Definition at line 261 of file HttpTokens.d.

References split().

void write IWriter  writer  )  [inline]
 

Output the token list to the provided writer

Reimplemented from IWritable.

Definition at line 282 of file HttpTokens.d.

References IWriter::cr(), and IWriter::put().

private bool split Token  t,
inout HttpToken  element
[inline]
 

split basic token into an HttpToken

Definition at line 298 of file HttpTokens.d.

References emptyString, inclusive, seperator, and Token::toString().

Referenced by get(), HttpTokens::FilteredTokens::opApply(), and opApply().

FilteredTokens createFilter char[]  match  )  [inline]
 

Create a filter for iterating over the tokens matching a particular name.

Definition at line 329 of file HttpTokens.d.

void setOutputBuffer IBuffer  output  )  [inline, protected]
 

Set the output buffer for adding tokens to. This is used by the various MutableXXXX classes.

Definition at line 398 of file HttpTokens.d.

IBuffer getOutputBuffer  )  [inline, protected]
 

Return the buffer used for output.

Reimplemented in HttpMutableHeaders.

Definition at line 409 of file HttpTokens.d.

char [] toOutputString  )  [inline]
 

Return a char[] representing the output. An empty array is returned if output was not configured.

Definition at line 421 of file HttpTokens.d.

References IBuffer::toString().

void add char[]  name,
void(*  dg)(IBuffer)
[inline, protected]
 

Add a token with the given name. The content is provided via the specified delegate. We stuff this name & content into the output buffer, and map a new Token onto the appropriate buffer slice.

Definition at line 439 of file HttpTokens.d.

References IBuffer::append(), IBuffer::getLimit(), inclusive, TokenStack::push(), sepString, and IBuffer::toString().

Referenced by add(), addDate(), and addInt().

void add char[]  name,
char[]  value
[inline, protected]
 

Add a simple name/value pair to the output

Reimplemented in HttpMutableParams.

Definition at line 465 of file HttpTokens.d.

References add(), and IBuffer::append().

void addInt char[]  name,
int  value
[inline, protected]
 

Add a name/integer pair to the output

Reimplemented in HttpMutableParams.

Definition at line 481 of file HttpTokens.d.

References add().

void addDate char[]  name,
long  value
[inline, protected]
 

Add a name/date(long) pair to the output

Reimplemented in HttpMutableParams.

Definition at line 495 of file HttpTokens.d.

References add(), and date.


Member Data Documentation

TokenStack stack [protected]
 

Definition at line 80 of file HttpTokens.d.

Referenced by HttpTokens::FilteredTokens::opApply().

IBuffer input [private]
 

Definition at line 82 of file HttpTokens.d.

IBuffer output [private]
 

Definition at line 82 of file HttpTokens.d.

bool parsed [private]
 

Definition at line 84 of file HttpTokens.d.

bool inclusive [private]
 

Definition at line 85 of file HttpTokens.d.

Referenced by add(), split(), and this().

char seperator [private]
 

Definition at line 86 of file HttpTokens.d.

Referenced by split(), and this().

char [1] sepString [private]
 

Definition at line 87 of file HttpTokens.d.

Referenced by add(), and this().

char [] emptyString [static, private]
 

Definition at line 88 of file HttpTokens.d.

Referenced by split(), and this().


The documentation for this class was generated from the following file:
Generated on Sun Nov 7 19:07:04 2004 for Mango by doxygen 1.3.6