2.7 第 6 步：编写“Hello-world”Java Servlet

╰+攻爆jí腚メ 2023-10-02 09:32 2阅读 0赞

甲*的servlet*是支持Java的HTTP服务器，诸如Apache Tomcat上内运行Java程序。Web 用户通过从 Web 浏览器（HTTP 客户端）发出适当的 URL 来调用 servlet。

在您继续之前，我假设您熟悉 Java 编程并已安装以下内容：

1.  JDK（阅读“[如何安装 JDK 和入门][JDK]”）。
2.  一个编程文本编辑器，例如 Sublime Text 或 Atom。

步骤 6(a) 编写一个“Hello-world”Java Servlet

Java servlet 是在 HTTP 服务器内运行的 Java 程序。Web 用户通过从浏览器（或 HTTP 客户端）发出 URL 来调用 servlet。

在这个例子中，我们将编写一个名为 的 Java servlet `HelloServlet`，它说“Hello, world!”。我们将配置为 Web 用户可以通过从他们的浏览器发出 URL 来调用这个 servlet ，如图所示：`http://ip_addr:port/hello/sayhello`

![TomcatWebappHelloServlet.png][]

编写以下名为“ `HelloServlet.java`”的源代码并将其保存在您的应用程序“ `classes`”目录（即“ ”）下。这个 servlet 说“你好”，回显一些请求信息，并在每个请求上打印一个随机数。`<TOMCAT_HOME>\webapps\hello\WEB-INF\classes\HelloServlet.java`

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36</pre> </td> 
   <td> <pre>// To save as "&lt;TOMCAT_HOME&gt;\webapps\hello\WEB-INF\classes\HelloServlet.java"
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import javax.servlet.annotation.*;
 
@WebServlet("/sayhello")   // Configure the request URL for this servlet (Tomcat 7/Servlet 3.0 upwards)
public class <strong>HelloServlet</strong> extends HttpServlet {

// The doGet() runs once per HTTP GET request to this servlet.
   @Override
   public void <strong>doGet</strong>(HttpServletRequest <strong>request</strong>, HttpServletResponse <strong>response</strong>)
         throws IOException, ServletException {
 
      // Set the response MIME type of the response message
      <strong>response.setContentType("text/html");</strong>
      // Allocate a output writer to write the response message into the network socket
      <strong>PrintWriter out = response.getWriter();</strong>
 
      // Write the response message, in an HTML page
      out.println("&lt;!DOCTYPE html&gt;");
      out.println("&lt;html&gt;");
      out.println("&lt;head&gt;&lt;title&gt;Hello, World&lt;/title&gt;&lt;/head&gt;");
      out.println("&lt;body&gt;");
      out.println("&lt;h1&gt;Hello, world!&lt;/h1&gt;");  // says Hello
      // Echo client's request information
      out.println("&lt;p&gt;Request URI: " + <strong>request.getRequestURI()</strong> + "&lt;/p&gt;");
      out.println("&lt;p&gt;Protocol: " + <strong>request.getProtocol()</strong> + "&lt;/p&gt;");
      out.println("&lt;p&gt;PathInfo: " + <strong>request.getPathInfo()</strong> + "&lt;/p&gt;");
      out.println("&lt;p&gt;Remote Address: " + <strong>request.getRemoteAddr()</strong> + "&lt;/p&gt;");
      // Generate a random number upon each request
      out.println("&lt;p&gt;A Random Number: &lt;strong&gt;" + <strong>Math.random()</strong> + "&lt;/strong&gt;&lt;/p&gt;");
      out.println("&lt;/body&gt;&lt;/html&gt;");
      out.close();  // Always close the output writer
   }
}</pre> </td> 
  </tr> 
 </tbody> 
</table>

注意，在第 7 行，我们通过注解将其配置`HelloServlet`为 URL " `/sayhello`" ，适用于 Tomcat 7 以后。换句话说，完整的 URL 应该是触发 this 。`@WebServlet("/sayhello")``http://ip_addr:port/hello/sayhello``HelloServlet`

步骤 6(b) 编译 Servlet （困难）

我们需要 Java Servlet API 来编译 servlet。Servlet API 不是 JDK 的一部分。Tomcat 在`<TOMCAT_HOME>/lib/servlet-api.jar`. 我们需要通过`-cp`(classpath) 选项将这个 JAR 文件包含在编译中，如下所示：

