所有超级接口:

java.lang.AutoCloseable

所有已知实现类:

ProducerInterceptorWrapper
```
@Public
@Stable
public interface ProducerInterceptor
extends java.lang.AutoCloseable
```
A plugin interface that allows you to intercept (and possibly mutate) the messages received by the producer before they are published to the Pulsar brokers.
Exceptions thrown by ProducerInterceptor methods will be caught, logged, but not propagated further.
ProducerInterceptor callbacks may be called from multiple threads. Interceptor implementation must ensure thread-safety, if needed.
Since the producer may run multiple interceptors, a particular interceptor will be called in the order specified by ProducerBuilder.intercept(ProducerInterceptor...).

方法概要

所有方法实例方法抽象方法
修饰符和类型	方法	说明
`Message`	`beforeSend(Producer producer, Message message)`	This is called from `Producer.send(Object)` and `Producer.sendAsync(Object)` methods, before send the message to the brokers.
`void`	`close()`	Close the interceptor.
`boolean`	`eligible(Message message)`	Check whether the interceptor is eligible for this message.
`void`	`onSendAcknowledgement(Producer producer, Message message, MessageId msgId, java.lang.Throwable exception)`	This method is called when the message sent to the broker has been acknowledged, or when sending the message fails.

- 方法详细资料
  - close
```
void close()
```
    Close the interceptor.
    
    指定者:
    
    close 在接口中 java.lang.AutoCloseable
  - eligible
```
boolean eligible(Message message)
```
    Check whether the interceptor is eligible for this message.
    
    参数:
    
    message - message to send
    
    返回:
    
    whether the interceptor can be applied to this particular message.
  - beforeSend
```
Message beforeSend(Producer producer,
                   Message message)
```
    This is called from Producer.send(Object) and Producer.sendAsync(Object) methods, before send the message to the brokers. This method is allowed to modify the record, in which case, the new record will be returned.
    Any exception thrown by this method will be caught by the caller and logged, but not propagated further.
    Each interceptor will be passed the message returned by the last successful executed interceptor or the original message if it is the first one. Since interceptors are allowed to modify messages, interceptors may potentially get the message already modified by other interceptors. However, building a pipeline of mutable interceptors that depend on the output of the previous interceptor is discouraged, because of potential side-effects caused by interceptors potentially failing to modify the message and throwing an exception.
    
    参数:
    
    producer - the producer which contains the interceptor.
    
    message - message to send
    
    返回:
    
    the intercepted message
  - onSendAcknowledgement
```
void onSendAcknowledgement(Producer producer,
                           Message message,
                           MessageId msgId,
                           java.lang.Throwable exception)
```
    This method is called when the message sent to the broker has been acknowledged, or when sending the message fails. This method is generally called just before the user callback is called, and in additional cases when an exception on the producer side.
    Any exception thrown by this method will be ignored by the caller.
    This method will generally execute in the background I/O thread, so the implementation should be reasonably fast. Otherwise, sending of messages from other threads could be delayed.
    
    参数:
    
    producer - the producer which contains the interceptor.
    
    message - the message that application sends
    
    msgId - the message id that assigned by the broker; null if send failed.
    
    exception - the exception on sending messages, null indicates send has succeed.

接口 ProducerInterceptor

方法概要

方法详细资料

close

eligible

beforeSend

onSendAcknowledgement