Tomcat Derby 教程 - 《ZetCode 中文系列教程》

Java Web 应用

原文：http://zetcode.com/java/tomcatderby/

在本教程中，我们将使用 Tomcat 和 Derby。该应用分为四个层，它具有一个控制器，并使用 DAO 访问数据。对于项目创建，我们使用 NetBeans IDE。源代码可从作者的 Github TomcatDerby 仓库中获得。

现代 Java Web 应用主要通过使用诸如 Spring 或 Vaadin 之类的框架来创建。但是有必要了解基础。

我们使用pure.css库来帮助创建用户界面。

Apache Derby 是完全用 Java 实现的开源关系数据库。它占地面积小，易于部署和安装。它支持嵌入式和客户端/服务器模式。

Apache Tomcat 是 Java Servlet，JavaServer Pages，Java Expression Language 和 Java WebSocket 技术的开源实现。

数据访问对象（DAO）是为数据库或其他持久性机制提供抽象接口的对象。 DAO 完全向其客户端隐藏了数据源实现细节。它充当组件和数据源之间的适配器。

Java Web 应用

我们在 NetBeans 中创建一个新的 Web 应用。该应用管理一个简单的Cars表。它将创建新的汽车，检索一辆汽车和所有汽车。

该应用分为四个层：表示层，模型层，服务层和持久层。 Web 应用的多层设置是重要的软件开发模式。

$ tree
.
├── nb-configuration.xml
├── pom.xml
├── README.md
└── src
    ├── main
    │   ├── java
    │   │   └── com
    │   │       └── zetcode
    │   │           ├── bean
    │   │           │   └── Car.java
    │   │           ├── persistence
    │   │           │   ├── CarDAO.java
    │   │           │   ├── Executable.java
    │   │           │   └── JdbcDAO.java
    │   │           ├── service
    │   │           │   ├── CarsService.java
    │   │           │   └── ICarsService.java
    │   │           ├── util
    │   │           │   ├── DBUtils.java
    │   │           │   ├── ServiceLocator.java
    │   │           │   └── ValidateParameter.java
    │   │           └── web
    │   │               └── Controller.java
    │   └── webapp
    │       ├── allCars.jsp
    │       ├── carSaved.jsp
    │       ├── index.jsp
    │       ├── META-INF
    │       │   └── context.xml
    │       ├── readCarId.jsp
    │       ├── readCar.jsp
    │       ├── showCar.jsp
    │       ├── unknown.jsp
    │       ├── WEB-INF
    │       └── wrongParams.jsp
    └── test
        └── java

这是项目结构。

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" 
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.mycompany</groupId>
    <artifactId>DerbyTomcat</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>war</packaging>
    <name>DerbyTomcat</name>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
    </properties>
    <dependencies>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>4.0.0</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>org.apache.derby</groupId>
            <artifactId>derbyclient</artifactId>
            <version>10.14.1.0</version>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
            <version>3.7</version>
        </dependency>
    </dependencies>
   <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.2.0</version>
                <configuration>
                    <failOnMissingWebXml>false</failOnMissingWebXml>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

pom.xml包含项目依赖项：servlet 的 JAR，JSP 页面，Derby 数据库驱动程序，JSTL 库以及某些帮助程序类的 Apache Commons Lang JAR。

Tomcat Derby 教程 - 图1

图：数据库创建

在“服务”选项卡中，我们右键单击 Java DB 节点，然后选择“创建数据库”选项。我们给它命名为testdb。该数据库位于用户主目录的.netbeans_derby目录中。

cars.sql

CREATE TABLE CARS(ID BIGINT NOT NULL PRIMARY KEY GENERATED ALWAYS AS IDENTITY 
    (START WITH 1, INCREMENT BY 1), NAME VARCHAR(30), PRICE INT);
INSERT INTO CARS(Name, Price) VALUES('Audi', 52642);
INSERT INTO CARS(Name, Price) VALUES('Mercedes', 57127);
INSERT INTO CARS(Name, Price) VALUES('Skoda', 9000);
INSERT INTO CARS(Name, Price) VALUES('Volvo', 29000);
INSERT INTO CARS(Name, Price) VALUES('Bentley', 350000);
INSERT INTO CARS(Name, Price) VALUES('Citroen', 21000);
INSERT INTO CARS(Name, Price) VALUES('Hummer', 41400);
INSERT INTO CARS(Name, Price) VALUES('Volkswagen', 21600);

这是创建Cars表的 SQL。汽车对象的 ID 会自动增加。我们可以使用 NetBeans 工具创建Cars表。我们右键单击“数据库”节点，然后选择“新建连接”选项。

Tomcat Derby 教程 - 图2

图：连接向导

我们在连接向导中填写必要的详细信息。我们使用 Derby 网络驱动程序； Derby 的端口是 1527。

Tomcat Derby 教程 - 图3

图：连接

创建一个新的连接对象；它由橙色图标表示。其上下文菜单提供了用于连接到指定数据库并执行命令的选项。 “执行命令”选项显示了执行 SQL 命令的工具。在此窗口中，我们可以使用上面的 SQL 创建Cars表。

Tomcat Derby 教程 - 图4

图：NetBeans Derby 工具

NetBeans 具有有用的 Derby 工具，可用于管理 Derby 数据库。

context.xml

<?xml version="1.0" encoding="UTF-8"?>
<Context path="/DerbyTomcat">
    <Resource name="jdbc/testdb"
              auth="Container" 
              type="javax.sql.DataSource"
              driverClassName="org.apache.derby.jdbc.ClientDriver" 
              username="app"
              password="app" 
              url="jdbc:derby://localhost:1527/testdb" 
              maxActive="10" maxIdle="4" 
    />
</Context>

在META-INF目录中的context.xml文件中，我们提供了数据源。使用 JNDI API 查找资源。

模型层

模型层具有Car类。

Car.java

package com.zetcode.bean;
import java.util.Objects;
public class Car {
    private Long id;
    private String name;
    private int price;
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public int getPrice() {
        return price;
    }
    public void setPrice(int price) {
        this.price = price;
    }
    public Long getId() {
        return id;
    }
    public void setId(Long id) {
        this.id = id;
    }
    @Override
    public int hashCode() {
        int hash = 7;
        hash = 61 * hash + Objects.hashCode(this.id);
        hash = 61 * hash + Objects.hashCode(this.name);
        hash = 61 * hash + this.price;
        return hash;
    }
    @Override
    public boolean equals(Object obj) {
        if (this == obj) {
            return true;
        }
        if (obj == null) {
            return false;
        }
        if (getClass() != obj.getClass()) {
            return false;
        }
        final Car other = (Car) obj;
        if (this.price != other.price) {
            return false;
        }
        if (!Objects.equals(this.name, other.name)) {
            return false;
        }
        return Objects.equals(this.id, other.id);
    }    
}

Car类具有三个属性以及相应的获取器和设置器方法。

表示层

应用的表示层包含 JSP 页面，这些页面构建了应用的用户界面。

index.jsp

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@page trimDirectiveWhitespaces="true"%>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!DOCTYPE html>
<html>
    <head>
        <title>Home page</title>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1">
    </head>
    <body>
        <h2>Home page</h2>
        <p>Available actions:</p>
        <ul>
            <li><a href="controller?action=listcars">Show all</a></li>
            <li><a href="controller?action=readbyid">Show car by ID</a></li>
            <li><a href="controller?action=readcar">Create a new car</a></li>
        </ul>
            <a href="<%= request.getContextPath() %>">Home</a>
    </body>
</html>

index.jsp页面包含三个可用操作的链接：显示所有汽车，显示通过其 ID 找到的汽车以及创建新汽车。

<a href="<%= request.getContextPath() %>">Home</a>

使用getContextPath()方法，我们可以获得主页路径。

allCars.jsp

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@page trimDirectiveWhitespaces="true"%>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!DOCTYPE html>
<html>
    <head>
        <title>Cars</title>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1">
        <link rel="stylesheet" href="https://unpkg.com/purecss@1.0.0/build/pure-min.css" 
              integrity="sha384-nn4HPE8lTHyVtfCBi5yW9d20FjT8BJwUXyWZT9InLYax14RDjBj46LmSztkmNP9w"
              crossorigin="anonymous">  
        <style>
            body { padding:1em }
            nav { margin-top: 2em }
        </style>
    </head>
    <body>
        <h2>All cars</h2>
        <table class="pure-table pure-table-horizontal">
            <thead>
                <tr>
                    <th>Id</th>
                    <th>Name</th>
                    <th>Price</th>
                </tr>
            </thead>
            <c:forEach items="${carList}" var='car'>
                <tr>
                    <td>
                        <c:out value="${car.id}"/>
                    </td>
                    <td>
                        <c:out value="${car.name}"/>
                    </td>
                    <td>
                        <c:out value="${car.price}"/>
                    </td>                    
                </tr>
            </c:forEach>          
        </table>
            <a href="<%= request.getContextPath() %>">Home</a>
    </body>
</html>

在allCars.jsp页面中，JSTL 的<c:forEach>和<c:out>标签用于打印每个返回的汽车对象的属性。

<table class="pure-table pure-table-horizontal">

我们使用pure.css类来设计表。

readCar.jsp

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@page trimDirectiveWhitespaces="true" %>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!DOCTYPE html>
<html>
    <head>
        <title>Car details</title>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1">
        <link rel="stylesheet" href="https://unpkg.com/purecss@1.0.0/build/pure-min.css" 
              integrity="sha384-nn4HPE8lTHyVtfCBi5yW9d20FjT8BJwUXyWZT9InLYax14RDjBj46LmSztkmNP9w"
              crossorigin="anonymous">      
        <style>
            body { padding:1em }
            nav { margin-top: 2em }
        </style>
    </head>
    <body>
        <form class="pure-form pure-form-stacked" action="controller?action=savecar" method="post">
            <legend>Enter car details:</legend>
            <label for="carName">Name:</label>
            <input id="carName" type="text" name="carName">
            <label for="carPrice">Price:</label>
            <input id ="carPrice" type="text" name="carPrice">
            <button class="pure-button pure-button-primary" type="submit">Submit</button>
        </form>
            <a href="<%= request.getContextPath() %>">Home</a>
    </body>
</html>

在readCar.jsp页面上，我们有一个表格来输入新车的详细信息。

readCarId.jsp

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@page trimDirectiveWhitespaces="true"%>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!DOCTYPE html>
<html>
    <head>
        <title>Enter car ID</title>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1">
        <link rel="stylesheet" href="https://unpkg.com/purecss@1.0.0/build/pure-min.css" 
              integrity="sha384-nn4HPE8lTHyVtfCBi5yW9d20FjT8BJwUXyWZT9InLYax14RDjBj46LmSztkmNP9w"
              crossorigin="anonymous">  
        <style>
            body { padding:1em }
            nav { margin-top:2em }
        </style>        
    </head>
    <body>
        <form class="pure-form pure-form-stacked" action="controller">
            <legend>Enter car Id</legend>
            <input type="hidden" name="action" value="viewcar">
            <label for="carId">Id:</label>
            <input id="carId" type="text" name="carId">
            <button class="pure-button pure-button-primary" type="submit">Submit</button>
        </form>
            <a href="<%= request.getContextPath() %>">Home</a>
    </body>
</html>

在readCarId.jsp文件中，我们有一个表格来输入我们要检索的汽车 ID。

carSaved.jsp

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@page trimDirectiveWhitespaces="true"%>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<!DOCTYPE html>
<html>
    <head>
        <title>Car saved</title>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1">
    </head>
    <body>
        <p>
            Successfully saved  <c:out value="${sessionScope.carName}"/>
            car priced <c:out value="${sessionScope.carPrice}"/>
        </p>
            <a href="<%= request.getContextPath() %>">Home</a>
    </body>
</html>

在carSaved.jsp页面中，我们仅通知您已保存具有给定名称和价格的汽车。我们使用 JSTL 库中的<c:out>标签。

showCar.jsp

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@page trimDirectiveWhitespaces="true"%>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!DOCTYPE html>
<html>
    <head>
        <title>Returned car</title>        
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1">
    </head>
    <body>
        <h2>Car details</h2>
        <ul>
            <li>ID: <c:out value="${returnedCar.id}"/></li>
            <li>Name: <c:out value="${returnedCar.name}"/></li>
            <li>Price: <c:out value="${returnedCar.price}"/></li>
        </ul>
            <a href="<%= request.getContextPath() %>">Home</a>
    </body>
</html>

在showCar.jsp页面中，我们显示检索到的汽车的属性。

unknown.jsp

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@page trimDirectiveWhitespaces="true"%>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<!DOCTYPE html>
<html>
    <head>
        <title>Unknown action</title>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1">
    </head>
    <body>
        <h2>Unknown action</h2>
            <a href="<%= request.getContextPath() %>">Home</a>
    </body>
