init-param——Web程序中的全局参数设置

一、简介

init-param是指在web.xml配置文件中，设置Web应用的全局参数。在整个Web应用程序中，无论是哪个Servlet调用这个全局参数，都会返回相同的参数值。因为参数的值是固定的，所以我们把它叫做初始化参数。在Web应用启动后，我们就可以通过servlet context 或servletConfig对象来访问它们。

二、init-param的作用

Web应用程序通常有一些通用的变量或参数，这些参数需要在整个应用程序中都能够被调用，比如连接数据库的用户名和密码，或是一些URL地址等等。如果这些参数在各自的Servlet中进行设置，那么会显得非常麻烦，而且也非常不利于统一管理。

所以，我们可以通过设置init-param来帮助我们全局地统一管理一些通用参数。在整个Web应用程序中，我们可以通过servlet context 或servletConfig对象来访问这些参数，而且这些参数是只读的，而不是可写的。这样做可以节约大量的代码和时间。

比如，我们可以在web.xml文件中设置一些全局参数，如连接数据库的用户名和密码，如下代码所示：

  <context-param>
      <param-name>username</param-name>
      <param-value>john</param-value>
  </context-param>

  <context-param>
      <param-name>password</param-name>
      <param-value>passwd</param-value>
  </context-param>

这样，我们就可以在任何一个Servlet或JSP页面中通过servlet context 或servletConfig对象来访问这些参数了。

三、设置init-param参数

在Web应用程序中设置全局参数非常容易，只需要在web.xml文件中添加一下context-param节点即可，如下代码所示：

  <context-param>
      <param-name>参数名</param-name>
      <param-value>参数值</param-value>
  </context-param>

其中，param-name用来定义参数的名称，而param-value用来定义参数的值。

在Java Web应用程序中，可以通过ServletContext对象的getInitParameter方法或ServletConfig对象的getInitParameter方法来获取与init-param元素关联的值。

四、使用init-param参数

在Java Web应用程序中，可以通过ServletContext对象或ServletConfig对象来获取与init-param元素关联的值。

获取ServletContext对象的方法如下所示：

ServletContext context = getServletContext();
String paramValue = context.getInitParameter("参数名");

获取ServletConfig对象的方法如下所示：

ServletConfig config = getServletConfig();
String paramValue = config.getInitParameter("参数名");

五、注意事项

如果有多个init-param元素的param-name属性具有相同的值，则取第一个节点的值。

在使用init-param时，需要注意以下几点：

1.在web.xml文件中设置的参数值是只读的。

2.参数的值是可以是任意类型的，包括字符串、数字、字符等。

3.在Java Web应用程序中，可以通过ServletContext对象或ServletConfig对象来获取与init-param元素关联的值。

4.如果有多个init-param元素的param-name属性具有相同的值，则取第一个节点的值。

六、示例代码

web.xml配置文件：

  <web-app>
      <!-- 字符编码设置 -->
      <filter>
          <filter-name>charsetFilter</filter-name>
          <filter-class>com.xxx.filter.CharsetFilter</filter-class>
          <init-param>
              <param-name>charset</param-name>
              <param-value>UTF-8</param-value>
          </init-param>
      </filter>
  </web-app>

Java Servlet中获取刚才的init-param参数：

  public class CharsetFilter implements Filter {
      private String charset;
      public void init(FilterConfig filterConfig) throws ServletException {
          charset = filterConfig.getInitParameter("charset");
      }
      public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
          request.setCharacterEncoding(charset);
          response.setCharacterEncoding(charset);
          chain.doFilter(request, response);
      }
      public void destroy() {
      }
  }