001package com.nimbusds.oauth2.sdk;
002
003
004import java.net.URI;
005
006import com.nimbusds.oauth2.sdk.http.HTTPRequest;
007
008
009/**
010 * Request message, serialises to an HTTP request.
011 */
012public interface Request extends Message {
013
014
015        /**
016         * Gets the URI of the endpoint (HTTP or HTTPS) for which the request 
017         * is intended.
018         * 
019         * @return The endpoint URI, {@code null} if not specified.
020         */
021        public URI getEndpointURI();
022        
023        
024        /**
025         * Returns the matching HTTP request.
026         *
027         * @return The HTTP request.
028         *
029         * @throws SerializeException If the request message couldn't be
030         *                            serialised to an HTTP request.
031         */
032        public HTTPRequest toHTTPRequest() 
033                throws SerializeException;
034}
035
036