Skip to content

Commit

Permalink
Fix Jetty configuration table formatting.
Browse files Browse the repository at this point in the history
  • Loading branch information
ddeaguiar committed Jan 20, 2021
1 parent 11d7a35 commit 60b2730
Showing 1 changed file with 22 additions and 22 deletions.
44 changes: 22 additions & 22 deletions content/reference/jetty.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -12,91 +12,91 @@ ifdef::env-github,env-browser[:outfilessuffix: .adoc]

The following table lists the container options supported by Jetty.

[cols="s,d,d", options="header", grid="rows"]
[cols="m,d,d", options="header", grid="rows"]
|===
| Key | Value type | Description

| `:daemon?`
| :daemon?
| Boolean
| Use daemon threads. Defaults to `false`.

| `:max-threads`
| :max-threads
| Integer
| The maximum number of threads to use. Defaults to `50`.

| `:reuse-addr?`
| :reuse-addr?
| Boolean
| Reuse the socket address. Defaults to `true`.

| `:thread-pool`
| :thread-pool
| A link:https://www.eclipse.org/jetty/javadoc/jetty-9/org/eclipse/jetty/util/thread/ThreadPool.html[ThreadPool] instance.
| override the Jetty thread pool (ignores max-threads)

| `:configurator`
| :configurator
| Function
| A function called with the `org.eclipse.jetty.server.Server`
instance. Expected to return the Server instance. Use when advanced customization is required.

| `:context-configurator`
| :context-configurator
| Function
| A function called with the `org.eclipse.jetty.servlet.ServletContextHandler` instance. Use when advanced customization is required.

| `:ssl?`
| :ssl?
| Boolean
| Allows connections over HTTPS.

| `:ssl-port`
| :ssl-port
| Integer
| Port to use for TLS listener. Defaults to `443` and implies `:ssl?`.

| `:h2c?`
| :h2c?
| Boolean
| HTTP/2 cleartext support. Allows upgrading connections from HTTP/1.1 to the Http/2 protocol. Defaults to `true`. When `true`, `:port` must be specified. link:https://httpwg.org/specs/rfc7540.html#versioning[HTTP/2 versioning], link:https://www.eclipse.org/jetty/documentation/jetty-9/index.html#http2[Jetty HTTP/2] documentation.

| `:h2?`
| :h2?
| Boolean
| HTTP/2 TLS support. When `true`, `:ssl-port` must be specified. link:https://httpwg.org/specs/rfc7540.html#versioning[HTTP/2 versioning], link:https://www.eclipse.org/jetty/documentation/jetty-9/index.html#http2[Jetty HTTP/2] documentation.

| `:connection-factory-fns`
| :connection-factory-fns
| Vector of Functions
| A vector of functions that take the options map and
an `org.eclipse.jetty.server.HttpConfiguration` instance and return an
`org.eclipse.jetty.server.ConnectionFactory` instance. Applies only to
the SSL connection.

| `:ssl-context-factory`
| `org.eclipse.jetty.util.ssl.SslContextFactory`
| :ssl-context-factory
| An link:https://www.eclipse.org/jetty/javadoc/jetty-9/org/eclipse/jetty/util/ssl/SslContextFactory.html[SslContextFactory] instance.
| The `SSLContextFactory` instance to use when creating the server. If
specified, `:key-password`, `:keystore`, `:truststore`,
`:trust-password`, `:security-provider`, `:client-auth` are ignored.

| `:keystore`
| :keystore
| String _or_ `java.security.Keystore`
| Used for TLS. Path to keystore file _or_ a `java.security.Keystore` instance. Not used if `:ssl-context-factory` is set.

| `:key-password`
| :key-password
| String
| Used for TLS. Keystore password. Not used if `:ssl-context-factory` is set.

| `:truststore`
| :truststore
| String _or_ `java.security.Keystore`
| Used for TLS. Path to keystore file _or_ a `java.security.Keystore` instance. Not used if `:ssl-context-factory` is set.

| `:trust-password`
| :trust-password
| String
| Used for TLS. Trust store password. Not used if `:ssl-context-factory` is set.

| `:client-auth`
| :client-auth
| String
| SSL client certificate authenticate, may be set to :need,
`:want` or `:none`. Defaults to `:none`.

| `:security-provider`
| :security-provider
| String
| Java Security Provider name. Refer to the Jetty https://www.eclipse.org/jetty/documentation/jetty-9/index.html#configuring-ssl[ConfiguringSSL/TLS] documentation. Not used if `:ssl-context-factory` is set.

| `:io.pedestal.http.jetty/http-configuration`
| org.eclipse.jetty.server.HttpConfiguration
| :io.pedestal.http.jetty/http-configuration
| An link:https://www.eclipse.org/jetty/javadoc/jetty-9/org/eclipse/jetty/server/HttpConfiguration.html[HttpConfiguration] instance.
| The `HttpConfiguration` instance to use when creating the
server. Use when advanced customization is required. The default
`HttpConfiguration` is listed below.
Expand Down

0 comments on commit 60b2730

Please sign in to comment.