com.atlassian.confluence.api.impl.pagination

Class PaginationServiceImpl

java.lang.Object

com.atlassian.confluence.api.impl.pagination.PaginationServiceImpl

All Implemented Interfaces:

PaginationServiceInternal, PaginationService

public class PaginationServiceImpl
extends Object
implements PaginationServiceInternal

Constructor Summary

Constructors

Constructor and Description
PaginationServiceImpl(org.springframework.transaction.PlatformTransactionManager transactionManager, net.sf.hibernate.SessionFactory sessionFactory)

Method Summary

Modifier and Type	Method and Description
<F,T> Paginated<T>	createPaginated(PaginationBatch<F> fetchBatch, com.google.common.base.Function<Iterable<F>,Iterable<T>> modelConverter, int maxLimit) Constructs a Paginated implementation backed by the given PaginationBatch.
<F,T> PagingIterator<T>	createPagingIterator(PaginationBatch<F> fetchBatch, int resultsPerPage, com.google.common.base.Function<Iterable<F>,Iterable<T>> modelConverter) Constructs a PagingIterator backed by the given PaginationBatch.
<H,M> PageResponse<M>	doPaginationListRequest(LimitedRequest initialRequest, PaginationBatch<H> fetchPage, com.google.common.base.Function<Iterable<H>,Iterable<M>> modelConverter) Perform a pagination request, this will execute the fetchBatch function as many times as necessary to retrieve the page of results.
<H,M> PageResponse<M>	doPaginationRequest(LimitedRequest initialRequest, PaginationBatch<H> fetchPage, com.google.common.base.Function<? super H,M> modelConverter) Perform a pagination request, this will execute the fetchBatch function as many times as necessary to retrieve the page of results.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PaginationServiceImpl

public PaginationServiceImpl(org.springframework.transaction.PlatformTransactionManager transactionManager,
                             net.sf.hibernate.SessionFactory sessionFactory)

Method Detail

doPaginationRequest

public <H,M> PageResponse<M> doPaginationRequest(LimitedRequest initialRequest,
                                                 PaginationBatch<H> fetchPage,
                                                 com.google.common.base.Function<? super H,M> modelConverter)

Description copied from interface: PaginationService

Perform a pagination request, this will execute the fetchBatch function as many times as necessary to retrieve the page of results. Each execution of the fetch page function will pull at most com.atlassian.confluence.api.model.pagination.LimitedRequest.getMaxLimit() results from the datasource. FetchBatch will be executed in a new transaction for each batch to prevent excessive memory usage. It is expected that any permission checking is performed in the PaginationBatch.

The PaginationService is responsible for ensuring that enough results are returned from the PaginationBatch to fulfill the request. The PaginationBatch should not treat the pageRequest getStart and getLimit values as user specific indexes, only results the user can see should be returned. If a user does not have permission to see any results in the requested range an empty list should be returned in the response and the hasMore flag set if there are more results still to check. The pagination service will call again if more results are required.

Specified by:

doPaginationRequest in interface PaginationService

Parameters:

initialRequest - - a request for a range of data

fetchPage - - the function to supply the results

modelConverter - - a function to convert from the supplied object to a model object, this will be executed within a transaction.

Returns:

a PageResponse of model objects, with results that the user is allowed to see.

doPaginationListRequest

public <H,M> PageResponse<M> doPaginationListRequest(LimitedRequest initialRequest,
                                                     PaginationBatch<H> fetchPage,
                                                     com.google.common.base.Function<Iterable<H>,Iterable<M>> modelConverter)

Description copied from interface: PaginationService

Perform a pagination request, this will execute the fetchBatch function as many times as necessary to retrieve the page of results. Each execution of the fetch page function will pull at most com.atlassian.confluence.api.model.pagination.LimitedRequest.getMaxLimit() results from the datasource. FetchBatch will be executed in a new transaction for each batch to prevent excessive memory usage. It is expected that any permission checking is performed in the PaginationBatch.

The PaginationService is responsible for ensuring that enough results are returned from the PaginationBatch to fulfill the request. The PaginationBatch should not treat the pageRequest getStart and getLimit values as user specific indexes, only results the user can see should be returned. If a user does not have permission to see any results in the requested range an empty list should be returned in the response and the hasMore flag set if there are more results still to check. The pagination service will call again if more results are required.

Specified by:

doPaginationListRequest in interface PaginationService

Parameters:

initialRequest - - a request for a range of data

fetchPage - - the function to supply the results

modelConverter - - a function to convert from the supplied object to a model object, this will be executed within a transaction.

Returns:

a PageResponse of model objects, with results that the user is allowed to see.

createPagingIterator

public <F,T> PagingIterator<T> createPagingIterator(PaginationBatch<F> fetchBatch,
                                                    int resultsPerPage,
                                                    com.google.common.base.Function<Iterable<F>,Iterable<T>> modelConverter)

Description copied from interface: PaginationServiceInternal

Constructs a PagingIterator backed by the given PaginationBatch. The Iterator is guaranteed to yield all results provided by the PaginationBatch. No more than resultsPerPage are fetched from the PaginationBatch at one time, and each batch of data is only kept live for the time it takes callers to iterate through it.

Specified by:

createPagingIterator in interface PaginationServiceInternal

Parameters:

fetchBatch - - a request for a range of data

resultsPerPage - - number of results to request from PaginationBatch each invocation.

modelConverter - - a function to convert from the supplied object to a model object, this will be executed within a transaction.

Returns:

a PagingIterator of model objects, with results that the user is allowed to see.

See Also:

com.atlassian.confluence.api.model.pagination.PagingIterator

createPaginated

public <F,T> Paginated<T> createPaginated(PaginationBatch<F> fetchBatch,
                                          com.google.common.base.Function<Iterable<F>,Iterable<T>> modelConverter,
                                          int maxLimit)

Description copied from interface: PaginationServiceInternal

Constructs a Paginated implementation backed by the given PaginationBatch.

Specified by:

createPaginated in interface PaginationServiceInternal

Parameters:

fetchBatch - - a request for a range of data

modelConverter - - a function to convert from the supplied object to a model object, this will be executed within a transaction.

maxLimit - - the max limit to apply when creating LimitedRequests for paged requests from the Paginated.

See Also:

com.atlassian.confluence.api.model.pagination.Paginated