《Servlet、JSP和Spring MVC初学指南》——1.3 编写基础的Servlet应用程序

    xiaoxiao2024-04-01  123

    本节书摘来自异步社区《Servlet、JSP和Spring MVC初学指南》一书中的第1章,第1.3节,作者:【加】Budi Kurniawan(克尼亚万) , 【美】Paul Deck著,更多章节内容可以访问云栖社区“异步社区”公众号查看

    1.3 编写基础的Servlet应用程序

    其实,编写Servlet应用程序出奇简单。只需要创建一个目录结构,并把Servlet类放在某个目录下。本节将教你如何编写一个名为app01a的Servlet应用程序。最初,它会包含一个Servlet,即MyServlet,其效果是向用户发出一条问候。

    要运行Servlets,还需要一个Servlet容器。Tomcat是一个开源的Servlet容器,它是免费的,并且可以在任何能跑Java的平台上运行。如果你到现在都还没有安装Tomcat,就应该去看看附录A,并安装一个。

    1.3.1 编写和编译Servlet类确定你的机器上有了Servlet容器后,下一步就要编写和编译一个Servlet类。本例中的Servlet类是MyServlet,如清单1.1所示。按照惯例,Servlet类的名称要以Servlet作为后缀。

    清单1.1 MyServlet类

    package app01a; import java.io.IOException; import java.io.PrintWriter; import javax.servlet.Servlet; import javax.servlet.ServletConfig; import javax.servlet.ServletException; import javax.servlet.ServletRequest; import javax.servlet.ServletResponse; import javax.servlet.annotation.WebServlet; @WebServlet(name = "MyServlet", urlPatterns = { "/my" }) public class MyServlet implements Servlet { private transient ServletConfig servletConfig; @Override public void init(ServletConfig servletConfig) throws ServletException { this.servletConfig = servletConfig; } @Override public ServletConfig getServletConfig() { return servletConfig; } @Override public String getServletInfo() { return "My Servlet"; } @Override public void service(ServletRequest request, ServletResponse response) throws ServletException, IOException { String servletName = servletConfig.getServletName(); response.setContentType("text/html"); PrintWriter writer = response.getWriter(); writer.print("<html><head></head>" + "<body>Hello from " + servletName + "</body></html>"); } @Override public void destroy() { } }

    看到清单1.1中的代码时,可能首先注意到的是下面这个标注:

    @WebServlet(name = "MyServlet", urlPatterns = { "/my" })WebServlet标注类型用来声明一个Servlet。命名Servlet时,还可以暗示容器,是哪个URL调用这个Servlet。name属性是可选的,如有,通常用Servlet类的名称。重要的是urlPatterns属性,它也是可选的,但是一般都是有的。在MyServlet中,urlPatterns告诉容器,/my样式表示应该调用Servlet。

    注意,URL样式必须用一个正斜杠开头。

    Servlet的init方法只被调用一次,并将private transient变量ServletConfig设为传给该方法的ServletConfig对象:

    private transient ServletConfig servletConfig; @Override public void init(ServletConfig servletConfig) throws ServletException { this.servletConfig = servletConfig; }

    如果想通过Servlet内部使用ServletConfig,只需要将被传入的ServletConfig赋给一个类变量。

    Service方法发送字符串“Hello from MyServlet”给浏览器。对于每一个针对Servlet进来的HTTP请求,都会调用Service方法。

    为了编译Servlet,必须将Servlet API中的所有类型都放在你的类路径下。Tomcat中带有servlet-api.jar文件,其中包含了javax.servlet的成员,以及javax.servlet.http包。这个压缩文件放在Tomcat安装目录下的lib目录中。

    1.3.2 应用程序目录结构Servlet应用程序必须在某一个目录结构下部署。图1.2展示了app01a的应用程序目录。

    图1.2 应用程序目录

    这个目录结构最上面的 app01a 目录就是应用程序目录。在应用程序目录下,是WEB-INF目录。它有两个子目录:

    classes。Servlet类及其他Java类必须放在这里面。类以下的目录反映了类包的结构。在图1.2中,只部署了一个类:app01a.MyServlet。lib。Servlet应用程序所需的JAR文件要在这里部署。但Servlet API的JAR文件不需要在这里部署,因为Servlet容器已经有它的备份。在这个应用程序中,lib目录是空的。空的lib目录可以删除。Servlet/JSP应用程序一般都有JSP页面、HTML文件、图片文件以及其他资料。这些应该放在应用程序目录下,并且经常放在子目录下。例如,所有的图片文件可以放在一个image目录下,所有的JSP页面可以放在jsp目录下,等等。

    放在应用程序目录下的任何资源,用户只要输入资源URL,都可以直接访问到。如果想让某一个资源可以被Servlet访问,但不可以被用户访问,那么就要把它放在WEB-INF目录下。

    现在,准备将应用程序部署到Tomcat。使用Tomcat时,一种部署方法是将应用程序目录复制到Tomcat安装目录下的webapps目录中。也可以通过在Tomcat的conf目录中编辑server.xml文件实现部署,或者单独部署一个XML文件,这样就不需要编辑server.xml了。其他的Servlet容器可能会有不同的部署规则。关于如何将Servlet/JSP应用程序部署到Tomcat的详细信息,请查阅附录A。

    部署Servlet/JSP应用程序时,建议将它部署成一个WAR文件。WAR文件其实就是以.war作为扩展名的JAR文件。利用带有JDK或者类似WinZip工具的JAR软件,都可以创建WAR文件。然后,将WAR文件复制到Tomcat的webapps目录下。当开始启动Tomcat时,Tomcat就会自动解压这个war文件。部署成WAR文件在所有Servlet容器中都适用。我们将在第13章讨论更多关于部署的细节。

    1.3.3 调用Servlet要测试这个Servlet,需要启动或者重启Tomcat,并在浏览器中打开下面的URL(假设Tomcat配置为监听端口8080,这是它的默认端口):

    http://localhost:8080/app01a/my其输出结果应该类似于图1.3。

    图1.3 MyServlet的响应结果

    恭喜,你已经成功编写了第一个Servlet应用程序!

    相关资源:Servlet、JSP和SpringMVC初学指南
    最新回复(0)