EDIT

cdmlib-remote/src/main/java/eu/etaxonomy/cdm/remote/controller/util/PagerParameters.java -text

  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"

  xmlns:tx="http://www.springframework.org/schema/tx"

  xsi:schemaLocation="http://www.springframework.org/schema/beans

  <context:component-scan base-package="eu/etaxonomy/cdm/remote" />

  <!--

    ======= HandlerMappings =======

    -->

  <!--

    first we try to find the controller using the simpleurlmapping, then

    the classname this follows the principal of "convention over

    configuration"

  -->

  <bean

    class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping">

    <property name="order" value="1" />

    <property name="interceptors">

      <list>

        <!--<ref bean="contentNegociationHandlerInterceptor" /> -->

        <ref bean="localeContextHandlerInterceptor" />

      </list>

    </property>

    <property name="pathMatcher">

      <!--  must match the pathMatcher as set in AnnotationMethodHandlerAdapter -->

      <bean class="eu.etaxonomy.cdm.remote.controller.util.CdmAntPathMatcher" />

    </property>

  </bean>

    <!--

   -->

  <bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">

    <property name="order" value="0" />

    <property name="mappings">

      <props>

        <prop key="/index.do">urlFilenameViewController</prop>

        <prop key="/">welcomeFileViewController</prop>

      </props>

    </property>

  </bean>

  <!--

  ======= HandlerAdapters =======

  -->

  <bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">

     <property name="pathMatcher">

          <!--  must match the pathMatcher as set in DefaultAnnotationHandlerMapping -->

  </bean>

  <!-- needed when using SimpleUrlHandlerMapping 	-->

  <bean

    class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter" />

  <!--

  ======= HandlerInterceptors =======

  -->

  <!--

  <bean id="datasourceContextHandlerInterceptor"

    class="eu.etaxonomy.cdm.remote.controller.interceptor.DatasourceContextHandlerInterceptor" /> -->

  <bean id="localeContextHandlerInterceptor"

    class="eu.etaxonomy.cdm.remote.controller.interceptor.LocaleContextHandlerInterceptor" />

  <!--

     === no longer needed, replaced by ContentNegotiatingViewResolver ==

  <bean id="contentNegociationHandlerInterceptor"

    class="eu.etaxonomy.cdm.remote.controller.interceptor.ContentNegociationHandlerInterceptor">

    <property name="mapping">

      <map>

        <entry key="text/json" value="json" />

        <entry key="application/json" value="json" />

        <entry key="application/xml" value="xml" />

      </map>

    </property>

    <property name="defaultExtension" value="xml" />

  </bean>

   -->

  <!--

   ======= ViewControllers =======

   -->

  <bean id="urlFilenameViewController" class="org.springframework.web.servlet.mvc.UrlFilenameViewController">

  </bean>

  <!--

    The welcome-file-list in the web.xml will is ignored since the

    cdmserver servlet is mapped to the root path [/] So the welcome file

    list is being replaced by a SimpleUrlHandlerMapping on the root path

    [/] which is mapped via this ViewController to the [index] view

  -->

  <bean id="welcomeFileViewController"

    class="org.springframework.web.servlet.mvc.UrlFilenameViewController">

    <property name="suffix">

      <value>index</value>

    </property>

  </bean>

  <!--

  <bean id="oaiViewResolver" class="org.springframework.web.servlet.view.XmlViewResolver">

        <!-- FOR DEBUGING ONLY !!!!

        <property name="cache" value="false"/>

        <property name="order" value="2" />

        <property name="mediaTypes">

           <map>

          <entry key="xml" value="application/xml" />

        <entry key="dc" value="application/xml" />

        <entry key="rdf" value="application/xml" />

        <entry key="json" value="application/json" />

           </map>

        </property>

        <property name="viewResolvers">

            <list>

          <bean id="xmlTypeViewResolver" class="eu.etaxonomy.cdm.remote.view.PatternViewResolver">

              <property name="location" value="/WEB-INF/xml-views.xml"/>

              <!--

                  turn caching off FOR DEBUGING ONLY !!!!

              <property name="cache" value="false"/>

              -->

          </bean>

          <bean id="jsonTypeViewResolver" class="eu.etaxonomy.cdm.remote.view.PatternViewResolver">

              <property name="location" value="/WEB-INF/json-views.xml"/>

              <!--

                turn caching off FOR DEBUGING ONLY !!!!

              <property name="cache" value="false"/>

              -->

          </bean>

            </list>

        </property>

  </bean>

  <!--

  ======= Exception Handling =======

  -->

  <bean id="exceptionResolver" class="eu.etaxonomy.cdm.remote.exception.CdmExceptionResolver">

  </bean>

  <!--

    ======= Security =======

 * European Distributed Institute of Taxonomy

 *

