All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.signalfx.shaded.jetty.websocket.api.UpgradeResponse Maven / Gradle / Ivy

//
//  ========================================================================
//  Copyright (c) 1995-2022 Mort Bay Consulting Pty Ltd and others.
//  ------------------------------------------------------------------------
//  All rights reserved. This program and the accompanying materials
//  are made available under the terms of the Eclipse Public License v1.0
//  and Apache License v2.0 which accompanies this distribution.
//
//      The Eclipse Public License is available at
//      http://www.eclipse.org/legal/epl-v10.html
//
//      The Apache License v2.0 is available at
//      http://www.opensource.org/licenses/apache2.0.php
//
//  You may elect to redistribute this code under either of these licenses.
//  ========================================================================
//

package com.signalfx.shaded.jetty.websocket.api;

import java.io.IOException;
import java.util.List;
import java.util.Map;
import java.util.Set;

import com.signalfx.shaded.jetty.websocket.api.extensions.ExtensionConfig;

/**
 * The HTTP Upgrade to WebSocket Response
 */
public interface UpgradeResponse
{
    /**
     * Add a header value to the response.
     *
     * @param name the header name
     * @param value the header value
     */
    void addHeader(String name, String value);

    /**
     * Get the accepted WebSocket protocol.
     *
     * @return the accepted WebSocket protocol.
     */
    String getAcceptedSubProtocol();

    /**
     * Get the list of extensions that should be used for the websocket.
     *
     * @return the list of negotiated extensions to use.
     */
    List getExtensions();

    /**
     * Get a header value
     *
     * @param name the header name
     * @return the value (null if header doesn't exist)
     */
    String getHeader(String name);

    /**
     * Get the header names
     *
     * @return the set of header names
     */
    Set getHeaderNames();

    /**
     * Get the headers map
     *
     * @return the map of headers
     */
    Map> getHeaders();

    /**
     * Get the multi-value header value
     *
     * @param name the header name
     * @return the list of values (null if header doesn't exist)
     */
    List getHeaders(String name);

    /**
     * Get the HTTP Response Status Code
     *
     * @return the status code
     */
    int getStatusCode();

    /**
     * Get the HTTP Response Status Reason
     *
     * @return the HTTP Response status reason
     */
    String getStatusReason();

    /**
     * Test if upgrade response is successful.
     * 

* Merely notes if the response was sent as a WebSocket Upgrade, * or was failed (resulting in no upgrade handshake) * * @return true if upgrade response was generated, false if no upgrade response was generated * @deprecated this has no replacement, will be removed in Jetty 10 */ @Deprecated boolean isSuccess(); /** * Issue a forbidden upgrade response. *

* This means that the websocket endpoint was valid, but the conditions to use a WebSocket resulted in a forbidden * access. *

* Use this when the origin or authentication is invalid. * * @param message the short 1 line detail message about the forbidden response * @throws IOException if unable to send the forbidden */ void sendForbidden(String message) throws IOException; /** * Set the accepted WebSocket Protocol. * * @param protocol the protocol to list as accepted */ void setAcceptedSubProtocol(String protocol); /** * Set the list of extensions that are approved for use with this websocket. *

* Notes: *

    *
  • Per the spec you cannot add extensions that have not been seen in the {@link UpgradeRequest}, just remove * entries you don't want to use
  • *
  • If this is unused, or a null is passed, then the list negotiation will follow default behavior and use the * complete list of extensions that are * available in this WebSocket server implementation.
  • *
* * @param extensions the list of extensions to use. */ void setExtensions(List extensions); /** * Set a header *

* Overrides previous value of header (if set) * * @param name the header name * @param value the header value */ void setHeader(String name, String value); /** * Set the HTTP Response status code * * @param statusCode the status code */ void setStatusCode(int statusCode); /** * Set the HTTP Response status reason phrase *

* Note, not all implementation of UpgradeResponse can support this feature * * @param statusReason the status reason phrase */ void setStatusReason(String statusReason); /** * Set the success of the upgrade response. *

* * @param success true to indicate a response to the upgrade handshake was sent, false to indicate no upgrade * response was sent * @deprecated this has no replacement, will be removed in Jetty 10 */ @Deprecated void setSuccess(boolean success); }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy