概要
JSPの学習をしていて、DBに接続しようとしたときに発生した例外やエラーへの対処法をまとめてみました。また、学習するにあたり、なかなかいいサンプルコードを見つけることができなかったので、最後には簡単なサンプルも記載しています。
環境
Tomcat 8.5
Eclipse IDE for Java EE Developers
mysql-connector-java-8.0.13
問題の解決方法
データベースに接続できない
"No suitable driver found"という例外が発生し、データベースに接続できず、どうやったら解決できるものかと色々検索した結果、TomcatのlibフォルダーにJDBC driver（mysql-connector-java-8.0.13.jar）を入れていないことがわかりました。EclipseでJava Build Pathに追加しただけで、Tomcatの方には追加していませんでした。案外簡単なミスのように思われるかもしれませんが、初学者の私は解決策を見つけるのに苦労しました...。
（参考：https://stackoverflow.com/questions/1911253/（英語））
timezoneに関するエラーへの対処
原因はわかりませんが、Windowsでテストした際に、"The server time zone value '◇◇◇◇◇' is unrecognized or represents more than one time zone."（◇の部分は明らかな文字化け）というエラーが発生しました。その場合はencodingとserverTimezoneを設定することで回避できるようです。
（参考：https://www.nakamuri.info）
con = DriverManager.getConnection(
"jdbc:mysql://localhost:3306/test_db?characterEncoding=" +
"UTF-8&serverTimezone=JST",
"ユーザ名", "パスワード");
コード
データベースに名前を追加するだけの簡単なプログラム。本来は入力値をエスケープさせた方がよいのでしょうが、ここでは簡略化のため、そのまま利用しています。
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Database Test</title>
</head>
<body>
<form method="POST" action="add_name.jsp">
<label for="name">名前: </label>
<input type="text" name="name">
<input type="submit" value="送信">
</form>
</body>
</html>
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"
import="java.sql.*"%>
<%
request.setCharacterEncoding("UTF-8");
// データベースに接続
Connection connect = DriverManager.getConnection(
"jdbc:mysql://localhost:3306/sample_db?" +
"UTF-8&serverTimezone=JST",
"root", "root");
PreparedStatement ps = connect.prepareStatement
("INSERT INTO names (name) values (?)");
String name = request.getParameter("name");
ps.setString(1, request.getParameter("name"));
ps.executeUpdate();
connect.close();
ps.close();
%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Database Test</title>
</head>
<body>
<p><%=name %>さんを追加しました。</p>
<a href="index.jsp">戻る</a>
</body>
</html>
追記
この記事を投稿した後、参考書等をしっかり読んでみたところ、データベースへの接続にはDataSourceクラスのオブジェクトを利用するのが一般的だとわかりました。
この方法を利用するためには、まずcontext.xmlでデータソースの情報を定義します。
ここではsample_dbというデータベースにnamesというテーブルが存在すると仮定します。
<Context displayName="JSP Samples" docBase="jspSample"
path="/jspSample" reloadable="true">
<Resource name="jdbc/sample" auth="Container"
type="javax.sql.DataSource"
username="root" password=""
driverClassName="com.mysql.jdbc.Driver"
url="jdbc:mysql://localhost/sample_db?characterEncoding=utf-8&serverTimezone=JST"
maxActive="4" maxWait="5000" maxIdle="2"
validationQuery="SELECT count(*) FROM names" />
</Context>
そして、jspファイルのほうで、以下のように変更します。
// データベースにDriverManagerを使って接続する場合
Connection connect = DriverManager.getConnection(
"jdbc:mysql://localhost:3306/sample_db?" +
"UTF-8&serverTimezone=JST",
"root", "root");
// 上記のコードをDataSourceを利用する以下のコードに書き換える
Context context = new InitialContext();
DataSource ds = (DataSource)context.lookup("java:comp/env/jdbc/sample");
Connection db = ds.getConnection();
DataSourceクラスを用いることで、コネクションプーリングを利用することとなり、接続にかかる処理が省電力化できるそうです。（参考書：JSP & サーブレット入門教室)