</html>

当控制器收到未定义的动作时，将显示unknown.jsp页面。

wrongParams.jsp

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@page trimDirectiveWhitespaces="true"%>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<!DOCTYPE html>
<html>
    <head>
        <title>Wrong parameters</title>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1">
    </head>
    <body>
        <h2>Wrong parameters specified</h2>
            <a href="<%= request.getContextPath() %>">Home</a>
    </body>
</html>

请求参数无效时，显示wrongParams.jsp页面。创建名为ValidateParameter的工具类以确保请求参数的有效性。

服务层

服务层提供逻辑以对发送到 DAO 和从 DAO 发送的数据进行操作。

ICarsService.java

package com.zetcode.service;
import com.zetcode.bean.Car;
import java.util.List;
public interface ICarsService {
    public List<Car> findAllCars();
    public Car findCar(Long id);
    public void saveCar(Car car);
}

ICarsService为汽车服务提供了三种合同方式。我们提供了一种检索所有汽车，查找特定汽车并保存新汽车的方法。

CarsService.java

package com.zetcode.service;
import com.zetcode.bean.Car;
import com.zetcode.persistence.CarDAO;
import com.zetcode.persistence.JdbcDAO;
import java.util.List;
public class CarsService implements ICarsService {
    @Override
    public List<Car> findAllCars() {
        CarDAO carDAO = new JdbcDAO();
        return carDAO.findAll();
    }
    @Override
    public Car findCar(Long id) {
        CarDAO carDAO = new JdbcDAO();
        return carDAO.findCar(id);
    }
    @Override
    public void saveCar(Car car) {
        CarDAO carDAO = new JdbcDAO();
        carDAO.saveCar(car);
    }
}

CarsService提供合同方法的实现。

@Override
public List<Car> findAllCars() {
    CarDAO carDAO = new JdbcDAO();
    return carDAO.findAll();
}

findAllCars()方法创建一个JdbcDAO并调用其findAll()方法。

持久层

在持久层中，我们应用 DAO 模式。 DAO 在定义的 API 中隐藏了数据库编程的复杂性。

CarDAO.java

package com.zetcode.persistence;
import com.zetcode.bean.Car;
import java.util.List;
public interface CarDAO {
  public void saveCar(Car car);
  public Car findCar(Long id);
  public List<Car> findAll();
}

这是CarDAO接口，显示用于访问我们的数据库的方法签名。

Executable.java

package com.zetcode.persistence;
import java.sql.SQLException;
import javax.naming.NamingException;
public interface Executable {
    void exec() throws SQLException, NamingException;
}

Executable接口是将try/catch/finally样板放入exec()方法的合约。

JdbcDAO.java

package com.zetcode.persistence;
import com.zetcode.bean.Car;
import com.zetcode.util.DBUtils;
import com.zetcode.util.ServiceLocator;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.util.ArrayList;
import java.util.List;
import java.util.logging.Level;
import java.util.logging.Logger;
import javax.naming.NamingException;
import java.sql.SQLException;
import javax.sql.DataSource;
public class JdbcDAO implements CarDAO {
    private static final String DATA_SOURCE = "java:comp/env/jdbc/testdb";
    private Connection con;
    private ResultSet rs;
    private PreparedStatement pst;
    @Override
    public void saveCar(Car car) {
        execute(() -> {
            DataSource ds = ServiceLocator.getDataSource(DATA_SOURCE);
            con = ds.getConnection();
            pst = con.prepareStatement("INSERT INTO CARS(Name, Price) VALUES(?, ?)");
            pst.setString(1, car.getName());
            pst.setInt(2, car.getPrice());
            pst.executeUpdate();
        });
    }
    @Override
    public Car findCar(Long id) {
        Car car = new Car();
        execute(() -> {
            DataSource ds = ServiceLocator.getDataSource(DATA_SOURCE);
            con = ds.getConnection();
            pst = con.prepareStatement("SELECT * FROM CARS WHERE Id = (?)");
            pst.setLong(1, id);
            rs = pst.executeQuery();
            if (rs.next()) {
                car.setId(rs.getLong(1));
                car.setName(rs.getString(2));
                car.setPrice(rs.getInt(3));
            }
        });
        return car;
    }
    @Override
    public List<Car> findAll() {
        List<Car> carList = new ArrayList<>();
        execute(() -> {
            DataSource ds = ServiceLocator.getDataSource(DATA_SOURCE);
            con = ds.getConnection();
            pst = con.prepareStatement("SELECT * FROM CARS");
            rs = pst.executeQuery();
            while (rs.next()) {
                Car car = new Car();
                car.setId(rs.getLong(1));
                car.setName(rs.getString(2));
                car.setPrice(rs.getInt(3));
                carList.add(car);
            }
        });
        return carList;
    }
    private void execute(Executable executable) {
        try {
            executable.exec();
        } catch (NamingException | SQLException e) {
            Logger lgr = Logger.getLogger(JdbcDAO.class.getName());
            lgr.log(Level.SEVERE, e.getMessage(), e);
        } finally {
            DBUtils.closeResultSet(rs);
            DBUtils.closeStatement(pst);
            DBUtils.closeConnection(con);
        }
    }
}

