javax.servlet

## Interface Registration

- All Known Subinterfaces:
    FilterRegistration, FilterRegistration.Dynamic, Registration.Dynamic, ServletRegistration, ServletRegistration.Dynamic

      public interface Registration

  Common interface for the registration of Filters and Servlets.
  Since:
    Servlet 3.0

- - ### Nested Class Summary

    Nested Classes
    Modifier and Type | Interface and Description
    --- | ---
    `static interface` | `Registration.Dynamic` Interface through which a Servlet or Filter registered via one of the addServlet or addFilter methods, respectively, on ServletContext may be further configured.

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `java.lang.String` | `getClassName()`
    `java.lang.String` | `getInitParameter(java.lang.String name)` Get the value of an initialisation parameter.
    `java.util.Map<java.lang.String,java.lang.String>` | `getInitParameters()` Get the names and values of all the initialisation parameters.
    `java.lang.String` | `getName()`
    `boolean` | `setInitParameter(java.lang.String name, java.lang.String value)` Add an initialisation parameter if not already added.
    `java.util.Set<java.lang.String>` | `setInitParameters(java.util.Map<java.lang.String,java.lang.String> initParameters)` Add multiple initialisation parameters.

- - ### Method Detail

    - #### getName

          java.lang.String getName()

    - #### getClassName

          java.lang.String getClassName()

    - #### setInitParameter

          boolean setInitParameter(java.lang.String name,
                                 java.lang.String value)

      Add an initialisation parameter if not already added.
      Parameters:
        `name` - Name of initialisation parameter
        `value` - Value of initialisation parameter
      Returns:
        `true` if the initialisation parameter was set, `false` if the initialisation parameter was not set because an initialisation parameter of the same name already existed
      Throws:
        `java.lang.IllegalArgumentException` - if name or value is `null`
        `java.lang.IllegalStateException` - if the ServletContext associated with this registration has already been initialised

    - #### getInitParameter

          java.lang.String getInitParameter(java.lang.String name)

      Get the value of an initialisation parameter.
      Parameters:
        `name` - The initialisation parameter whose value is required
      Returns:
        The value of the named initialisation parameter

    - #### setInitParameters

          java.util.Set<java.lang.String> setInitParameters(java.util.Map<java.lang.String,java.lang.String> initParameters)

      Add multiple initialisation parameters. If any of the supplied initialisation parameter conflicts with an existing initialisation parameter, no updates will be performed.
      Parameters:
        `initParameters` - The initialisation parameters to add
      Returns:
        The set of initialisation parameter names that conflicted with existing initialisation parameter. If there are no conflicts, this Set will be empty.
      Throws:
        `java.lang.IllegalArgumentException` - if any of the supplied initialisation parameters have a null name or value
        `java.lang.IllegalStateException` - if the ServletContext associated with this registration has already been initialised

    - #### getInitParameters

          java.util.Map<java.lang.String,java.lang.String> getInitParameters()

      Get the names and values of all the initialisation parameters.
      Returns:
        A Map of initialisation parameter names and associated values keyed by name

Copyright © 2000-2021 Apache Software Foundation. All Rights Reserved.