opensim/OpenSim/Framework/Servers/HttpServer/OSHttpServer/IHttpRequest.cs

using System;
using System.Collections.Specialized;
using System.IO;
using System.Net;
using OSHttpServer.Exceptions;

namespace OSHttpServer
{
    /// <summary>
    /// Contains server side HTTP request information.
    /// </summary>
    public interface IHttpRequest
    {
        /// <summary>
        /// Gets kind of types accepted by the client.
        /// </summary>
        string[] AcceptTypes { get; }

        uint ID {get; }
        /// <summary>
        /// Gets or sets body stream.
        /// </summary>
        Stream Body { get; set; }

        /// <summary>
        /// Gets or sets kind of connection used for the session.
        /// </summary>
        ConnectionType Connection { get; set; }

        IHttpClientContext Context { get; }

        /// <summary>
        /// Gets or sets number of bytes in the body.
        /// </summary>
        int ContentLength { get; set; }

        /// <summary>
        /// Gets cookies that was sent with the request.
        /// </summary>
        RequestCookies Cookies { get; }

        /// <summary>
        /// Gets form parameters.
        /// </summary>
        //HttpForm Form { get; }

        /// <summary>
        /// Gets headers sent by the client.
        /// </summary>
        NameValueCollection Headers { get; }

        /// <summary>
        /// Gets or sets version of HTTP protocol that's used. 
        /// </summary>
        /// <remarks>
        /// Probably <see cref="HttpHelper.HTTP10"/> or <see cref="HttpHelper.HTTP11"/>.
        /// </remarks>
        /// <seealso cref="HttpHelper"/>
        string HttpVersion { get; set; }

        /// <summary>
        /// Gets whether the request was made by Ajax (Asynchronous JavaScript)
        /// </summary>
        bool IsAjax { get; }

        /// <summary>
        /// Gets or sets requested method.
        /// </summary>
        /// <remarks>
        /// Will always be in upper case.
        /// </remarks>
        /// <see cref="Method"/>
        string Method { get; set; }

        /*
        /// <summary>
        /// Gets parameter from <see cref="QueryString"/> or <see cref="Form"/>.
        /// </summary>
        HttpParam Param { get; }
        */

        /// <summary>
        /// Gets variables sent in the query string
        /// </summary>
        NameValueCollection QueryString { get; }

        /// <summary>
        /// Gets or sets requested URI.
        /// </summary>
        Uri Uri { get; set; }

        /// <summary>
        /// Gets or sets path and query.
        /// </summary>
        /// <see cref="Uri"/>
        /// <remarks>
        /// Are only used during request parsing. Cannot be set after "Host" header have been
        /// added.
        /// </remarks>
        string UriPath { get; set; }

        /// <summary>
        /// Called during parsing of a <see cref="IHttpRequest"/>.
        /// </summary>
        /// <param name="name">Name of the header, should not be URL encoded</param>
        /// <param name="value">Value of the header, should not be URL encoded</param>
        /// <exception cref="BadRequestException">If a header is incorrect.</exception>
        void AddHeader(string name, string value);

        /// <summary>
        /// Add bytes to the body
        /// </summary>
        /// <param name="bytes">buffer to read bytes from</param>
        /// <param name="offset">where to start read</param>
        /// <param name="length">number of bytes to read</param>
        /// <returns>Number of bytes actually read (same as length unless we got all body bytes).</returns>
        /// <exception cref="InvalidOperationException">If body is not writable</exception>
        /// <exception cref="ArgumentNullException"><c>bytes</c> is null.</exception>
        /// <exception cref="ArgumentOutOfRangeException"><c>offset</c> is out of range.</exception>
        int AddToBody(byte[] bytes, int offset, int length);

        /// <summary>
        /// Clear everything in the request
        /// </summary>
        void Clear();

        /// <summary>
        /// Decode body into a form.
        /// </summary>
        /// <param name="providers">A list with form decoders.</param>
        /// <exception cref="InvalidDataException">If body contents is not valid for the chosen decoder.</exception>
        /// <exception cref="InvalidOperationException">If body is still being transferred.</exception>
        //void DecodeBody(FormDecoderProvider providers);

        /// <summary>
        /// Sets the cookies.
        /// </summary>
        /// <param name="cookies">The cookies.</param>
        void SetCookies(RequestCookies cookies);

        IPEndPoint LocalIPEndPoint { get; }
        IPEndPoint RemoteIPEndPoint { get; }
        double ArrivalTS { get; set; }
    }
}