web.xml之init-param参数的用途

下文笔者讲述web.xml配置文件中init-param参数的功能简介说明,如下所示

web.xml之init-param功能

`web.xml`文件中`init-param`元素
   用于定义特定于某个Servlet或Filter初始化参数
   与`context-param`不同,`init-param`是局部
   只对声明它Servlet或Filter生效
   使用 getServletConfig().getInitParameter 获取参数值
   
init-param主要功能：
	-Servlet或Filter配置：
	   为特定Servlet或Filter设置初始化参数
	    这些参数在Servlet或Filter初始化时可被读取和使用
	-传递配置信息：
	    允许开发者向Servlet或Filter传递配置信息
  使用 `getServletConfig().getInitParameter()` 或 `filterConfig.getInitParameter()` 方法
     获取这些参数的值

例：
   数据库连接字符串、文件路径等。
	 -自定义行为:
	   通过设置不同的初始化参数
	    可改变同一个Servlet或Filter
		在不同环境下行为

例:Servlet中定义`init-param`示例

<servlet>
    <servlet-name>exampleServlet</servlet-name>
    <servlet-class>com.example.ExampleServlet</servlet-class>
    <init-param>
        <param-name>maxUploadSize</param-name>
        <param-value>10485760</param-value> <!-- 10MB -->
    </init-param>
</servlet>
 
此例中
  `init-param` 定义一个名为 `maxUploadSize`参数
  其值为`10485760`(即 10MB)
   这个参数仅对`exampleServlet`生效

Filter中定义`init-param`

 
<filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
 
此例子中
  `init-param`定义一个名为`encoding`参数
   其值为`UTF-8`
    这个参数仅对`encodingFilter`生效

获取参数值

public class ExampleServlet extends HttpServlet {
    private int maxUploadSize;

    @Override
    public void init() throws ServletException {
        super.init();
        String paramValue = getServletConfig().getInitParameter("maxUploadSize");
        if (paramValue != null) {
            maxUploadSize = Integer.parseInt(paramValue);
        }
    }

    // 其他方法...
}

从Servlet配置中
   获取名为 `maxUploadSize` 的参数值
    并将其转换为整数类型

Filter

public class EncodingFilter implements Filter {
    private String encoding;

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        this.encoding = filterConfig.getInitParameter("encoding");
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        if (this.encoding != null) {
            request.setCharacterEncoding(this.encoding);
        }
        chain.doFilter(request, response);
    }

    @Override
    public void destroy() {
        // 清理工作
    }
}
 
 
从 Filter 配置中获取名为`encoding` 的参数值
并将其应用于请求字符编码设置

### 总结 - `init-param` 用于为特定的 Servlet 或 Filter 提供初始化参数。 - 这些参数是局部的，只对声明它们的组件生效。 - 可以通过 。