ServletとJDBCでINSERT文を実行する方法を初心者向けに徹底解説

INSERT文の基本「データを追加する」書き方

新人と先輩の会話形式で理解しよう

新人

「JavaのServletでデータベースにデータを追加するにはどうすればいいんですか？」

先輩

「データベースにデータを追加するときは、SQLというデータベース専用の言語のINSERT文を使うんだ。そしてJavaではJDBCという仕組みを使って、そのSQLを実行する。」

新人

「INSERT文って何ですか？プログラミング初心者でも理解できますか？」

先輩

「INSERT文はデータベースのテーブルに新しいデータを追加するための命令だよ。たとえば会員登録フォームで名前やメールアドレスを入力したとき、その情報をデータベースに保存する処理に使われる。」

新人

「なるほど。ServletとJDBCを使えば、そのINSERT文をJavaプログラムから実行できるんですね。」

先輩

「その通り。まずはServletとJDBCの役割から順番に理解していこう。」

1. ServletとJDBCによるINSERT文の基本役割

JavaのWebアプリケーション開発では、ユーザーが入力したデータをデータベースに保存する処理が頻繁に登場します。例えば会員登録、商品登録、問い合わせフォーム、予約システムなど、多くのWebシステムでデータ登録処理が必要になります。

このときに使われる代表的なSQLがINSERT文です。INSERT文とは、データベースのテーブルに新しい行を追加するためのSQL命令です。

例えば「ユーザー」というテーブルに新しい会員を登録する場合、名前やメールアドレスなどの情報をデータベースに保存します。このような処理をJavaのServletから実行することで、Webアプリケーションとして動作する仕組みになります。

ここで重要になるのが次の二つの技術です。

Servlet

JavaでWebアプリケーションを作るための仕組みです。ブラウザから送られてきたデータを受け取り、処理を実行します。

JDBC

Javaからデータベースを操作するための標準技術です。SQL文をJavaプログラムから実行するために使用します。

つまり、Webシステムのデータ登録処理は次の流れで行われます。

ブラウザからフォーム送信

Servletがリクエストを受け取る

JDBCを使ってデータベースへ接続

INSERT文を実行してデータを追加

この仕組みを理解すると、JavaのWebアプリケーション開発の基本構造が見えてきます。プログラミング初心者の方は、まず「JavaからSQLを実行できる」というポイントを理解しておくことが大切です。

2. SQLのINSERT文をJavaプログラムで実行する仕組み

次に、SQLのINSERT文をJavaプログラムから実行する仕組みを説明します。

通常、データベースはMySQLやPostgreSQLなどのデータベース管理システムによって管理されています。これらのデータベースはSQLという専用の言語で操作します。

しかし、JavaプログラムはそのままではSQLを実行できません。そこで登場するのがJDBCという仕組みです。

JDBCはJava Database Connectivityの略で、Javaからデータベースを操作するための標準インターフェースです。

簡単に言うと、JDBCはJavaとデータベースの橋渡し役をする仕組みです。

例えば、Javaプログラムが次のようなINSERT文を実行するとします。


String sql = "INSERT INTO users (name, email) VALUES ('Taro', 'taro@example.com')";
Statement stmt = conn.createStatement();
stmt.executeUpdate(sql);

このコードでは、usersテーブルに新しいユーザー情報を登録しています。

executeUpdateというメソッドは、データの追加、更新、削除を行うSQLを実行するときに使用するメソッドです。

INSERT文を実行すると、データベースのテーブルに新しいレコードが追加されます。レコードとは、データベースの一行分のデータのことを指します。

このように、JavaのプログラムからSQL文を実行することで、Webアプリケーションはデータベースと連携することができるようになります。

3. データの追加に必要なConnectionとStatementの準備

JavaでINSERT文を実行するためには、まずデータベースに接続する必要があります。この接続を行うオブジェクトがConnectionです。

Connectionとは、Javaプログラムとデータベースをつなぐ通信経路のようなものです。これがないと、SQL文をデータベースに送ることができません。

次に必要になるのがStatementです。

Statementは、SQL文をデータベースに送信して実行するためのオブジェクトです。つまりConnectionでデータベースに接続し、Statementを使ってSQLを実行するという流れになります。

