Interface Http1Config

All Superinterfaces:
HttpConfig, NamedService, ProtocolConfig, Prototype.Api
All Known Implementing Classes:
Http1Config.BuilderBase.Http1ConfigImpl
public interface Http1Config extends Prototype.Api, HttpConfig
HTTP/1.1 server configuration.
See Also:

  • Method Details

    • builder

      static Http1Config.Builder builder()
      Create a new fluent API builder to customize configuration.
      Returns:
      a new builder

    • builder

      static Http1Config.Builder builder(Http1Config instance)
      Create a new fluent API builder from an existing instance.
      Parameters:
      instance - an existing instance used as a base for the builder
      Returns:
      a builder based on an instance

    • create

      static Http1Config create(Config config)
      Create a new instance from configuration.
      Parameters:
      config - used to configure the new instance
      Returns:
      a new instance configured from configuration

    • create

      static Http1Config create()
      Create a new instance with default values.
      Returns:
      a new instance

    • type

      default String type()
      Protocol configuration type.
      Specified by:
      type in interface NamedService
      Returns:
      type of this configuration

    • name

      String name()
      Name of this configuration, in most cases the same as type().
      Specified by:
      name in interface NamedService
      Returns:
      name of this configuration

    • maxPrologueLength

      int maxPrologueLength()
      Maximal size of received HTTP prologue (GET /path HTTP/1.1).
      Returns:
      maximal size in bytes

    • maxHeadersSize

      int maxHeadersSize()
      Maximum size of received headers in bytes, which must be greater than 0. Defaults to 16384.

      This override preserves generated Http1Config.BuilderBase binary compatibility.

      Specified by:
      maxHeadersSize in interface HttpConfig
      Returns:
      maximum headers size

    • validatePrologue

      boolean validatePrologue()
      Disables query and fragment syntax validation when set to false; intended only for closed systems receiving trusted, valid request targets, as behavior for invalid input is unspecified. Validation of path is controlled by validatePath().
      Returns:
      whether to validate prologue query and fragment

    • validatePath

      boolean validatePath()
      Whether to validate path characters and HTTP/1.1 request-target forms.
      Returns:
      whether to validate path

    • continueImmediately

      boolean continueImmediately()
      When true WebServer answers to expect continue with 100 continue immediately, not waiting for user to actually request the data.
      Returns:
      if true answer with 100 continue immediately after expect continue

    • requestedUriDiscovery

      RequestedUriDiscoveryContext requestedUriDiscovery()
      Requested URI discovery settings.
      Returns:
      settings for computing the requested URI

    • sendListeners

      List<Http1ConnectionListener> sendListeners()
      Connection send event listeners for HTTP/1.1.
      Returns:
      send event listeners

    • receiveListeners

      List<Http1ConnectionListener> receiveListeners()
      Connection receive event listeners for HTTP/1.1.
      Returns:
      receive event listeners

    • altSvc

      default Optional<AltSvc> altSvc()
      Explicit Alt-Svc advertisement.
      Returns:
      alternative service advertisement

    • compositeSendListener

      Http1ConnectionListener compositeSendListener()
      A single send listener, this value is computed.
      Returns:
      send listener

    • compositeReceiveListener

      Http1ConnectionListener compositeReceiveListener()
      A single receive listener, this value is computed.
      Returns:
      receive listener

    • receiveLog

      @Deprecated(since="4.5.0", forRemoval=true) boolean receiveLog()
      Deprecated, for removal: This API element is subject to removal in a future version.
      use HttpConfig.log()
      Logging of received packets. Uses trace and debug levels on logger of Http1LoggingConnectionListener with suffix of .recv`.
      Returns:
      true if logging should be enabled for received packets, false if no logging should be done

    • sendLog

      @Deprecated(since="4.5.0", forRemoval=true) boolean sendLog()
      Deprecated, for removal: This API element is subject to removal in a future version.
      use HttpConfig.log()
      Logging of sent packets. Uses trace and debug levels on logger of Http1LoggingConnectionListener with suffix of .send`.
      Returns:
      true if logging should be enabled for sent packets, false if no logging should be done