JdbcDAO是CarDAO接口的具体实现。它使用 JDBC 从Cars表中插入和检索数据。

private static final String DATA_SOURCE = "java:comp/env/jdbc/testdb";

这是用于定位testdb数据库的 JNDI 资源名称。

@Override
public void saveCar(Car car) {
    execute(() -> {
        DataSource ds = ServiceLocator.getDataSource(DATA_SOURCE);
        con = ds.getConnection();
        pst = con.prepareStatement("INSERT INTO CARS(Name, Price) VALUES(?, ?)");
        pst.setString(1, car.getName());
        pst.setInt(2, car.getPrice());
        pst.executeUpdate();
    });
}

saveCar()方法保存一个新的汽车对象。 ServiceLocator.getDataSource()方法查找并返回数据源。该代码已插入execute()方法中，该方法将处理try/catch/finally样板。

@Override
public Car findCar(Long id) {
    Car car = new Car();
    execute(() -> {
        DataSource ds = ServiceLocator.getDataSource(DATA_SOURCE);
        con = ds.getConnection();
        pst = con.prepareStatement("SELECT * FROM CARS WHERE Id = (?)");
        pst.setLong(1, id);
        rs = pst.executeQuery();
        if (rs.next()) {
            car.setId(rs.getLong(1));
            car.setName(rs.getString(2));
            car.setPrice(rs.getInt(3));
        }
    });
    return car;
}

findCar()方法从Cars表中检索新车。它执行准备好的语句，该语句接收汽车的 ID。一个新的car bean 填充了返回的数据。

private void execute(Executable executable) {
    try {
        executable.exec();
    } catch (NamingException | SQLException e) {
        Logger lgr = Logger.getLogger(JdbcDAO.class.getName());
        lgr.log(Level.SEVERE, e.getMessage(), e);
    } finally {
        DBUtils.closeResultSet(rs);
        DBUtils.closeStatement(pst);
        DBUtils.closeConnection(con);
    }
}

处理异常的重复代码位于execute()方法中。

工具类

我们创建了三个工具类：ServiceLocator，ValidateParameter和DBUtils。这些类位于com.zetcode.util包中。

ServiceLocator.java

package com.zetcode.util;
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.naming.NamingException;
import javax.sql.DataSource;
public class ServiceLocator {
    public static DataSource getDataSource(String jndiName) throws NamingException {
        Context ctx = new InitialContext();
        DataSource ds = (DataSource) ctx.lookup(jndiName);
        return ds;
    }
}

ServiceLocator查找并返回数据源。从JdbcDAO类调用它。数据源的详细信息在context.xml文件中指定。

ValidateParameter.java

package com.zetcode.util;
import org.apache.commons.lang3.math.NumberUtils;
public class ValidateParameter {
    private static final int MAX_PRICE_CAR = 10_000_000;
    public static boolean validateName(String param) {
        return !(null == param || "".equals(param));
    }
    public static boolean validateId(String param) {
        return !(null == param || "".equals(param) || 
                !NumberUtils.isCreatable(param));
    }   
    public static boolean validatePrice(String param) {
       if (null == param || "".equals(param) || !NumberUtils.isCreatable(param)) {
           return false;
       }
       int price = Integer.valueOf(param);
       return !(price < 0 || price > MAX_PRICE_CAR);
    } 
}

ValidateParameter具有用于验证请求参数的静态方法。例如，ID 必须为数字，且价格不得为负。我们使用 Apache Commons Lang 库中的NumberUtils.isCreatable()方法来确保参数为数字。