実際のコード例を見てみましょう。


import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.Statement;

public class InsertExample {

    public static void main(String[] args) throws Exception {

        Connection conn = DriverManager.getConnection(
            "jdbc:mysql://localhost:3306/sampledb",
            "root",
            "password"
        );

        Statement stmt = conn.createStatement();

        String sql = "INSERT INTO users (name, email) VALUES ('Hanako', 'hanako@example.com')";

        stmt.executeUpdate(sql);

        conn.close();
    }
}

このプログラムでは、まずDriverManagerを使ってデータベースへ接続しています。その後、Statementを作成し、INSERT文を実行しています。

この処理をServletの中で実行すると、Webフォームから送信されたデータをそのままデータベースに保存できるようになります。

たとえば会員登録フォームの場合、ユーザーが入力した名前やメールアドレスをINSERT文で保存することで、会員データがデータベースに登録されます。

このようにServletとJDBCを組み合わせることで、JavaのWebアプリケーションはデータベースと連携した実用的なシステムを構築することができます。

Javaのデータベース処理では、Connection、Statement、SQLという三つの要素が重要になります。この三つの関係を理解することが、JDBCの基本を理解する第一歩になります。

4. PreparedStatementを使った安全なINSERT文の実装方法

Javaのデータベース処理では、単純にStatementを使ってINSERT文を実行する方法もありますが、実際のWebアプリケーション開発ではPreparedStatementという仕組みを使うことが推奨されています。

PreparedStatementとは、あらかじめSQL文の構造を準備しておき、その後で値だけを安全に設定できる仕組みです。Webアプリケーションではユーザーが入力したデータをデータベースに保存することが多いため、安全性を確保することがとても重要になります。

例えば会員登録画面では、名前やメールアドレスなどの情報をユーザーが入力します。その入力データをそのままSQL文に組み込んでしまうと、データベースの動作に問題が発生する可能性があります。

そこでPreparedStatementを使うことで、SQL文の構造とデータを分けて処理することができます。これにより安全なINSERT処理を実装することが可能になります。

PreparedStatementの特徴

SQL文の構造を事前に準備する

値の部分だけ後から設定できる

安全なデータベース操作が可能になる

実際のJavaコードを見てみましょう。


import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;

public class PreparedInsertExample {

    public static void main(String[] args) throws Exception {

        Connection conn = DriverManager.getConnection(
            "jdbc:mysql://localhost:3306/sampledb",
            "root",
            "password"
        );

        String sql = "INSERT INTO users (name, email) VALUES (?, ?)";

        PreparedStatement pstmt = conn.prepareStatement(sql);

        pstmt.setString(1, "Taro");
        pstmt.setString(2, "taro@example.com");

        pstmt.executeUpdate();

        conn.close();
    }
}

このコードでは、値の部分に疑問符を使っています。この疑問符はプレースホルダーと呼ばれ、後から値を設定するための場所を意味します。

PreparedStatementを使うことで、より安全で管理しやすいJavaのデータベース処理を実装することができます。実務のWebシステム開発では、INSERT文だけでなくUPDATE文やDELETE文でもPreparedStatementが使われることが一般的です。

5. パラメータのバインドによるSQLインジェクション対策

Webアプリケーションでデータベースを扱う場合、必ず理解しておく必要がある重要なセキュリティ問題があります。それがSQLインジェクションです。

SQLインジェクションとは、ユーザー入力を利用してSQL文を不正に操作する攻撃方法です。もしSQL文の中にユーザー入力を直接埋め込んでしまうと、悪意のある入力によってデータベースが不正に操作される可能性があります。

例えばログイン画面や登録フォームなどでは、ユーザーが自由に文字を入力できます。この入力内容がそのままSQL文として処理されると、データベースの内容が改ざんされる危険があります。

この問題を防ぐために使われる仕組みがパラメータのバインドです。

パラメータのバインドとは、SQL文の中に直接データを書き込むのではなく、専用のメソッドを使って安全に値を設定する方法です。PreparedStatementではsetStringやsetIntなどのメソッドを使って値を設定します。

具体的な例を確認してみましょう。


String sql = "INSERT INTO users (name, age) VALUES (?, ?)";

PreparedStatement pstmt = conn.prepareStatement(sql);