**（适用于 Windows）**

// Assume that Tomcat is installed in c:\myWebProject\tomcat
    // Change directory to the Java source directory
    c:
    cd \myWebProject\tomcat\webapps\hello\WEB-INF\classes
    
    // Compile with servlet API library
    javac -cp .;c:\myWebProject\tomcat\lib\servlet-api.jar HelloServlet.java

**（对于 macOS）**

// Assume that Tomcat is installed in ~/myWebProject/tomcat
    // Change directory to the Java source directory
    cd ~/myWebProject/tomcat/webapps/hello/WEB-INF/classes
    
    // Compile with Servlet API - Need to use $HOME instead of ~ in the "javac" command
    javac -cp .:$HOME/myWebProject/tomcat/lib/servlet-api.jar HelloServlet.java

编译的输出是“ `HelloServlet.class`”。

**使用“文件资源管理器”检查“ `webapps/hello/WEB-INF/classes`”文件夹以确保“ `HelloServlet.class`”已在正确的位置创建。**

步骤 6(c) 调用 Servlet

重新启动您的 Tomcat 服务器（不需要，但以防万一……）。

要调用此 servlet，请启动浏览器，并发出如下配置的请求 URL：

http://localhost:9999/hello/sayhello

您将在 Web 浏览器中看到 servlet 的输出。

刷新浏览器，每次刷新都会看到一个新的随机数。换句话说，`doGet()`servlet的方法每个请求运行一次。

查看页面源代码

（对于 Firefox 和 Chrome）右键单击页面⇒“查看页面源”以查看 Web 浏览器接收到的输出（由服务器返回）。请注意，Web 浏览器仅接收 servlet 的输出（通过`out.println()`语句生成）。客户端无法访问 servlet 源代码（其中可能包含机密信息）。

（对于 macOS 的 Safari 浏览器）您需要启用“首选项”下的“开发人员菜单”才能启用“查看源”菜单。

<!DOCTYPE html>
    <html>
    <head><title>Hello, World</title></head>
    <body>
    <h1>Hello, world!</h1>
    <p>Request URI: /hello/sayhello</p>
    <p>Protocol: HTTP/1.1</p>
    <p>PathInfo: null</p>
    <p>Remote Address: 127.0.0.1</p>
    <p>A Random Number: <strong>0.3523682325749493</strong></p>
    </body>
    </html>

**（跳过，除非...）**可能的错误是“404 File Not Found”和“500 Internal Server Error”。阅读“[如何调试][Link 1]”部分。

（可选）检查 HTTP 请求和响应消息

当您`http://localhost:9999/hello/sayhello`在 Web 浏览器上输入 URL（例如）时，会向服务器发送HTTP GET*请求消息*；服务器返回*响应信息*显示在浏览器上。您可以通过 Web 浏览器的开发工具检查请求和响应消息。

对于**Firefox/Chrome**，按 F12（称为 F12 调试器）以启用“Web 控制台”或“开发人员工具”。选择“控制台”或“网络”窗格。输入 URL `http://localhost:9999/hello/sayhello`（或刷新）。在“网络”或“网络”下。展开链接`http://localhost:9999/hello/sayhello`。HTTP 消息由标题和正文组成。检查请求头和正文；以及响应头和正文。

请求消息*头*如下：

GET http://localhost:9999/hello/sayhello HTTP/1.1
    Host: localhost:9999
    Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
    Accept-Encoding: gzip, deflate
    Accept-Language: en-US,en;q=0.5
    Cache-Control:max-age=0
    Connection: keep-alive
    Upgrade-Insecure-Requests: 1
    User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Firefox/52.0

对于此请求，没有请求消息正文。

响应消息*头*如下：

HTTP/1.1 200 OK
    Date: xxx, xx xxx xxxx xx:xx:xx xxx
    Content-Length: 286
    Content-Type: text/html;charset=ISO-8859-1

响应消息*体*如下：

<!DOCTYPE html>
    <html>
    <head><title>Hello, World</title></head>
    <body>
    <h1>Hello, world!</h1>
    <p>Request URI: /hello/sayhello</p>
    <p>Protocol: HTTP/1.1</p>
    <p>PathInfo: null</p>
    <p>Remote Address: 0:0:0:0:0:0:0:1</p>
    <p>A Random Number: <strong>0.4480280769255568</strong></p>
    </body></html>

