pagination

Documentation

Overview

Package pagination provides support for pagination requests and responses.

Index

• Variables
• type Pages
  • func New(page, perPage, total int) *Pages
  • func NewFromRequest(req *http.Request, count int) *Pages
  • func (p *Pages) BuildLinkHeader(baseURL string, defaultPerPage int) string
  • func (p *Pages) BuildLinks(baseURL string, defaultPerPage int) [4]string
  • func (p *Pages) Limit() int
  • func (p *Pages) Offset() int

Variables

var (
	// DefaultPageSize specifies the default page size
	DefaultPageSize = 100
	// MaxPageSize specifies the maximum page size
	MaxPageSize = 1000
	// PageVar specifies the query parameter name for page number
	PageVar = "page"
	// PageSizeVar specifies the query parameter name for page size
	PageSizeVar = "per_page"
)

Types

type Pages

type Pages struct {
	Page       int         `json:"page"`
	PerPage    int         `json:"per_page"`
	PageCount  int         `json:"page_count"`
	TotalCount int         `json:"total_count"`
	Items      interface{} `json:"items"`
}

Pages represents a paginated list of data items.

func New

func New(page, perPage, total int) *Pages

New creates a new Pages instance. The page parameter is 1-based and refers to the current page index/number. The perPage parameter refers to the number of items on each page. And the total parameter specifies the total number of data items. If total is less than 0, it means total is unknown.

func NewFromRequest

func NewFromRequest(req *http.Request, count int) *Pages

NewFromRequest creates a Pages object using the query parameters found in the given HTTP request. count stands for the total number of items. Use -1 if this is unknown.

func (*Pages) BuildLinkHeader

func (p *Pages) BuildLinkHeader(baseURL string, defaultPerPage int) string

BuildLinkHeader returns an HTTP header containing the links about the pagination.

func (*Pages) BuildLinks

func (p *Pages) BuildLinks(baseURL string, defaultPerPage int) [4]string

BuildLinks returns the first, prev, next, and last links corresponding to the pagination. A link could be an empty string if it is not needed. For example, if the pagination is at the first page, then both first and prev links will be empty.

func (*Pages) Limit

func (p *Pages) Limit() int

Limit returns the LIMIT value that can be used in a SQL statement.

func (*Pages) Offset

func (p *Pages) Offset() int

Offset returns the OFFSET value that can be used in a SQL statement.