📌 Servlet + JNDI Resource 기반 DB 연동 회원가입/로그인 구현

📅 날짜

2025-04-11

📝 학습 내용

이번 실습에서는 JNDI 기반 Resource 설정을 통해
Oracle/MySQL DB와 커넥션풀(Connection Pool)을 연동하고,
회원가입 및 로그인 기능을 구현했다.
이를 통해 Servlet + DB 연동 + 인증 흐름을 명확하게 학습했다.

---

☁️ JNDI와 Resource란?

🔷 JNDI (Java Naming and Directory Interface)

• JNDI는 Java에서 이름 기반으로 객체(리소스)를 찾을 수 있도록 도와주는 API
• 흔히 말하는 lookup("java:/comp/env/...") 방식은 JNDI의 일종
• 톰캣이나 WAS에 미리 등록해둔 자원(DB 연결, 환경값 등)을 코드에서 직접 new로 생성하지 않고 참조 가능

즉, JNDI는 설정 정보와 실제 코드를 분리시켜주며,
자원(리소스)의 재사용성과 유지보수성을 높여준다.

---

🔷 Resource (자원)

• 웹 애플리케이션에서 자원이란 주로 DB 연결 정보, 외부 서버 연결 설정 등을 의미
• 이 자원들을 context.xml에 정의해두고, JNDI를 통해 접근하는 구조

쉽게 말해, context.xml에서 자원을 미리 정의해두고,
코드에서는 이름만 알아서 JNDI lookup()으로 가져와 쓰는 방식이다.

---

🧩 실습 흐름과 연결

• context.xml에서 DB 연결 정보를 미리 Resource로 등록
• web.xml에서 Resource 이름을 애플리케이션 내에 노출 (JNDI 참조명 등록)
• DBUtils.java 클래스에서 다음과 같이 lookup

Context initContext = new InitialContext();
Context envContext = (Context)initContext.lookup("java:/comp/env");
DataSource ds = (DataSource)envContext.lookup("jdbc/OracleDB");
Connection conn = ds.getConnection();

---

📦 왜 직접 DriverManager.getConnection(...)을 쓰지 않고 Resource를 쓸까?

전통 방식 (DriverManager)	Resource (JNDI + DataSource)
코드에서 직접 연결정보 입력	설정 분리 (context.xml에 따로 관리)
커넥션 매번 생성/종료	커넥션 풀 활용 (성능 향상)
보안 위험 (계정 노출)	설정파일로 분리하여 보안 강화
유지보수 불편	환경만 바꾸면 코드 수정 無

---

1️⃣ 프로젝트 개요 및 구성

기능	설명
회원가입	사용자 정보 입력 후 DB에 저장 (/join.do)
로그인	DB의 사용자 정보와 매칭하여 인증 (/login.do)
메인 페이지	로그인 성공 시 진입 (/main.do)

---

📂 주요 파일 구조 요약

🔹 Servlet 클래스

파일명	역할
Home.java	/index.do, /main.do 처리
Join.java	GET: 회원가입 폼, POST: 회원 정보 DB 저장
Login.java	GET: 로그인 폼, POST: 로그인 인증 + 세션 설정

🔹 DTO 및 유틸 클래스

파일명	설명
UserDto.java	사용자 정보 모델 클래스 (username, password, role)
OracleDBUtils.java / MysqlDbUtils.java	DataSource(JNDI) 기반 DB 연결 클래스, 싱글톤 방식

🔹 JSP 뷰 파일

파일명	경로	역할
index.jsp	/WEB-INF/index.jsp	진입 페이지
join.jsp	/WEB-INF/user/join.jsp	회원가입 폼
login.jsp	/WEB-INF/user/login.jsp	로그인 폼
main.jsp	/WEB-INF/main.jsp	로그인 후 메인 페이지

---

2️⃣ DB 테이블 구조

회원 정보를 저장할 테이블 구조는 다음과 같다:

CREATE TABLE tbl_user (
    username VARCHAR2(100) PRIMARY KEY,
    password VARCHAR2(100) NOT NULL,
    role     VARCHAR2(50)  DEFAULT 'ROLE_USER'
);

🔗 위 테이블은 UserDto 객체와 1:1로 매핑된다.

---

3️⃣ Resource 설정 (JNDI 기반 DB 연결)

🔧 context.xml – 커넥션풀 설정

<Resource driverClassName="oracle.jdbc.driver.OracleDriver"
          url="jdbc:oracle:thin:@localhost:1521:xe"
          username="system"
          password="1234"
          name="jdbc/OracleDB"
          type="javax.sql.DataSource"
          auth="Container"
          maxActive="20"
          maxIdle="10"
          maxWait="5000"/>

<Resource driverClassName="com.mysql.cj.jdbc.Driver"
          url="jdbc:mysql://localhost/bookDb"
          username="root"
          password="1234"
          name="jdbc/MysqlDB"
          type="javax.sql.DataSource"
          auth="Container"
          maxActive="10"
          maxIdle="2"
          maxWait="5000"/>

🔧 web.xml – JNDI 이름 매핑

<resource-ref>
	<res-ref-name>jdbc/OracleDB</res-ref-name>
	<res-type>javax.sql.DataSource</res-type>
	<res-auth>Container</res-auth>
</resource-ref>

<resource-ref>
	<res-ref-name>jdbc/MysqlDB</res-ref-name>
	<res-type>javax.sql.DataSource</res-type>
	<res-auth>Container</res-auth>
</resource-ref>

설정 파일	역할
context.xml	실제 DB 연결 정보 (url, 계정 등) 정의
web.xml	프로젝트 내에서 참조할 이름 지정 (JNDI 이름 매핑)

---

4️⃣ 전체 흐름 구조

🧩 기능 흐름: join.do

[GET] /join.do
 → 회원가입 폼(jsp) 출력

[POST] /join.do
 → 사용자 정보 수집
 → DB 저장(insert into tbl_user)
 → 성공 시 → /login.do 리다이렉트
 → 실패 시 → /join.do 다시 포워딩

🧩 기능 흐름: login.do

[GET] /login.do
 → 로그인 폼(jsp) 출력

[POST] /login.do
 → 사용자 정보 검증
 → DB에서 username 조회 → password 비교
 → 성공 시 세션에 로그인 정보 저장
 → /main.do 리다이렉트
 → 실패 시 → /login.do 다시 포워딩

🔐 세션 처리 예시

HttpSession session = req.getSession();
session.setAttribute("username", username);
session.setAttribute("role", dbUser.getRole());

---

🔥 요약

• JNDI 기반 커넥션풀 설정을 통해 효율적으로 DB 연결 관리
• context.xml, web.xml 설정을 명확히 구분하여 적용
• Oracle과 MySQL 모두 사용 가능하도록 구성
• Servlet + DTO + DBUtils + JSP를 통해 회원가입/로그인 전체 흐름을 구현
• 세션 기반 로그인 상태 유지, 실패 시 포워딩 처리도 경험함

---

✏️ 느낀 점

이번 실습을 통해 JNDI Resource 기반의 DB 연결과 사용자 인증 흐름을 처음부터 끝까지 구현해보며,
Java 웹 애플리케이션에서 리소스를 안전하고 효율적으로 관리하는 방법을 익힐 수 있었다.
다음에는 필터(Filter), 인터셉터, 권한 분기 처리 등을 적용해보며 보안 처리 흐름을 심화 학습할 계획이다.

---

🔗 참고 자료

• Oracle DataSource 설정 가이드
• Tomcat JNDI 설정 공식 문서
• Baeldung - DataSource with Servlets

---