现在在Java Web开发中,常量信息倾向于写在某个配置文件里。需求变化的时候只需要修改一下配置文件就可以了,而不需要修改源程序,也不会重新编译,维护起来相当方便。web.xml提供了设置初始化参数的功能,可以将这些信息配置在web.xml中。配置完毕后,Servlet中提供方法getInitParameter(String param)来获取初始化参数值,也可以由ServletConfig对象取得。Servlet提供getServletConfig()返回Servlet对象。由ServletConfig取初始化参数与Servlet直接取方式一样。
除了在Servlet中编写代码读取web.xml中的初始参数。Java EE 5提供了一种新的方案叫做资源注射(Resource Injection),或者叫做资源注入。也就是说,不需要Servlet主动去读取资源,Tomcat启动的时候会把web.xml里配置的信息主动“注射”到Servlet里。这个过程是运行时自动完成的,不需要编写任何代码。
资源注射是通过注解(Annotation)完成的。注解是Java 5.0里引入的新特性。注解是一种特殊的接口,以“@”符号为标志。以下是一个实例代码:
java代码:InjectionServlet.java
import java.io.IOException;
import java.io.PrintWriter;
import javax.annotation.Resource;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class InjectionServlet extends HttpServlet {
private @Resource(name="hello") String hello; //注入的字符串,一行的写法
private @Resource(name="i") int i; //注入的整数
@Resource(name="persons") //两行的写法
private String persons; //注解与代码分开
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
request.setCharacterEncoding("UTF-8");
response.setCharacterEncoding("UTF-8");
response.setContentType("text/html");
PrintWriter out=response.getWriter();
out.println("<html>");
out.println("<head><title>资源注入</title></head>");
out.println("<body>");
out.println("<b>注入的字符串:</b><br/> - "+hello+"<br/>");
out.println("<b>注入的整数:</b><br/> - "+i+"<br/>");
out.println("<b>注入的字符串数组:</b><br/>");
for(String person:persons.split(",")){
out.println(" - "+person+"<br/>");
}
out.println("</body></html>");
out.flush();
out.close();
}
@Override
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
this.doGet(request, response);
}
}
配置文件web.xml:
文件中使用标签<env-entry>来配置资源。<env-entry>仅能配置java.lang包下标准类型的变量,如String、Integer、Double等。
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
<env-entry>
<env-entry-name>hello</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>Welcome to JavaEE Resource Injection.</env-entry-value>
</env-entry>
<env-entry>
<env-entry-name>i</env-entry-name>
<env-entry-type>java.lang.Integer</env-entry-type>
<env-entry-value>80</env-entry-value>
</env-entry>
<env-entry>
<env-entry-name>persons</env-entry-name>
<env-entry-type>java.lang.String</env-entry-type>
<env-entry-value>aaa,bbb,ccc,ddd</env-entry-value>
</env-entry>
<servlet>
<servlet-name>InjectionServlet</servlet-name>
<servlet-class>InjectionServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>InjectionServlet</servlet-name>
<url-pattern>/InjectionServlet</url-pattern>
</servlet-mapping>
</web-app>
现在只要在浏览器中输入url就可显示信息。
使用JNDI获取资源
资源注射的工作原理是JNDI(Java 命名与目录接口,Java Naming and Directory)。InjectionServlet实例中使用<evn-entry>配置了名为hello,i,persons的JNDI资源,然后使用@Resource将指定名称的JNDI资源注射到InjectionServlet里。如果不使用@Resource,通过查找JNDI同样可以获取到这三个资源,代码如下:
Context ctx=new InitialContext(); //实例化一个Context对象
String hello=(String)ctx.lookup("hello"); //查找资源hello
Integer i=(Integer)ctx.lookup("i");
String persons=(String)ctx.lookup("persons");
注:注射是利用@注解实现的。JDK 5以上支持@注解。资源注射需要服务器的支持,Tomcat 6是支持的,但某些其他Web服务器或者低版本的Tomcat可能不支持。