pstmt.setString(1, "Hanako");
pstmt.setInt(2, 25);

pstmt.executeUpdate();

このコードでは名前と年齢の値を安全にSQLへ設定しています。疑問符の位置に対して順番に値を設定する仕組みになっています。

一番目の疑問符に名前を設定

二番目の疑問符に年齢を設定

このようにPreparedStatementを使ってパラメータをバインドすることで、ユーザー入力がSQLの構造を壊すことを防ぐことができます。

JavaのServletとJDBCを使ったWebアプリケーション開発では、SQLインジェクション対策は必須の知識です。安全なデータベース処理を実装するためにも、PreparedStatementとパラメータバインドの仕組みを必ず理解しておきましょう。

6. executeUpdateメソッドによる実行結果更新件数の取得

INSERT文を実行したあとには、その処理が正常に実行されたかどうかを確認することが重要です。JDBCではexecuteUpdateというメソッドを使うことで、SQLの実行結果を数値として取得することができます。

executeUpdateメソッドは、データの追加更新削除などを行うSQL文を実行するときに使用されるメソッドです。このメソッドの戻り値には、処理によって影響を受けた行数が返されます。

例えばINSERT文が正常に実行された場合は一行追加されるため、一という数値が返されます。

この仕組みを利用することで、データベース登録が成功したかどうかをJavaプログラムで確認することができます。

実際のコード例を見てみましょう。


String sql = "INSERT INTO users (name, email) VALUES (?, ?)";

PreparedStatement pstmt = conn.prepareStatement(sql);

pstmt.setString(1, "Saburo");
pstmt.setString(2, "saburo@example.com");

int result = pstmt.executeUpdate();

System.out.println("更新件数：" + result);

このプログラムではexecuteUpdateの戻り値をresultという変数に保存しています。この値を確認することで、データベースに何件のデータが追加されたかを知ることができます。


更新件数：1

もしデータの追加に失敗した場合は、更新件数が零になることもあります。このような結果を確認することで、エラー処理やログ出力などの処理を実装することが可能になります。

Webアプリケーションでは、登録成功メッセージやエラー表示などをユーザーへ返すことが多いため、executeUpdateによる実行結果の確認はとても重要な処理になります。

JavaのServletとJDBCを使ったデータベース操作では、PreparedStatementによる安全なSQL実行とexecuteUpdateによる実行結果の確認を組み合わせることで、信頼性の高いデータ登録処理を作ることができます。

7. データベース接続における例外処理とリソースの解放

JavaのServletとJDBCを使ってINSERT文を実行する場合、必ず考慮しなければならない重要なポイントがあります。それが例外処理とリソースの解放です。

データベース接続は、アプリケーションの中でも特に失敗が発生しやすい処理です。例えばデータベースサーバーが停止している場合や接続情報が間違っている場合など、さまざまな原因でエラーが発生する可能性があります。

このような状況に備えるために、Javaでは例外処理という仕組みを使います。例外処理とは、プログラムの実行中に問題が発生したときでも、プログラムが途中で止まらないようにするための仕組みです。

JDBCを使ったデータベース処理では、接続オブジェクトやSQL実行オブジェクトを使い終わったあとに必ず解放する必要があります。これをリソースの解放と呼びます。

もしリソースを解放しないまま処理を続けてしまうと、サーバーのメモリが無駄に消費されてしまい、アプリケーションの性能が低下する原因になります。

そのためJavaではfinallyブロックを使って、必ずリソースを解放する処理を書くことが一般的です。


Connection conn = null;
PreparedStatement pstmt = null;

try {

    conn = DriverManager.getConnection(
        "jdbc:mysql://localhost:3306/sampledb",
        "root",
        "password"
    );

    String sql = "INSERT INTO users (name,email) VALUES (?,?)";

    pstmt = conn.prepareStatement(sql);

    pstmt.setString(1,"Taro");
    pstmt.setString(2,"taro@example.com");

    pstmt.executeUpdate();

} catch(Exception e) {

    e.printStackTrace();

} finally {

    try {

        if(pstmt != null){
            pstmt.close();
        }

        if(conn != null){
            conn.close();
        }

    } catch(Exception e){
        e.printStackTrace();
    }

}

