Class Request

src/main/java/net/freeutils/httpserver/HTTPServer.java:1320–1567

The Request class encapsulates a single HTTP request.

     * The {@code Request} class encapsulates a single HTTP request.
     */
    public class Request {

        protected String method;
        protected URI uri;
        protected URL baseURL; // cached value
        protected String version;
        protected Headers headers;
        protected InputStream body;
        protected Map<String, String> params; // cached value
        protected VirtualHost host; // cached value
        protected VirtualHost.ContextInfo context; // cached value

        /**
         * Constructs a Request from the data in the given input stream.
         *
         * @param in the input stream from which the request is read
         * @throws IOException if an error occurs
         */
        public Request(InputStream in) throws IOException {
            readRequestLine(in);
            headers = readHeaders(in);
            // RFC2616#3.6 - if "chunked" is used, it must be the last one
            // RFC2616#4.4 - if non-identity Transfer-Encoding is present,
            // it must either include "chunked" or close the connection after
            // the body, and in any case ignore Content-Length.
            // if there is no such Transfer-Encoding, use Content-Length
            // if neither header exists, there is no body
            String header = headers.get("Transfer-Encoding");
            if (header != null && !header.toLowerCase(Locale.US).equals("identity")) {
                if (Arrays.asList(splitElements(header, true)).contains("chunked"))
                    body = new ChunkedInputStream(in, headers);
                else
                    body = in; // body ends when connection closes
            } else {
                header = headers.get("Content-Length");
                long len = header == null ? 0 : parseULong(header, 10);
                body = new LimitedInputStream(in, len, false);
            }
        }

        /**
         * Returns the request method.
         *
         * @return the request method
         */
        public String getMethod() { return method; }

        /**
         * Returns the request URI.
         *
         * @return the request URI
         */
        public URI getURI() { return uri; }

        /**
         * Returns the request version string.
         *
         * @return the request version string