OrganizationTypesResource.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.OrganizationType;
import converter.OrganizationTypesConverter;
import converter.OrganizationTypeConverter;
import converter.list.OrganizationTypeListConverter;

/**
 * 
 * @author Dave Angulo
 */

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

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

	/**
	 * Get method for retrieving a collection of OrganizationType instance in
	 * XML format.
	 * 
	 * @return an instance of OrganizationTypesConverter
	 */
	@GET
	@Produces( { "application/xml", "application/json" })
	public OrganizationTypesConverter 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 OrganizationType e") String query) {
		return new OrganizationTypesConverter(getEntities(start, max, query), uriInfo
				.getAbsolutePath(), expandLevel);
	}

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

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

	@Path("list/")
	@GET
	@Produces( { "application/json" })
	public OrganizationTypeListConverter list(@QueryParam("start") @DefaultValue("0") int start,
			@QueryParam("max") @DefaultValue("10") int max,
			@QueryParam("query") @DefaultValue("SELECT e FROM OrganizationType e") String query) {
		return new OrganizationTypeListConverter(getEntities(start, max, query), uriInfo
				.getAbsolutePath(), uriInfo.getBaseUri());
	}

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