org.springframework.kafka.event.NonResponsiveConsumerEvent Maven / Gradle / Ivy
/*
* Copyright 2017-2019 the original author or authors.
*
* 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
*
* https://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.springframework.kafka.event;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import org.apache.kafka.clients.consumer.Consumer;
import org.apache.kafka.common.TopicPartition;
/**
* An event that is emitted when a consumer is not responding to
* the poll; a possible indication that the broker is down.
*
* @author Gary Russell
* @since 1.3.1
*
*/
public class NonResponsiveConsumerEvent extends KafkaEvent {
private static final long serialVersionUID = 1L;
private final long timeSinceLastPoll;
private final String listenerId;
private final List topicPartitions;
private transient Consumer consumer;
@Deprecated
public NonResponsiveConsumerEvent(Object source, long timeSinceLastPoll, String id,
Collection topicPartitions, Consumer consumer) {
this(source, null, timeSinceLastPoll, id, topicPartitions, consumer); // NOSONAR
}
/**
* Construct an instance with the provided properties.
* @param source the container instance that generated the event.
* @param container the container or the parent container if the container is a child.
* @param timeSinceLastPoll the time since the last poll.
* @param id the container id.
* @param topicPartitions the topic partitions.
* @param consumer the consumer.
* @since 2.2.1
*/
public NonResponsiveConsumerEvent(Object source, Object container,
long timeSinceLastPoll, String id,
Collection topicPartitions, Consumer consumer) {
super(source, container);
this.timeSinceLastPoll = timeSinceLastPoll;
this.listenerId = id;
this.topicPartitions = topicPartitions == null ? null : new ArrayList<>(topicPartitions);
this.consumer = consumer;
}
/**
* How long since the last poll.
* @return the time in milliseconds.
*/
public long getTimeSinceLastPoll() {
return this.timeSinceLastPoll;
}
/**
* The TopicPartitions the container is listening to.
* @return the TopicPartition list.
*/
public Collection getTopicPartitions() {
return this.topicPartitions == null ? null : Collections.unmodifiableList(this.topicPartitions);
}
/**
* The id of the listener (if {@code @KafkaListener}) or the container bean name.
* @return the id.
*/
public String getListenerId() {
return this.listenerId;
}
/**
* Retrieve the consumer. Only populated if the listener is consumer-aware.
* Allows the listener to resume a paused consumer.
* @return the consumer.
*/
public Consumer getConsumer() {
return this.consumer;
}
@Override
public String toString() {
return "NonResponsiveConsumerEvent [timeSinceLastPoll="
+ ((float) this.timeSinceLastPoll / 1000) + "s, listenerId=" + this.listenerId // NOSONAR magic #
+ ", container=" + getSource()
+ ", topicPartitions=" + this.topicPartitions + "]";
}
}