org.apache.kafka.clients.admin.ElectPreferredLeadersResult Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of kafka-client Show documentation
There is a newer version: 1.2.2.1-jre17
/*
 * 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.kafka.clients.admin;


import java.util.Collection;
import java.util.Map;
import java.util.Optional;
import java.util.Set;

import org.apache.kafka.common.ElectionType;
import org.apache.kafka.common.KafkaFuture;
import org.apache.kafka.common.TopicPartition;
import org.apache.kafka.common.annotation.InterfaceStability;
import org.apache.kafka.common.errors.UnknownTopicOrPartitionException;
import org.apache.kafka.common.internals.KafkaFutureImpl;

/**
 * The result of {@link Admin#electPreferredLeaders(Collection, ElectPreferredLeadersOptions)}
 *
 * The API of this class is evolving, see {@link Admin} for details.
 *
 * @deprecated Since 2.4.0. Use {@link Admin#electLeaders(ElectionType, Set, ElectLeadersOptions)}.
 */
@InterfaceStability.Evolving
@Deprecated
public class ElectPreferredLeadersResult {
    private final ElectLeadersResult electionResult;

    ElectPreferredLeadersResult(ElectLeadersResult electionResult) {
        this.electionResult = electionResult;
    }

    /**
     * Get the result of the election for the given {@code partition}.
     * If there was not an election triggered for the given {@code partition}, the
     * returned future will complete with an error.
     */
    public KafkaFuture partitionResult(final TopicPartition partition) {
        final KafkaFutureImpl result = new KafkaFutureImpl<>();

        electionResult.partitions().whenComplete(
                new KafkaFuture.BiConsumer>, Throwable>() {
                    @Override
                    public void accept(Map> topicPartitions, Throwable throwable) {
                        if (throwable != null) {
                            result.completeExceptionally(throwable);
                        } else if (!topicPartitions.containsKey(partition)) {
                            result.completeExceptionally(new UnknownTopicOrPartitionException(
                                        "Preferred leader election for partition \"" + partition +
                                        "\" was not attempted"));
                        } else {
                            Optional exception = topicPartitions.get(partition);
                            if (exception.isPresent()) {
                                result.completeExceptionally(exception.get());
                            } else {
                                result.complete(null);
                            }
                        }
                    }
                });

        return result;
    }

    /**
     * Get a future for the topic partitions for which a leader election
     * was attempted. A partition will be present in this result if
     * an election was attempted even if the election was not successful.
     *
     * This method is provided to discover the partitions attempted when
     * {@link Admin#electPreferredLeaders(Collection)} is called
     * with a null {@code partitions} argument.
     */
    public KafkaFuture> partitions() {
        final KafkaFutureImpl> result = new KafkaFutureImpl<>();

        electionResult.partitions().whenComplete(
                new KafkaFuture.BiConsumer>, Throwable>() {
                    @Override
                    public void accept(Map> topicPartitions, Throwable throwable) {
                        if (throwable != null) {
                            result.completeExceptionally(throwable);
                        } else {
                            result.complete(topicPartitions.keySet());
                        }
                    }
                });

        return result;
    }

    /**
     * Return a future which succeeds if all the topic elections succeed.
     */
    public KafkaFuture all() {
        return electionResult.all();
    }
}