http://git-wip-us.apache.org/repos/asf/kafka-site/blob/2d621da3/0101/javadoc/org/apache/kafka/clients/producer/KafkaProducer.html
----------------------------------------------------------------------
diff --git a/0101/javadoc/org/apache/kafka/clients/producer/KafkaProducer.html 
b/0101/javadoc/org/apache/kafka/clients/producer/KafkaProducer.html
new file mode 100644
index 0000000..21af49c
--- /dev/null
+++ b/0101/javadoc/org/apache/kafka/clients/producer/KafkaProducer.html
@@ -0,0 +1,633 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
+<!-- NewPage -->
+<html lang="en">
+<head>
+<!-- Generated by javadoc (version 1.7.0_79) on Tue Oct 04 12:37:09 PDT 2016 
-->
+<title>KafkaProducer (kafka 0.10.1.0 API)</title>
+<meta name="date" content="2016-10-04">
+<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" 
title="Style">
+</head>
+<body>
+<script type="text/javascript"><!--
+    if (location.href.indexOf('is-external=true') == -1) {
+        parent.document.title="KafkaProducer (kafka 0.10.1.0 API)";
+    }
+//-->
+</script>
+<noscript>
+<div>JavaScript is disabled on your browser.</div>
+</noscript>
+<!-- ========= START OF TOP NAVBAR ======= -->
+<div class="topNav"><a name="navbar_top">
+<!--   -->
+</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a 
name="navbar_top_firstrow">
+<!--   -->
+</a>
+<ul class="navList" title="Navigation">
+<li><a href="../../../../../overview-summary.html">Overview</a></li>
+<li><a href="package-summary.html">Package</a></li>
+<li class="navBarCell1Rev">Class</li>
+<li><a href="package-tree.html">Tree</a></li>
+<li><a href="../../../../../deprecated-list.html">Deprecated</a></li>
+<li><a href="../../../../../index-all.html">Index</a></li>
+<li><a href="../../../../../help-doc.html">Help</a></li>
+</ul>
+</div>
+<div class="subNav">
+<ul class="navList">
+<li><a href="../../../../../org/apache/kafka/clients/producer/Callback.html" 
title="interface in org.apache.kafka.clients.producer"><span 
class="strong">Prev Class</span></a></li>
+<li><a 
href="../../../../../org/apache/kafka/clients/producer/MockProducer.html" 
title="class in org.apache.kafka.clients.producer"><span class="strong">Next 
Class</span></a></li>
+</ul>
+<ul class="navList">
+<li><a 
href="../../../../../index.html?org/apache/kafka/clients/producer/KafkaProducer.html"
 target="_top">Frames</a></li>
+<li><a href="KafkaProducer.html" target="_top">No Frames</a></li>
+</ul>
+<ul class="navList" id="allclasses_navbar_top">
+<li><a href="../../../../../allclasses-noframe.html">All Classes</a></li>
+</ul>
+<div>
+<script type="text/javascript"><!--
+  allClassesLink = document.getElementById("allclasses_navbar_top");
+  if(window==top) {
+    allClassesLink.style.display = "block";
+  }
+  else {
+    allClassesLink.style.display = "none";
+  }
+  //-->
+</script>
+</div>
+<div>
+<ul class="subNavList">
+<li>Summary:&nbsp;</li>
+<li>Nested&nbsp;|&nbsp;</li>
+<li>Field&nbsp;|&nbsp;</li>
+<li><a href="#constructor_summary">Constr</a>&nbsp;|&nbsp;</li>
+<li><a href="#method_summary">Method</a></li>
+</ul>
+<ul class="subNavList">
+<li>Detail:&nbsp;</li>
+<li>Field&nbsp;|&nbsp;</li>
+<li><a href="#constructor_detail">Constr</a>&nbsp;|&nbsp;</li>
+<li><a href="#method_detail">Method</a></li>
+</ul>
+</div>
+<a name="skip-navbar_top">
+<!--   -->
+</a></div>
+<!-- ========= END OF TOP NAVBAR ========= -->
+<!-- ======== START OF CLASS DATA ======== -->
+<div class="header">
+<div class="subTitle">org.apache.kafka.clients.producer</div>
+<h2 title="Class KafkaProducer" class="title">Class 
KafkaProducer&lt;K,V&gt;</h2>
+</div>
+<div class="contentContainer">
+<ul class="inheritance">
+<li><a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true";
 title="class or interface in java.lang">java.lang.Object</a></li>
+<li>
+<ul class="inheritance">
+<li>org.apache.kafka.clients.producer.KafkaProducer&lt;K,V&gt;</li>
+</ul>
+</li>
+</ul>
+<div class="description">
+<ul class="blockList">
+<li class="blockList">
+<dl>
+<dt>All Implemented Interfaces:</dt>
+<dd><a 
href="http://docs.oracle.com/javase/7/docs/api/java/io/Closeable.html?is-external=true";
 title="class or interface in java.io">Closeable</a>, <a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/AutoCloseable.html?is-external=true";
 title="class or interface in java.lang">AutoCloseable</a>, <a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html" 
