tango.net.http.HttpTokens

License:

BSD style: see license.txt

Version:

Initial release: April 2004

Author:

Kris
struct HttpToken
Struct used to expose freachable HttpToken instances.
class HttpTokens
Maintains a set of HTTP tokens. These tokens include headers, query- parameters, and anything else vaguely related. 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, per se. Instead it marks tokens as being 'unused' by setting content to null, avoiding unwarranted reshaping of the token stack. The token stack is reused as time goes on, so there's only minor runtime overhead.
this(char separator, bool inclusive = false)
Construct a set of tokens based upon the given delimiter, and an indication of whether said delimiter 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.
this(HttpTokens source)
Clone a source set of HttpTokens
void parse(InputBuffer input) [abstract]
Read all tokens. Everything is mapped rather than being allocated & copied
void parse(char[] content)
Parse an input string.
HttpTokens reset()
Reset this set of tokens.
bool isParsed()
Have tokens been parsed yet?
void setParsed(bool parsed)
Indicate whether tokens have been parsed or not.
const(char)[] get(const(char)[] name, const(char)[] ret = null)
Return the value of the provided header, or null if the header does not exist
int getInt(const(char)[] name, int ret = -1)
Return the integer value of the provided header, or the provided default-vaule if the header does not exist
Time getDate(const(char)[] name, Time date = epoch)
Return the date value of the provided header, or the provided default-value if the header does not exist
int opApply(scope int delegate(ref HttpToken) dg)
Iterate over the set of tokens
void produce(scope size_t delegate(const(void)[]) consume, const(char)[] eol = null)
Output the token list to the provided consumer
bool handleMissingSeparator(const(char)[] s, ref HttpToken element) [protected]
overridable method to handle the case where a token does not have a separator. Apparently, this can happen in HTTP usage
FilteredTokens createFilter(char[] match)
Create a filter for iterating over the tokens matching a particular name.
char[] formatTokens(OutputBuffer dst, const(char)[] delim)
these should be exposed carefully ******************
Return a char[] representing the output. An empty array is returned if output was not configured. This perhaps could just return our 'output' buffer content, but that would not reflect deletes, or seperators. Better to do it like this instead, for a small cost.
void add(const(char)[] name, scope void delegate(OutputBuffer) value) [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.
void add(const(char)[] name, const(char)[] value) [protected]
Add a simple name/value pair to the output
void addInt(const(char)[] name, size_t value) [protected]
Add a name/integer pair to the output
void addDate(const(char)[] name, Time value) [protected]
Add a name/date(long) pair to the output
bool remove(const(char)[] name) [protected]
remove a token from our list. Returns false if the named token is not found.