Java용 MyBatis 확장 툴킷으로, MyBatis에 CRUD 인터페이스, 조건 래퍼, 페이지네이션, 코드 생성을 추가합니다.
pagehelper-org/Mybatis-PageHelper
다양한 데이터베이스에 맞는 LIMIT 또는 이에 준하는 SQL을 생성해 쿼리에 물리적 페이징을 적용하는 MyBatis 플러그인입니다.
- 스타
- 12,316
- 포크
- 3,073
- 열린 이슈
- 66
- 마지막 커밋
- 3일 전
어떤 프로젝트인가요?
PageHelper는 Java 영속성 프레임워크인 MyBatis의 페이징 플러그인입니다. 개발자가 페이징 SQL을 직접 작성하는 대신 쿼리 전에 정적 메서드를 호출하면, 플러그인이 SQL을 재작성해 요청한 페이지의 행만 데이터베이스에서 가져옵니다. 단일 테이블 쿼리와 복잡한 다중 테이블 쿼리를 모두 지원합니다.
플러그인은 JDBC URL을 바탕으로 데이터베이스 방언을 자동 감지하며, MySQL, PostgreSQL, Oracle, SQL Server, DB2, H2와 Dameng, Kingbase, openGauss 같은 중국 내 데이터베이스를 포함한 다양한 데이터베이스를 지원합니다. dialectAlias 설정으로 사용자 지정 방언을 등록할 수도 있습니다. Hikari, Druid, Tomcat JDBC, DBCP, C3P0 등의 커넥션 풀도 방언 협상 과정에서 인식됩니다.
PageHelper는 Maven 아티팩트로 배포되며 클래스패스에 jsqlparser가 필요합니다. 버전 6은 JDK 8 이상이 필요하고, 버전 5는 JDK 6을 지원합니다. Spring Boot 프로젝트용 별도 starter도 유지 관리됩니다.
핵심 기능
- 01데이터베이스 수준에서 한 페이지의 행만 가져오도록 쿼리를 재작성합니다.
- 02JDBC URL을 바탕으로 데이터베이스 방언을 자동 감지합니다.
- 03여러 중국 내 데이터베이스를 포함해 폭넓은 데이터베이스를 지원합니다.
- 04dialectAlias 설정으로 사용자 지정 방언을 사용할 수 있습니다.
- 05Executor 수준의 QueryInterceptor 확장 지점을 제공합니다.
활용 사례
- MyBatis를 사용하는 Java 서비스에 페이지네이션 목록 엔드포인트를 추가할 때.
- LIMIT 절을 직접 작성하지 않고 복잡한 다중 테이블 쿼리를 페이지 단위로 조회할 때.
- Dameng이나 Kingbase 같은 중국 내 데이터베이스에서 MyBatis를 실행할 때.
빠른 시작
- 1
최신 버전의 pagehelper Maven 의존성을 pom.xml에 추가하세요
- 2
설정 및 사용 방법에 대한 자세한 내용은 사용 가이드를 읽어 보세요
사용 전 알아둘 점
- 문서와 README는 주로 중국어로 작성되어 있으며, 영어 버전은 별도의 파일에 있습니다.
- MyBatis 설정과 클래스패스에 jsqlparser 라이브러리가 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- Mybatis-PageHelper은(는) 무엇인가요?
- 다양한 데이터베이스에 맞는 LIMIT 또는 이에 준하는 SQL을 생성해 쿼리에 물리적 페이징을 적용하는 MyBatis 플러그인입니다. PageHelper는 Java 영속성 프레임워크인 MyBatis의 페이징 플러그인입니다. 개발자가 페이징 SQL을 직접 작성하는 대신 쿼리 전에 정적 메서드를 호출하면, 플러그인이 SQL을 재작성해 요청한 페이지의 행만 데이터베이스에서 가져옵니다. 단일 테이블 쿼리와 복잡한 다중 테이블 쿼리를 모두 지원합니다.
- Mybatis-PageHelper은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- Mybatis-PageHelper은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- Mybatis-PageHelper은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. Mybatis-PageHelper의 마지막 커밋은 2026년 11월 3일입니다.
- Mybatis-PageHelper은(는) 어디에 사용할 수 있나요?
- MyBatis를 사용하는 Java 서비스에 페이지네이션 목록 엔드포인트를 추가할 때. LIMIT 절을 직접 작성하지 않고 복잡한 다중 테이블 쿼리를 페이지 단위로 조회할 때. Dameng이나 Kingbase 같은 중국 내 데이터베이스에서 MyBatis를 실행할 때.
- Mybatis-PageHelper는 어떻게 설치하나요?
- 최신 버전의 pagehelper Maven 의존성을 pom.xml에 추가하세요 설정 및 사용 방법에 대한 자세한 내용은 사용 가이드를 읽어 보세요
- Mybatis-PageHelper은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pagehelper-org/Mybatis-PageHelper
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
JDBC 및 ODBC 드라이버를 통해 100개 이상의 데이터베이스를 지원하는 무료 멀티플랫폼 데스크톱 SQL 클라이언트이자 데이터베이스 도구입니다.
운영 데이터베이스에서 참조 무결성을 유지한 부분 집합을 만들고 외래 키 관계를 따라 데이터를 탐색할 수 있는 무료 Java 도구입니다.
Spring Boot와 MyBatis로 구축하고 Docker로 배포할 수 있는, 쇼핑몰 프런트엔드와 관리자 백엔드를 갖춘 풀스택 전자상거래 시스템입니다.
Spring Boot 백엔드와 Vue 프런트엔드로 구성된 HR 관리 시스템 스캐폴드로, 역할 기반 메뉴, 직원 정보, 급여 계좌와 온라인 채팅을 제공합니다.
사용자·역할·메뉴·권한 관리, 코드 생성, 예약 작업 기능을 갖춘 Spring Boot 기반 Java 빠른 개발용 관리자 프레임워크입니다.