2.8 第 7 步：编写数据库 Servlet

本节假设您熟悉“Java 数据库编程”和“MySQL 数据库服务器”。否则，请分别阅读“ [Java 数据库程序][Java]”和“[如何安装 MySQL 和入门][MySQL]”。

步骤 7(a) 在 MySQL 上设置数据库（已在 MySQL 练习中完成）

启动你的 MySQL 服务器。记下服务器的端口号。我将假设 MySQL 服务器运行在端口上`3306`，而 Tomcat 运行在端口上`9999`。

// For Windows: I shall assume that MySQL is installed in "c:\myWebProject\mysql"
    c:
    cd \myWebProject\mysql\bin
    mysqld --console
    
    // For macOS
    // Use graphical control at "System Preferences" -> MySQL

启动 MySQL 客户端。我假设有一个名为“ `myuser`”的用户，密码为“ `xxxx`”。

// For Windows: I shall assume that MySQL is installed in "c:\myWebProject\mysql"
    c:
    cd \myWebProject\mysql\bin
    mysql -u myuser -p
     
    // For macOS: I shall assume that MySQL is installed in "/usr/local/mysql"
    cd /usr/local/mysql/bin
    ./mysql -u myuser -p

运行以下 SQL 语句以创建一个名为“ `ebookshop`”的数据库，其中有一个名为“ `books`”的表，有 5 列：`id`、`title`、`author`、`price`、`qty`。

create database if not exists ebookshop;
    
    use ebookshop;
    
    drop table if exists books;
    create table books (
       id     int,
       title  varchar(50),
       author varchar(50),
       price  float,
       qty    int,
       primary key (id));
    
    insert into books values (1001, 'Java for dummies', 'Tan Ah Teck', 11.11, 11);
    insert into books values (1002, 'More Java for dummies', 'Tan Ah Teck', 22.22, 22);
    insert into books values (1003, 'More Java for more dummies', 'Mohammad Ali', 33.33, 33);
    insert into books values (1004, 'A Cup of Java', 'Kumar', 55.55, 55);
    insert into books values (1005, 'A Teaspoon of Java', 'Kevin Jones', 66.66, 66);
    
    select * from books;

步骤 7(b) 安装 MySQL JDBC 驱动程序（在前面的 JDBC 练习中已经完成）

如果您还没有下载 MySQL JDBC 驱动程序，则需要下载。阅读“[安装 MySQL JDBC 驱动程序][MySQL JDBC]”。

步骤 7(c) 将 MySQL JDBC 驱动程序复制到 Tomcat 的“lib” （重要！！！不要错过这一步！！！）

将 MySQL JDBC Driver**`JAR`**文件“ ”复制到 Tomcat 的目录中，即“ ”（对于 Windows）或“ ”（macOS）。`mysql-connector-java-8.0.{xx}.jar``lib``c:\myWebProject\tomcat\lib``~\myWebProject\tomcat\lib`

步骤 7(d) 编写客户端 HTML 表单

让我们编写一个 HTML 脚本来创建一个带有 3 个复选框和一个提交按钮的*查询表单*，如下图所示。`querybook.html`在您的应用程序根目录“ `<TOMCAT_HOME>\webapps\hello`”中将 HTML 文件另存为“ ”。

![HtmlFormBookQuery.png][]

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16</pre> </td> 
   <td> <pre>&lt;!DOCTYPE html&gt;
&lt;html&gt;
&lt;head&gt;
  &lt;title&gt;Yet Another Bookshop&lt;/title&gt;
&lt;/head&gt;
&lt;body&gt;
  &lt;h2&gt;One More Bookshop&lt;/h2&gt;
  &lt;form method="get" <strong>action="http://localhost:9999/hello/query"</strong>&gt;
    &lt;b&gt;Choose an author:&lt;/b&gt;
    &lt;input type="checkbox" <strong>name="author" value="Tan Ah Teck"</strong> /&gt;Ah Teck
    &lt;input type="checkbox" <strong>name="author" value="Mohammad Ali"</strong> /&gt;Ali
    &lt;input type="checkbox" <strong>name="author" value="Kumar"</strong> /&gt;Kumar
    &lt;input type="submit" value="Search" /&gt;
  &lt;/form&gt;