このようにfinallyの中でcloseメソッドを呼び出すことで、データベース接続やSQLオブジェクトを確実に解放することができます。

Webアプリケーションでは多くのユーザーが同時にアクセスするため、リソース管理はとても重要です。JavaのServlet開発では、例外処理とリソース解放を必ずセットで実装することがベストプラクティスとなっています。

8. INSERT文実行時の文字化けを防ぐための設定ポイント

JavaのServletとJDBCを使ったデータベース処理では、文字化けの問題が発生することがあります。特に日本語を扱うWebアプリケーションでは、この問題がよく発生します。

文字化けとは、本来表示されるべき文字が正しく表示されず、意味不明な文字列として表示されてしまう現象です。

この問題が発生する原因の多くは、文字コードの設定が統一されていないことです。文字コードとは、文字をコンピュータで扱うためのルールのことです。

例えばブラウザが送信する文字コード、Servletが処理する文字コード、データベースが保存する文字コードがそれぞれ異なる場合、INSERT文で登録したデータが文字化けしてしまうことがあります。

この問題を防ぐためには、Servlet側でリクエストの文字コードを指定することが重要です。


protected void doPost(HttpServletRequest request,HttpServletResponse response){

    request.setCharacterEncoding("UTF-8");

    String name = request.getParameter("name");
    String email = request.getParameter("email");

}

この処理を行うことで、ブラウザから送信された日本語データを正しく受け取ることができます。

さらにデータベース接続の際にも文字コードを指定することで、INSERT文の文字化けを防ぐことができます。


Connection conn = DriverManager.getConnection(
    "jdbc:mysql://localhost:3306/sampledb?useUnicode=true&characterEncoding=UTF-8",
    "root",
    "password"
);

このように文字コードを統一することで、JavaのWebアプリケーションで日本語データを安全に扱うことができるようになります。

Servlet開発では、文字コードの設定は必須の基本知識です。特に日本語データを扱うシステムでは、必ずUTF8を統一して使用することが重要です。

9. Servletでのデータ追加におけるベストプラクティスまとめ

ここまで、JavaのServletとJDBCを使ったINSERT文によるデータ追加処理について詳しく解説してきました。実際のWebアプリケーション開発では、単にデータを登録できるだけではなく、安全性と安定性を考えた実装が重要になります。

まず基本となるのはPreparedStatementを使った安全なSQL実行です。Statementを使ってSQLを直接組み立てる方法は簡単ですが、セキュリティの観点から推奨されていません。

PreparedStatementを利用することで、SQLインジェクション攻撃を防ぎながら安全にデータベースへINSERT処理を行うことができます。

次に重要なのが例外処理です。データベース接続やSQL実行では、予期しないエラーが発生することがあります。例外処理を適切に実装することで、エラーが発生してもアプリケーションが安全に動作し続けるようになります。

さらに、データベース接続オブジェクトやPreparedStatementオブジェクトは必ずcloseメソッドで解放する必要があります。これを怠るとサーバーの負荷が増え、システム全体のパフォーマンス低下につながります。

また、日本語を扱うWebアプリケーションでは文字コードの設定も重要です。Servlet側の文字コード設定とデータベース接続時の文字コード設定を統一することで、文字化けを防ぐことができます。

実際のServlet処理では、次のような流れでデータ登録処理を実装することが多くなります。


request.setCharacterEncoding("UTF-8");

Connection conn = DriverManager.getConnection(
    "jdbc:mysql://localhost:3306/sampledb?useUnicode=true&characterEncoding=UTF-8",
    "root",
    "password"
);

String sql = "INSERT INTO users (name,email) VALUES (?,?)";

PreparedStatement pstmt = conn.prepareStatement(sql);

pstmt.setString(1,request.getParameter("name"));
pstmt.setString(2,request.getParameter("email"));

pstmt.executeUpdate();

pstmt.close();
conn.close();

このように基本的な手順を正しく理解しておくことで、JavaのServletを使ったデータベース登録処理を安全に実装することができます。

JavaのWeb開発では、データベース処理は非常に重要な要素です。INSERT文の仕組みを理解することで、会員登録システムや問い合わせ管理システムなど、さまざまなWebサービスを構築できるようになります。