com.identityx.auth.def.IHttpRequest Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of daon-http-digest-auth Show documentation

Client library used for adding authentication to http messages as required by IdentityX Rest Services

There is a newer version: 5.6.0.2

Show newest version

/*
* Copyright Daon.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*     http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/

package com.identityx.auth.def;

import java.util.Map;

import com.identityx.auth.impl.HttpMethod;

public interface IHttpRequest {

    /**
     * Returns the request's headers.  Never null.
     *
     * @return the request's headers.  Never null.
     * @see #getHeader(String)
     */
    public Map getHeaders();

    /**
     * Returns the first available value for the request header with the specified name, or {@code null} if the header
     * does not exist.
     *
     * If there is more than one value, only the first will be returned and any subsequent values will be omitted.
     * If you believe a header will have multiple values, use {@link #getHeaders() getHeaders()} instead.
     *
     * @param headerName the name of the header to inspect
     * @return the first available value for the request header with the specified name, or {@code null} if the header
     *         does not exist.
     */
    public String getHeader(String headerName);

    /**
     * Returns the request method.
     *
     * @return the request method.
     */
    public HttpMethod getMethod();

    /**
     * Returns the request parameters.
     *
     * @return the request parameters.
     */
    public Map getParameters();

    /**
     * Returns the first available value of the request parameter with the specified name or {@code null} if the
     * parameter does not exist.
     *
     * @param parameterName the name of the parameter to look up
     * @return the first available value of the request parameter with the specified name or {@code null} if the
     *         parameter does not exist.
     * @since 1.0.RC2
     */
    public String getParameter(String parameterName);

    /**
     * Returns the request query parameter String, or {@code null} if there is no URI query parameter component.
     *
     * @return the request query parameter String, or {@code null} if there is no URI query parameter component.
     */
    public String getQueryParameters();

}