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);
    //下面三行配置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);
}

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

猜你喜欢

转载自blog.csdn.net/Smallc0de/article/details/109031084
今日推荐