Package javax.websocket.server

Class ServerEndpointConfig.Builder

  • Enclosing interface:
    ServerEndpointConfig
    public static final class ServerEndpointConfig.Builder
extends java.lang.Object
    The ServerEndpointConfig.Builder is a class used for creating ServerEndpointConfig.Builder objects for the purposes of deploying a server endpoint.

    Here are some examples:

    Building a plain configuration for an endpoint with just a path. 

     
 ServerEndpointConfig config = ServerEndpointConfig.Builder.create(ProgrammaticEndpoint.class, "/foo").build();

    Building a configuration with no subprotocols and a custom configurator. 

     
 ServerEndpointConfig config = ServerEndpointConfig.Builder.create(ProgrammaticEndpoint.class, "/bar")
         .subprotocols(subprotocols)
         .configurator(new MyServerConfigurator())
         .build();
    Author:
    dannycoward

    • Method Detail

      • create

        public static ServerEndpointConfig.Builder create​(java.lang.Class<?> endpointClass,
                                                  java.lang.String path)
        Creates the builder with the mandatory information of the endpoint class (programmatic or annotated), the relative URI or URI-template to use, and with no subprotocols, extensions, encoders, decoders or custom configurator.
        Parameters:
        endpointClass - the class of the endpoint to configure
        path - The URI or URI template where the endpoint will be deployed. A trailing "/" will be ignored and the path must begin with /.
        Returns:
        a new instance of ServerEndpointConfig.Builder

      • build

        public ServerEndpointConfig build()
        Builds the configuration object using the current attributes that have been set on this builder object.
        Returns:
        a new ServerEndpointConfig object.

      • encoders

        public ServerEndpointConfig.Builder encoders​(java.util.List<java.lang.Class<? extends Encoder>> encoders)
        Sets the list of encoder implementation classes for this builder.
        Parameters:
        encoders - the encoders
        Returns:
        this builder instance

      • decoders

        public ServerEndpointConfig.Builder decoders​(java.util.List<java.lang.Class<? extends Decoder>> decoders)
        Sets the decoder implementation classes to use in the configuration.
        Parameters:
        decoders - the decoders
        Returns:
        this builder instance.

      • subprotocols

        public ServerEndpointConfig.Builder subprotocols​(java.util.List<java.lang.String> subprotocols)
        Sets the subprotocols to use in the configuration.
        Parameters:
        subprotocols - the subprotocols.
        Returns:
        this builder instance

      • extensions

        public ServerEndpointConfig.Builder extensions​(java.util.List<Extension> extensions)
        Sets the extensions to use in the configuration.
        Parameters:
        extensions - the extensions to use.
        Returns:
        this builder instance.

      • configurator

        public ServerEndpointConfig.Builder configurator​(ServerEndpointConfig.Configurator serverEndpointConfigurator)
        Sets the custom configurator to use on the configuration object built by this builder.
        Parameters:
        serverEndpointConfigurator - the configurator
        Returns:
        this builder instance