1
1
# Apicurio Registry Example Applications
2
2
This repository contains a set of example applications (mostly Kafka applications) that use the
3
- Apicurio Registry as part of their workflow. The registry is typically used to store schemas
3
+ Apicurio Registry as part of their workflow. The registry is typically used to store schemas
4
4
used by Kafka serializer and deserializer classes. These serdes classes will fetch the schema
5
- from the registry for use during producing or consuming operations (to serializer, deserializer,
5
+ from the registry for use during producing or consuming operations (to serializer, deserializer,
6
6
or validate the Kafka message payload).
7
7
8
8
Each example in this repository attempts to demonstrate some specific use-case or configuration.
@@ -23,13 +23,13 @@ Simply run ``docker-compose -f examples/tools/kafka-compose/kafka-compose.yaml
23
23
A list of examples is included below, with descriptions and explanations of each covered use-case.
24
24
25
25
## Simple Avro Example
26
- This example application demonstrates the basics of using the registry in a very simple Kafka
27
- publish/subscribe application using Apache Avro as the schema technology used to serialize
28
- and deserialize message payloads.
26
+ This example application demonstrates the basics of using the registry in a very simple Kafka
27
+ publish/subscribe application using Apache Avro as the schema technology used to serialize
28
+ and deserialize message payloads.
29
29
30
30
## Simple JSON Schema Example
31
- This example application demonstrates the basics of using the registry in a very simple Kafka
32
- publish/subscribe application using JSON Schema to validate message payloads when both producing
31
+ This example application demonstrates the basics of using the registry in a very simple Kafka
32
+ publish/subscribe application using JSON Schema to validate message payloads when both producing
33
33
and consuming them. JSON Schema is not a serialization technology, but rather is only used for
34
34
validation. Therefore, it can be enabled or disabled in the serializer and deserializer.
35
35
@@ -42,7 +42,7 @@ is essentially the same as the Simple Avro Example, but using a Confluent serial
42
42
Apicurio Registry deserializer.
43
43
44
44
## Avro Bean Example
45
- This example demonstrates how to use Avro as the schema and serialization technology while
45
+ This example demonstrates how to use Avro as the schema and serialization technology while
46
46
using a Java Bean as the Kafka message payload. This is essentially the same as the Simple
47
47
Avro Example, but using a java bean instead of a ` GenericRecord ` as the message payload.
48
48
@@ -55,18 +55,18 @@ the same as the Simple Avro Example, except instead of using one of the default
55
55
Registry Global ID strategies, it uses a custom one.
56
56
57
57
## Simple Avro Maven Example
58
- This example application demonstrates how to use the Apicurio Registry maven plugin to
58
+ This example application demonstrates how to use the Apicurio Registry maven plugin to
59
59
pre-register an Avro schema so that it does not need to be embedded within the producer
60
60
application. Note that this example will fail unless the maven plugin is executed before
61
61
the Java application. See the javadoc in the example for details.
62
62
63
63
## Rest Client example
64
- This example application demonstrates how to use the Apicurio Registry rest client to create,
65
- delete, or fetch schemas. This example contains two basic java application, one showing how to
66
- improve the logs by logging all the request and response headers and a basic example on how to
64
+ This example application demonstrates how to use the Apicurio Registry rest client to create,
65
+ delete, or fetch schemas. This example contains two basic java application, one showing how to
66
+ improve the logs by logging all the request and response headers and a basic example on how to
67
67
use the client.
68
68
69
69
## Mix Avro Schemas Example
70
70
This example application showcases an scenario where Apache Avro messages are published to the same
71
71
Kafka topic using different Avro schemas. This example uses the Apicurio Registry serdes classes to serialize
72
- and deserialize Apache Avro messages using different schemas, even if received in the same Kafka topic.
72
+ and deserialize Apache Avro messages using different schemas, even if received in the same Kafka topic.
0 commit comments