2020/10/30 Updated by

Java: JDBC

Javaのプログラムでデータベースにアクセスをする

[前提条件]

ローカルホスト(IPアドレス127.0.0.1)上で MariaDB が動作している。
MariaDB プロセスに対して、ローカルホストからネットワーク接続できる。(Windowsのfirewallの話)
MariaDB 内にデータベース nittaDB があり、その中にテーブル article が存在している。(MariaDBの話)
データベース nittaDB に対して、ユーザ nitta がネットワーク経由でパスワード PasswordOfNitta を用いてアクセスできる権限が設定されている。(MariaDBのユーザ権限の話)
上記の緑色の文字の部分 は自分の環境に合わせて置き換えて読むこと。
具体的にはこちらの手順でWindows10上にインストールしたxamp 内のMariaDB データベースサーバに「新しいデータベースとユーザを追加」した状態を想定している。

[注意] ここではMariaDBを想定して説明しているが、MySQLを利用する場合は jdbc　が異なるので注意する。 MySQL の場合はこちらを参照すること。少し古いが mysql-connector-java-5.1.16-bin.jar も使える。

手元のjava環境にMariaDBデータベースサーバにアクセスする機能を追加する

Java 8 以降がインストールされていることを確認する。もしもJavaがインストールされていなければOpenJDKまたはAzul Zuluをインストールする。Windowsだとどちらでも構わない。macOSの場合は Azul Zule の方がインストールが楽だと思われる。
javaからデータベースにアクセスするには JDBC (Java Database Connectivity)が必要となる。また、データベース毎に用意されたドライバが必要となる。ドライバはJavaの標準のクラスライブラリには含まれていないので、自分で入手して実行時のクラスパスに置く必要がある。
MariaDBの公式サイトから jdbc (Connector/J) をダウンロードする。

https://mariadb.com/kb/en/about-mariadb-connector-j/

適切な場所に jar ファイルを配置する。
jarファイルへのパスをCLASSPATH環境変数に含めるように設定する。

環境変数を設定した後で起動したプログラム(たとえばコマンドプロンプト等)では、CLASSPATH変数に値が設定されている。 CLASSPATH変数に値を設定する場合は、必ず '.' (カレント・ディレクトリ)も先頭に含めておくこと。複数の値を設定する場合は ';' (セミコロン)でつなぐ。

システムの詳細設定 → システムのプロパティ → 環境変数 → 「システム環境変数」に対して「新規」または「編集」 → 「CLASSPATH」変数に ';' でつないで(フォルダまたはjarファイルへの)パスを指定する。

    変数名: CLASSPATH
    変数値: .;C:\Users\nitta\Documents\java\lib\mariadb-java-client-2.7.0.jar;C:\xampp\tomcat\lib\servlet-api.jar

javaプログラムでMariaDBデータベースサーバにデータを追加する

SQLを使うJavaプログラムをコンパイルして実行してみる。

緑色の文字の部分 は自分の環境に合わせて書き換えること。

InsertDB.java

import java.sql.*;

public class InsertDB {
    public static void main(String[] args) {
	String host="127.0.0.1";
	String db = "nittaDB";
	String user = "nitta";
	String pass = "PasswordOfNitta";
	String tbl = "article";

	String url=null;
	Connection con=null;
	PreparedStatement pst=null;
	String insertSql = "insert into "+tbl
	    +" (cdate,title,uname,contents) values(now(),?,?,?)";
	try {
	    Class.forName("org.mariadb.jdbc.Driver");
	    url = "jdbc:mysql://"+host+"/"+db
		+"?useUnicode=true&characterEncoding=utf8";
	    con = DriverManager.getConnection(url,user,pass);
	    pst = con.prepareStatement(insertSql);
	} catch (Exception e) {
	    e.printStackTrace();
	    System.exit(1);
	}

	try {
	    pst.setString(1,"山田太郎");
	    pst.setString(2,"あいさつ");
	    pst.setString(3,"こんにちは");
	    pst.executeUpdate();
	} catch (Exception e) {
	    e.printStackTrace();
	}
	
	try {
	    pst.close();
	    con.close();
	} catch (Exception e) {}
    }
}

InsertDB.javaの実行例

C:\Users\nitta> cd Documents\java\jdbc 
C:\Users\nitta\Documents\java\jdbc> javac -encoding utf8 InsertDB.java  ← ソースのencodingを指定して、コンパイルする
C:\Users\nitta\Documents\java\jdbc> java InsertDB      ← InsertDBを実行する。何も表示されなければエラーは起きていない。
C:\Users\nitta\Documents\java\jdbc> echo %CLASSPATH%       ← CLASSPATH環境変数を値を表示してみる(オプション)
.;C:\Users\nitta\Documents\java\lib\mariadb-java-client-2.7.0.jar;C:\xampp\tomcat\lib\servlet-api.jar
C:\Users\nitta\Documents\java\jdbc>

pypMyAdminを表示しているブラウザで、nittaDBデータベースのarticleテーブルの[表示]タブを選択すると、テーブルに登録されているデータを確認できる。

javaプログラムでMariaDBデータベースサーバからデータを取得する

SQLを使うJavaプログラムをコンパイルして実行してみる。

緑色の文字の部分 は自分の環境に合わせて書き換えること。

SelectDB.java

import java.sql.*;

public class SelectDB {
    public static void main(String[] args) {
	String host="127.0.0.1";
	String db = "nittaDB";
	String user = "nitta";
	String pass = "PasswordOfNitta";
	String tbl = "article";

	String url=null;
	Connection con=null;
	Statement st=null;
	try {
	    Class.forName("org.mariadb.jdbc.Driver");
	    url = "jdbc:mysql://"+host+"/"+db
		+"?useUnicode=true&characterEncoding=utf8";
	    con = DriverManager.getConnection(url,user,pass);
	    st = con.createStatement();
	} catch (Exception e) {
	    e.printStackTrace();
	    System.exit(1);
	}

	try {
	    ResultSet rs = st.executeQuery("select * from "+tbl);
	    while (rs.next()) {
		int id = rs.getInt("id");
		Date cd = rs.getDate("cdate");
		String ti = rs.getString("title");
		String un = rs.getString("uname");
		String co = rs.getString("contents");
		System.out.println(id+":"+cd+":"+ti+"["+un+"]");
		System.out.println(co);
	    }
	} catch (Exception e) {
	    e.printStackTrace();
	}
	
	try {
	    st.close();
	    con.close();
	} catch (Exception e) {}
    }
}

SelectDB.javaの実行例

C:\Users\nitta> cd Documents\java\jdbc 
C:\Users\nitta\Documents\java\jdbc> javac -encoding utf8 SelectDB.java  ← ソースのencodingを指定して、コンパイルする
C:\Users\nitta\Documents\java\jdbc> java SelectDB      ← SelectDBを実行する。データベースのデータが表示される。
1:2020-10-30:山田太郎[あいさつ]    ← id:cdate:uname[title]
こんにちは                             ← contents

C:\Users\nitta\Documents\java\jdbc>