include/hbase/client/client.h

/*
 * 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.
 *
 */

#pragma once

#include <memory>
#include <string>

#include "hbase/connection/rpc-client.h"
#include "hbase/client/async-connection.h"
#include "hbase/client/configuration.h"

#include "hbase/client/table.h"
#include "hbase/serde/table-name.h"

namespace hbase {

class Table;
/**
 * Client.
 *
 * This is the class that provides access to an HBase cluster.
 * It is thread safe and does connection pooling. Current recommendations are to
 * have only one Client per cluster around.
 */
class Client {
 public:
  /**
   * @brief Create a new client.
   * @param quorum_spec Where to connect to get Zookeeper bootstrap information.
   */
  Client();
  explicit Client(const Configuration& conf);
  ~Client() = default;

  /**
   * @brief Retrieve a Table implementation for accessing a table.
   * @param - table_name
   */
  std::unique_ptr<::hbase::Table> Table(const pb::TableName& table_name);

  /**
   * @brief Close the Client connection.
   */
  void Close();

  /**
   * @brief Internal. DO NOT USE.
   */
  std::shared_ptr<AsyncConnectionImpl> async_connection() { return async_connection_; }

 private:
  /** Data */
  std::shared_ptr<AsyncConnectionImpl> async_connection_;

 private:
  /** Methods */
  void Init(const Configuration& conf);
};

}  // namespace hbase