Repolode
Enviar
pagehelper-org

pagehelper-org/Mybatis-PageHelper

Plugin de MyBatis que añade paginación física a las consultas y genera SQL con LIMIT o su equivalente según la base de datos.

Ver en GitHubSitio web
Estrellas
12,316
Forks
3,073
Issues abiertos
66
Último commit
hace 4 días

¿Qué es?

PageHelper es un plugin de paginación para MyBatis, el framework de persistencia de Java. En lugar de escribir SQL de paginación a mano, el desarrollador llama a un método estático antes de ejecutar la consulta, y el plugin reescribe el SQL para que la base de datos devuelva solo las filas de la página solicitada. Admite consultas de una sola tabla y consultas complejas con varias tablas.

El plugin detecta automáticamente el dialecto de la base de datos a partir de la URL JDBC y es compatible con una larga lista de bases de datos, entre ellas MySQL, PostgreSQL, Oracle, SQL Server, DB2, H2 y varias bases de datos chinas, como Dameng, Kingbase y openGauss. Se pueden registrar dialectos personalizados mediante la configuración dialectAlias. También reconoce pools de conexiones como Hikari, Druid, Tomcat JDBC, DBCP y C3P0 para negociar el dialecto.

PageHelper se distribuye como un artefacto Maven y requiere jsqlparser en el classpath. La versión 6 requiere JDK 8 o posterior, mientras que la versión 5 admite JDK 6. Para los proyectos de Spring Boot se mantiene un starter independiente.

Funciones clave

  • 01Reescribe las consultas para obtener solo una página de filas en la base de datos.
  • 02Detecta automáticamente el dialecto de la base de datos a partir de la URL JDBC.
  • 03Es compatible con una amplia variedad de bases de datos, incluidas varias bases de datos chinas.
  • 04Permite usar dialectos personalizados mediante la configuración dialectAlias.
  • 05Ofrece un punto de extensión QueryInterceptor en el nivel de Executor.

Casos de uso

  • Añadir endpoints de listas paginadas a un servicio Java que usa MyBatis.
  • Paginar consultas complejas con varias tablas sin escribir cláusulas LIMIT a mano.
  • Usar MyBatis con bases de datos chinas como Dameng o Kingbase.

Inicio rápido

  1. 1

    Añade la dependencia Maven de pagehelper (usa la versión más reciente) a pom.xml

  2. 2

    Consulta la guía de uso para obtener información detallada sobre la configuración y el uso

Antes de usarlo

  • La documentación y el README están principalmente en chino; la versión en inglés está en un archivo aparte.
  • Requiere una configuración de MyBatis y la biblioteca jsqlparser en el classpath.

En colecciones

Bases de datos y herramientas SQL

Temas

#mybatis#pagination#java#jdbc#orm#sql#spring-boot#mybatis-plugin

Preguntas frecuentes

¿Qué es Mybatis-PageHelper?
Plugin de MyBatis que añade paginación física a las consultas y genera SQL con LIMIT o su equivalente según la base de datos. PageHelper es un plugin de paginación para MyBatis, el framework de persistencia de Java. En lugar de escribir SQL de paginación a mano, el desarrollador llama a un método estático antes de ejecutar la consulta, y el plugin reescribe el SQL para que la base de datos devuelva solo las filas de la página solicitada. Admite consultas de una sola tabla y consultas complejas con varias tablas.
¿Mybatis-PageHelper es gratuito? ¿Qué licencia tiene?
Mybatis-PageHelper es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Mybatis-PageHelper sigue mantenido?
Mantenimiento activo. El último commit de Mybatis-PageHelper fue el 3 nov 2026.
¿Para qué puedo usar Mybatis-PageHelper?
Añadir endpoints de listas paginadas a un servicio Java que usa MyBatis. Paginar consultas complejas con varias tablas sin escribir cláusulas LIMIT a mano. Usar MyBatis con bases de datos chinas como Dameng o Kingbase.
¿Cómo se instala Mybatis-PageHelper?
Añade la dependencia Maven de pagehelper (usa la versión más reciente) a pom.xml Consulta la guía de uso para obtener información detallada sobre la configuración y el uso
¿Dónde consigo Mybatis-PageHelper?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/pagehelper-org/Mybatis-PageHelper

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados