WildFly Full 29 Model Reference

  1. home
  2. subsystem=undertow
  3. servlet-container

A servlet container

Children (3)

Provided capabilities(1)

Name Dynamic Other provider points
org.wildfly.undertow.servlet-container true

none

Attributes (21)

  • allow-non-standard-wrappers If true then request and response wrappers that do not extend the standard wrapper classes can be used
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • allow-orphan-session Indicates whether session creation should be permitted after a response-closing operation, e.g. HttpServletResponse.sendRedirect(...). Enabling this behavior is generally discouraged, as the created session will be unreferenceable.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • default-buffer-cache The buffer cache to use for caching static resources
    • Attribute Value
    Default Value default
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • default-cookie-version The default cookie version servlet applications will send
  • default-encoding Default encoding to use for all deployed applications
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • default-session-timeout The default session timeout (in minutes) for all applications deployed in the container.
    • Attribute Value
    Default Value 30
    Type INT
    Nillable true
    Expressions Allowed true
    Unit MINUTES
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • directory-listing If directory listing should be enabled for default servlets.
    • Attribute Value
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • disable-caching-for-secured-pages If Undertow should set headers to disable caching for secured paged. Disabling this can cause security problems, as sensitive pages may be cached by an intermediary.
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • disable-file-watch-service If this is true then the file watch service will not be used to monitor exploded deployments for changes
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • disable-session-id-reuse If this is true then an unknown session ID will never be reused, and a new session id will be generated. If this is false then it will be re-used if and only if it is present in the session manager of another deployment, to allow the same session id to be shared between applications on the same server.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • eager-filter-initialization If true undertow calls filter init() on deployment start rather than when first requested.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • file-cache-max-file-size The maximum size of a file that will be cached in the file cache
    • Attribute Value
    Default Value 10485760
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • file-cache-metadata-size The maximum number of files that will have their metadata cached
    • Attribute Value
    Default Value 100
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • file-cache-time-to-live The length of time in ms an item will stay cached. By default this is 2000 for exploded deployments, and -1 (infinite) for archive deployments
    • Attribute Value
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • ignore-flush Ignore flushes on the servlet output stream. In most cases these just hurt performance for no good reason.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • max-sessions The maximum number of sessions that can be active at one time
    • Attribute Value
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • preserve-path-on-forward If this is true Undertow will reset request path, URL and URI information to original values after forward.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • proactive-authentication If proactive authentication should be used. If this is true a user will always be authenticated if credentials are present.
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • session-id-length The length of the generated session ID. Longer session ID's are more secure. This number refers to the number of bytes of randomness that are used to generate the session ID, the actual ID that is sent to the client will be base64 encoded so will be approximately 33% larger (e.g. a session id length of 30 will result in a cookie value of length 40).
    • Attribute Value
    Default Value 30
    Type INT
    Nillable true
    Expressions Allowed true
    Min 16
    Max 200
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • stack-trace-on-error If an error page with the stack trace should be generated on error. Values are all, none and local-only
    • Attribute Value
    Default Value local-only
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Allowed Values none
    local-only
    all
  • use-listener-encoding Use encoding defined on listener
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services

Operations (2)

  • add Adds a servlet container
    Request Parameter Type Required Expressions Allowed Default value Description
    allow-non-standard-wrappers BOOLEAN false true false If true then request and response wrappers that do not extend the standard wrapper classes can be used
    allow-orphan-session BOOLEAN false true false Indicates whether session creation should be permitted after a response-closing operation, e.g. HttpServletResponse.sendRedirect(...). Enabling this behavior is generally discouraged, as the created session will be unreferenceable.
    default-buffer-cache STRING false true default The buffer cache to use for caching static resources
    default-cookie-version INT false true 0 The default cookie version servlet applications will send
    default-encoding STRING false true Default encoding to use for all deployed applications
    default-session-timeout INT false true 30 The default session timeout (in minutes) for all applications deployed in the container.
    directory-listing BOOLEAN false true If directory listing should be enabled for default servlets.
    disable-caching-for-secured-pages BOOLEAN false true true If Undertow should set headers to disable caching for secured paged. Disabling this can cause security problems, as sensitive pages may be cached by an intermediary.
    disable-file-watch-service BOOLEAN false true false If this is true then the file watch service will not be used to monitor exploded deployments for changes
    disable-session-id-reuse BOOLEAN false true false If this is true then an unknown session ID will never be reused, and a new session id will be generated. If this is false then it will be re-used if and only if it is present in the session manager of another deployment, to allow the same session id to be shared between applications on the same server.
    eager-filter-initialization BOOLEAN false true false If true undertow calls filter init() on deployment start rather than when first requested.
    file-cache-max-file-size INT false true 10485760 The maximum size of a file that will be cached in the file cache
    file-cache-metadata-size INT false true 100 The maximum number of files that will have their metadata cached
    file-cache-time-to-live INT false true The length of time in ms an item will stay cached. By default this is 2000 for exploded deployments, and -1 (infinite) for archive deployments
    ignore-flush BOOLEAN false true false Ignore flushes on the servlet output stream. In most cases these just hurt performance for no good reason.
    max-sessions INT false true The maximum number of sessions that can be active at one time
    preserve-path-on-forward BOOLEAN false true false If this is true Undertow will reset request path, URL and URI information to original values after forward.
    proactive-authentication BOOLEAN false true true If proactive authentication should be used. If this is true a user will always be authenticated if credentials are present.
    session-id-length INT false true 30 The length of the generated session ID. Longer session ID's are more secure. This number refers to the number of bytes of randomness that are used to generate the session ID, the actual ID that is sent to the client will be base64 encoded so will be approximately 33% larger (e.g. a session id length of 30 will result in a cookie value of length 40).
    stack-trace-on-error STRING false true local-only If an error page with the stack trace should be generated on error. Values are all, none and local-only
    use-listener-encoding BOOLEAN false true false Use encoding defined on listener
  • remove Removes a servlet container