Apache Kafka API AdminClient 获取对象

AdminClient

这个类是操作Kafka的核心，但是我们并不需要直接new出来，因为Apache提供的这个类是通过反射拿到实例对象的，而所有需要的参数都是通过Properties对象设置并传递进去的。更多内容请点击【Apache Kafka API AdminClient系列】。

获取AdminClient对象：

AdminClient提供了一个create()方法用于创建该类的实例，官网介绍如下：

非常的简洁，基本上没啥作用。那这玩意儿怎么用呢？下面举个例子创建这个对象.

static String BROKER_URL = "100.100.100.100:9092"; //broker ip或者hostname

public static AdminClient adminClient() {
    Properties props = new Properties();
    // 配置Kafka服务的访问地址及端口号
    props.setProperty(AdminClientConfig.BOOTSTRAP_SERVERS_CONFIG, BROKER_URL);
    //给kafka内部的key和value反序列化
    props.put("key.deserializer", "org.apache.kafka.common.serialization.StringDeserializer");
	props.put("value.deserializer", "org.apache.kafka.common.serialization.StringDeserializer");
    //下面三行配置SASL验证方式，如果没有可以略过
    props.put("security.protocol", "SASL_SSL");
    props.put("ssl.truststore.location", "D:/truststore.jks");
    props.put("ssl.truststore.password", "123456");
    //配置密码机制和账户密码
    props.put("sasl.mechanism", "SCRAM-SHA-512");
    props.put("sasl.jaas.config", "org.apache.kafka.common.security.scram.ScramLoginModule required username='user' password='kafkapwd';");
    // 创建AdminClient实例
    return AdminClient.create(props);
}

考虑到每次连接kafka都是一个耗时比较大的步骤，切记在项目中一定不要每次用就重新获取一个，这样会浪费大量的时间在连接上。比如交给Spring容器管理就是一个很不错的选择，在外部使用的时候只需要get出来就可以了，而不需要重新构造一个出来。

@Repository
public class KafkaConnection {
	private AdminClient adminClient;
	@PostConstruct
	private void initAdminClient(){
	    if (!Objects.nonNull(adminClient)) {
	       this.adminClient =  adminClient();
	    }
	}
	public AdminClient getAdminClient() {
        return adminClient;
    }
}

除了使用Properties类以外，官网还提供了一个以Map为基础的创建方法。这个就是对Properties换了一下，就不多说了，喜欢这种方式的同学可以自己试一下。

关闭AdminClient对象：

既然能创建自然也就可以关闭，AdminClient给提供的同样也有一个close()方法：

Close the AdminClient and release all associated resources.
调用这个方法能够关闭AdminClient并且释放所有相关的资源。

直接调用即可，但是正如上面所说，连接Kafka本身消耗的性能就很大，每次操作就关闭一下显然很不合适。但是一切都不是绝对的，需要因地制宜符合需求才是最好的。

adminClient.close();

想必大家都注意到了，上面的图片中有两个close()方法：

1. public void close()
2. public abstract void close(long duration, java.util.concurrent.TimeUnit unit)

其实Apache的这一套JAVA API给大多数方法都提供了两个方法。一个是默认的，另一个是具有一个可以操作值得方法，但是大多数情况下使用默认方法就足够使用了。因为默认的方法其实内部也是调用的具有操作值得方法，只不过这个操作值是由Apache公司设置了，比如close()方法得源码里面：

default void close() {
	//直接调用就是第二个close(long duration, java.util.concurrent.TimeUnit unit)方法
	this.close(9223372036854775807L, TimeUnit.MILLISECONDS);
}

这里说明清楚，后面的例子我们就直接使用默认的方法去操作，不在赘述这里了。