title="interface in 
org.apache.kafka.clients.producer">Producer</a>&lt;K,V&gt;</dd>
+</dl>
+<hr>
+<br>
+<pre>public class <span class="strong">KafkaProducer&lt;K,V&gt;</span>
+extends <a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true";
 title="class or interface in java.lang">Object</a>
+implements <a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html" 
title="interface in 
org.apache.kafka.clients.producer">Producer</a>&lt;K,V&gt;</pre>
+<div class="block">A Kafka client that publishes records to the Kafka cluster.
+ <P>
+ The producer is <i>thread safe</i> and sharing a single producer instance 
across threads will generally be faster than
+ having multiple instances.
+ <p>
+ Here is a simple example of using the producer to send records with strings 
containing sequential numbers as the key/value
+ pairs.
+ <pre>
+ <code>Properties props = new Properties();
+ props.put("bootstrap.servers", "localhost:9092");
+ props.put("acks", "all");
+ props.put("retries", 0);
+ props.put("batch.size", 16384);
+ props.put("linger.ms", 1);
+ props.put("buffer.memory", 33554432);
+ props.put("key.serializer", 
"org.apache.kafka.common.serialization.StringSerializer");
+ props.put("value.serializer", 
"org.apache.kafka.common.serialization.StringSerializer");
+
+ Producer&lt;String, String&gt; producer = new KafkaProducer&lt;&gt;(props);
+ for(int i = 0; i &lt; 100; i++)
+     producer.send(new ProducerRecord&lt;String, String&gt;("my-topic", 
Integer.toString(i), Integer.toString(i)));
+
+ producer.close();
+ </code></pre>
+ <p>
+ The producer consists of a pool of buffer space that holds records that 
haven't yet been transmitted to the server
+ as well as a background I/O thread that is responsible for turning these 
records into requests and transmitting them
+ to the cluster. Failure to close the producer after use will leak these 
resources.
+ <p>
+ The <a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#send(org.apache.kafka.clients.producer.ProducerRecord)"><code>send()</code></a>
 method is asynchronous. When called it adds the record to a buffer of pending 
record sends
+ and immediately returns. This allows the producer to batch together 
individual records for efficiency.
+ <p>
+ The <code>acks</code> config controls the criteria under which requests are 
considered complete. The "all" setting
+ we have specified will result in blocking on the full commit of the record, 
the slowest but most durable setting.
+ <p>
+ If the request fails, the producer can automatically retry, though since we 
have specified <code>retries</code>
+ as 0 it won't. Enabling retries also opens up the possibility of duplicates 
(see the documentation on
+ <a href="http://kafka.apache.org/documentation.html#semantics";>message 
delivery semantics</a> for details).
+ <p>
+ The producer maintains buffers of unsent records for each partition. These 
buffers are of a size specified by
+ the <code>batch.size</code> config. Making this larger can result in more 
batching, but requires more memory (since we will
+ generally have one of these buffers for each active partition).
+ <p>
+ By default a buffer is available to send immediately even if there is 
additional unused space in the buffer. However if you
+ want to reduce the number of requests you can set <code>linger.ms</code> to 
something greater than 0. This will
+ instruct the producer to wait up to that number of milliseconds before 
sending a request in hope that more records will
+ arrive to fill up the same batch. This is analogous to Nagle's algorithm in 
TCP. For example, in the code snippet above,
+ likely all 100 records would be sent in a single request since we set our 
linger time to 1 millisecond. However this setting
+ would add 1 millisecond of latency to our request waiting for more records to 
arrive if we didn't fill up the buffer. Note that
+ records that arrive close together in time will generally batch together even 
with <code>linger.ms=0</code> so under heavy load
+ batching will occur regardless of the linger configuration; however setting 
this to something larger than 0 can lead to fewer, more
+ efficient requests when not under maximal load at the cost of a small amount 
of latency.
+ <p>
+ The <code>buffer.memory</code> controls the total amount of memory available 
to the producer for buffering. If records
+ are sent faster than they can be transmitted to the server then this buffer 
space will be exhausted. When the buffer space is
+ exhausted additional send calls will block. The threshold for time to block 
is determined by <code>max.block.ms</code> after which it throws
+ a TimeoutException.
+ <p>
+ The <code>key.serializer</code> and <code>value.serializer</code> instruct 
how to turn the key and value objects the user provides with
+ their <code>ProducerRecord</code> into bytes. You can use the included <a 
href="../../../../../org/apache/kafka/common/serialization/ByteArraySerializer.html"
 title="class in 
org.apache.kafka.common.serialization"><code>ByteArraySerializer</code></a> or
+ <a 
href="../../../../../org/apache/kafka/common/serialization/StringSerializer.html"
 title="class in 
org.apache.kafka.common.serialization"><code>StringSerializer</code></a> for 
simple string or byte types.</div>
+</li>
+</ul>
+</div>
+<div class="summary">
+<ul class="blockList">
+<li class="blockList">
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+<ul class="blockList">
+<li class="blockList"><a name="constructor_summary">
+<!--   -->
+</a>
+<h3>Constructor Summary</h3>
+<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" 
summary="Constructor Summary table, listing constructors, and an explanation">
+<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
+<tr>
+<th class="colOne" scope="col">Constructor and Description</th>
+</tr>
+<tr class="altColor">
+<td class="colOne"><code><strong><a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#KafkaProducer(java.util.Map)">KafkaProducer</a></strong>(<a
 
href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&lt;<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
 title="class or interface in java.lang">String</a>,<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true";
 title="class or interface in java.lang">Object</a>&gt;&nbsp;configs)</code>
+<div class="block">A producer is instantiated by providing a set of key-value 
pairs as configuration.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colOne"><code><strong><a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#KafkaProducer(java.util.Map,%20org.apache.kafka.common.serialization.Serializer,%20org.apache.kafka.common.serialization.Serializer)">KafkaProducer</a></strong>(<a
 
href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&lt;<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
 title="class or interface in java.lang">String</a>,<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true";
 title="class or interface in java.lang">Object</a>&gt;&nbsp;configs,
+             <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in org.apache.kafka.common.serialization">Serializer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>&gt;&nbsp;keySerializer,
+             <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in org.apache.kafka.common.serialization">Serializer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;&nbsp;valueSerializer)</code>
+<div class="block">A producer is instantiated by providing a set of key-value 
pairs as configuration, a key and a value <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in 
org.apache.kafka.common.serialization"><code>Serializer</code></a>.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colOne"><code><strong><a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#KafkaProducer(java.util.Properties)">KafkaProducer</a></strong>(<a
 
href="http://docs.oracle.com/javase/7/docs/api/java/util/Properties.html?is-external=true";
 title="class or interface in java.util">Properties</a>&nbsp;properties)</code>
+<div class="block">A producer is instantiated by providing a set of key-value 
pairs as configuration.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colOne"><code><strong><a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#KafkaProducer(java.util.Properties,%20org.apache.kafka.common.serialization.Serializer,%20org.apache.kafka.common.serialization.Serializer)">KafkaProducer</a></strong>(<a
 
href="http://docs.oracle.com/javase/7/docs/api/java/util/Properties.html?is-external=true";
 title="class or interface in java.util">Properties</a>&nbsp;properties,
+             <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in org.apache.kafka.common.serialization">Serializer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>&gt;&nbsp;keySerializer,
+             <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in org.apache.kafka.common.serialization">Serializer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;&nbsp;valueSerializer)</code>
+<div class="block">A producer is instantiated by providing a set of key-value 
pairs as configuration, a key and a value <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in 
org.apache.kafka.common.serialization"><code>Serializer</code></a>.</div>
+</td>
+</tr>
+</table>
+</li>
+</ul>
+<!-- ========== METHOD SUMMARY =========== -->
+<ul class="blockList">
+<li class="blockList"><a name="method_summary">
+<!--   -->
+</a>
+<h3>Method Summary</h3>
+<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" 
summary="Method Summary table, listing methods, and an explanation">
+<caption><span>Methods</span><span class="tabEnd">&nbsp;</span></caption>
+<tr>
+<th class="colFirst" scope="col">Modifier and Type</th>
+<th class="colLast" scope="col">Method and Description</th>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#close()">close</a></strong>()</code>
+<div class="block">Close this producer.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#close(long,%20java.util.concurrent.TimeUnit)">close</a></strong>(long&nbsp;timeout,
+     <a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/TimeUnit.html?is-external=true";
 title="class or interface in 
java.util.concurrent">TimeUnit</a>&nbsp;timeUnit)</code>
+<div class="block">This method waits up to <code>timeout</code> for the 
producer to complete the sending of all incomplete requests.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#flush()">flush</a></strong>()</code>
+<div class="block">Invoking this method makes all buffered records immediately 
available to send (even if <code>linger.ms</code> is
+ greater than 0) and blocks on the completion of the requests associated with 
these records.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&lt;<a 
href="../../../../../org/apache/kafka/common/MetricName.html" title="class in 
org.apache.kafka.common">MetricName</a>,? extends <a 
href="../../../../../org/apache/kafka/common/Metric.html" title="interface in 
org.apache.kafka.common">Metric</a>&gt;</code></td>
+<td class="colLast"><code><strong><a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#metrics()">metrics</a></strong>()</code>
+<div class="block">Get the full set of internal metrics maintained by the 
producer.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true";
 title="class or interface in java.util">List</a>&lt;<a 
href="../../../../../org/apache/kafka/common/PartitionInfo.html" title="class 
in org.apache.kafka.common">PartitionInfo</a>&gt;</code></td>
+<td class="colLast"><code><strong><a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#partitionsFor(java.lang.String)">partitionsFor</a></strong>(<a
 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
 title="class or interface in java.lang">String</a>&nbsp;topic)</code>
+<div class="block">Get the partition metadata for the give topic.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Future.html?is-external=true";
 title="class or interface in java.util.concurrent">Future</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/RecordMetadata.html" 
title="class in 
org.apache.kafka.clients.producer">RecordMetadata</a>&gt;</code></td>
+<td class="colLast"><code><strong><a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#send(org.apache.kafka.clients.producer.ProducerRecord)">send</a></strong>(<a
 href="../../../../../org/apache/kafka/clients/producer/ProducerRecord.html" 