&lt;/body&gt;
&lt;/html&gt;</pre> </td> 
  </tr> 
 </tbody> 
</table>

您可以通过发出以下 URL 来浏览 HTML 页面：

http://localhost:9999/hello/querybook.html

选中一个框（例如，“Tan Ah Teck”）并单击“搜索”按钮。由于您尚未编写服务器端程序，因此预计您会收到错误“404 File Not Found”。

但是观察浏览器导航栏中的网址，转载如下：

http://localhost:9999/hello/query?author=Tan+Ah+Teck

查询字符串和 NAME=VALUE 对

上面的 URL 由两部分组成：

1.  从标签的 " `action`" 属性中提取的 URL `<form>`。
2.  所谓的*查询字符串*以 a 开头，后跟从所选标签（即）中提取的“ ”对。请注意，空格被替换为（或-后跟十六进制空格的 ASCII 代码），因为 URL 中不允许出现空格。`'?'``name=value``<input>``author=Tan+Ah+Teck``'+'``%20``'%'`

如果您选中两个框（例如，“Tan Ah Teck”和“Mohammad Ali”），您将触发一个查询字符串，其中包含两个由 .name 分隔的“name=value”对`'&'`。

http://localhost:9999/hello/query?author=Tan+Ah+Teck&author=Mohammad+Ali

步骤 7(e) 编写服务器端数据库查询 Servlet

下一步是编写一个Java servlet，它通过查询数据库来响应客户端的请求并返回查询结果。

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64</pre> </td> 
   <td> <pre>// To save as "&lt;TOMCAT_HOME&gt;\<strong>webapps\hello\WEB-INF\classes\QueryServlet.java</strong>".
import java.io.*;
import java.sql.*;
import javax.servlet.*;
import javax.servlet.http.*;
import javax.servlet.annotation.*;

@WebServlet("<strong>/query</strong>")   // Configure the request URL for this servlet (Tomcat 7/Servlet 3.0 upwards)
public class <strong>QueryServlet</strong> extends HttpServlet {

// The doGet() runs once per HTTP GET request to this servlet.
   @Override
   public void <strong>doGet</strong>(HttpServletRequest request, HttpServletResponse response)
               throws ServletException, IOException {
      // Set the MIME type for the response message
      response.setContentType("text/html");
      // Get a output writer to write the response message into the network socket
      PrintWriter out = response.getWriter();

// Print an HTML page as the output of the query
      out.println("&lt;!DOCTYPE html&gt;");
      out.println("&lt;html&gt;");
      out.println("&lt;head&gt;&lt;title&gt;Query Response&lt;/title&gt;&lt;/head&gt;");
      out.println("&lt;body&gt;");

try (
         // Step 1: Allocate a database 'Connection' object
         <strong>Connection conn = DriverManager.getConnection(
               "jdbc:mysql://localhost:3306/ebookshop?allowPublicKeyRetrieval=true&amp;useSSL=false&amp;serverTimezone=UTC",
               "myuser", "xxxx");</strong>   // For MySQL
               // The format is: "jdbc:mysql://hostname:port/databaseName", "username", "password"

// Step 2: Allocate a 'Statement' object in the Connection
         <strong>Statement stmt = conn.createStatement();</strong>
      ) {
         // Step 3: Execute a SQL SELECT query
         <strong>String sqlStr = "select * from books where author = "
               + "'" + request.getParameter("author") + "'" </strong>  // Single-quote SQL string
               <strong>+ " and qty &gt; 0 order by price desc";</strong>

out.println("&lt;h3&gt;Thank you for your query.&lt;/h3&gt;");
         out.println("&lt;p&gt;Your SQL statement is: " + sqlStr + "&lt;/p&gt;"); // Echo for debugging
         <strong>ResultSet rset = stmt.executeQuery(sqlStr);</strong>  // Send the query to the server

// Step 4: Process the query result set
         int count = 0;
         while(<strong>rset.next()</strong>) {
            // Print a paragraph &lt;p&gt;...&lt;/p&gt; for each record
            out.println("&lt;p&gt;" + <strong>rset.getString("author")</strong>
                  + ", " + <strong>rset.getString("title")</strong>
                  + ", $" + <strong>rset.getDouble("price")</strong> + "&lt;/p&gt;");
            count++;
         }
         out.println("&lt;p&gt;==== " + count + " records found =====&lt;/p&gt;");
      } catch(Exception ex) {
         out.println("&lt;p&gt;Error: " + ex.getMessage() + "&lt;/p&gt;");
         out.println("&lt;p&gt;Check Tomcat console for details.&lt;/p&gt;");
         ex.printStackTrace();
      }  // Step 5: Close conn and stmt - Done automatically by try-with-resources (JDK 7)
 
      out.println("&lt;/body&gt;&lt;/html&gt;");
      out.close();
   }
}</pre> </td> 
  </tr> 
 </tbody> 
