SSL协议生产和消费消息
更新时间:2024-09-26
在 Kafka 集群所在 VPC 网络下或者公网环境访问,使用 SSL 协议接入,接入点可以在集群详情页面查看。
环境准备
集群准备
1. 购买专享版消息服务for Kafka集群
开通消息服务 for Kafka服务后,在控制台页面点击『创建集群』,即可进行购买。
2. 为购买的集群创建主题
在控制台页面点击集群名称,进入集群详情页面。
在左侧的边栏中点击『主题管理』,进入主题管理页面。
在主题管理页面点击『创建主题』,进行主题的创建。
使用步骤:
步骤一:获取集群接入点
具体请参考:接入点查看。
步骤二:添加Maven配置
XML
1<dependencies>
2 <dependency>
3 <groupId>org.apache.kafka</groupId>
4 <artifactId>kafka-clients</artifactId>
5 <version>2.7.2</version>
6 </dependency>
7 <!-- https://mvnrepository.com/artifact/org.apache.maven.plugins/maven-assembly-plugin -->
8 <dependency>
9 <groupId>org.apache.maven.plugins</groupId>
10 <artifactId>maven-assembly-plugin</artifactId>
11 <version>3.5.0</version>
12 </dependency>
13</dependencies>
步骤三:准备证书文件
下载证书文件:如何下载证书?
步骤四:创建kafka.properties配置文件
提供接入 Kafka 服务需要的配置信息,配置项如下,可以使用证书文件中的client_ssl.properties文件:
- bootstrap.servers 配置为SSL协议对应的接入点地址,具体请参考接入点查看。
- security.protocol 固定为 SSL
- ssl.truststore.location 配置为 client.truststore.jks 文件路径
- ssl.truststore.password 固定为 bms@kafka
- ssl.keystore.location 配置为 client.keystore.jks 文件路径
- ssl.keystore.password 配置为keystore的访问密码,可以从client_ssl.properties中获取
- ssl.endpoint.identification.algorithm 固定为空
XML
1bootstrap.servers=<接入点地址>
2
3security.protocol=SSL
4ssl.truststore.location=client.truststore.jks
5ssl.truststore.password=bms@kafka
6ssl.keystore.location=client.keystore.jks
7ssl.keystore.password=password
8ssl.endpoint.identification.algorithm=
kafka.properties 可以作为 resources 文件与代码一起打包,代码运行时会在 classpath 中寻找 kafka.properties 文件资源;也可以在运行代码时将 kafka.properties 置于进程工作目录同级的 config 目录下。
步骤五:编写测试代码
- 需要关注并自行修改的参数
参数名 | 含义 |
---|---|
path | 接入点信息kafka.properties所在路径(建议写文件所在的绝对路径) |
topic | 主题名称 |
message | 消息的具体内容 |
group_id | 消费组id |
生产者代码示例
创建KafkaProducerDemo.java文件,具体代码示例如下:
Java
1package org.example.Java示例.SSL;
2
3import org.apache.kafka.clients.producer.KafkaProducer;
4import org.apache.kafka.clients.producer.ProducerConfig;
5import org.apache.kafka.clients.producer.ProducerRecord;
6import org.apache.kafka.clients.producer.RecordMetadata;
7
8import java.io.File;
9import java.io.FileInputStream;
10import java.io.IOException;
11import java.util.Properties;
12
13public class KafkaProducerDemo {
14 public static void main(String[] args) throws IOException {
15
16 // 需要自行配置下面三个参数
17 // kafka.properties所在路径(建议写文件所在的绝对路径)
18 String path = "kafka.properties";
19 // 主题名称-topic name
20 String topic = "test_ssl";
21 // 消息内容
22 String message = "kafka java test";
23
24 // 创建配置类,并获取配置文件 kafka.properties 的内容。
25 Properties properties = new Properties();
26 File file = new File(path);
27 try {
28 if (file.exists()) {
29 // 如果通过用户指定的path路径找到了kafka.properties文件,则加载kafka.properties中的配置项
30 properties.load(new FileInputStream(file));
31 } else {
32 // 如果没有从path中找到,则从KafkaProducerDemo所在的路径去查找
33 properties.load(
34 KafkaProducerDemo.class.getClassLoader().getResourceAsStream("kafka.properties")
35 );
36 }
37 } catch (IOException e) {
38 // 没找到kafka.properties文件,在此处处理异常
39 throw e;
40 }
41
42 // Kafka消息的序列化方式。
43 properties.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer");
44 properties.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer");
45 // 请求的最长等待时间。
46 properties.put(ProducerConfig.MAX_BLOCK_MS_CONFIG, 30 * 1000);
47 // 设置客户端内部重试次数。
48 properties.put(ProducerConfig.RETRIES_CONFIG, 5);
49 // 设置客户端内部重试间隔。
50 properties.put(ProducerConfig.RECONNECT_BACKOFF_MS_CONFIG, 3000);
51
52 // 构建kafkaProducer对象
53 KafkaProducer<String, String> kafkaProducer = new KafkaProducer<>(properties);
54
55 try {
56 // 向指定的topic发送100条消息
57 for (int i = 0; i < 100; i++) {
58 // 通过 ProducerRecord 构造一个消息对象
59 ProducerRecord<String, String> kafkaMessage = new ProducerRecord<>(topic, message + "-" + i);
60 // 通过kafkaProducer发送消息
61 kafkaProducer.send(kafkaMessage, (RecordMetadata recordMetadata, Exception e) -> {
62 // 发送信息后的回调函数,用以验证消息是否发送成功
63 if (e == null) {
64 System.out.println("send success:" + recordMetadata.toString());
65 } else {
66 e.printStackTrace();
67 System.err.println("send failed");
68 }
69 });
70 }
71 }catch (Exception e){
72 System.out.println(e.getMessage());
73 e.printStackTrace();
74 }finally {
75 // 不要忘记关闭资源
76 kafkaProducer.close();
77 }
78 }
79}
消费者代码示例
创建KafkaConsumerDemo.java文件,具体代码示例如下:
Java
1package org.example.Java示例.SSL;
2
3import org.apache.kafka.clients.consumer.ConsumerConfig;
4import org.apache.kafka.clients.consumer.ConsumerRecord;
5import org.apache.kafka.clients.consumer.ConsumerRecords;
6import org.apache.kafka.clients.consumer.KafkaConsumer;
7
8import java.io.File;
9import java.io.FileInputStream;
10import java.io.IOException;
11import java.time.Duration;
12import java.util.Collections;
13import java.util.Properties;
14
15public class KafkaConsumerDemo {
16 public static void main(String[] args) throws IOException {
17
18 // 需要自行配置下面三个参数
19 // kafka.properties所在路径(建议写文件所在的绝对路径)
20 String path = "kafka.properties";
21 // 主题名称-topic name
22 String topic = "test_ssl";
23 // 消费组id
24 String group_id = "test_group";
25
26 // 创建配置类,并获取配置文件 kafka.properties 的内容。
27 Properties properties = new Properties();
28 File file = new File(path);
29 try {
30 if (file.exists()) {
31 // 如果通过用户指定的path路径找到了kafka.properties文件,则加载kafka.properties中的配置项
32 properties.load(new FileInputStream(file));
33 } else {
34 // 如果没有从path中找到,则从KafkaProducerDemo所在的路径去查找
35 properties.load(
36 KafkaProducerDemo.class.getClassLoader().getResourceAsStream("kafka.properties")
37 );
38 }
39 } catch (IOException e) {
40 // 没找到kafka.properties文件,在此处处理异常
41 throw e;
42 }
43
44 // Kafka消息的序列化方式
45 properties.put(ConsumerConfig.KEY_DESERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringDeserializer");
46 properties.put(ConsumerConfig.VALUE_DESERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringDeserializer");
47 // 指定消费组id
48 properties.put(ConsumerConfig.GROUP_ID_CONFIG, group_id);
49 // enable.auto.commit如果为true,则消费者的偏移量将定期在后台提交。
50 properties.put(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG, "true");
51 // 重置消费位点策略:earliest、latest、none
52 properties.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest");
53 // 设置kafka自动提交offset的频率,默认5000ms,也就是5s
54 properties.put(ConsumerConfig.AUTO_COMMIT_INTERVAL_MS_CONFIG, 1000);
55 // 设置消费者在一次poll中返回的最大记录数
56 properties.put(ConsumerConfig.MAX_POLL_RECORDS_CONFIG, 1000);
57 // 设置消费者两次poll的最大时间间隔
58 properties.put(ConsumerConfig.MAX_POLL_INTERVAL_MS_CONFIG, 1000);
59
60 // 构建KafkaConsumer对象
61 KafkaConsumer<String, String> kafkaConsumer = new KafkaConsumer<>(properties);
62
63 //订阅主题
64 kafkaConsumer.subscribe(Collections.singleton(topic));
65
66 try{
67 //持续消费主题中的消息
68 while(true){
69 // 构建ConsumerRecord用于接收存储消息
70 ConsumerRecords<String, String> kafkaMessage = kafkaConsumer.poll(Duration.ofMillis(5000));
71 for (ConsumerRecord<String, String> consumerRecord : kafkaMessage) {
72 // 打印消息具体内容
73 System.out.printf("offset = %d, key = %s, value = %s%n", consumerRecord.offset(), consumerRecord.key(), consumerRecord.value());
74 }
75 }
76 }catch (Exception e){
77 System.out.println(e.getMessage());
78 e.printStackTrace();
79 }finally {
80 kafkaConsumer.close();
81 }
82 }
83}
步骤六:编译并运行
编译并运行上述两个代码文件。
- 先启动KafkaConsumerDemo.java
- 再启动KafkaProducerDemo.java
步骤七:查看集群监控
查看消息是否发送成功或消费成功有两种方式:
- 查看程序输出日志。
- 在专享版消息服务 for Kafka控制台查看集群监控,获取集群生产、消息情况。
推荐使用第二种方式,下面介绍如何查看集群监控。
(1)在专享版消息服务 for Kafka的控制台页面找到需要连接的集群,点击集群名称进入『集群详情』页面。
(2)页面跳转后,进入左侧边中的『集群详情』页面。
(3)点击左侧边栏中的『集群监控』,进入『集群监控』页面。
(4)通过查看『集群监控』页面,提供的不同纬度的监控信息(集群监控、节点监控、主题监控、消费组监控),即可获知集群的生产和消费情况。
集群监控的具体使用请参考:集群监控