/*
 * JBoss, Home of Professional Open Source.
 * Copyright 2014 Red Hat, Inc., and individual contributors
 * as indicated by the @author tags.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

package io.undertow.server.protocol.http;

import io.undertow.util.HttpString;

The current state of the tokenizer state machine. This class is mutable and not thread safe.

As the machine changes state this class is updated rather than allocating a new one each time. fields are not private to allow for efficient putfield / getfield access Fields can mean different things depending on the current state. This means that names may not always reflect complete functionality. This class is re-used for requests on the same connection.
Author:Stuart Douglas
/** * The current state of the tokenizer state machine. This class is mutable and not thread safe. * <p/> * As the machine changes state this class is updated rather than allocating a new one each time. * * fields are not private to allow for efficient putfield / getfield access * * Fields can mean different things depending on the current state. This means that names may * not always reflect complete functionality. * * This class is re-used for requests on the same connection. * * @author Stuart Douglas */
class ParseState { //parsing states public static final int VERB = 0; public static final int PATH = 1; public static final int PATH_PARAMETERS = 2; public static final int QUERY_PARAMETERS = 3; public static final int VERSION = 4; public static final int AFTER_VERSION = 5; public static final int HEADER = 6; public static final int HEADER_VALUE = 7; public static final int PARSE_COMPLETE = 8;
The actual state of request parsing
/** * The actual state of request parsing */
int state;
The current state in the tokenizer state machine.
/** * The current state in the tokenizer state machine. */
int parseState;
If this state is a prefix or terminal match state this is set to the string that is a candidate to be matched
/** * If this state is a prefix or terminal match state this is set to the string * that is a candidate to be matched */
HttpString current;
The bytes version of current
/** * The bytes version of {@link #current} */
byte[] currentBytes;
If this state is a prefix match state then this holds the current position in the string.
/** * If this state is a prefix match state then this holds the current position in the string. * */
int pos; boolean urlDecodeRequired = false;
If this is in NO_STATE.NO_STATE then this holds the current token that has been read so far.
/** * If this is in {@link io.undertow.annotationprocessor.AbstractParserGenerator#NO_STATE} then this holds the current token that has been read so far. */
final StringBuilder stringBuilder = new StringBuilder();
This has different meanings depending on the current state. In state HEADER it is a the first character of the header, that was read by HEADER_VALUE to see if this was a continuation. In state HEADER_VALUE if represents the last character that was seen.
/** * This has different meanings depending on the current state. * * In state {@link #HEADER} it is a the first character of the header, that was read by * {@link #HEADER_VALUE} to see if this was a continuation. * * In state {@link #HEADER_VALUE} if represents the last character that was seen. * */
byte leftOver;
This is used to store the next header value when parsing header key / value pairs,
/** * This is used to store the next header value when parsing header key / value pairs, */
HttpString nextHeader; String nextQueryParam; int mapCount; final StringBuilder decodeBuffer = new StringBuilder();
In general browsers will often send the same header with every request. This cache allows us to re-use the resulting strings.
/** * In general browsers will often send the same header with every request. This cache allows us to re-use the resulting * strings. */
final CacheMap<HttpString, String> headerValuesCache; ParseState(int cacheSize) { this.parseState = 0; this.pos = 0; if(cacheSize <= 0) { headerValuesCache = null; } else { headerValuesCache = new CacheMap<>(cacheSize); } } public boolean isComplete() { return state == PARSE_COMPLETE; } public final void parseComplete(){ state = PARSE_COMPLETE; } public void reset() { this.state = 0; this.parseState = 0; this.current = null; this.currentBytes = null; this.pos = 0; this.leftOver = 0; this.urlDecodeRequired = false; this.stringBuilder.setLength(0); this.nextHeader = null; this.nextQueryParam = null; this.mapCount = 0; } }