title="class in org.apache.kafka.clients.producer">ProducerRecord</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>,<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;&nbsp;record)</code>
+<div class="block">Asynchronously send a record to a topic.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Future.html?is-external=true";
 title="class or interface in java.util.concurrent">Future</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/RecordMetadata.html" 
title="class in 
org.apache.kafka.clients.producer">RecordMetadata</a>&gt;</code></td>
+<td class="colLast"><code><strong><a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#send(org.apache.kafka.clients.producer.ProducerRecord,%20org.apache.kafka.clients.producer.Callback)">send</a></strong>(<a
 href="../../../../../org/apache/kafka/clients/producer/ProducerRecord.html" 
title="class in org.apache.kafka.clients.producer">ProducerRecord</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>,<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;&nbsp;record,
+    <a href="../../../../../org/apache/kafka/clients/producer/Callback.html" 
title="interface in 
org.apache.kafka.clients.producer">Callback</a>&nbsp;callback)</code>
+<div class="block">Asynchronously send a record to a topic and invoke the 
provided callback when the send has been acknowledged.</div>
+</td>
+</tr>
+</table>
+<ul class="blockList">
+<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object">
+<!--   -->
+</a>
+<h3>Methods inherited from class&nbsp;java.lang.<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true";
 title="class or interface in java.lang">Object</a></h3>
+<code><a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#clone()"
 title="class or interface in java.lang">clone</a>, <a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)"
 title="class or interface in java.lang">equals</a>, <a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#finalize()"
 title="class or interface in java.lang">finalize</a>, <a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass()"
 title="class or interface in java.lang">getClass</a>, <a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode()"
 title="class or interface in java.lang">hashCode</a>, <a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify()"
 title="class or interface in java.lang">notify</a>, <a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang
 /Object.html?is-external=true#notifyAll()" title="class or interface in 
java.lang">notifyAll</a>, <a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString()"
 title="class or interface in java.lang">toString</a>, <a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait()"
 title="class or interface in java.lang">wait</a>, <a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long)"
 title="class or interface in java.lang">wait</a>, <a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long,%20int)"
 title="class or interface in java.lang">wait</a></code></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="details">
+<ul class="blockList">
+<li class="blockList">
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+<ul class="blockList">
+<li class="blockList"><a name="constructor_detail">
+<!--   -->
+</a>
+<h3>Constructor Detail</h3>
+<a name="KafkaProducer(java.util.Map)">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>KafkaProducer</h4>
+<pre>public&nbsp;KafkaProducer(<a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&lt;<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
 title="class or interface in java.lang">String</a>,<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true";
 title="class or interface in java.lang">Object</a>&gt;&nbsp;configs)</pre>
