JSP에서 MariaDB 연결하기: JDBC 기본 설정 및 테스트
이 글에서는 JSP를 통해 MariaDB에 연결하는 방법에 대해 알아봅니다. JDBC를 사용하여 데이터베이스와 직접 연결하는 과정은 데이터베이스 프로그래밍의 기본을 이해하는 데 필수적입니다. 다음 단계별로 MariaDB JDBC 드라이버를 다운로드하고, 연결 관리 클래스를 작성하며, 간단한 연결 테스트를 수행하는 JSP 페이지를 만들어보겠습니다.
1. MariaDB JDBC 드라이버 다운로드 및 복사
1. 먼저, MariaDB에 연결하기 위해 JDBC 드라이버가 필요합니다. MariaDB JDBC 드라이버는 공식 MariaDB 사이트에서 다운로드할 수 있습니다.

2. 다운로드한 .jar
파일을 프로젝트의 WEB-INF/lib
폴더에 복사하여 프로젝트에서 사용할 수 있도록 설정합니다.

2. 연결 관리 클래스 작성
다음으로, 데이터베이스 연결을 관리하는 클래스를 작성합니다. 이 클래스는 데이터베이스 연결을 열고 닫는 기능을 수행하며, 이후 데이터베이스 작업을 쉽게 관리할 수 있도록 도와줍니다. 다음은 연결 관리 클래스를 작성하는 예제 코드입니다.
package common;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.Statement;
public class JDBConnect {
public Connection con;
public Statement stmt;
public PreparedStatement psmt;
public ResultSet rs;
// 기본 생성자
public JDBConnect() {
try {
// JDBC 드라이버 로드
Class.forName("org.mariadb.jdbc.Driver");
// DB에 연결
String url = "jdbc:mariadb://localhost:3307/school"; // 데이터베이스 URL (school은 데이터베이스 이름)
String id = "blueshare"; // 데이터베이스 사용자 ID
String pwd = "1234"; // 데이터베이스 사용자 암호
con = DriverManager.getConnection(url, id, pwd); // 데이터베이스에 연결
System.out.println("DB 연결 성공(기본 생성자)");
}
catch (Exception e) {
e.printStackTrace();
}
}
// 연결 해제(자원 반납)
public void close() {
try {
if (rs != null) rs.close();
if (stmt != null) stmt.close();
if (psmt != null) psmt.close();
if (con != null) con.close();
System.out.println("JDBC 자원 해제");
}
catch (Exception e) {
e.printStackTrace();
}
}
}
- Connection : 데이터베이스 연결을 나타내는 객체입니다. 이 객체를 통해 SQL 명령을 실행하고 데이터베이스와의 통신을 관리합니다.
- Statement : SQL 문을 실행하기 위한 객체입니다. 정적 SQL 쿼리를 실행할 때 사용됩니다.
- PreparedStatement : 미리 컴파일된 SQL 문을 실행하기 위한 객체입니다. 파라미터가 포함된 동적 SQL 쿼리를 실행할 때 사용됩니다.
- ResultSet : SQL 쿼리의 결과를 저장하는 객체입니다. SELECT 문을 실행한 후, 결과를 테이블 형식으로 반환받아 이 객체를 통해 처리할 수 있습니다.
3. 연결 테스트 JSP 작성
마지막으로, 위에서 작성한 연결 관리 클래스를 사용하여 데이터베이스 연결을 테스트하는 JSP 페이지를 작성합니다. 아래의 JSP 코드는 데이터베이스에 연결하고, 연결이 성공했는지 확인한 후 연결을 해제합니다.
<%@ page import="common.JDBConnect"%>
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<html>
<head><title>JDBC</title></head>
<body>
<h2>JDBC 테스트</h2>
<%
JDBConnect jdbc = new JDBConnect();
jdbc.close();
%>
</body>
</html>
위의 코드를 실행하면 콘솔에 “DB 연결 성공(기본 생성자)”와 “JDBC 자원 해제” 메시지가 출력되며, MariaDB와의 연결이 정상적으로 이루어졌음을 확인할 수 있습니다.

☞ JDBC를 사용하여 데이터베이스에 연결하는 방식은 학습과 기본적인 개념 이해를 위해 매우 중요합니다. 그러나 실무에서는 웹 애플리케이션의 성능과 확장성을 위해 커넥션 풀을 사용하는 것이 일반적입니다. 이후 단계에서는 Connection Pool과 JNDI(Java Naming and Directory Interface) 등을 사용하는 방법에 대해 알아보겠습니다.
관련 이전 게시글
- 윈도우 11에서 Apache Tomcat 설치 및 설정 방법
- STS4에서 Dynamic Web Project 생성하는 방법
- JSP 기본 문법: 디렉티브, 스크립틀릿, 표현식, 선언문
- JSP 액션 태그: include와 forward 사용법
- JSP 내장 객체 사용법: request와 response
이 글이 도움이 되셨다면 공유 부탁 드립니다.