| /** |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package org.apache.atlas.web.resources; |
| |
| import org.apache.atlas.discovery.AtlasLineageService; |
| import org.apache.atlas.exception.AtlasBaseException; |
| import org.apache.atlas.model.lineage.AtlasLineageInfo; |
| import org.apache.atlas.model.lineage.AtlasLineageInfo.LineageDirection; |
| import org.apache.atlas.type.AtlasTypeRegistry; |
| import org.apache.atlas.utils.AtlasPerfTracer; |
| import org.apache.atlas.v1.model.lineage.LineageResponse; |
| import org.apache.atlas.v1.model.lineage.SchemaResponse; |
| import org.apache.atlas.web.util.LineageUtils; |
| import org.apache.atlas.web.util.Servlets; |
| import org.slf4j.Logger; |
| import org.slf4j.LoggerFactory; |
| import org.springframework.stereotype.Service; |
| |
| import javax.inject.Inject; |
| import javax.inject.Singleton; |
| import javax.ws.rs.Consumes; |
| import javax.ws.rs.GET; |
| import javax.ws.rs.Path; |
| import javax.ws.rs.PathParam; |
| import javax.ws.rs.Produces; |
| import javax.ws.rs.WebApplicationException; |
| import javax.ws.rs.core.Response; |
| |
| @Path("lineage") |
| @Singleton |
| @Service |
| @Deprecated |
| public class LineageResource { |
| private static final Logger LOG = LoggerFactory.getLogger(DataSetLineageResource.class); |
| private static final Logger PERF_LOG = AtlasPerfTracer.getPerfLogger("rest.LineageResource"); |
| |
| private final AtlasLineageService atlasLineageService; |
| private final AtlasTypeRegistry typeRegistry; |
| |
| /** |
| * Created by the Guice ServletModule and injected with the |
| * configured LineageService. |
| * |
| */ |
| @Inject |
| public LineageResource(AtlasLineageService atlasLineageService, AtlasTypeRegistry typeRegistry) { |
| this.atlasLineageService = atlasLineageService; |
| this.typeRegistry = typeRegistry; |
| } |
| |
| /** |
| * Returns input lineage graph for the given entity id. |
| * @param guid dataset entity id |
| * @return |
| */ |
| @GET |
| @Path("{guid}/inputs/graph") |
| @Consumes(Servlets.JSON_MEDIA_TYPE) |
| @Produces(Servlets.JSON_MEDIA_TYPE) |
| public LineageResponse inputsGraph(@PathParam("guid") String guid) { |
| if (LOG.isDebugEnabled()) { |
| LOG.debug("==> LineageResource.inputsGraph({})", guid); |
| } |
| |
| LineageResponse ret = new LineageResponse(); |
| |
| AtlasPerfTracer perf = null; |
| try { |
| if (AtlasPerfTracer.isPerfTraceEnabled(PERF_LOG)) { |
| perf = AtlasPerfTracer.getPerfTracer(PERF_LOG, "LineageResource.inputsGraph(" + guid + ")"); |
| } |
| |
| AtlasLineageInfo lineageInfo = atlasLineageService.getAtlasLineageInfo(guid, LineageDirection.INPUT, -1); |
| ret.setRequestId(Servlets.getRequestId()); |
| ret.setResults(LineageUtils.toLineageStruct(lineageInfo, typeRegistry)); |
| |
| return ret; |
| } catch (AtlasBaseException e) { |
| LOG.error("Unable to get lineage inputs graph for entity guid={}", guid, e); |
| throw new WebApplicationException(Servlets.getErrorResponse(e)); |
| } catch (WebApplicationException e) { |
| LOG.error("Unable to get lineage inputs graph for entity guid={}", guid, e); |
| throw e; |
| } finally { |
| AtlasPerfTracer.log(perf); |
| |
| if (LOG.isDebugEnabled()) { |
| LOG.debug("<== LineageResource.inputsGraph({})", guid); |
| } |
| } |
| } |
| |
| /** |
| * Returns the outputs graph for a given entity id. |
| * |
| * @param guid dataset entity id |
| */ |
| @GET |
| @Path("{guid}/outputs/graph") |
| @Consumes(Servlets.JSON_MEDIA_TYPE) |
| @Produces(Servlets.JSON_MEDIA_TYPE) |
| public LineageResponse outputsGraph(@PathParam("guid") String guid) { |
| if (LOG.isDebugEnabled()) { |
| LOG.debug("==> LineageResource.outputsGraph({})", guid); |
| } |
| |
| LineageResponse ret = new LineageResponse(); |
| |
| AtlasPerfTracer perf = null; |
| |
| try { |
| if (AtlasPerfTracer.isPerfTraceEnabled(PERF_LOG)) { |
| perf = AtlasPerfTracer.getPerfTracer(PERF_LOG, "LineageResource.outputsGraph(" + guid + ")"); |
| } |
| |
| AtlasLineageInfo lineageInfo = atlasLineageService.getAtlasLineageInfo(guid, LineageDirection.OUTPUT, -1); |
| ret.setRequestId(Servlets.getRequestId()); |
| ret.setResults(LineageUtils.toLineageStruct(lineageInfo, typeRegistry)); |
| |
| return ret; |
| } catch (AtlasBaseException e) { |
| LOG.error("Unable to get lineage outputs graph for entity guid={}", guid, e); |
| throw new WebApplicationException(Servlets.getErrorResponse(e)); |
| } catch (WebApplicationException e) { |
| LOG.error("Unable to get lineage outputs graph for entity guid={}", guid, e); |
| throw e; |
| } finally { |
| AtlasPerfTracer.log(perf); |
| |
| if (LOG.isDebugEnabled()) { |
| LOG.debug("<== LineageResource.outputsGraph({})", guid); |
| } |
| } |
| } |
| |
| /** |
| * Returns the schema for the given dataset id. |
| * |
| * @param guid dataset entity id |
| */ |
| @GET |
| @Path("{guid}/schema") |
| @Consumes(Servlets.JSON_MEDIA_TYPE) |
| @Produces(Servlets.JSON_MEDIA_TYPE) |
| public SchemaResponse schema(@PathParam("guid") String guid) { |
| if (LOG.isDebugEnabled()) { |
| LOG.debug("==> LineageResource.schema({})", guid); |
| } |
| |
| AtlasPerfTracer perf = null; |
| SchemaResponse ret = new SchemaResponse(); |
| |
| try { |
| if (AtlasPerfTracer.isPerfTraceEnabled(PERF_LOG)) { |
| perf = AtlasPerfTracer.getPerfTracer(PERF_LOG, "LineageResource.schema(" + guid + ")"); |
| } |
| |
| SchemaResponse.SchemaDetails schemaDetails = atlasLineageService.getSchemaForHiveTableByGuid(guid); |
| |
| |
| ret.setRequestId(Servlets.getRequestId()); |
| ret.setResults(schemaDetails); |
| return ret; |
| } catch (IllegalArgumentException e) { |
| LOG.error("Unable to get schema for entity guid={}", guid, e); |
| throw new WebApplicationException(Servlets.getErrorResponse(e, Response.Status.BAD_REQUEST)); |
| } catch (WebApplicationException e) { |
| LOG.error("Unable to get schema for entity guid={}", guid, e); |
| throw e; |
| } catch (AtlasBaseException e) { |
| LOG.error("Unable to get schema for entity={}", guid, e); |
| throw new WebApplicationException(Servlets.getErrorResponse(e, e.getAtlasErrorCode().getHttpCode())); |
| } catch (Throwable e) { |
| LOG.error("Unable to get schema for entity={}", guid, e); |
| throw new WebApplicationException(Servlets.getErrorResponse(e, Response.Status.INTERNAL_SERVER_ERROR)); |
| } finally { |
| AtlasPerfTracer.log(perf); |
| |
| if (LOG.isDebugEnabled()) { |
| LOG.debug("<== LineageResource.schema({})", guid); |
| } |
| } |
| } |
| } |