kstreamplify icon indicating copy to clipboard operation
kstreamplify copied to clipboard

Interactive queries documentation

Open clvacher opened this issue 2 years ago • 2 comments

Problem

Documentation on interactive queries does not showcase an actual implementation of an interactive query, leaving the users scratching their heads for it.

Suggestion

A detailled explanation on how to interact with a store in the README, at least mentioning the autowiring of the KafkaStreamsInitializer class to retrieve the kafkaStreams instance

A link to a side project (?) showcasing the feature

Additional Context

Integrating @loicgreffier 's work on the subject for internal showcases to Kstreamplify is probably a very good addition to the library.

clvacher avatar Dec 01 '23 16:12 clvacher

Linked with #141

loicgreffier avatar Dec 01 '23 17:12 loicgreffier

I definitely think that accessing the kafka streams instance should have its own documentation part in the Getting Started section as it can be use for multiple purposes, not only interactive queries. Like :

  • Getting Started ...
    • Error Handling
      • Topology
      • Production and Deserialization
      • Avro Schema
    • REST Endpoints
    • Accessing the Kafka Streams instance

With this kind of code sample:

public class MyService {
    @Autowired
    private KafkaStreamsInitializer kafkaStreamsInitializer;

    public void doSomething() {
      kafkaStreamsInitializer.getKafkaStreams();
    }
}

loicgreffier avatar Dec 01 '23 18:12 loicgreffier

Initialized by https://github.com/michelin/kstreamplify/pull/204

loicgreffier avatar Aug 05 '24 07:08 loicgreffier