org.apache.pulsar.client.admin.Transactions Maven / Gradle / Ivy
/**
* 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.pulsar.client.admin;
import java.util.Map;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.TimeUnit;
import org.apache.pulsar.client.api.transaction.TxnID;
import org.apache.pulsar.common.policies.data.TransactionBufferStats;
import org.apache.pulsar.common.policies.data.TransactionCoordinatorInternalStats;
import org.apache.pulsar.common.policies.data.TransactionCoordinatorStats;
import org.apache.pulsar.common.policies.data.TransactionInBufferStats;
import org.apache.pulsar.common.policies.data.TransactionInPendingAckStats;
import org.apache.pulsar.common.policies.data.TransactionMetadata;
import org.apache.pulsar.common.policies.data.TransactionPendingAckInternalStats;
import org.apache.pulsar.common.policies.data.TransactionPendingAckStats;
public interface Transactions {
/**
* Get transaction metadataStore stats.
*
* @param coordinatorId the id which get transaction coordinator
* @return the future of transaction metadata store stats.
*/
CompletableFuture getCoordinatorStatsByIdAsync(int coordinatorId);
/**
* Get transaction metadataStore stats.
*
* @param coordinatorId the id which get transaction coordinator
* @return the transaction metadata store stats.
*/
TransactionCoordinatorStats getCoordinatorStatsById(int coordinatorId) throws PulsarAdminException;
/**
* Get transaction metadataStore stats.
*
* @return the map future of transaction metadata store stats.
*/
CompletableFuture> getCoordinatorStatsAsync();
/**
* Get transaction metadataStore stats.
*
* @return the map of transaction metadata store stats.
*/
Map getCoordinatorStats() throws PulsarAdminException;
/**
* Get transaction in buffer stats.
*
* @param txnID the txnId
* @param topic the produce topic
* @return the future stats of transaction in buffer.
*/
CompletableFuture getTransactionInBufferStatsAsync(TxnID txnID, String topic);
/**
* Get transaction in buffer stats.
*
* @param txnID the txnId
* @param topic the produce topic
* @return the stats of transaction in buffer.
*/
TransactionInBufferStats getTransactionInBufferStats(TxnID txnID, String topic) throws PulsarAdminException;
/**
* Get transaction in pending ack stats.
*
* @param txnID the txnId
* @param topic the ack topic
* @param subName the subscription name of this transaction ack
* @return the future stats of transaction in pending ack.
*/
CompletableFuture getTransactionInPendingAckStatsAsync(TxnID txnID, String topic,
String subName);
/**
* Get transaction in pending ack stats.
*
* @param txnID the txnId
* @param topic the ack topic
* @param subName the subscription name of this transaction ack
* @return the stats of transaction in pending ack.
*/
TransactionInPendingAckStats getTransactionInPendingAckStats(TxnID txnID, String topic,
String subName) throws PulsarAdminException;
/**
* Get transaction metadata.
*
* @param txnID the ID of this transaction
* @return the future metadata of this transaction.
*/
CompletableFuture getTransactionMetadataAsync(TxnID txnID);
/**
* Get transaction metadata.
*
* @param txnID the ID of this transaction
* @return the metadata of this transaction.
*/
TransactionMetadata getTransactionMetadata(TxnID txnID) throws PulsarAdminException;
/**
* Get transaction buffer stats.
*
* @param topic the topic of getting transaction buffer stats
* @return the future stats of transaction buffer in topic.
*/
CompletableFuture getTransactionBufferStatsAsync(String topic);
/**
* Get transaction buffer stats.
*
* @param topic the topic of getting transaction buffer stats
* @return the stats of transaction buffer in topic.
*/
TransactionBufferStats getTransactionBufferStats(String topic) throws PulsarAdminException;
/**
* Get transaction pending ack stats.
*
* @param topic the topic of this transaction pending ack stats
* @param subName the subscription name of this transaction pending ack stats
* @return the stats of transaction pending ack.
*/
CompletableFuture getPendingAckStatsAsync(String topic, String subName);
/**
* Get transaction pending ack stats.
*
* @param topic the topic of this transaction pending ack stats
* @param subName the subscription name of this transaction pending ack stats
* @return the stats of transaction pending ack.
*/
TransactionPendingAckStats getPendingAckStats(String topic, String subName) throws PulsarAdminException;
/**
* Get slow transactions by coordinator id.
*
* @param coordinatorId the coordinator id of getting slow transaction status.
* @param timeout the timeout
* @param timeUnit the timeout timeUnit
* @return the future metadata of slow transactions.
*/
CompletableFuture> getSlowTransactionsByCoordinatorIdAsync(Integer coordinatorId,
long timeout,
TimeUnit timeUnit);
/**
* Get slow transactions by coordinator id.
*
* @param coordinatorId the coordinator id of getting slow transaction status.
* @param timeout the timeout
* @param timeUnit the timeout timeUnit
* @return the metadata of slow transactions.
*/
Map getSlowTransactionsByCoordinatorId(Integer coordinatorId,
long timeout,
TimeUnit timeUnit) throws PulsarAdminException;
/**
* Get slow transactions.
*
* @param timeout the timeout
* @param timeUnit the timeout timeUnit
*
* @return the future metadata of slow transactions.
*/
CompletableFuture> getSlowTransactionsAsync(long timeout,
TimeUnit timeUnit);
/**
* Get slow transactions.
*
* @param timeout the timeout
* @param timeUnit the timeout timeUnit
*
* @return the metadata of slow transactions.
*/
Map getSlowTransactions(long timeout, TimeUnit timeUnit) throws PulsarAdminException;
/**
* Get transaction coordinator internal stats.
*
* @param coordinatorId the coordinator ID
* @param metadata is get ledger metadata
*
* @return the future internal stats of this coordinator
*/
CompletableFuture getCoordinatorInternalStatsAsync(int coordinatorId,
boolean metadata);
/**
* Get transaction coordinator internal stats.
*
* @param coordinatorId the coordinator ID
* @param metadata whether to obtain ledger metadata
*
* @return the internal stats of this coordinator
*/
TransactionCoordinatorInternalStats getCoordinatorInternalStats(int coordinatorId,
boolean metadata) throws PulsarAdminException;
/**
* Get pending ack internal stats.
*
* @param topic the topic of get pending ack internal stats
* @param subName the subscription name of this pending ack
* @param metadata whether to obtain ledger metadata
*
* @return the future internal stats of pending ack
*/
CompletableFuture getPendingAckInternalStatsAsync(String topic, String subName,
boolean metadata);
/**
* Get pending ack internal stats.
*
* @param topic the topic of get pending ack internal stats
* @param subName the subscription name of this pending ack
* @param metadata whether to obtain ledger metadata
*
* @return the internal stats of pending ack
*/
TransactionPendingAckInternalStats getPendingAckInternalStats(String topic, String subName,
boolean metadata) throws PulsarAdminException;
}