</table>

请注意，在第 8 行中，我们通过 annotation 将其配置`QueryServlet`为 URL " `/query`" `@WebServlet("/query")`。换句话说，触发这个的完整 URL`QueryServlet`是，它对应于前面写的“ ”标签的“ ”属性。`http://ip_addr:port/hello/query``action``<form>``querybook.html`

![TomcatWebappQueryServlet.png][]

`QueryServlet.java`使用 Servlet API 库编译“ ”，如下所示：

// Windows
    c:
    cd \myWebProject\tomcat\webapps\hello\WEB-INF\classes
    javac -cp .;c:\myWebProject\tomcat\lib\servlet-api.jar QueryServlet.java
    
    // macOS
    cd ~/myWebProject/tomcat/webapps/hello/WEB-INF/classes
    javac -cp .:$HOME/myWebProject/tomcat/lib/servlet-api.jar QueryServlet.java

使用“文件资源管理器”，确认`QueryServlet.class`在“ `classes`”目录中生成了“ ”。

步骤 7(f) 从带有查询字符串的客户端表单调用 Servlet

发出以下 URL 以浏览`querybook.html`您之前创建的 HMTL 表单“ ”：

http://localhost:9999/hello/querybook.html

选择一个作者（例如，“Tan Ah Teck”）并单击提交按钮，这会激活在`<form>`“ `action`”属性中编码的以下 URL ，以及 NAME=VALUE 对的查询字符串：

http://localhost:9999/hello/query?author=Tan+Ah+Teck

上面的 URL "/ `query`" 映射到`QueryServlet`.

使用方法 request.getParameter(NAME)处理 NAME=VALUE 对

我们可以使用 方法`request.getParameter()`来处理`NAME=VALUE`查询字符串中的对。具体来说，该方法`request.getParameter(NAME)`返回`VALUE`，如下图所示：

![请求获取参数][d4076c3bdb49752a1fb629652e7b2b8e.png]

上面的查询字符串有一`NAME=VALUE`对`author=Tan+Ah+Teck`. 在第 38 行，该方法`request.getParameter("author")`返回一个字符串“ `Tan Ah Teck`”，插入到 SQL`SELECT`命令中：

select * from books where author = 'Tan Ah Teck' and qty > 0 order by price desc

这样`SELECT`就根据用户在表单中的选择形成了SQL命令。

**（跳过除非...）如果您看到空白屏幕或不正确的输出，请从 Tomcat 控制台查找错误消息！！！**检查“[如何调试][Link 1]”数据库 Servlet 错误。

2.9（过时和不要做）（Tomcat 7 之前）使用web.xml部署 Servlet

请跳过本节。我把它放在这里以防万一......

Tomcat 7/Servlet 3.0 支持部署 servlet的注解。在 Tomcat 7 之前，您需要通过配置文件中的*部署描述符*来部署 servlet 。`@WebServlet("url")``web.xml`

创建以下名为“ `web.xml`”的配置文件，并将其保存在“ ”（即“ ”）下。**`webapps\hello\WEB-INF`**`<TOMCAT_HOME>\webapps\hello\WEB-INF\web.xml`

<table> 
 <tbody> 
  <tr> 
   <td> <pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21</pre> </td> 
   <td> <pre>&lt;?xml version="1.0" encoding="ISO-8859-1"?&gt;