DBUtils.java

package com.zetcode.util;
import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;
import java.util.logging.Level;
import java.util.logging.Logger;
public class DBUtils {
    private static final Logger logger = Logger.getLogger(DBUtils.class.getName());
    public static void closeResultSet(ResultSet rs) {
        if (rs != null) {
            try {
                rs.close();
            } catch (SQLException ex) {
                logger.log(Level.FINEST, "Could not close JDBC ResultSet", ex);
            } catch (Throwable ex) {
                // We don't trust the JDBC driver: It might throw RuntimeException or Error.
                logger.log(Level.FINEST, "Unexpected exception on closing JDBC ResultSet", ex);
            }
        }
    }
    public static void closeStatement(Statement stmt) {
        if (stmt != null) {
            try {
                stmt.close();
            } catch (SQLException ex) {
                logger.log(Level.FINEST, "Could not close JDBC Statement", ex);
            } catch (Throwable ex) {
                // We don't trust the JDBC driver: It might throw RuntimeException or Error.
                logger.log(Level.FINEST, "Unexpected exception on closing JDBC Statement", ex);
            }
        }
    }    
    public static void closeConnection(Connection con) {
        if (con != null) {
            try {
                con.close();
            } catch (SQLException ex) {
                logger.log(Level.FINEST, "Could not close JDBC Connection", ex);
            } catch (Throwable ex) {
                // We don't trust the JDBC driver: It might throw RuntimeException or Error.
                logger.log(Level.FINEST, "Unexpected exception on closing JDBC Connection", ex);
            }
        }
    }
}

DBUtils包含释放数据库资源和处理异常的方法。

控制器

Controller是一个 Servlet，它接收传入的请求，调用服务方法并发送响应。

Controller.java

package com.zetcode.web;
import com.zetcode.bean.Car;
import com.zetcode.persistence.CarDAO;
import com.zetcode.persistence.JdbcDAO;
import com.zetcode.service.CarsService;
import com.zetcode.service.ICarsService;
import com.zetcode.util.ValidateParameter;
import java.io.IOException;
import javax.servlet.RequestDispatcher;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet(name = "Controller", urlPatterns = {"/controller"})
public class Controller extends HttpServlet {
    private static final String ACTION_KEY = "action";
    private static final String READ_CAR_BY_ID_VIEW = "readCarId.jsp";
    private static final String SHOW_CAR_VIEW = "showCar.jsp";
    private static final String READ_CAR_VIEW = "readCar.jsp";
    private static final String CAR_SAVED_VIEW = "carSaved.jsp";
    private static final String ALL_CARS_VIEW = "allCars.jsp";
    private static final String UNKNOWN_VIEW = "unknown.jsp";
    private static final String WRONG_PARAMS_VIEW = "wrongParams.jsp";
    private static final String LIST_CARS_ACTION = "listcars";
    private static final String READ_CAR_BY_ID_ACTION = "readbyid";
    private static final String READ_CAR_ACTION = "readcar";
    private static final String VIEW_CAR_ACTION = "viewcar";
    private static final String SAVE_CAR_ACTION = "savecar";
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        String actionName = request.getParameter(ACTION_KEY);
        String page = UNKNOWN_VIEW;
        if (LIST_CARS_ACTION.equals(actionName)) {
            ICarsService service = new CarsService();
            request.setAttribute("carList", service.findAllCars());
            page = ALL_CARS_VIEW;
        }
        if (READ_CAR_BY_ID_ACTION.equals(actionName)) {
            page = READ_CAR_BY_ID_VIEW;
        }     
        if (READ_CAR_ACTION.equals(actionName)) {
            page = READ_CAR_VIEW;
        }             
        if (VIEW_CAR_ACTION.equals(actionName)) {
            String sid = request.getParameter("carId");
            if (ValidateParameter.validateId(sid)) {
                ICarsService service = new CarsService();
                Long carId = Long.valueOf(sid);
                request.setAttribute("returnedCar", service.findCar(carId));
                page = SHOW_CAR_VIEW;
            } else {
                page = WRONG_PARAMS_VIEW;
            }
        }
        RequestDispatcher disp = getServletContext().getRequestDispatcher("/" + page);
        disp.forward(request, response);
    }
    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        String actionName = request.getParameter(ACTION_KEY);
        String page = UNKNOWN_VIEW;        
        if (SAVE_CAR_ACTION.equals(actionName)) {
            String sname = request.getParameter("carName");
            String sprice = request.getParameter("carPrice");
            if (ValidateParameter.validateName(sname)
                    && ValidateParameter.validatePrice(sprice)) {
                Car car = new Car();
                car.setName(sname);
                car.setPrice(Integer.valueOf(sprice));
                ICarsService service = new CarsService();
                service.saveCar(car);
                request.getSession().setAttribute("carName", sname);
                request.getSession().setAttribute("carPrice", sprice);
                page = CAR_SAVED_VIEW;
            } else {
                page = WRONG_PARAMS_VIEW;
            }
        }    
        response.sendRedirect(page);
    }
}