import eu.etaxonomy.cdm.remote.controller.util.PagerParameters;

 *

    public static final Integer DEFAULT_PAGESIZE = 20;

    public static final Integer DEFAULT_PAGE_NUMBER = 0;

    @InitBinder

        binder.registerCustomEditor(UUID.class, new UUIDPropertyEditor());

        binder.registerCustomEditor(Class.class, new CdmTypePropertyEditor());

    }

    /**

     * @param pageNumber

     *            the number of the page to be returned, the first page has the

     *            pageNumber = 1 - <i>optional parameter</i>

     * @param pageSize

     *            the maximum number of entities returned per page (can be null

     *            to return all entities in a single page) - <i>optional

     *            parameter</i>

     * @param type

     *            Further restricts the type of entities to be returned.

     *            If null the base type <code>&lt;T&gt;</code> is being used. - <i>optional parameter</i>

     * @return

     * @throws IOException

     */

    @RequestMapping(method = RequestMethod.GET, params = "pageNumber")

    public Pager<T> doPage(

            @RequestParam(value = "pageNumber") Integer pageNumber,

            @RequestParam(value = "pageSize", required = false) Integer pageSize,

            @RequestParam(value = "class", required = false) Class<T> type,

            HttpServletRequest request,

            HttpServletResponse response) throws IOException

            {

        PagerParameters pagerParameters = new PagerParameters(pageSize, pageNumber);

        pagerParameters.normalizeAndValidate(response);

        return service.page(type, pagerParameters.getPageSize(), pagerParameters.getPageNumber(), null, DEFAULT_INIT_STRATEGY);

    }

    /**

     * Parameter less method to be used as default when request without parameter are made. Otherwise

     * the nameless methods {@link #doPage(Integer, Integer, Class)} and {@link #doList(Integer, Integer, Class)}

     * are ambigous.

     * @return

     * @throws IOException

     */

    @RequestMapping(method = RequestMethod.GET)

    public Pager<T> doPage(HttpServletRequest request, HttpServletResponse response) throws IOException{

        return doPage(null, null, null, request, response);

    }

    /**

     * @param start

     *            The offset index from the start of the list. The first entity

     *            has the index = 0 - <i>required parameter</i>

     * @param limit

     *            The maximum number of entities returned. - <i>optional parameter</i>

     *            If limit is set to a value < 1 all entities will be returned

     * @param type

     *            Further restricts the type of entities to be returned.

     *            If null the base type <code>&lt;T&gt;</code> is being used. - <i>optional parameter</i>

     * @return a List of entities

     */

    @RequestMapping(method = RequestMethod.GET, params = "start")

    public List<T> doList(

            @RequestParam(value = "start", required = true) Integer start,

            @RequestParam(value = "limit", required = false) Integer limit,

            @RequestParam(value = "class", required = false) Class<T> type) {

        //if(start == null){ start = 0;}

        if(limit == null){ limit = DEFAULT_PAGESIZE;}

        if(limit < 1){ limit = null;}

        return service.list(type, limit, start, null, DEFAULT_INIT_STRATEGY);

    }

  /* TODO

* European Distributed Institute of Taxonomy

*

import eu.etaxonomy.cdm.remote.controller.util.PagerParameters;

    public static final Logger logger = Logger.getLogger(PolytomousKeyListController.class);

    private ITaxonService taxonService;

    @Autowired

    public void setService(IPolytomousKeyService service) {

        this.service = service;

    }

    @Autowired

    public void setService(ITaxonService taxonService) {

        this.taxonService = taxonService;

    }

    @RequestMapping(

            params = {"findByTaxonomicScope"},

            method = RequestMethod.GET)

    public Pager<PolytomousKey> doFindByTaxonomicScope(

            @RequestParam(value = "findByTaxonomicScope") UUID taxonUuid,

            @RequestParam(value = "pageNumber", required = false) Integer pageNumber,

            @RequestParam(value = "pageSize", required = false) Integer pageSize,

            HttpServletRequest request,

            HttpServletResponse response)throws IOException {

        logger.info("doFindByTaxonomicScope: " + request.getRequestURI() + request.getQueryString());

        PagerParameters pagerParameters = new PagerParameters(pageSize, pageNumber);

        pagerParameters.normalizeAndValidate(response);

        TaxonBase taxon = taxonService.find(taxonUuid);

        Pager<PolytomousKey> pager = service.findByTaxonomicScope(taxon, pagerParameters.getPageSize(), pagerParameters.getPageNumber(), null);

        return pager;

    }

import static java.net.HttpURLConnection.HTTP_BAD_REQUEST;

import eu.etaxonomy.cdm.remote.controller.util.PagerParameters;

        logger.info("doFind : " + request.getRequestURI() + "?" + request.getQueryString() );

        PagerParameters pagerParams = new PagerParameters(pageSize, pageNumber);

        pagerParams.normalizeAndValidate(response);

        config.setPageNumber(pagerParams.getPageNumber());

        config.setPageSize(pagerParams.getPageSize());

// $Id: TaxonController.java 5473 2009-03-25 13:42:07Z a.kohlbecker $

/**

* Copyright (C) 2011 EDIT

* European Distributed Institute of Taxonomy

* http://www.e-taxonomy.eu

*

* The contents of this file are subject to the Mozilla Public License Version 1.1

* See LICENSE.TXT at the top of this package for the full license terms.

*/