&lt;web-app version="3.0"
  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_3_0.xsd"&gt;
 
   <strong>&lt;!-- To save as "hello\WEB-INF\web.xml" --&gt;</strong>
 
   &lt;servlet&gt;
      &lt;servlet-name&gt;<strong>HelloWorld</strong>&lt;/servlet-name&gt;
      &lt;servlet-class&gt;<strong>HelloServlet</strong>&lt;/servlet-class&gt;
   &lt;/servlet&gt;
 
   <strong>&lt;!-- Note: All &lt;servlet&gt; elements MUST be grouped together and
     placed IN FRONT of the &lt;servlet-mapping&gt; elements --&gt;</strong>
 
   &lt;servlet-mapping&gt;
      &lt;servlet-name&gt;<strong>HelloWorld</strong>&lt;/servlet-name&gt;
      &lt;url-pattern&gt;<strong>/sayhello</strong>&lt;/url-pattern&gt;
   &lt;/servlet-mapping&gt;
&lt;/web-app&gt;</pre> </td> 
  </tr> 
 </tbody> 
</table>

在上面的配置中，一个具有类文件“ `HelloServlet.class`”的 servlet被映射到请求 URL“ `/sayhello`”（通过*任意的* `servlet-name`“ `HelloWorld`”），在这个 web 应用程序“ `hello`”下。换句话说，这个 servlet 的完整请求 URL 是“ ”。`http://hostname:port/hello/sayhello`

这个配置文件保存在你的 webapp " `hello`"下，只适用于这个特定的 webapp " `hello`"。

重新启动 Tomcat 服务器以刷新“ `web.xml`”文件。

**注：**每个Servlet，你需要写一对`<servlet>`和`<servlet-mapping>`元素与常用但任意`<servlet-name>`。请注意，所有`<servlet>`元素必须组合在一起并放置在`<servlet-mapping>`元素的前面。

#### 3. 全栈 Web 开发人员 ####

全栈 Web 开发人员是可以开发客户端和服务器软件的人。他/她需要熟悉客户端（前端）编程、服务器端（后端）编程和数据库。你现在更近了一步。

![全栈网络开发人员][b42ca56ae0550e81303519d53b3ae8ca.png]

#### 4.（跳过，除非...）如何调试？ ####

“所有可能出错的事情都会出错。” 最重要的事情是找到**错误消息**！！！

总是...

1.  **重新启动 Tomcat（并检查 Tomcat 的控制台是否有错误消息）！！！**
2.  **重启浏览器！！！**
3.  使用**Cntl-F5**（而不是刷新按钮或 F5）刷新浏览器以获取新副本，而不是从缓存中获取。
4.  检查你的拼写！始终假设所有程序都区分大小写。如果可能，请不要键入、复制和粘贴！
5.  最重要的是 - 找到**错误消息**！！！
    
    1.  检查 Tomcat 控制台上的错误消息。大多数错误消息都有几行屏幕。您需要从最后一行缓慢向上滚动以**查找错误消息的第一**行。
        
            com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure  <== First line
            The last packet sent successfully to the server was 0 milliseconds ago.
            The driver has not received any packets from the server.
                    at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
                    at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:57)
                    at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)
                    at java.lang.reflect.Constructor.newInstance(Constructor.java:525)
                    ......
                    ......
                    at com.mysql.jdbc.NonRegisteringDriver.connect(NonRegisteringDriver.java:305)
                    at java.sql.DriverManager.getConnection(DriverManager.java:579)
                    at java.sql.DriverManager.getConnection(DriverManager.java:221)
                    at MySQLJdbcTestJDK7.main(MySQLJdbcTestJDK7.java:7)         <== Your program's line number here (line 7)
    2.  检查位于“ `<TOMCAT_HOME>\logs`”的 Tomcat 日志文件。“ `catalina.yyyy-mm-dd.log`”显示Tomcat的启动消息。还要检查“ `localhost.yyyy-mm-dd.log`”。
6.  如果在雷击之前一切都运行良好，问问自己“我改变了什么？”

4.1 安装后无法启动Tomcat

SYMPTOM: Cannot start Tomcat after installation. The Tomcat console flashed and disappeared.
    POSSIBLE SOLUTIONS: 
      1. Run the script "configtest.bat" (for Windows) or "./configtest.sh" (for macOS/Linux) to check
         configuration files ("server.xml", "web.xml", "content.xml").
      2. Check the Tomcat's log files, located at "<TOMCAT_HOME>\logs".
         The "catalina.{yyyy-mm-dd}.log" shows the Tomcat's startup messages.
      3. Start the tomcat in the debugging mode by running "catalina debug" (or ./catalina.sh debug) and 
         type "run" in the "jdb" prompt. Look for the error messages.
      4. If the error messages indicate that another Tomcat instance is running
         (java.net.BindException: Address already in use: JVM_Bind), kill the Tomcat process (See below).
      5. If the error messages indicate that another application is running on the Tomcat's port numbers,
         then you need to change the Tomcat's port number in "server.xml".
         You can issue command "netstat -an" to check the status of all the ports.

