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