/** * Copyright (C) 2009 - present by OpenGamma Inc. and the OpenGamma group of companies * * Please see distribution for license. */ package com.opengamma.master.config.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.config.ConfigDocument; import com.opengamma.master.config.ConfigMaster; import com.opengamma.master.config.ConfigMetaDataRequest; import com.opengamma.master.config.ConfigMetaDataResult; import com.opengamma.master.config.ConfigSearchRequest; import com.opengamma.master.config.ConfigSearchResult; import com.opengamma.util.ArgumentChecker; import com.opengamma.util.rest.AbstractDataResource; import com.opengamma.util.rest.RestUtils; /** * RESTful resource for configs. * <p> * The configs resource receives and processes RESTful calls to the config master. */ @Path("configMaster") public class DataConfigMasterResource extends AbstractDataResource { /** * The config master. */ private final ConfigMaster _cfgMaster; /** * Creates the resource, exposing the underlying master over REST. * * @param configMaster the underlying config master, not null */ public DataConfigMasterResource(final ConfigMaster configMaster) { ArgumentChecker.notNull(configMaster, "configMaster"); _cfgMaster = configMaster; } //------------------------------------------------------------------------- /** * Gets the config master. * * @return the config master, not null */ public ConfigMaster getConfigMaster() { return _cfgMaster; } //------------------------------------------------------------------------- @GET public Response getHateaos(@Context UriInfo uriInfo) { return hateoasResponse(uriInfo); } @HEAD @Path("configs") public Response status() { // simple HEAD to quickly return, avoiding loading the whole database return responseOk(); } @GET @Path("metaData") public Response metaData(@Context UriInfo uriInfo) { ConfigMetaDataRequest request = RestUtils.decodeQueryParams(uriInfo, ConfigMetaDataRequest.class); ConfigMetaDataResult result = getConfigMaster().metaData(request); return responseOkObject(result); } @SuppressWarnings({"rawtypes", "unchecked" }) // necessary to stop Jersey issuing warnings due to <?> @POST @Path("configSearches") public Response search(ConfigSearchRequest request) { ConfigSearchResult<?> result = getConfigMaster().search(request); return responseOkObject(result); } @POST @Path("configs") public Response add(@Context UriInfo uriInfo, ConfigDocument request) { ConfigDocument result = getConfigMaster().add(request); URI createdUri = DataConfigResource.uriVersion(uriInfo.getBaseUri(), result.getUniqueId()); return responseCreatedObject(createdUri, result); } //------------------------------------------------------------------------- @Path("configs/{configId}") public DataConfigResource findConfig(@PathParam("configId") String idStr) { ObjectId id = ObjectId.parse(idStr); return new DataConfigResource(this, id); } //------------------------------------------------------------------------- /** * Builds a URI for config 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, ConfigMetaDataRequest 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("configSearches"); 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("configs"); return bld.build(); } }