Package jakarta.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 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
All Methods Instance Methods Abstract Methods Modifier and Type Method Description java.lang.String
getClassName()
Obtain the name of the implementation class for the Servlet.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()
Obtain the name of the Servlet.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()
Obtain the name of the Servlet.- Returns:
- the name of the Servlet.
-
getClassName
java.lang.String getClassName()
Obtain the name of the implementation class for the Servlet.- Returns:
- the name of the implementation class for the Servlet.
-
setInitParameter
boolean setInitParameter(java.lang.String name, java.lang.String value)
Add an initialisation parameter if not already added.- Parameters:
name
- Name of initialisation parametervalue
- 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 isnull
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 valuejava.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
-
-