//
// ========================================================================
// Copyright (c) 1995-2020 Mort Bay Consulting Pty Ltd and others.
//
// This program and the accompanying materials are made available under
// the terms of the Eclipse Public License 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0
//
// This Source Code may also be made available under the following
// Secondary Licenses when the conditions for such availability set
// forth in the Eclipse Public License, v. 2.0 are satisfied:
// the Apache License v2.0 which is available at
// https://www.apache.org/licenses/LICENSE-2.0
//
// SPDX-License-Identifier: EPL-2.0 OR Apache-2.0
// ========================================================================
//

package org.eclipse.jetty.http;

import java.nio.ByteBuffer;

import org.eclipse.jetty.util.Index;
import org.eclipse.jetty.util.StringUtil;

public enum HttpVersion
{
    HTTP_0_9("HTTP/0.9", 9),
    HTTP_1_0("HTTP/1.0", 10),
    HTTP_1_1("HTTP/1.1", 11),
    HTTP_2("HTTP/2.0", 20);

    public static final Index<HttpVersion> CACHE = new Index.Builder<HttpVersion>()
        .caseSensitive(false)
        .withAll(HttpVersion.values(), HttpVersion::toString)
        .build();

    
Optimised lookup to find an Http Version and whitespace in a byte array.
Params:
  • bytes – Array containing ISO-8859-1 characters
  • position – The first valid index
  • limit – The first non valid index
Returns:An HttpMethod if a match or null if no easy match.
/** * Optimised lookup to find an Http Version and whitespace in a byte array. * * @param bytes Array containing ISO-8859-1 characters * @param position The first valid index * @param limit The first non valid index * @return An HttpMethod if a match or null if no easy match. */
public static HttpVersion lookAheadGet(byte[] bytes, int position, int limit) { int length = limit - position; if (length < 9) return null; if (bytes[position + 4] == '/' && bytes[position + 6] == '.' && Character.isWhitespace((char)bytes[position + 8]) && ((bytes[position] == 'H' && bytes[position + 1] == 'T' && bytes[position + 2] == 'T' && bytes[position + 3] == 'P') || (bytes[position] == 'h' && bytes[position + 1] == 't' && bytes[position + 2] == 't' && bytes[position + 3] == 'p'))) { switch (bytes[position + 5]) { case '1': switch (bytes[position + 7]) { case '0': return HTTP_1_0; case '1': return HTTP_1_1; default: return null; } case '2': switch (bytes[position + 7]) { case '0': return HTTP_2; default: return null; } default: return null; } } return null; }
Optimised lookup to find an HTTP Version and trailing white space in a byte array.
Params:
  • buffer – buffer containing ISO-8859-1 characters
Returns:An HttpVersion if a match or null if no easy match.
/** * Optimised lookup to find an HTTP Version and trailing white space in a byte array. * * @param buffer buffer containing ISO-8859-1 characters * @return An HttpVersion if a match or null if no easy match. */
public static HttpVersion lookAheadGet(ByteBuffer buffer) { if (buffer.hasArray()) return lookAheadGet(buffer.array(), buffer.arrayOffset() + buffer.position(), buffer.arrayOffset() + buffer.limit()); return null; } private final String _string; private final byte[] _bytes; private final ByteBuffer _buffer; private final int _version; HttpVersion(String s, int version) { _string = s; _bytes = StringUtil.getBytes(s); _buffer = ByteBuffer.wrap(_bytes); _version = version; } public byte[] toBytes() { return _bytes; } public ByteBuffer toBuffer() { return _buffer.asReadOnlyBuffer(); } public int getVersion() { return _version; } public boolean is(String s) { return _string.equalsIgnoreCase(s); } public String asString() { return _string; } @Override public String toString() { return _string; }
Case insensitive fromString() conversion
Params:
  • version – the String to convert to enum constant
Returns:the enum constant or null if version unknown
/** * Case insensitive fromString() conversion * * @param version the String to convert to enum constant * @return the enum constant or null if version unknown */
public static HttpVersion fromString(String version) { return CACHE.get(version); } public static HttpVersion fromVersion(int version) { switch (version) { case 9: return HttpVersion.HTTP_0_9; case 10: return HttpVersion.HTTP_1_0; case 11: return HttpVersion.HTTP_1_1; case 20: return HttpVersion.HTTP_2; default: throw new IllegalArgumentException(); } } }