/*
 * Copyright (c) 2013 Malhar Inc. ALL Rights Reserved.
 *
 * 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.datatorrent.contrib.hbase;

import java.io.IOException;
import org.apache.hadoop.hbase.client.HTable;

/**
 * Interface for persistence strategy.<br>
 *
 * <br>
 * The interface needs to be implemented by any class that will provide the persistence
 * for the HBase output operator. The output operator will use the persistence strategy
 * to persist processing state into HBase.<br>
 *
 * <br>
 * The table is provided by the operator using the setTable method. It can be used by the
 * implementor to persist the state in an application specific way. There are additional
 * method to retrieve and save state that needs to be implemented by the implementor.<br>
 *
 * <br>
 *
 * @since 0.3.2
 */
public interface HBaseStatePersistenceStrategy
{
  /**
   * Set the table.
   * It is called by the operator to set the table.
   * @param table The table
   */
  public void setTable(HTable table);

  /**
   * Get the table.
   * @return The table
   */
  public HTable getTable();

  /**
   * Setup the persistence.
   * This method is called once by the operator for the persistence
   * strategy to initialize any resources it needs to.
   * @throws IOException
   */
  public void setup() throws IOException;

  /**
   * Retrieve the state.
   * Retrieve the state of a given parameter. The name of the parameter is specified. The
   * implementor should retrieve and return the previously saved value of the parameter if any from
   * the persistence storage.
   * @param name The parameter name
   * @return The previously saved value if there is any, null otherwise
   * @throws IOException
   */
  public byte[] getState(byte[] name) throws IOException;

  /**
   * Save the state.
   * Save the state of a given parameter. The name and value of the parameter are specified.
   * The implementor should save the name and value of the parameter in a persistence storage to
   * be recalled later.
   * @param name The name of the parameter
   * @param value The value of the parameter
   * @throws IOException
   */
  public void saveState(byte[] name, byte[] value) throws IOException;
}