package eu.etaxonomy.cdm.remote.controller.util;

import static java.net.HttpURLConnection.HTTP_BAD_REQUEST;

import java.io.IOException;

import javax.servlet.http.HttpServletResponse;

import eu.etaxonomy.cdm.remote.controller.HttpStatusMessage;

/**

 * @author a.kohlbecker

 * @date 22.08.2011

 *

 */

public class PagerParameters {

    private Integer pageSize;

    private Integer pageNumber;

    public void setPageSize(Integer pageSize) {

        this.pageSize = pageSize;

    }

    public Integer getPageSize() {

        return pageSize;

    }

    public void setPageNumber(Integer pageNumber) {

        this.pageNumber = pageNumber;

    }

    public Integer getPageNumber() {

        return pageNumber;

    }

    public PagerParameters(Integer pageSize, Integer pageNumber) {

        this.pageSize = pageSize;

        this.pageNumber = pageNumber;

    }

    public void normalizeAndValidate(HttpServletResponse response) throws IOException{

        if(pageNumber == null){

            pageNumber = 0;

        }

        if(pageSize == null){

            pageSize = 0;

        }

        if(pageNumber < 0){

            HttpStatusMessage.fromString("The query parameter 'pageNumber' must not be a negative number").setStatusCode(HTTP_BAD_REQUEST).send(response);

        }

        if(pageSize < 0){

            HttpStatusMessage.fromString("The query parameter 'pageSize' must not be a negative number").setStatusCode(HTTP_BAD_REQUEST).send(response);

        }

    }

}