Servlet 实例

Servlet 是服务 HTTP 请求并实现 javax.servlet.Servlet 接口的 Java 类。Web 应用程序开发人员通常编写 Servlet 来扩展 javax.servlet.http.HttpServlet,并实现 Servlet 接口的抽象类专门用来处理 HTTP 请求。

Hello World 示例代码

下面是 Servlet 输出 Hello World 的示例源代码:

  1. // 导入必需的 java 库
  2. import java.io.*;
  3. import javax.servlet.*;
  4. import javax.servlet.http.*;
  5. // 扩展 HttpServlet 类
  6. public class HelloWorld extends HttpServlet {
  7. private String message;
  8. public void init() throws ServletException
  9. {
  10. // 执行必需的初始化
  11. message = "Hello World";
  12. }
  13. public void doGet(HttpServletRequest request,
  14. HttpServletResponse response)
  15. throws ServletException, IOException
  16. {
  17. // 设置响应内容类型
  18. response.setContentType("text/html");
  19. // 实际的逻辑是在这里
  20. PrintWriter out = response.getWriter();
  21. out.println("<h1>" + message + "</h1>");
  22. }
  23. public void destroy()
  24. {
  25. // 什么也不做
  26. }
  27. }

编译 Servlet

让我们把上面的代码写在 HelloWorld.java 文件中,把这个文件放在 C:\ServletDevel(在 Windows 上)或 /usr/ServletDevel(在 UNIX 上)中,您还需要把这些目录添加到 CLASSPATH 中。

假设您的环境已经正确地设置,进入 ServletDevel 目录,并编译 HelloWorld.java,如下所示:

  1. $ javac HelloWorld.java

如果 Servlet 依赖于任何其他库,您必须在 CLASSPATH 中包含那些 JAR 文件。在这里,我只包含了 servlet-api.jar JAR 文件,因为我没有在 Hello World 程序中使用任何其他库。

该命令行使用 Sun Microsystems Java 软件开发工具包(JDK)内置的 javac 编译器。为使该命令正常工作, PATH 环境变量需要设置 Java SDK 的路径。

如果一切顺利,上面编译会在同一目录下生成 HelloWorld.class 文件。下一节将讲解已编译的 Servlet 如何部署在生产中。

Servlet 部署

默认情况下,Servlet 应用程序位于路径 <Tomcat-installation-directory>/webapps/ROOT 下,且类文件放在 <Tomcat-installation-directory>/webapps/ROOT/WEB-INF/classes 中。

如果您有一个完全合格的类名称 com.myorg.MyServlet,那么这个 Servlet 类必须位于 WEB-INF/classes/com/myorg/MyServlet.class 中。

现在,让我们把 HelloWorld.class 复制到 <Tomcat-installation-directory>/webapps/ROOT/WEB-INF/classes 中,并在位于 <Tomcat-installation-directory>/webapps/ROOT/WEB-INF/ 的 web.xml 文件中创建以下条目:

  1. <web-app>
  2. <servlet>
  3. <servlet-name>HelloWorld</servlet-name>
  4. <servlet-class>HelloWorld</servlet-class>
  5. </servlet>
  6. <servlet-mapping>
  7. <servlet-name>HelloWorld</servlet-name>
  8. <url-pattern>/HelloWorld</url-pattern>
  9. </servlet-mapping>
  10. </web-app>

上面的条目要被创建在 web.xml 文件中的 <web-app>…</web-app> 标签内。在该文件中可能已经有各种可用的条目,但不要在意。

到这里,您基本上已经完成了,现在让我们使用 <Tomcat-installation-directory>\bin\startup.bat(在 Windows 上)或 <Tomcat-installation-directory>/bin/startup.sh(在 Linux/Solaris 等上)启动 tomcat 服务器,最后在浏览器的地址栏中输入 http://localhost:8080/HelloWorld。如果一切顺利,您会看到下面的结果:

Servlet 实例

destory 方法

destory 方法被调用后,servlet 被销毁,但是并没有立即被回收,再次请求时,并没有重新初始化。

代码示例:

  1. private String message;
  2. @Override
  3. public void init() throws ServletException {
  4. message = "Hello World , Nect To Meet You: " + System.currentTimeMillis();
  5. System.out.println("servlet初始化……");
  6. super.init();
  7. }
  8. @Override
  9. public void doGet(HttpServletRequest req, HttpServletResponse response) throws ServletException, IOException {
  10. response.setContentType("text/html");
  11. PrintWriter writer = response.getWriter();
  12. writer.write("<h1>" + message + "</h1>");
  13. destroy();
  14. }
  15. @Override
  16. public void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
  17. // TODO Auto-generated method stub
  18. super.doPost(req, resp);
  19. }
  20. @Override
  21. public void destroy() {
  22. System.out.println("servlet销毁!");
  23. super.destroy();
  24. }

控制台打印:

  1. servlet初始化……
  2. servlet销毁!
  3. 2017-7-6 19:48:52 org.apache.catalina.core.StandardContext reload
  4. 信息: Reloading Context with name [/myServlet] has started
  5. servlet销毁!
  6. 2017-7-6 19:48:52 org.apache.catalina.core.StandardContext reload
  7. 信息: Reloading Context with name [/myServlet] is completed
  8. servlet初始化……
  9. servlet销毁!
  10. servlet销毁!
  11. servlet销毁!
  12. servlet销毁!
  13. servlet销毁!
  14. servlet销毁!
  15. servlet销毁!

servlet 浏览器访问路径配置有个小问题

1、java 类里的注解 —— @WebServlet("/HelloServlet") 对应浏览器路径:

  1. http://localhost:8080/TomcatTest/HelloServlet

2、配置文件(web.xml)里对应的浏览器访问路径:

  1. http://localhost:8080/TomcatTest/TomcatTest/HelloServlet

这两种配一个就好了,不然路径重名的话反而会让tomcat启动不了。

例如这样就启动不了:

修改 web.xml :

  1. <url-pattern>/HelloServlet</url-pattern>

修改后,web.xml 和 java 类的注解,对应路径都是:

  1. http://localhost:8080/TomcatTest/HelloServlet

导致

  1. 命名的 servlet[HelloServlet]和 [com.runoob.test.HelloServlet] 都被映射到 URL 模式 [/ HelloServlet] 这是不允许的。

解决办法:

注解去掉或者保留注解进入web.xml将映射删除既可以。