HttpParser (Apache Tomcat 7.0.109 API Documentation)

java.lang.Object
- org.apache.tomcat.util.http.parser.HttpParser

```
public class HttpParser
extends Object
```
HTTP header value parser implementation. Parsing HTTP headers as per RFC2616 is not always as simple as it first appears. For headers that only use tokens the simple approach will normally be sufficient. However, for the other headers, while simple code meets 99.9% of cases, there are often some edge cases that make things far more complicated. The purpose of this parser is to let the parser worry about the edge cases. It provides tolerant (where safe to do so) parsing of HTTP header values assuming that wrapped header lines have already been unwrapped. (The Tomcat header processing code does the unwrapping.) Provides parsing of the following HTTP header values as per RFC 2616: - Authorization for DIGEST authentication - MediaType (used for Content-Type header) Support for additional headers will be provided as required.

Constructor Summary

Constructors
Constructor and Description

HttpParser(String relaxedPathChars, String relaxedQueryChars)

Constructors
Constructor and Description
`HttpParser(String relaxedPathChars, String relaxedQueryChars)`

Method Summary

Methods
Modifier and Type	Method and Description
`static boolean`	`isAbsolutePath(int c)`
`boolean`	`isAbsolutePathRelaxed(int c)`
`static boolean`	`isAlpha(int c)`
`static boolean`	`isControl(int c)`
`static boolean`	`isHex(int c)`
`static boolean`	`isHttpProtocol(int c)`
`static boolean`	`isNotRequestTarget(int c)`
`boolean`	`isNotRequestTargetRelaxed(int c)`
`static boolean`	`isNumeric(int c)`
`static boolean`	`isQuery(int c)`
`boolean`	`isQueryRelaxed(int c)`
`static boolean`	`isToken(int c)`
`static boolean`	`isUserInfo(int c)`
`static Map<String,String>`	`parseAuthorizationDigest(StringReader input)` Parses an HTTP Authorization header for DIGEST authentication as per RFC 2617 section 3.2.2.
`static MediaType`	`parseMediaType(StringReader input)`
`static String`	`unquote(String input)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HttpParser

public HttpParser(String relaxedPathChars,
          String relaxedQueryChars)

Method Detail

parseAuthorizationDigest
```
public static Map<String,String> parseAuthorizationDigest(StringReader input)
                                                   throws IllegalArgumentException,
                                                          IOException
```
Parses an HTTP Authorization header for DIGEST authentication as per RFC 2617 section 3.2.2.

Parameters:
input - The header value to parse

Returns:
A map of directives and values as Strings or null if a parsing error occurs. Although the values returned are Strings they will have been validated to ensure that they conform to RFC 2617.

Throws:

IllegalArgumentException - If the header does not conform to RFC 2617

IOException - If an error occurs while reading the input

parseMediaType

public static MediaType parseMediaType(StringReader input)
                                throws IOException

Throws:: IOException

isNotRequestTargetRelaxed

public boolean isNotRequestTargetRelaxed(int c)

isAbsolutePathRelaxed

public boolean isAbsolutePathRelaxed(int c)

isQueryRelaxed
```
public boolean isQueryRelaxed(int c)
```

unquote

public static String unquote(String input)

isToken
```
public static boolean isToken(int c)
```

isHex
```
public static boolean isHex(int c)
```

isNotRequestTarget

public static boolean isNotRequestTarget(int c)

isHttpProtocol

public static boolean isHttpProtocol(int c)

isAlpha
```
public static boolean isAlpha(int c)
```

isNumeric

public static boolean isNumeric(int c)

isUserInfo

public static boolean isUserInfo(int c)

isAbsolutePath

public static boolean isAbsolutePath(int c)

isQuery
```
public static boolean isQuery(int c)
```

isControl

public static boolean isControl(int c)

Class HttpParser

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

HttpParser

Method Detail

parseAuthorizationDigest

parseMediaType

isNotRequestTargetRelaxed

isAbsolutePathRelaxed

isQueryRelaxed

unquote

isToken

isHex

isNotRequestTarget

isHttpProtocol

isAlpha

isNumeric

isUserInfo

isAbsolutePath

isQuery

isControl