FiltersResource.java

/*
 *  Copyright (c) 2008 Boulder Community Foundation - iVolunteer
 *
 *  Permission is hereby granted, free of charge, to any person obtaining a copy
 *  of this software and associated documentation files (the "Software"), to deal
 *  in the Software without restriction, including without limitation the rights
 *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 *  copies of the Software, and to permit persons to whom the Software is
 *  furnished to do so, subject to the following conditions:
 *
 *  The above copyright notice and this permission notice shall be included in
 *  all copies or substantial portions of the Software.
 *
 *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 *  THE SOFTWARE.
 */

package service;

import java.util.Collection;
import javax.ws.rs.Path;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.Produces;
import javax.ws.rs.Consumes;
import javax.ws.rs.PathParam;
import javax.ws.rs.QueryParam;
import javax.ws.rs.DefaultValue;
import javax.ws.rs.core.Response;
import javax.ws.rs.core.Context;
import javax.ws.rs.core.UriInfo;
import com.sun.jersey.api.core.ResourceContext;
import persistence.Filter;
import converter.FiltersConverter;
import converter.FilterConverter;

/**
 * 
 * @author Dave Angulo
 */

@Path("/filters/")
public class FiltersResource extends Base {
	@Context
	protected UriInfo			uriInfo;
	@Context
	protected ResourceContext	resourceContext;

	/** Creates a new instance of FiltersResource */
	public FiltersResource() {
	}

	/**
	 * Get method for retrieving a collection of Filter instance in XML format.
	 * 
	 * @return an instance of FiltersConverter
	 */
	@GET
	@Produces( { "application/xml", "application/json" })
	public FiltersConverter get(@QueryParam("start") @DefaultValue("0") int start,
			@QueryParam("max") @DefaultValue("10") int max,
			@QueryParam("expandLevel") @DefaultValue("1") int expandLevel,
			@QueryParam("query") @DefaultValue("SELECT e FROM Filter e") String query) {
		PersistenceService persistenceSvc = PersistenceService.getInstance();
		try {
			return new FiltersConverter(getEntities(start, max, query), uriInfo.getAbsolutePath(),
					expandLevel);
		} finally {
		}
	}

	/**
	 * Post method for creating an instance of Filter using XML as the input
	 * format.
	 * 
	 * @param data
	 *            an FilterConverter entity that is deserialized from an XML
	 *            stream
	 * @return an instance of FilterConverter
	 */
	@POST
	@Consumes( { "application/xml", "application/json" })
	public Response post(FilterConverter data) {
		try {
			Filter entity = data.getEntity();
			createEntity(entity);
			return Response.created(uriInfo.getAbsolutePath().resolve(entity.getId() + "/"))
					.build();
		} finally {
		}
	}

	/**
	 * Returns a dynamic instance of FilterResource used for entity navigation.
	 * 
	 * @return an instance of FilterResource
	 */
	@Path("{id}/")
	public service.FilterResource getFilterResource(@PathParam("id") String id) {
		FilterResource resource = resourceContext.getResource(FilterResource.class);
		resource.setId(id);
		return resource;
	}

	/**
	 * Returns all the entities associated with this resource.
	 * 
	 * @return a collection of Filter instances
	 */
	@Override
	protected Collection<Filter> getEntities(int start, int max, String query) {
		return (Collection<Filter>) super.getEntities(start, max, query);
	}
}