/**
 * Copyright (C) 2014-2015 LinkedIn Corp. (pinot-core@linkedin.com)
 *
 * Licensed 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 com.linkedin.pinot.controller.api.restlet.resources;

import org.restlet.representation.Representation;
import org.restlet.representation.StringRepresentation;
import org.restlet.resource.ServerResource;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.linkedin.pinot.common.protocols.SegmentCompletionProtocol;
import com.linkedin.pinot.common.restlet.swagger.Description;
import com.linkedin.pinot.common.restlet.swagger.HttpVerb;
import com.linkedin.pinot.common.restlet.swagger.Paths;
import com.linkedin.pinot.common.restlet.swagger.Summary;
import com.linkedin.pinot.controller.helix.core.realtime.SegmentCompletionManager;


/**
 * A class to field the segmentConsumed() API from a server instance,
 * signalling that it has consumed a kafka topic in a segment until the
 * end criteria.
 * @see {@link com.linkedin.pinot.common.protocols.SegmentCompletionProtocol}
 */
public class LLCSegmentConsumed extends ServerResource {
  private static Logger LOGGER = LoggerFactory.getLogger(LLCSegmentConsumed.class);

  @Override
  @HttpVerb("get")
  @Description("Receives the consumed offset for a partition to be committed")
  @Summary("Receives the consumed offset for a partition from the server")
  @Paths({"/" + SegmentCompletionProtocol.MSG_TYPE_CONSUMED})
  public Representation get() {
    final String offset = getReference().getQueryAsForm().getValues(SegmentCompletionProtocol.PARAM_OFFSET);
    final String segmentName = getReference().getQueryAsForm().getValues(SegmentCompletionProtocol.PARAM_SEGMENT_NAME);
    final String instanceId = getReference().getQueryAsForm().getValues(SegmentCompletionProtocol.PARAM_INSTANCE_ID);
    if (offset == null || segmentName == null || instanceId == null) {
      return new StringRepresentation(SegmentCompletionProtocol.RESP_FAILED.toJsonString());
    }
    SegmentCompletionProtocol.Request.Params reqParams = new SegmentCompletionProtocol.Request.Params();
    reqParams.withSegmentName(segmentName).withInstanceId(instanceId).withOffset(Long.valueOf(offset));
    LOGGER.info("Request: segment={} offset={} instance={} ", segmentName, offset, instanceId);
    SegmentCompletionProtocol.Response response = SegmentCompletionManager.getInstance().segmentConsumed(reqParams);
    LOGGER.info("Response: instance={} segment={} status={} offset={}", instanceId, segmentName, response.getStatus(), response.getOffset());
    return new StringRepresentation(response.toJsonString());
  }
}