/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package jakarta.servlet;

import java.util.Enumeration;

A servlet configuration object used by a servlet container to pass information to a servlet during initialization.
/** * A servlet configuration object used by a servlet container to pass * information to a servlet during initialization. */
public interface ServletConfig {
Returns the name of this servlet instance. The name may be provided via server administration, assigned in the web application deployment descriptor, or for an unregistered (and thus unnamed) servlet instance it will be the servlet's class name.
Returns:the name of the servlet instance
/** * Returns the name of this servlet instance. The name may be provided via * server administration, assigned in the web application deployment * descriptor, or for an unregistered (and thus unnamed) servlet instance it * will be the servlet's class name. * * @return the name of the servlet instance */
public String getServletName();
Returns a reference to the ServletContext in which the caller is executing.
See Also:
Returns:a ServletContext object, used by the caller to interact with its servlet container
/** * Returns a reference to the {@link ServletContext} in which the caller is * executing. * * @return a {@link ServletContext} object, used by the caller to interact * with its servlet container * @see ServletContext */
public ServletContext getServletContext();
Returns a String containing the value of the named initialization parameter, or null if the parameter does not exist.
Params:
  • name – a String specifying the name of the initialization parameter
Returns:a String containing the value of the initialization parameter
/** * Returns a <code>String</code> containing the value of the named * initialization parameter, or <code>null</code> if the parameter does not * exist. * * @param name * a <code>String</code> specifying the name of the * initialization parameter * @return a <code>String</code> containing the value of the initialization * parameter */
public String getInitParameter(String name);
Returns the names of the servlet's initialization parameters as an Enumeration of String objects, or an empty Enumeration if the servlet has no initialization parameters.
Returns:an Enumeration of String objects containing the names of the servlet's initialization parameters
/** * Returns the names of the servlet's initialization parameters as an * <code>Enumeration</code> of <code>String</code> objects, or an empty * <code>Enumeration</code> if the servlet has no initialization parameters. * * @return an <code>Enumeration</code> of <code>String</code> objects * containing the names of the servlet's initialization parameters */
public Enumeration<String> getInitParameterNames(); }