+<div class="block">A producer is instantiated by providing a set of key-value 
pairs as configuration. Valid configuration strings
+ are documented <a 
href="http://kafka.apache.org/documentation.html#producerconfigs";>here</a>. 
Values can be
+ either strings or Objects of the appropriate type (for example a numeric 
configuration would accept either the
+ string "42" or the integer 42).</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>configs</code> - 
The producer configs</dd></dl>
+</li>
+</ul>
+<a name="KafkaProducer(java.util.Map, 
org.apache.kafka.common.serialization.Serializer, 
org.apache.kafka.common.serialization.Serializer)">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>KafkaProducer</h4>
+<pre>public&nbsp;KafkaProducer(<a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&lt;<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
 title="class or interface in java.lang">String</a>,<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true";
 title="class or interface in java.lang">Object</a>&gt;&nbsp;configs,
+             <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in org.apache.kafka.common.serialization">Serializer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>&gt;&nbsp;keySerializer,
+             <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in org.apache.kafka.common.serialization">Serializer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;&nbsp;valueSerializer)</pre>
+<div class="block">A producer is instantiated by providing a set of key-value 
pairs as configuration, a key and a value <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in 
org.apache.kafka.common.serialization"><code>Serializer</code></a>.
+ Valid configuration strings are documented <a 
href="http://kafka.apache.org/documentation.html#producerconfigs";>here</a>.
+ Values can be either strings or Objects of the appropriate type (for example 
a numeric configuration would accept
+ either the string "42" or the integer 42).</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>configs</code> - 
The producer configs</dd><dd><code>keySerializer</code> - The serializer for 
key that implements <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in 
org.apache.kafka.common.serialization"><code>Serializer</code></a>. The 
configure() method won't be
+                       called in the producer when the serializer is passed in 
directly.</dd><dd><code>valueSerializer</code> - The serializer for value that 
implements <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in 
org.apache.kafka.common.serialization"><code>Serializer</code></a>. The 
configure() method won't
+                         be called in the producer when the serializer is 
passed in directly.</dd></dl>
+</li>
+</ul>
+<a name="KafkaProducer(java.util.Properties)">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>KafkaProducer</h4>
+<pre>public&nbsp;KafkaProducer(<a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/Properties.html?is-external=true";
 title="class or interface in java.util">Properties</a>&nbsp;properties)</pre>
+<div class="block">A producer is instantiated by providing a set of key-value 
pairs as configuration. Valid configuration strings
+ are documented <a 
href="http://kafka.apache.org/documentation.html#producerconfigs";>here</a>.</div>
+<dl><dt><span 
class="strong">Parameters:</span></dt><dd><code>properties</code> - The 
producer configs</dd></dl>
+</li>
+</ul>
+<a name="KafkaProducer(java.util.Properties, 
org.apache.kafka.common.serialization.Serializer, 
org.apache.kafka.common.serialization.Serializer)">
+<!--   -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>KafkaProducer</h4>
+<pre>public&nbsp;KafkaProducer(<a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/Properties.html?is-external=true";
 title="class or interface in java.util">Properties</a>&nbsp;properties,
+             <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in org.apache.kafka.common.serialization">Serializer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>&gt;&nbsp;keySerializer,
+             <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in org.apache.kafka.common.serialization">Serializer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;&nbsp;valueSerializer)</pre>
+<div class="block">A producer is instantiated by providing a set of key-value 
pairs as configuration, a key and a value <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in 
org.apache.kafka.common.serialization"><code>Serializer</code></a>.
+ Valid configuration strings are documented <a 
href="http://kafka.apache.org/documentation.html#producerconfigs";>here</a>.</div>
+<dl><dt><span 
class="strong">Parameters:</span></dt><dd><code>properties</code> - The 
producer configs</dd><dd><code>keySerializer</code> - The serializer for key 
that implements <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in 
org.apache.kafka.common.serialization"><code>Serializer</code></a>. The 
configure() method won't be
+                       called in the producer when the serializer is passed in 
directly.</dd><dd><code>valueSerializer</code> - The serializer for value that 
implements <a 
href="../../../../../org/apache/kafka/common/serialization/Serializer.html" 
title="interface in 
org.apache.kafka.common.serialization"><code>Serializer</code></a>. The 
configure() method won't
+                         be called in the producer when the serializer is 
passed in directly.</dd></dl>
+</li>
+</ul>
+</li>
+</ul>
+<!-- ============ METHOD DETAIL ========== -->
+<ul class="blockList">
+<li class="blockList"><a name="method_detail">
+<!--   -->
+</a>
+<h3>Method Detail</h3>
+<a name="send(org.apache.kafka.clients.producer.ProducerRecord)">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>send</h4>
+<pre>public&nbsp;<a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Future.html?is-external=true";
 title="class or interface in java.util.concurrent">Future</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/RecordMetadata.html" 
title="class in 
org.apache.kafka.clients.producer">RecordMetadata</a>&gt;&nbsp;send(<a 
href="../../../../../org/apache/kafka/clients/producer/ProducerRecord.html" 
title="class in org.apache.kafka.clients.producer">ProducerRecord</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>,<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;&nbsp;record)</pre>
+<div class="block">Asynchronously send a record to a topic. Equivalent to 
<code>send(record, null)</code>.
+ See <a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html#send(org.apache.kafka.clients.producer.ProducerRecord,%20org.apache.kafka.clients.producer.Callback)"><code>send(ProducerRecord,
 Callback)</code></a> for details.</div>
+<dl>
+<dt><strong>Specified by:</strong></dt>
+<dd><code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html#send(org.apache.kafka.clients.producer.ProducerRecord)">send</a></code>&nbsp;in
 interface&nbsp;<code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html" 
title="interface in org.apache.kafka.clients.producer">Producer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>,<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;</code></dd>
+<dt><span class="strong">Parameters:</span></dt><dd><code>record</code> - The 
record to send</dd>
+<dt><span class="strong">Returns:</span></dt><dd>A future which will 
eventually contain the response information</dd></dl>
+</li>
+</ul>
+<a name="send(org.apache.kafka.clients.producer.ProducerRecord, 
org.apache.kafka.clients.producer.Callback)">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>send</h4>
+<pre>public&nbsp;<a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Future.html?is-external=true";
 title="class or interface in java.util.concurrent">Future</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/RecordMetadata.html" 
title="class in 
org.apache.kafka.clients.producer">RecordMetadata</a>&gt;&nbsp;send(<a 
href="../../../../../org/apache/kafka/clients/producer/ProducerRecord.html" 
title="class in org.apache.kafka.clients.producer">ProducerRecord</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>,<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;&nbsp;record,
+                          <a 
href="../../../../../org/apache/kafka/clients/producer/Callback.html" 
title="interface in 
org.apache.kafka.clients.producer">Callback</a>&nbsp;callback)</pre>
+<div class="block">Asynchronously send a record to a topic and invoke the 
provided callback when the send has been acknowledged.
+ <p>
+ The send is asynchronous and this method will return immediately once the 
record has been stored in the buffer of
+ records waiting to be sent. This allows sending many records in parallel 
without blocking to wait for the
+ response after each one.
+ <p>
+ The result of the send is a <a 
href="../../../../../org/apache/kafka/clients/producer/RecordMetadata.html" 
title="class in 
org.apache.kafka.clients.producer"><code>RecordMetadata</code></a> specifying 
the partition the record was sent to, the offset
+ it was assigned and the timestamp of the record. If
+ <code>CreateTime</code> is used by the topic, the timestamp
+ will be the user provided timestamp or the record send time if the user did 
not specify a timestamp for the
+ record. If <code>LogAppendTime</code> is used for the
+ topic, the timestamp will be the Kafka broker local time when the message is 
appended.
+ <p>
+ Since the send call is asynchronous it returns a <a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Future.html?is-external=true";
 title="class or interface in java.util.concurrent"><code>Future</code></a> for 