SYMPTOM: Cannot start Tomcat
    ERROR MESSAGE: 
      SEVERE: StandardServer.await: create[localhost:8005]
      java.net.BindException: Address already in use: JVM_Bind
    POSSIBLE SOLUTIONS:
      1. Another Tomcat instance has been started. Kill it (see below).
      2. Another application is running on the Tomcat's port number.
         Change the Tomcat's port number in "server.xml".
         You can issue command "netstat -an" to check the status of all the ports.

SYMPTOM: Cannot start Tomcat after installation
    ERROR MESSAGE: 
      1. Neither the JAVA_HOME nor the JRE_HOME environment variable is defined
      2. JRE_HOME environment variable is not defined
    POSSIBLE SOLUTIONS:
      1. Check if JAVA_HOME is properly defined, via command "set JAVA_HOME" (for Windows)
         or "echo $JAVA_HOME" (for macOS/Linux). Check the spelling carefully.
      2. Define environment variable JAVA_HOME according to "Step 2: Create an Environment Variable JAVA_HOME".

SYMPTOM: Cannot start Tomcat after installation (for macOS)
    ERROR MESSAGE: 
      "Permission Denied" running catalina.sh
    POSSIBLE SOLUTIONS:
      Check if catalina.sh is executable by the current user!

定位/杀死Tomcat的进程

*  在windows中，启动“任务管理器”，Tomcat作为一个名为“ `java.exe`”的“进程”运行。您可能需要终止该进程。
 *  在 macOS 中，启动“活动监视器”。选择“所有进程”并查找“ `java.exe`”。
 *  在 Linux/macOS 中，您可以发出“ `ps aux | grep tomcat`”来定位 Tomcat 进程。记下进程 ID (pid)。您可以通过“ ”杀死Tomcat进程。`kill -9 pid`

4.2 浏览器无法访问Tomcat服务器