该 servlet 位于com.zetcode.web包中。

private static final String READ_CAR_BY_ID_VIEW = "readCarId.jsp";
private static final String SHOW_CAR_VIEW = "showCar.jsp";
private static final String READ_CAR_VIEW = "readCar.jsp";
...

这些是我们的应用中使用的各种视图。

private static final String LIST_CARS_ACTION = "listcars";
private static final String READ_CAR_BY_ID_ACTION = "readbyid";
private static final String READ_CAR_ACTION = "readcar";
...

这些是应用的各种动作。例如，READ_CAR_ACTION显示的视图包含一个表单，用户可以在其中输入新车的详细信息。

if (LIST_CARS_ACTION.equals(actionName)) {
    ICarsService service = new CarsService();
    request.setAttribute("carList", service.findAllCars());
    page = ALL_CARS_VIEW;
}

对于LIST_CARS_ACTION，我们创建一个CarsService对象。我们调用findAllCars()服务方法，并将结果设置为carList属性。然后，控制器 Servlet 指向ALL_CARS_VIEW。

if (VIEW_CAR_ACTION.equals(actionName)) {
    String sid = request.getParameter("carId");
    if (ValidateParameter.validateId(sid)) {
        ICarsService service = new CarsService();
        Long carId = Long.valueOf(sid);
        request.setAttribute("returnedCar", service.findCar(carId));
        page = SHOW_CAR_VIEW;
    } else {
        page = WRONG_PARAMS_VIEW;
    }
}

为了查看一辆汽车，我们从request参数中获得了汽车的 ID。该值使用ValidateParameter.validateId()工具方法进行验证。（该值不能为null，为空，并且必须为数字。）如果参数无效，则控制器导航至WRONG_PARAMS_VIEW。

findCar()尝试从数据库中检索汽车。返回的汽车将插入returnedCar属性，该属性随后会在showCar.jsp页面中获取。

if (ValidateParameter.validateName(sname)
        && ValidateParameter.validatePrice(sprice)) {
    Car car = new Car();
    car.setName(sname);
    car.setPrice(Integer.valueOf(sprice));
    ICarsService service = new CarsService();
    service.saveCar(car);
    request.getSession().setAttribute("carName", sname);
    request.getSession().setAttribute("carPrice", sprice);
    page = CAR_SAVED_VIEW;
} else {
    page = WRONG_PARAMS_VIEW;
}

该代码位于doPost()方法中。保存新车时，我们有两个参数：汽车的名称和价格。该 ID 由 Derby 自动创建。验证参数，并创建一个新的Car对象并填充参数。 saveCar()将汽车对象保存到数据库中。汽车的名称将传递到CAR_SAVED_VIEW，以便向用户创建消息。由于我们在doPost()方法中使用了重定向，因此我们将汽车的名称及其价格放入会话对象；进行重定向操作后，我们会从原始请求中删除数据。

response.sendRedirect(page);

遵循发布/重定向/获取模式，我们将重定向到doPost()方法中的视图。这样可以防止提交多个表单。（例如，我们可能不小心多次添加了汽车）。

Tomcat Derby 教程 - 图5

图：显示所有汽车

在本教程中，我们创建了一个简单的 Web 应用框架，用于管理汽车对象。数据已保存在 Derby 数据库中。

该应用分为四层。我们已经使用 DAO 模式进行数据访问。您可以在 ZetCode 的 Derby 教程中找到有关 Derby 的更多信息。在中显示数据网格中的数据教程中，我们展示了如何在 EasyUI datagrid 控件中显示来自 Derby 数据库的数据。