/**
* Copyright (C) 2009 - present by OpenGamma Inc. and the OpenGamma group of companies
*
* Please see distribution for license.
*/
package com.opengamma.master.convention.impl;
import java.net.URI;
import javax.ws.rs.GET;
import javax.ws.rs.HEAD;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.core.Context;
import javax.ws.rs.core.Response;
import javax.ws.rs.core.UriBuilder;
import javax.ws.rs.core.UriInfo;
import com.opengamma.id.ObjectId;
import com.opengamma.master.convention.ConventionDocument;
import com.opengamma.master.convention.ConventionMaster;
import com.opengamma.master.convention.ConventionMetaDataRequest;
import com.opengamma.master.convention.ConventionMetaDataResult;
import com.opengamma.master.convention.ConventionSearchRequest;
import com.opengamma.master.convention.ConventionSearchResult;
import com.opengamma.util.ArgumentChecker;
import com.opengamma.util.rest.AbstractDataResource;
import com.opengamma.util.rest.RestUtils;
/**
* RESTful resource for conventions.
* <p>
* The conventions resource receives and processes RESTful calls to the convention master.
*/
@Path("conventionMaster")
public class DataConventionMasterResource extends AbstractDataResource {
/**
* The convention master.
*/
private final ConventionMaster _exgMaster;
/**
* Creates the resource, exposing the underlying master over REST.
*
* @param conventionMaster the underlying convention master, not null
*/
public DataConventionMasterResource(final ConventionMaster conventionMaster) {
ArgumentChecker.notNull(conventionMaster, "conventionMaster");
_exgMaster = conventionMaster;
}
//-------------------------------------------------------------------------
/**
* Gets the convention master.
*
* @return the convention master, not null
*/
public ConventionMaster getConventionMaster() {
return _exgMaster;
}
//-------------------------------------------------------------------------
@GET
public Response getHateaos(@Context UriInfo uriInfo) {
return hateoasResponse(uriInfo);
}
@HEAD
@Path("conventions")
public Response status() {
// simple HEAD to quickly return, avoiding loading the whole database
return responseOk();
}
@GET
@Path("metaData")
public Response metaData(@Context UriInfo uriInfo) {
ConventionMetaDataRequest request = RestUtils.decodeQueryParams(uriInfo, ConventionMetaDataRequest.class);
ConventionMetaDataResult result = getConventionMaster().metaData(request);
return responseOkObject(result);
}
@POST
@Path("conventionSearches")
public Response search(ConventionSearchRequest request) {
ConventionSearchResult result = getConventionMaster().search(request);
return responseOkObject(result);
}
@POST
@Path("conventions")
public Response add(@Context UriInfo uriInfo, ConventionDocument request) {
ConventionDocument result = getConventionMaster().add(request);
URI createdUri = (new DataConventionResource()).uriVersion(uriInfo.getBaseUri(), result.getUniqueId());
return responseCreatedObject(createdUri, result);
}
//-------------------------------------------------------------------------
@Path("conventions/{conventionId}")
public DataConventionResource findConvention(@PathParam("conventionId") String idStr) {
ObjectId id = ObjectId.parse(idStr);
return new DataConventionResource(this, id);
}
//-------------------------------------------------------------------------
/**
* Builds a URI for security meta-data.
*
* @param baseUri the base URI, not null
* @param request the request, may be null
* @return the URI, not null
*/
public static URI uriMetaData(URI baseUri, ConventionMetaDataRequest request) {
UriBuilder bld = UriBuilder.fromUri(baseUri).path("metaData");
if (request != null) {
RestUtils.encodeQueryParams(bld, request);
}
return bld.build();
}
/**
* Builds a URI.
*
* @param baseUri the base URI, not null
* @return the URI, not null
*/
public static URI uriSearch(URI baseUri) {
UriBuilder bld = UriBuilder.fromUri(baseUri).path("conventionSearches");
return bld.build();
}
/**
* Builds a URI.
*
* @param baseUri the base URI, not null
* @return the URI, not null
*/
public static URI uriAdd(URI baseUri) {
UriBuilder bld = UriBuilder.fromUri(baseUri).path("conventions");
return bld.build();
}
}