ERROR MESSAGE:
      (Firefox) Unable to Connect
      (IE) Internet Explorer cannot display the webpage
      (Chrome) Oops! Google Chrome could not connect to ...
      (Safari) Safari can't connect to the server
    PROBABLE CAUSES: You are simply not connecting to your Tomcat.
    POSSIBLE SOLUTION:
      1. Check if your Tomcat server has been started?
      2. Check the hostname and port number of your URL (http://localhost:9999/...)
    
    ERROR MESSAGE: Error 404 File Not Found
    PROBABLE CAUSES: You have connected to your Tomcat.
      But Tomcat server cannot find the HTML file or Servlet that your requested.
    POSSIBLE SOLUTION:
      1. Check your spelling! The path is case-sensitive!
      2. For HTML file request with URL http://localhost:9999/xxxx/filename.html:
         a. Open Tomcat's "webapps" directory, check if sub-directory "xxxx" exists. It is case-sensitive.
         b. Open the "xxxx" directory, check if "filename.html" exists.
      3. For servlet request with URL http://localhost:9999/xxxx/servletURL:
         a. Check the Tomcat's console for error message.
         b. Check the Tomcat console to make sure that your application "xxxx" has been deployed.
         c. Open Tomcat's "webapps" directory, check if sub-directory "xxxx" exists.
         d. Open the "xxxx" directory, check if sub-directory "WEB-INF" (uppercase with a dash) exists.
         e. Open the "WEB-INF", check if sub-directory "classes" (lowercase, plural) exists.
         f. Open your servlet, check if the servlet is mapped to servletURL
         g. Check if you have compiled the servlet. That is, the .class exisits (NOT .java).
    
    ERROR MESSAGE: Error 500 Internal Server Error
    POSSIBLE SOLUTION:
      Error 500 should have triggered many error message in the Tomcat's console.
      Go to the Tomcat's console, find the error message.
    
    ERROR MESSAGE: Error 505: GET (or POST) method not supported
    POSSIBLE SOLUTION:
      Check you servlet to make sure that you have defined a doGet() (or doPost()) method.

4.3 Java Servlet 错误

SYMPTOM: Cannot compile Java Servlet
    ERROR MESSAGE: class xxxx is public, should be declared in a file named xxxx.java
    CAUSES/SOLUTION:
      In Java, the filename must be the same as the classname with extension of ".java".

SYMPTOM: Cannot compile Java Servlet
    ERROR MESSAGE: package javax.servlet does not exist
    CAUSES/SOLUTION:
      The Java Servlet library is missing. Read "Step 6(b) Compiling the Servlet" 
      again, again and again....

SYMPTOM: A "new" servlet does not run
    ERROR MESSAGE:
    java.lang.IllegalStateException: Error starting child (in Tomcat console)
    The servlets named [xxx] and [yyy] are both mapped to the url-pattern [zzz] which is not permitted
    CAUSES/SOLUTION:
      Check to ensure that no two servlets are mapping to the SAME URL in @WebServlet("url")

4.4 Java 数据库 Servlet 错误

ERROR MESSAGE: No suitable driver found
    POSSIBLE SOLUTION:
      Check if you have done Step 7(c) Copy the MySQL JDBC Drive to Tomcat's "lib".
    
    ERROR MESSAGE: Communications link failure
    POSSIBLE SOLUTION:
      Check if you have started MySQL server.
    
    ERROR MESSAGE: Access denied for user 'myuser'@'localhost' (using password: YES)
    POSSIBLE SOLUTION:
      Wrong username or password in your servlet's getConnection()
    
    ERROR MESSAGE: Public Key Retrieval is not allowed
    POSSIBLE SOLUTION:
      Add jdbc:mysql://localhost:3306/ebookshop?allowPublicKeyRetrieval=true&useSSL=false to databaseURL.
    
    ERROR MESSAGE: The server time zone value '...' is unrecognized or represents more than one time zone
    POSSIBLE SOLUTION:
      Add jdbc:mysql://localhost:3306/ebookshop?serverTimezone=UTC to databaseURL.
    
    ERROR MESSAGE: You have an error in your SQL syntax ...
    POSSIBLE SOLUTION:
      SQL syntax error. Check you SQL statement.

**参考资料和资源**

1.  Apache Tomcat 母网站@http: [//tomcat.apache.org][tomcat.apache.org]。
2.  Apache Tomcat 文档@“ `<TOMCAT_HOME>\webapps\docs`”。
3.  “[如何安装 MySQL 并开始使用][MySQL]”。
4.  “ [Java 数据库 (JDBC) 编程简介][Java]”。
5.  Jason Brittain、Ian F. Darwin，“ *Tomcat 权威指南*”，第 2 版，OReilly，2007 年。

[JDK]: https://www3.ntu.edu.sg/home/ehchua/programming/howto/JDK_HowTo.html
[TomcatWebappHelloServlet.png]: https://img-blog.csdnimg.cn/img_convert/209293bd07e8dc3c1f589d06cd47483c.png
[Link 1]: https://www3.ntu.edu.sg/home/ehchua/programming/howto/Tomcat_HowTo.html#TomcatDebug
[Java]: https://www3.ntu.edu.sg/home/ehchua/programming/java/JDBC_Basic.html
[MySQL]: https://www3.ntu.edu.sg/home/ehchua/programming/sql/MySQL_HowTo.html
[MySQL JDBC]: https://www3.ntu.edu.sg/home/ehchua/programming/java/JDBC_Basic.html#MySQLJDBCDriverInstall
[HtmlFormBookQuery.png]: https://img-blog.csdnimg.cn/img_convert/ddfbb6a15fc908fcfcd8e7a81ee38ae4.png
[TomcatWebappQueryServlet.png]: https://img-blog.csdnimg.cn/img_convert/e671d981b226102bd7f766cb8bcb6ac6.png
[d4076c3bdb49752a1fb629652e7b2b8e.png]: https://img-blog.csdnimg.cn/img_convert/d4076c3bdb49752a1fb629652e7b2b8e.png
[b42ca56ae0550e81303519d53b3ae8ca.png]: https://img-blog.csdnimg.cn/img_convert/b42ca56ae0550e81303519d53b3ae8ca.png
[tomcat.apache.org]: http://tomcat.apache.org/