根據官網的介紹,ApacheKafka®是一個分佈式流媒體平臺,它主要有3種功能:html
發佈和訂閱消息流,這個功能相似於消息隊列,這也是kafka歸類爲消息隊列框架的緣由java
以容錯的方式記錄消息流,kafka以文件的方式來存儲消息流git
能夠再消息發佈的時候進行處理github
Producer
: 消息和數據的生產者,向kafka的一個Topic發佈消息的進程/代碼/服務web
Consumer
:消息和數據的消費者,訂閱數據(topic)而且處理其發佈的消息的進程/代碼/服務spring
Consumer Group
:邏輯概念,對於同一個topic,會廣播給不一樣的group,一個group中,只有一個consumer能夠消費該消息apache
Broker
:物理概念,kafka集羣中的每一個kafka節點json
Topic
:邏輯概念,kafka消息的類別,對數據進行區分、隔離bootstrap
Partition
:物理概念,kafka下數據存儲的基本單元。一個topic數據,會被分散存儲到多個Partition,每個Partition是有序的windows
Replication
:同一個Partition可能會多個Replica,多個Replica之間數據是同樣的
Replication Leader
:一個Partition的多個Replica上,須要一個Leader負責該Partition上與Producer和Consumer交互
ReplicaManager
:負責管理當前broker全部分區和副本的信息,處理KafkaController發起的一些請求,副本狀態的切換、添加/讀取消息等
http://zookeeper.apache.org/releases.html#download
複製代碼
http://kafka.apache.org/downloads
複製代碼
解壓、配置環境變量 PS:若是是Mac的話,有一個便捷安裝方法,brew install kafka
運行cmd命令窗口,輸入zkServer回車,出現下圖的就表示zookeeper啓動成功,也代表安裝成功了。
在新的cmd命令行用cd命令切換到kafka根目錄..\kafka_2.11-2.2.0
,輸入命令
.\bin\windows\kafka-server-start.bat .\config\server.properties
複製代碼
運行新的cmd命令行,進入..\kafka_2.11-2.2.0\bin\windows
,建立主題:test
,輸入命令
kafka-topics.bat --create --zookeeper localhost:2181 --replication-factor 1 --partitions 1 --topic test
複製代碼
運行新的cmd命令行,進入..\kafka_2.11-2.2.0\bin\windows
,輸入命令
kafka-console-producer.bat --broker-list localhost:9092 --topic test
複製代碼
運行新的cmd命令行,進入..\kafka_2.11-2.2.0\bin\windows
,輸入命令
kafka-console-consumer.bat --bootstrap-server localhost:9092 --topic test --from-beginning
複製代碼
在Producer窗口下輸入信息進行測試 ,輸入的消息立馬就會出如今Consumer中,代表kafka已經安裝測試成功
項目結構
pom.xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.4.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.cxy</groupId>
<artifactId>kafka</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>kafka</name>
<description>kafka_learning</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.kafka</groupId>
<artifactId>spring-kafka</artifactId>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.springframework.kafka</groupId>
<artifactId>spring-kafka-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.8.5</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-log4j</artifactId>
<version>1.3.5.RELEASE</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
複製代碼
application.properties
kafka.consumer.zookeeper.connect=127.0.0.1:2181
kafka.consumer.servers=127.0.0.1:9092
kafka.consumer.enable.auto.commit=true
kafka.consumer.session.timeout=6000
kafka.consumer.auto.commit.interval=100
kafka.consumer.auto.offset.reset=latest
kafka.consumer.topic=kafkaTestTopic
kafka.consumer.group.id=kafkaTest
kafka.consumer.concurrency=10
kafka.producer.servers=127.0.0.1:9092
kafka.producer.retries=0
kafka.producer.batch.size=4096
kafka.producer.linger=1
kafka.producer.buffer.memory=40960
kafka.topic.default=kafkaTestTopic
複製代碼
log4j.properties
log4j.rootLogger=DEBUG, stdout
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n
複製代碼
ErrorCode.java
package com.cxy.kafka.common;
/**
* @Auther: cxy
* @Date: 2019/4/9
* @Description:
*/
public class ErrorCode {
public final static int SUCCESS = 200;
public final static int EXCEPTION = 500;
}
複製代碼
MessageEntity.java
package com.cxy.kafka.common;
import lombok.EqualsAndHashCode;
import lombok.Getter;
import lombok.Setter;
/**
* @Auther: cxy
* @Date: 2019/4/9
* @Description:
*/
@Getter
@Setter
@EqualsAndHashCode
public class MessageEntity {
private String title;
private String body;
@Override
public String toString(){
return "MessageEntity{" +
"title='" + title + '\'' + ",body='" + body + '\'' + '}'; } } 複製代碼
Response.java
package com.cxy.kafka.common;
import lombok.Getter;
import lombok.Setter;
/**
* @Auther: cxy
* @Date: 2019/4/9
* @Description:
*/
@Getter
@Setter
public class Response {
private int code;
private String message;
public Response(int code, String message){
this.code = code;
this.message = message;
}
}
複製代碼
KafkaProducerConfig.java
package com.cxy.kafka.config;
import com.cxy.kafka.common.MessageEntity;
import org.apache.kafka.clients.producer.ProducerConfig;
import org.apache.kafka.common.serialization.StringSerializer;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.kafka.annotation.EnableKafka;
import org.springframework.kafka.core.DefaultKafkaProducerFactory;
import org.springframework.kafka.core.KafkaTemplate;
import org.springframework.kafka.core.ProducerFactory;
import org.springframework.kafka.support.serializer.JsonSerializer;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;
/**
* @Auther: cxy
* @Date: 2019/4/9
* @Description:
*/
@Configuration
@EnableKafka
public class KafkaProducerConfig {
@Value("${kafka.producer.servers}")
private String servers;
@Value("${kafka.producer.retries}")
private int retries;
@Value("${kafka.producer.batch.size}")
private int batchSize;
@Value("${kafka.producer.linger}")
private int linger;
@Value("${kafka.producer.buffer.memory}")
private int bufferMemory;
public Map<String,Object> producerConfigs() {
Map<String,Object> props = new HashMap<String, Object>(16);
props.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, servers);
props.put(ProducerConfig.RETRIES_CONFIG, retries);
props.put(ProducerConfig.BATCH_SIZE_CONFIG, batchSize);
props.put(ProducerConfig.LINGER_MS_CONFIG, linger);
props.put(ProducerConfig.BUFFER_MEMORY_CONFIG, bufferMemory);
props.put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, StringSerializer.class);
props.put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, StringSerializer.class);
return props;
}
public ProducerFactory<String, MessageEntity> producerFactory(){
return new DefaultKafkaProducerFactory<String, MessageEntity>(
producerConfigs(),
new StringSerializer(),
new JsonSerializer<MessageEntity>());
}
@Bean
public KafkaTemplate<String, MessageEntity> kafkaTemplate(){
return new KafkaTemplate<String, MessageEntity>(producerFactory());
}
}
複製代碼
KafkaConsumerConfig.java
package com.cxy.kafka.config;
import com.cxy.kafka.common.MessageEntity;
import org.apache.kafka.clients.consumer.ConsumerConfig;
import org.apache.kafka.common.serialization.StringDeserializer;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.kafka.annotation.EnableKafka;
import org.springframework.kafka.config.ConcurrentKafkaListenerContainerFactory;
import org.springframework.kafka.config.KafkaListenerContainerFactory;
import org.springframework.kafka.core.ConsumerFactory;
import org.springframework.kafka.core.DefaultKafkaConsumerFactory;
import org.springframework.kafka.listener.ConcurrentMessageListenerContainer;
import org.springframework.kafka.support.serializer.JsonDeserializer;
import java.util.HashMap;
import java.util.Map;
/**
* @Auther: cxy
* @Date: 2019/4/9
* @Description:
*/
@Configuration
@EnableKafka
public class KafkaConsumerConfig {
@Value("${kafka.consumer.servers}")
private String servers;
//服務是否自動提交
@Value("${kafka.consumer.enable.auto.commit}")
private boolean enableAutoCommit;
//session超時時間
@Value("${kafka.consumer.session.timeout}")
private String sessionTimeout;
//提交的間隔
@Value("${kafka.consumer.auto.commit.interval}")
private String autoCommitInterval;
//生產者groupId
@Value("${kafka.consumer.group.id}")
private String groupId;
//自動將offset重置到某位置
@Value("${kafka.consumer.auto.offset.reset}")
private String autoOffsetReset;
//併發數目
@Value("${kafka.consumer.concurrency}")
private int concurrency;
private Map<String,Object> consumerConfigs() {
Map<String,Object> props = new HashMap<String, Object>(16);
props.put(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG, servers);
props.put(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG, enableAutoCommit);
props.put(ConsumerConfig.SESSION_TIMEOUT_MS_CONFIG, sessionTimeout);
props.put(ConsumerConfig.AUTO_COMMIT_INTERVAL_MS_CONFIG, autoCommitInterval);
props.put(ConsumerConfig.GROUP_ID_CONFIG, groupId);
props.put(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, autoOffsetReset);
props.put(ConsumerConfig.KEY_DESERIALIZER_CLASS_CONFIG, StringDeserializer.class);
props.put(ConsumerConfig.VALUE_DESERIALIZER_CLASS_CONFIG, StringDeserializer.class);
return props;
}
private ConsumerFactory<String, MessageEntity> consumerFactory() {
return new DefaultKafkaConsumerFactory<String, MessageEntity>(
consumerConfigs(),
new StringDeserializer(),
new JsonDeserializer<MessageEntity>(MessageEntity.class));
}
@Bean
public KafkaListenerContainerFactory<ConcurrentMessageListenerContainer<String, MessageEntity>> kafkaListenerContainerFactory(){
ConcurrentKafkaListenerContainerFactory<String, MessageEntity> factory = new ConcurrentKafkaListenerContainerFactory<String, MessageEntity>();
factory.setConsumerFactory(consumerFactory());
factory.setConcurrency(concurrency);
factory.getContainerProperties().setPollTimeout(1500);
return factory;
}
}
複製代碼
ProducerCallback.java
package com.cxy.kafka.producer;
import com.cxy.kafka.common.MessageEntity;
import com.google.gson.Gson;
import lombok.extern.slf4j.Slf4j;
import org.apache.kafka.clients.producer.RecordMetadata;
import org.apache.log4j.Logger;
import org.springframework.kafka.support.SendResult;
import org.springframework.lang.Nullable;
import org.springframework.util.concurrent.ListenableFutureCallback;
/**
* @Auther: cxy
* @Date: 2019/4/9
* @Description:
*/
@Slf4j
public class ProducerCallback implements ListenableFutureCallback<SendResult<String, MessageEntity>> {
public static final Logger logger = Logger.getLogger(ProducerCallback.class);
private final long startTime;
private final String key;
private final MessageEntity messageEntity;
private final Gson gson = new Gson();
public ProducerCallback(long startTime, String key, MessageEntity messageEntity){
this.startTime = startTime;
this.key = key;
this.messageEntity = messageEntity;
}
@Override
public void onFailure(Throwable throwable) {
throwable.printStackTrace();
}
@Override
public void onSuccess(@Nullable SendResult<String, MessageEntity> stringMessageEntitySendResult) {
if(stringMessageEntitySendResult == null){
return;
}
long elapsedTime = System.currentTimeMillis() - startTime;
RecordMetadata metadata = stringMessageEntitySendResult.getRecordMetadata();
if(metadata!=null){
StringBuilder stringBuilder = new StringBuilder();
stringBuilder.append("message(")
.append("key= ").append(key).append(",")
.append("message= ").append(gson.toJson(messageEntity)).append(")")
.append("sent to partition(").append(metadata.partition()).append(")")
.append("with offset(").append(metadata.offset()).append(")")
.append("in ").append(elapsedTime).append(" ms");
logger.info(stringBuilder.toString());
}
}
}
複製代碼
SimpleProducer.java
package com.cxy.kafka.producer;
import com.cxy.kafka.common.MessageEntity;
import org.apache.kafka.clients.producer.ProducerRecord;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.kafka.core.KafkaTemplate;
import org.springframework.kafka.support.SendResult;
import org.springframework.stereotype.Component;
import org.springframework.util.concurrent.ListenableFuture;
/**
* @Auther: cxy
* @Date: 2019/4/9
* @Description:
*/
@Component
public class SimpleProducer {
@Autowired
@Qualifier("kafkaTemplate")
private KafkaTemplate<String, MessageEntity> kafkaTemplate;
public void send(String topic, MessageEntity messageEntity){
kafkaTemplate.send(topic,messageEntity);
}
public void send(String topic, String key, MessageEntity messageEntity){
ProducerRecord<String, MessageEntity> record = new ProducerRecord<String, MessageEntity>(topic,key,messageEntity);
long startTime = System.currentTimeMillis();
ListenableFuture<SendResult<String, MessageEntity>> future = kafkaTemplate.send(record);
future.addCallback(new ProducerCallback(startTime,key,messageEntity));
}
}
複製代碼
SimpleConsumer.java
package com.cxy.kafka.consumer;
import com.cxy.kafka.common.MessageEntity;
import com.google.gson.Gson;
import lombok.extern.slf4j.Slf4j;
import org.apache.log4j.Logger;
import org.springframework.kafka.annotation.KafkaListener;
import org.springframework.stereotype.Component;
/**
* @Auther: cxy
* @Date: 2019/4/9
* @Description:
*/
@Slf4j
@Component
public class SimpleConsumer {
public static final Logger logger = Logger.getLogger(SimpleConsumer.class);
private final Gson gson = new Gson();
@KafkaListener(topics = "${kafka.topic.default}",containerFactory = "kafkaListenerContainerFactory")
public void receive(MessageEntity messageEntity){
logger.info(gson.toJson(messageEntity));
}
}
複製代碼
ProducerController.java
package com.cxy.kafka.controller;
import com.cxy.kafka.common.ErrorCode;
import com.cxy.kafka.common.MessageEntity;
import com.cxy.kafka.common.Response;
import com.cxy.kafka.producer.SimpleProducer;
import com.google.gson.Gson;
import lombok.extern.slf4j.Slf4j;
import org.apache.log4j.Logger;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
/**
* @Auther: cxy
* @Date: 2019/4/9
* @Description:
*/
@Slf4j
@RestController
@RequestMapping("/kafka")
public class ProducerController {
public static final Logger logger = Logger.getLogger(ProducerController.class);
@Autowired
private SimpleProducer simpleProducer;
@Value("${kafka.topic.default}")
private String topic;
private Gson gson = new Gson();
@RequestMapping(value="/hello",method = RequestMethod.GET, produces = {"application/json"})
public Response sendKafka(){
return new Response(ErrorCode.SUCCESS,"SUCCESS");
}
@RequestMapping(value="/send",method = RequestMethod.POST, produces = {"application/json"})
public Response sendKafka(@RequestBody MessageEntity messageEntity){
try{
logger.info("kafka消息:{}"+gson.toJson(messageEntity));
simpleProducer.send(topic,"key",messageEntity);
logger.info("發送kafka成功!");
return new Response(ErrorCode.SUCCESS,"發送kafka成功!");
}catch(Exception e){
logger.error("發送kafka失敗!",e);
return new Response(ErrorCode.EXCEPTION,"發送kafka失敗!");
}
}
}
複製代碼
啓動
啓動KafkaApplication.java
。(必須打開zookeeper和kafka) 測試
我這邊用的是Restlet Client
插件,大家也能夠根據本身喜愛選擇測試工具
http://localhost:8080/kafka/hello
http://localhost:8080/kafka/send