No description

Find a file

Istvan Szukacs 89dd4f95ae Updating README.md		2014-05-13 11:19:21 -07:00
autodoc@b818f4e6bc	updated autodoc	2012-01-26 10:59:48 +00:00
dev-resources	change log4j to append to ./logs/kafka.log; tidy the zk consumer test	2013-06-09 07:51:34 +01:00
src/clj_kafka	use create-all when creating the node	2014-05-09 17:44:57 +01:00
test/clj_kafka/test	add broker-list to help build metadata.broker.list strings; change clj-kafka.zk/brokers to return an empty list if zookeeper is available but no kafka brokers are registered.	2014-04-15 13:54:29 +01:00
.gitignore	Add nrepl-port to gitignore	2014-02-24 12:36:10 +00:00
.travis.yml	update travis-ci to run only expectations	2013-06-09 09:18:19 +01:00
project.clj	release 0.2.6	2014-05-09 17:45:14 +01:00
README.md	Updating README.md	2014-05-13 11:19:21 -07:00

README.md

clj-kafka

Clojure library for Kafka.

Current build status:

Development is against the 0.8 release of Kafka. The protocols for 0.7 and 0.8 are incompatible so this will only work when connecting to a 0.8 cluster. Earlier releases of clj-kafka support the earlier 0.7 release if you need it.

Installing

Add the following to your Leiningen project.clj:

[clj-kafka "0.2.6-0.8"]

Usage

Producer

Discovery of Kafka brokers from Zookeeper:

(brokers {"zookeeper.connect" "127.0.0.1:2181"})
;; ({:host "localhost", :jmx_port -1, :port 9999, :version 1})

(use 'clj-kafka.producer)

(def p (producer {"metadata.broker.list" "localhost:9999"
                  "serializer.class" "kafka.serializer.DefaultEncoder"
                  "partitioner.class" "kafka.producer.DefaultPartitioner"}))

(send-message p (message "test" (.getBytes "this is my message")))

Zookeeper Consumer

The Zookeeper consumer uses broker information contained within Zookeeper to consume messages. This consumer also allows the client to automatically commit consumed offsets so they're not retrieved again.

(use 'clj-kafka.consumer.zk)
(use 'clj-kafka.core)

(def config {"zookeeper.connect" "localhost:2182"
             "group.id" "clj-kafka.consumer"
             "auto.offset.reset" "smallest"
             "auto.commit.enable" "false"})

(with-resource [c (consumer config)]
  shutdown
  (take 2 (messages c "test")))

License

Distributed under the Eclipse Public License, the same as Clojure.

Thanks

YourKit is kindly supporting this open source project with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: YourKit Java Profiler and YourKit .NET Profiler.