net.sf.ehcache.management.resource.services.CacheManagersResourceService Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of management-ehcache Show documentation

A library defining the ehcache management resource service interfaces and resource entities.

The newest version!

/* All content copyright (c) 2003-2012 Terracotta, Inc., except as may otherwise be noted in a separate copyright notice.  All rights reserved.*/
package net.sf.ehcache.management.resource.services;

import net.sf.ehcache.management.resource.CacheManagerEntity;

import javax.ws.rs.Consumes;
import javax.ws.rs.GET;
import javax.ws.rs.PUT;
import javax.ws.rs.Produces;
import javax.ws.rs.core.Context;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.UriInfo;
import java.util.Collection;

/**
 * 
 * A resource service for interacting with ehcache cache managers via the {@link CacheManagerEntity}.
 * 
 * 
 * @author brandony
 * 
 */
public interface CacheManagersResourceService {
  public final static String ATTR_QUERY_KEY = "show";

  /**
   * 
   * Get a {@code Collection} of {@link CacheManagerEntity} objects representing the cache manager information provided
   * by the associated monitorable entity's agent given the request path.
   * 
   * 
   * @param {@link UriInfo} for this resource request
   * @return a collection of {@link CacheManagerEntity} objects when successful.
   */
  @GET
  @Produces(MediaType.APPLICATION_JSON)
  Collection getCacheManagers(@Context UriInfo info);

  /**
   * Update a cache manager with the name specified in the request path, for a specific agent. The request
   * path that does not identify a unique cache manager resource for update will constitute a bad request and will be
   * denied, resulting in a response with a 400.
   *
   * @param info {@link UriInfo} for this resource request
   * @param resource {@code CacheEntity} resource for update or creation
   */
  @PUT
  @Consumes(MediaType.APPLICATION_JSON)
  void updateCacheManager(@Context UriInfo info, CacheManagerEntity resource);
}