001/*
002 *
003 * Licensed to the Apache Software Foundation (ASF) under one
004 * or more contributor license agreements.  See the NOTICE file
005 * distributed with this work for additional information
006 * regarding copyright ownership.  The ASF licenses this file
007 * to you under the Apache License, Version 2.0 (the
008 * "License"); you may not use this file except in compliance
009 * with the License.  You may obtain a copy of the License at
010 *
011 *     http://www.apache.org/licenses/LICENSE-2.0
012 *
013 * Unless required by applicable law or agreed to in writing, software
014 * distributed under the License is distributed on an "AS IS" BASIS,
015 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
016 * See the License for the specific language governing permissions and
017 * limitations under the License.
018 */
019package org.apache.hadoop.hbase.replication;
020
021import java.util.List;
022
023import org.apache.yetus.audience.InterfaceAudience;
024
025/**
026 * This is the interface for a Replication Tracker. A replication tracker provides the facility to
027 * subscribe and track events that reflect a change in replication state. These events are used by
028 * the ReplicationSourceManager to coordinate replication tasks such as addition/deletion of queues
029 * and queue failover. These events are defined in the ReplicationListener interface. If a class
030 * would like to listen to replication events it must implement the ReplicationListener interface
031 * and register itself with a Replication Tracker.
032 */
033@InterfaceAudience.Private
034public interface ReplicationTracker {
035
036  /**
037   * Register a replication listener to receive replication events.
038   * @param listener
039   */
040  public void registerListener(ReplicationListener listener);
041
042  public void removeListener(ReplicationListener listener);
043
044  /**
045   * Returns a list of other live region servers in the cluster.
046   * @return List of region servers.
047   */
048  public List<String> getListOfRegionServers();
049}