the
+ <a 
href="../../../../../org/apache/kafka/clients/producer/RecordMetadata.html" 
title="class in 
org.apache.kafka.clients.producer"><code>RecordMetadata</code></a> that will be 
assigned to this record. Invoking <a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Future.html?is-external=true#get()"
 title="class or interface in java.util.concurrent"><code>get()</code></a> on 
this future will block until the associated request completes and then return 
the metadata for the record
+ or throw any exception that occurred while sending the record.
+ <p>
+ If you want to simulate a simple blocking call you can call the 
<code>get()</code> method immediately:
+
+ <pre>
+ <code>byte[] key = "key".getBytes();
+ byte[] value = "value".getBytes();
+ ProducerRecord&lt;byte[],byte[]&gt; record = new 
ProducerRecord&lt;byte[],byte[]&gt;("my-topic", key, value)
+ producer.send(record).get();
+ </code></pre>
+ <p>
+ Fully non-blocking usage can make use of the <a 
href="../../../../../org/apache/kafka/clients/producer/Callback.html" 
title="interface in 
org.apache.kafka.clients.producer"><code>Callback</code></a> parameter to 
provide a callback that
+ will be invoked when the request is complete.
+
+ <pre>
+ <code>ProducerRecord&lt;byte[],byte[]&gt; record = new 
ProducerRecord&lt;byte[],byte[]&gt;("the-topic", key, value);
+ producer.send(myRecord,
+               new Callback() {
+                   public void onCompletion(RecordMetadata metadata, Exception 
e) {
+                       if(e != null) {
+                          e.printStackTrace();
+                       } else {
+                          System.out.println("The offset of the record we just 
sent is: " + metadata.offset());
+                       }
+                   }
+               });
+ </code>
+ </pre>
+
+ Callbacks for records being sent to the same partition are guaranteed to 
execute in order. That is, in the
+ following example <code>callback1</code> is guaranteed to execute before 
<code>callback2</code>:
+
+ <pre>
+ <code>producer.send(new ProducerRecord&lt;byte[],byte[]&gt;(topic, partition, 
key1, value1), callback1);
+ producer.send(new ProducerRecord&lt;byte[],byte[]&gt;(topic, partition, key2, 
value2), callback2);
+ </code>
+ </pre>
+ <p>
+ Note that callbacks will generally execute in the I/O thread of the producer 
and so should be reasonably fast or
+ they will delay the sending of messages from other threads. If you want to 
execute blocking or computationally
+ expensive callbacks it is recommended to use your own <a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/Executor.html?is-external=true";
 title="class or interface in java.util.concurrent"><code>Executor</code></a> 
in the callback body
+ to parallelize processing.</div>
+<dl>
+<dt><strong>Specified by:</strong></dt>
+<dd><code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html#send(org.apache.kafka.clients.producer.ProducerRecord,%20org.apache.kafka.clients.producer.Callback)">send</a></code>&nbsp;in
 interface&nbsp;<code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html" 
title="interface in org.apache.kafka.clients.producer">Producer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>,<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;</code></dd>
+<dt><span class="strong">Parameters:</span></dt><dd><code>record</code> - The 
record to send</dd><dd><code>callback</code> - A user-supplied callback to 
execute when the record has been acknowledged by the server (null
+        indicates no callback)</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code><a 
href="../../../../../org/apache/kafka/common/errors/InterruptException.html" 
title="class in org.apache.kafka.common.errors">InterruptException</a></code> - 
If the thread is interrupted while blocked</dd>
+<dd><code><a 
href="../../../../../org/apache/kafka/common/errors/SerializationException.html"
 title="class in 
org.apache.kafka.common.errors">SerializationException</a></code> - If the key 
or value are not valid objects given the configured serializers</dd>
+<dd><code><a 
href="../../../../../org/apache/kafka/common/errors/TimeoutException.html" 
title="class in org.apache.kafka.common.errors">TimeoutException</a></code> - 
if the time taken for fetching metadata or allocating memory for the record has 
surpassed <code>max.block.ms</code>.</dd></dl>
+</li>
+</ul>
+<a name="flush()">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>flush</h4>
+<pre>public&nbsp;void&nbsp;flush()</pre>
+<div class="block">Invoking this method makes all buffered records immediately 
available to send (even if <code>linger.ms</code> is
+ greater than 0) and blocks on the completion of the requests associated with 
these records. The post-condition
+ of <code>flush()</code> is that any previously sent record will have 
completed (e.g. <code>Future.isDone() == true</code>).
+ A request is considered completed when it is successfully acknowledged
+ according to the <code>acks</code> configuration you have specified or else 
it results in an error.
+ <p>
+ Other threads can continue sending records while one thread is blocked 
waiting for a flush call to complete,
+ however no guarantee is made about the completion of records sent after the 
flush call begins.
+ <p>
+ This method can be useful when consuming from some input system and producing 
into Kafka. The <code>flush()</code> call
+ gives a convenient way to ensure all previously sent messages have actually 
completed.
+ <p>
+ This example shows how to consume from one Kafka topic and produce to another 
Kafka topic:
+ <pre>
+ <code>for(ConsumerRecord&lt;String, String&gt; record: consumer.poll(100))
+     producer.send(new ProducerRecord("my-topic", record.key(), 
record.value());
+ producer.flush();
+ consumer.commit();
+ </code>
+ </pre>
+
+ Note that the above example may drop records if the produce request fails. If 
we want to ensure that this does not occur
+ we need to set <code>retries=&lt;large_number&gt;</code> in our config.</div>
+<dl>
+<dt><strong>Specified by:</strong></dt>
+<dd><code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html#flush()">flush</a></code>&nbsp;in
 interface&nbsp;<code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html" 
title="interface in org.apache.kafka.clients.producer">Producer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>,<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;</code></dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code><a 
href="../../../../../org/apache/kafka/common/errors/InterruptException.html" 
title="class in org.apache.kafka.common.errors">InterruptException</a></code> - 
If the thread is interrupted while blocked</dd></dl>
+</li>
+</ul>
+<a name="partitionsFor(java.lang.String)">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>partitionsFor</h4>
+<pre>public&nbsp;<a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true";
 title="class or interface in java.util">List</a>&lt;<a 
href="../../../../../org/apache/kafka/common/PartitionInfo.html" title="class 
in org.apache.kafka.common">PartitionInfo</a>&gt;&nbsp;partitionsFor(<a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true";
 title="class or interface in java.lang">String</a>&nbsp;topic)</pre>
+<div class="block">Get the partition metadata for the give topic. This can be 
used for custom partitioning.</div>
+<dl>
+<dt><strong>Specified by:</strong></dt>
+<dd><code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html#partitionsFor(java.lang.String)">partitionsFor</a></code>&nbsp;in
 interface&nbsp;<code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html" 
title="interface in org.apache.kafka.clients.producer">Producer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>,<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;</code></dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code><a 
href="../../../../../org/apache/kafka/common/errors/InterruptException.html" 
title="class in org.apache.kafka.common.errors">InterruptException</a></code> - 
If the thread is interrupted while blocked</dd></dl>
+</li>
+</ul>
+<a name="metrics()">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>metrics</h4>
+<pre>public&nbsp;<a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true";
 title="class or interface in java.util">Map</a>&lt;<a 
href="../../../../../org/apache/kafka/common/MetricName.html" title="class in 
org.apache.kafka.common">MetricName</a>,? extends <a 
href="../../../../../org/apache/kafka/common/Metric.html" title="interface in 
org.apache.kafka.common">Metric</a>&gt;&nbsp;metrics()</pre>
+<div class="block">Get the full set of internal metrics maintained by the 
producer.</div>
+<dl>
+<dt><strong>Specified by:</strong></dt>
+<dd><code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html#metrics()">metrics</a></code>&nbsp;in
 interface&nbsp;<code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html" 
title="interface in org.apache.kafka.clients.producer">Producer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>,<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;</code></dd>
+</dl>
+</li>
+</ul>
+<a name="close()">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>close</h4>
+<pre>public&nbsp;void&nbsp;close()</pre>
+<div class="block">Close this producer. This method blocks until all 
previously sent requests complete.
+ This method is equivalent to <code>close(Long.MAX_VALUE, 
TimeUnit.MILLISECONDS)</code>.
+ <p>
+ <strong>If close() is called from <a 
href="../../../../../org/apache/kafka/clients/producer/Callback.html" 
title="interface in 
org.apache.kafka.clients.producer"><code>Callback</code></a>, a warning message 
will be logged and close(0, TimeUnit.MILLISECONDS)
+ will be called instead. We do this because the sender thread would otherwise 
try to join itself and
+ block forever.</strong>
+ <p></div>
+<dl>
+<dt><strong>Specified by:</strong></dt>
+<dd><code><a 
href="http://docs.oracle.com/javase/7/docs/api/java/io/Closeable.html?is-external=true#close()"
 title="class or interface in java.io">close</a></code>&nbsp;in 
interface&nbsp;<code><a 
href="http://docs.oracle.com/javase/7/docs/api/java/io/Closeable.html?is-external=true";
 title="class or interface in java.io">Closeable</a></code></dd>
+<dt><strong>Specified by:</strong></dt>
+<dd><code><a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/AutoCloseable.html?is-external=true#close()"
 title="class or interface in java.lang">close</a></code>&nbsp;in 
interface&nbsp;<code><a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/AutoCloseable.html?is-external=true";
 title="class or interface in java.lang">AutoCloseable</a></code></dd>
+<dt><strong>Specified by:</strong></dt>
+<dd><code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html#close()">close</a></code>&nbsp;in
 interface&nbsp;<code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html" 
title="interface in org.apache.kafka.clients.producer">Producer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>,<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;</code></dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code><a 
href="../../../../../org/apache/kafka/common/errors/InterruptException.html" 
title="class in org.apache.kafka.common.errors">InterruptException</a></code> - 
If the thread is interrupted while blocked</dd></dl>
+</li>
+</ul>
+<a name="close(long, java.util.concurrent.TimeUnit)">
+<!--   -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>close</h4>
+<pre>public&nbsp;void&nbsp;close(long&nbsp;timeout,
+         <a 
href="http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/TimeUnit.html?is-external=true";
 title="class or interface in 
java.util.concurrent">TimeUnit</a>&nbsp;timeUnit)</pre>
+<div class="block">This method waits up to <code>timeout</code> for the 
producer to complete the sending of all incomplete requests.
+ <p>
+ If the producer is unable to complete all requests before the timeout 
expires, this method will fail
+ any unsent and unacknowledged records immediately.
+ <p>
+ If invoked from within a <a 
href="../../../../../org/apache/kafka/clients/producer/Callback.html" 
title="interface in 
org.apache.kafka.clients.producer"><code>Callback</code></a> this method will 
not block and will be equivalent to
+ <code>close(0, TimeUnit.MILLISECONDS)</code>. This is done since no further 
sending will happen while
+ blocking the I/O thread of the producer.</div>
+<dl>
+<dt><strong>Specified by:</strong></dt>
+<dd><code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html#close(long,%20java.util.concurrent.TimeUnit)">close</a></code>&nbsp;in
 interface&nbsp;<code><a 
href="../../../../../org/apache/kafka/clients/producer/Producer.html" 
title="interface in org.apache.kafka.clients.producer">Producer</a>&lt;<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">K</a>,<a 
href="../../../../../org/apache/kafka/clients/producer/KafkaProducer.html" 
title="type parameter in KafkaProducer">V</a>&gt;</code></dd>
+<dt><span class="strong">Parameters:</span></dt><dd><code>timeout</code> - The 
maximum time to wait for producer to complete any pending requests. The value 
should be
+                non-negative. Specifying a timeout of zero means do not wait 
for pending send requests to complete.</dd><dd><code>timeUnit</code> - The time 
unit for the <code>timeout</code></dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code><a 
href="../../../../../org/apache/kafka/common/errors/InterruptException.html" 
title="class in org.apache.kafka.common.errors">InterruptException</a></code> - 
If the thread is interrupted while blocked</dd>
+<dd><code><a 
href="http://docs.oracle.com/javase/7/docs/api/java/lang/IllegalArgumentException.html?is-external=true";
 title="class or interface in java.lang">IllegalArgumentException</a></code> - 
If the <code>timeout</code> is negative.</dd></dl>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+</div>
+<!-- ========= END OF CLASS DATA ========= -->
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<div class="bottomNav"><a name="navbar_bottom">
+<!--   -->
+</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a 
name="navbar_bottom_firstrow">
+<!--   -->
+</a>
+<ul class="navList" title="Navigation">
+<li><a href="../../../../../overview-summary.html">Overview</a></li>
+<li><a href="package-summary.html">Package</a></li>
+<li class="navBarCell1Rev">Class</li>
+<li><a href="package-tree.html">Tree</a></li>
+<li><a href="../../../../../deprecated-list.html">Deprecated</a></li>
+<li><a href="../../../../../index-all.html">Index</a></li>
+<li><a href="../../../../../help-doc.html">Help</a></li>
+</ul>
+</div>
+<div class="subNav">
+<ul class="navList">
+<li><a href="../../../../../org/apache/kafka/clients/producer/Callback.html" 
title="interface in org.apache.kafka.clients.producer"><span 
class="strong">Prev Class</span></a></li>
+<li><a 
href="../../../../../org/apache/kafka/clients/producer/MockProducer.html" 
title="class in org.apache.kafka.clients.producer"><span class="strong">Next 
Class</span></a></li>
+</ul>
+<ul class="navList">
+<li><a 
href="../../../../../index.html?org/apache/kafka/clients/producer/KafkaProducer.html"
 target="_top">Frames</a></li>
+<li><a href="KafkaProducer.html" target="_top">No Frames</a></li>
+</ul>
+<ul class="navList" id="allclasses_navbar_bottom">
+<li><a href="../../../../../allclasses-noframe.html">All Classes</a></li>
+</ul>
+<div>
+<script type="text/javascript"><!--
+  allClassesLink = document.getElementById("allclasses_navbar_bottom");
+  if(window==top) {
+    allClassesLink.style.display = "block";
+  }
+  else {
+    allClassesLink.style.display = "none";
+  }
+  //-->
+</script>
+</div>
+<div>
+<ul class="subNavList">
+<li>Summary:&nbsp;</li>
+<li>Nested&nbsp;|&nbsp;</li>
+<li>Field&nbsp;|&nbsp;</li>
+<li><a href="#constructor_summary">Constr</a>&nbsp;|&nbsp;</li>
+<li><a href="#method_summary">Method</a></li>
+</ul>
+<ul class="subNavList">
+<li>Detail:&nbsp;</li>
+<li>Field&nbsp;|&nbsp;</li>
+<li><a href="#constructor_detail">Constr</a>&nbsp;|&nbsp;</li>
+<li><a href="#method_detail">Method</a></li>
+</ul>
+</div>
+<a name="skip-navbar_bottom">
+<!--   -->
+</a></div>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+</body>
+</html>

Reply via email to