Allows the page_size value to be passed in the request.

[elyobo]

It is a frequent requirement that API clients can indicate the number of results that they require, rather than the API providing a fixed number of results.

This change allows resources to specify a page_size_parameter which is used to indicate the name of a query parameter which indicates the number of results to return.

• The default behaviour remains unchanged.
• Allows each resource to specify the page_size_parameter, which is handled by the factory and assigned to the controller.
• Adds a pageSizeParameter to the ResourceController, which is used to extract a query parameter from the request; if not provided, the pageSize is used instead.

[elyobo]

Build failures appear to be unrelated to the pull request.

[elyobo]

@weierophinney is there anything that you need me to tidy up on this?

[elyobo]

Thanks @weierophinney, that's great. I'm happy to provide unit tests on any further reuests, just refuse to merge until I stump up ;)