//
// ========================================================================
// 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();
}
}
}