content: /**
   * JBoss, Home of Professional Open Source
   * Copyright Red Hat, Inc., and individual contributors.
   *
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   * 	http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  package org.jboss.aerogear.unifiedpush.rest.registry.applications;
  
  import org.jboss.aerogear.unifiedpush.api.Installation;
  import org.jboss.aerogear.unifiedpush.dao.PageResult;
  import org.jboss.aerogear.unifiedpush.dto.Count;
  import org.jboss.aerogear.unifiedpush.rest.util.error.ErrorBuilder;
  import org.jboss.aerogear.unifiedpush.service.ClientInstallationService;
  import org.jboss.aerogear.unifiedpush.service.impl.SearchManager;
  import org.jboss.resteasy.spi.Link;
  import org.jboss.resteasy.spi.LinkHeader;
  
  import javax.inject.Inject;
  import javax.ws.rs.*;
  import javax.ws.rs.core.Context;
  import javax.ws.rs.core.MediaType;
  import javax.ws.rs.core.Response;
  import javax.ws.rs.core.UriInfo;
  
  
  @Path("/applications/{variantID}/installations/")
  public class InstallationManagementEndpoint {
      private static final int MAX_PAGE_SIZE = 50;
      private static final int DEFAULT_PAGE_SIZE = 25;
  
      @Inject
      private SearchManager searchManager;
  
      @Inject
      private ClientInstallationService clientInstallationService;
  
      /**
       * List Installations of specified Variant
       *
       * @param variantId id of {@link org.jboss.aerogear.unifiedpush.api.Variant}
       * @param page      page number
       * @param pageSize  number of items per page
       * @param search    search query
       * @param uri       uri
       * @return          list of {@link Installation}s
       *
       * @responseheader Link     Links to "prev", "first", "next" and "last" pages
       * @responseheader total    Total count of items
       *
       * @statuscode 404 The requested Variant resource does not exist
       */
      @GET
      @Produces(MediaType.APPLICATION_JSON)
      public Response findInstallations(@PathParam("variantID") String variantId,
                                        @QueryParam("page") Integer page,
                                        @QueryParam("per_page") Integer pageSize,
                                        @QueryParam("search") String search,
                                        @Context UriInfo uri) {
          if (pageSize != null) {
              pageSize = Math.min(MAX_PAGE_SIZE, pageSize);
          } else {
              pageSize = DEFAULT_PAGE_SIZE;
          }
  
          if (page == null) {
              page = 0;
          }
  
          if (search == null || search.isEmpty()) {
              search = null;
          }
  
          //Find the variant using the variantID
          if (!searchManager.getSearchService().existsVariantIDForDeveloper(variantId)) {
              return Response.status(Response.Status.NOT_FOUND).entity(ErrorBuilder.forVariants().notFound().build()).build();
          }
  
          //Find the installations using the variantID
          PageResult<Installation, Count> pageResult = searchManager.getSearchService().findAllInstallationsByVariantForDeveloper(variantId, page, pageSize, search);
  
          final long totalPages = pageResult.getAggregate().getCount() / pageSize;
          LinkHeader header = getLinkHeader(page, totalPages, uri);
  
          return Response.ok(pageResult.getResultList())
                  .header("Link", header.toString())
                  .header("total", pageResult.getAggregate().getCount())
                  .build();
      }
  
      static LinkHeader getLinkHeader(Integer page, long totalPages, UriInfo uri) {
          LinkHeader header = new LinkHeader();
  
          if (page != 0) {
              header.addLink(buildLink("prev", page - 1, uri));
              header.addLink(buildLink("first", 0, uri));
          }
  
          if (page < totalPages) {
              header.addLink(buildLink("next", page + 1, uri));
              header.addLink(buildLink("last", totalPages, uri));
          }
          return header;
      }
  
      private static Link buildLink(String rel, long pageNo, UriInfo uri) {
          Link link = new Link();
          link.setHref(uri.getAbsolutePathBuilder().queryParam("page", pageNo).build().toASCIIString());
          link.setRelationship(rel);
          return link;
      }
  
      /**
       * Get Installation of specified Variant
       *
       * @param variantId         id of {@link org.jboss.aerogear.unifiedpush.api.Variant}
       * @param installationId    id of {@link Installation}
       * @return                  requested {@link Installation}
       *
       * @statuscode 404 The requested Installation resource does not exist
       */
      @GET
      @Path("/{installationID}")
      @Produces(MediaType.APPLICATION_JSON)
      public Response findInstallation(@PathParam("variantID") String variantId, @PathParam("installationID") String installationId) {
  
          Installation installation = clientInstallationService.findById(installationId);
  
          if (installation == null) {
              return Response.status(Response.Status.NOT_FOUND).entity(ErrorBuilder.forInstallations().notFound().build()).build();
          }
  
          return Response.ok(installation).build();
      }
  
      /**
       * Update Installation of specified Variant
       *
       * @param entity            new info of {@link Installation}
       * @param variantId         id of {@link org.jboss.aerogear.unifiedpush.api.Variant}
       * @param installationId    id of {@link Installation}
       * @return          updated {@link Installation}
       *
       * @statuscode 204 The Installation updated successfully
       * @statuscode 404 The requested Installation resource does not exist
       */
      @PUT
      @Path("/{installationID}")
      @Consumes(MediaType.APPLICATION_JSON)
      @Produces(MediaType.APPLICATION_JSON)
      public Response updateInstallation(Installation entity, @PathParam("variantID") String variantId, @PathParam("installationID") String installationId) {
  
          Installation installation = clientInstallationService.findById(installationId);
  
          if (installation == null) {
              return Response.status(Response.Status.NOT_FOUND).entity(ErrorBuilder.forInstallations().notFound().build()).build();
          }
  
          clientInstallationService.updateInstallation(installation, entity);
  
          return Response.noContent().build();
  
      }
  
      /**
       * Delete Installation of specified Variant
       *
       * @param variantId         id of {@link org.jboss.aerogear.unifiedpush.api.Variant}
       * @param installationId    id of {@link Installation}
       * @return no content
       *
       * @statuscode 204 The Installation successfully deleted
       * @statuscode 404 The requested Installation resource does not exist
       */
      @DELETE
      @Path("/{installationID}")
      @Produces(MediaType.APPLICATION_JSON)
      public Response removeInstallation(@PathParam("variantID") String variantId, @PathParam("installationID") String installationId) {
  
          Installation installation = clientInstallationService.findById(installationId);
  
          if (installation == null) {
              return Response.status(Response.Status.NOT_FOUND).entity(ErrorBuilder.forInstallations().notFound().build()).build();
          }
  
          // remove it
          clientInstallationService.removeInstallation(installation);
  
          return Response.noContent().build();
      }
  }
  