save work

Author: nick-zh

content/kafkaException/__construct.md

@@ -0,0 +1,28 @@
+---
+title: "__construct"
+date: 2020-12-27T22:09:37+01:00
+draft: false
+---
+## Description
+```php
+public function __construct(
+    string $message,
+    int $code,
+    string $error_string,
+    bool $isFatal,
+    bool $isRetriable,
+    bool $transactionRequiresAbort
+) {}
+```
+Create new `KafkaErrorException`, this can be helpful for transaction tests
+## Example
+```php
+throw new Kafka\KafkaErrorException(
+    'Some error message',
+    88,
+    'This is a detailed error string',
+    false,
+    true,
+    false
+);
+```

content/kafkaException/_index.md

@@ -0,0 +1,6 @@
+---
+title: "KafkaException"
+date: 2020-12-27T22:09:37+01:00
+draft: false
+geekdocCollapseSection: true
+---

content/kafkaException/getErrorString.md

@@ -0,0 +1,21 @@
+---
+title: "getErrorString"
+date: 2020-12-27T22:09:37+01:00
+draft: false
+---
+## Description
+```php
+public function getErrorString(): string {}
+```
+Get error description for this exception
+## Example
+```php
+$conf = Kafka\Configuration();
+$conf->set('metadata.broker.list', 'kafka:9092');
+$producer = new Kafka\Producer($conf);
+try {
+    $producer->initTransactions(10000);
+} catch (Kafka\KafkaErrorException $e) {
+    echo $e->getErrorString();
+}
+```

content/kafkaException/isFatal.md

@@ -0,0 +1,23 @@
+---
+title: "isFatal"
+date: 2020-12-27T22:09:37+01:00
+draft: false
+---
+## Description
+```php
+public function isFatal(): bool {}
+```
+Check if it is a fatal exception
+## Example
+```php
+$conf = Kafka\Configuration();
+$conf->set('metadata.broker.list', 'kafka:9092');
+$producer = new Kafka\Producer($conf);
+try {
+    $producer->initTransactions(10000);
+} catch (Kafka\KafkaErrorException $e) {
+    if ($e->isFatal()) {
+        // non-recoverable error
+    }
+}
+```

content/kafkaException/isRetriable.md

@@ -0,0 +1,23 @@
+---
+title: "isRetriable"
+date: 2020-12-27T22:09:37+01:00
+draft: false
+---
+## Description
+```php
+public function isRetriable(): bool {}
+```
+Indicates that the operation that caused this exception can be retried.
+## Example
+```php
+$conf = Kafka\Configuration();
+$conf->set('metadata.broker.list', 'kafka:9092');
+$producer = new Kafka\Producer($conf);
+try {
+    $producer->initTransactions(10000);
+} catch (Kafka\KafkaErrorException $e) {
+    if ($e->isRetriable()) {
+        // action can be retried
+    }
+}
+```

content/kafkaException/transactionRequiresAbort.md

@@ -0,0 +1,23 @@
+---
+title: "transactionRequiresAbort"
+date: 2020-12-27T22:09:37+01:00
+draft: false
+---
+## Description
+```php
+public function transactionRequiresAbort(): bool {}
+```
+Check if error needs the transaction to be aborted
+## Example
+```php
+$conf = Kafka\Configuration();
+$conf->set('metadata.broker.list', 'kafka:9092');
+$producer = new Kafka\Producer($conf);
+try {
+    $producer->initTransactions(10000);
+} catch (Kafka\KafkaErrorException $e) {
+    if ($e->$transactionRequiresAbort()) {
+        $producer->abortTransaction(10000);
+    }
+}
+```