程序包 org.hibernate.dialect.pagination

类 AbstractLimitHandler

    • 构造器详细资料

      • AbstractLimitHandler

        protected AbstractLimitHandler()

    • 方法详细资料

      • supportsLimit

        public boolean supportsLimit()
        从接口复制的说明: LimitHandler
        Does this handler support some form of limiting query results via a SQL clause?
        指定者:
        supportsLimit 在接口中 LimitHandler
        返回:
        True if this handler supports some form of LIMIT.

      • supportsLimitOffset

        public boolean supportsLimitOffset()
        从接口复制的说明: LimitHandler
        Does this handler's LIMIT support (if any) additionally support specifying an offset?
        指定者:
        supportsLimitOffset 在接口中 LimitHandler
        返回:
        True if the handler supports an offset within the limit support.

      • supportsVariableLimit

        public boolean supportsVariableLimit()
        Does this handler support bind variables (i.e., prepared statement parameters) for its limit/offset?
        返回:
        True if bind variables can be used; false otherwise.

      • bindLimitParametersInReverseOrder

        public boolean bindLimitParametersInReverseOrder()
        ANSI SQL defines the LIMIT clause to be in the form LIMIT offset, limit. Does this dialect require us to bind the parameters in reverse order?
        返回:
        true if the correct order is limit, offset

      • bindLimitParametersFirst

        public boolean bindLimitParametersFirst()
        Does the LIMIT clause come at the start of the SELECT statement, rather than at the end?
        返回:
        true if limit parameters should come before other parameters

      • useMaxForLimit

        public boolean useMaxForLimit()
        Does the LIMIT clause take a "maximum" row number instead of a total number of returned rows?

        This is easiest understood via an example. Consider you have a table with 20 rows, but you only want to retrieve rows number 11 through 20. Generally, a limit with offset would say that the offset = 11 and the limit = 10 (we only want 10 rows at a time); this is specifying the total number of returned rows. Some dialects require that we instead specify offset = 11 and limit = 20, where 20 is the "last" row we want relative to offset (i.e. total number of rows = 20 - 11 = 9)

        So essentially, is limit relative from offset? Or is limit absolute?

        返回:
        True if limit is relative from offset; false otherwise.

      • forceLimitUsage

        public boolean forceLimitUsage()
        Generally, if there is no limit applied to a Hibernate query we do not apply any limits to the SQL query. This option forces that the limit be written to the SQL query.
        返回:
        True to force limit into SQL query even if none specified in Hibernate query; false otherwise.

      • convertToFirstRowValue

        public int convertToFirstRowValue​(int zeroBasedFirstResult)
        Hibernate APIs explicitly state that setFirstResult() should be a zero-based offset. Here we allow the Dialect a chance to convert that value based on what the underlying db or driver will expect.

        NOTE: what gets passed into processSql(String, org.hibernate.engine.spi.RowSelection) is the zero-based offset. Dialects which do not supportsVariableLimit() should take care to perform any needed first-row-conversion calls prior to injecting the limit values into the SQL string.

        参数:
        zeroBasedFirstResult - The user-supplied, zero-based first row offset.
        返回:
        The corresponding db/dialect specific offset.
        另请参阅:
        Query.setFirstResult(int), Criteria.setFirstResult(int)

      • processSql

        public String processSql​(String sql,
                         RowSelection selection)
        从接口复制的说明: LimitHandler
        Return processed SQL query.
        指定者:
        processSql 在接口中 LimitHandler
        参数:
        sql - the SQL query to process.
        selection - the selection criteria for rows.
        返回:
        Query statement with LIMIT clause applied.

      • bindLimitParametersAtStartOfQuery

        public int bindLimitParametersAtStartOfQuery​(RowSelection selection,
                                             PreparedStatement statement,
                                             int index)
                                      throws SQLException
        从接口复制的说明: LimitHandler
        Bind parameter values needed by the LIMIT clause before original SELECT statement.
        指定者:
        bindLimitParametersAtStartOfQuery 在接口中 LimitHandler
        参数:
        selection - the selection criteria for rows.
        statement - Statement to which to bind limit parameter values.
        index - Index from which to start binding.
        返回:
        The number of parameter values bound.
        抛出:
        SQLException - Indicates problems binding parameter values.

      • bindLimitParametersAtEndOfQuery

        public int bindLimitParametersAtEndOfQuery​(RowSelection selection,
                                           PreparedStatement statement,
                                           int index)
                                    throws SQLException
        从接口复制的说明: LimitHandler
        Bind parameter values needed by the LIMIT clause after original SELECT statement.
        指定者:
        bindLimitParametersAtEndOfQuery 在接口中 LimitHandler
        参数:
        selection - the selection criteria for rows.
        statement - Statement to which to bind limit parameter values.
        index - Index from which to start binding.
        返回:
        The number of parameter values bound.
        抛出:
        SQLException - Indicates problems binding parameter values.

      • setMaxRows

        public void setMaxRows​(RowSelection selection,
                       PreparedStatement statement)
                throws SQLException
        从接口复制的说明: LimitHandler
        Use JDBC API to limit the number of rows returned by the SQL query. Typically handlers that do not support LIMIT clause should implement this method.
        指定者:
        setMaxRows 在接口中 LimitHandler
        参数:
        selection - the selection criteria for rows.
        statement - Statement which number of returned rows shall be limited.
        抛出:
        SQLException - Indicates problems while limiting maximum rows returned.

      • bindLimitParameters

        protected final int bindLimitParameters​(RowSelection selection,
                                        PreparedStatement statement,
                                        int index)
                                 throws SQLException
        Default implementation of binding parameter values needed by the LIMIT clause.
        参数:
        selection - the selection criteria for rows.
        statement - Statement to which to bind limit parameter values.
        index - Index from which to start binding.
        返回:
        The number of parameter values bound.
        抛出:
        SQLException - Indicates problems binding parameter values.

      • getMaxOrLimit

        protected final int getMaxOrLimit​(RowSelection selection)
        Some dialect-specific LIMIT clauses require the maximum last row number (aka, first_row_number + total_row_count), while others require the maximum returned row count (the total maximum number of rows to return).
        参数:
        selection - the selection criteria for rows.
        返回:
        The appropriate value to bind into the limit clause.