MASES.KNet 1.3.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package MASES.KNet --version 1.3.1
NuGet\Install-Package MASES.KNet -Version 1.3.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="MASES.KNet" Version="1.3.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MASES.KNet --version 1.3.1
#r "nuget: MASES.KNet, 1.3.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install MASES.KNet as a Cake Addin
#addin nuget:?package=MASES.KNet&version=1.3.1

// Install MASES.KNet as a Cake Tool
#tool nuget:?package=MASES.KNet&version=1.3.1

KNet: library usage

To use KNet classes the developer can write code in .NET using the same classes available in the official Apache Kafka package. If classes or methods are not available yet it is possible to use the approach synthetized in What to do if an API was not yet implemented

Producer example

Below the reader can found two different version of producer examples.

Simple producer

A basic producer can be like the following one:

using MASES.KNet;
using MASES.KNet.Clients.Producer;
using Java.Util;
using System;

namespace MASES.KNetTemplate.KNetProducer
{
    class Program
    {
        const string theServer = "localhost:9092";
        const string theTopic = "myTopic";

        static string serverToUse = theServer;
        static string topicToUse = theTopic;

        static void Main(string[] args)
        {
            var appArgs = KNetCore.ApplicationArgs;

            if (appArgs.Length != 0)
            {
                serverToUse = args[0];
            }

			Properties props = new Properties();
			props.Put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, serverToUse);
			props.Put(ProducerConfig.ACKS_CONFIG, "all");
			props.Put(ProducerConfig.RETRIES_CONFIG, 0);
			props.Put(ProducerConfig.LINGER_MS_CONFIG, 1);
			props.Put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer");
			props.Put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer");

			using (KafkaProducer producer = new KafkaProducer(props))
			{
				int i = 0;
				while (!resetEvent.WaitOne(0))
				{
					var record = new ProducerRecord<string, string>(topicToUse, i.ToString(), i.ToString());
					var result = producer.Send(record);
					Console.WriteLine($"Producing: {record} with result: {result.Get()}");
					producer.Flush();
					i++;
				}
			}
        }
    }
}

The example above can be found in the templates package. Its behavior is:

  • during initialization prepares the properties,
  • create a producer using the properties
  • create ProducerRecord and send it
  • print out the produced data and the resulting RecordMetadata

Producer with Callback

A producer with Callback can be like the following one. In this example the reader can highlight a slightly difference from the corresponding Java code. Surf JVM callbacks to go into detail in the callback management from JVM.

using MASES.KNet;
using MASES.KNet.Clients.Producer;
using Java.Util;
using System;

namespace MASES.KNetTemplate.KNetProducer
{
    class Program
    {
        const string theServer = "localhost:9092";
        const string theTopic = "myTopic";

        static string serverToUse = theServer;
        static string topicToUse = theTopic;

        static void Main(string[] args)
        {
            var appArgs = KNetCore.ApplicationArgs;

            if (appArgs.Length != 0)
            {
                serverToUse = args[0];
            }

			Properties props = new Properties();
			props.Put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, serverToUse);
			props.Put(ProducerConfig.ACKS_CONFIG, "all");
			props.Put(ProducerConfig.RETRIES_CONFIG, 0);
			props.Put(ProducerConfig.LINGER_MS_CONFIG, 1);
			props.Put(ProducerConfig.KEY_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer");
			props.Put(ProducerConfig.VALUE_SERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringSerializer");

			using (KafkaProducer producer = new KafkaProducer(props))
			{
				int i = 0;
				using (var callback = new Callback((o1, o2) =>
				{
					if (o2 != null) Console.WriteLine(o2.ToString());
					else Console.WriteLine($"Produced on topic {o1.Topic} at offset {o1.Offset}");
				}))
				{
					while (!resetEvent.WaitOne(0))
					{
						var record = new ProducerRecord<string, string>(topicToUse, i.ToString(), i.ToString());
						var result = producer.Send(record, callback);
						Console.WriteLine($"Producing: {record} with result: {result.Get()}");
						producer.Flush();
						i++;
					}
				}
			}
        }
    }
}

The example above can be found in the templates package. Its behavior is:

  • during initialization prepares the properties
  • create a producer using the properties
  • create ProducerRecord and send it using the API Send with the attached Callback
  • when the operation completed the Callback is called:
    • if an Exception was raised it will be printed out
    • otherwise the RecordMetadata is printed out
  • print out the produced data and the resulting RecordMetadata

Consumer example

A basic consumer can be like the following one:

using MASES.KNet;
using MASES.KNet.Clients.Consumer;
using Java.Util;
using System;

namespace MASES.KNetTemplate.KNetConsumer
{
    class Program
    {
        const string theServer = "localhost:9092";
        const string theTopic = "myTopic";

        static string serverToUse = theServer;
        static string topicToUse = theTopic;

        static void Main(string[] args)
        {
            var appArgs = KNetCore.ApplicationArgs;

            if (appArgs.Length != 0)
            {
                serverToUse = args[0];
            }

            Properties props = new Properties();
            props.Put(ConsumerConfig.BOOTSTRAP_SERVERS_CONFIG, serverToUse);
            props.Put(ConsumerConfig.GROUP_ID_CONFIG, "test");
            props.Put(ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG, "true");
            props.Put(ConsumerConfig.AUTO_COMMIT_INTERVAL_MS_CONFIG, "1000");
            props.Put(ConsumerConfig.KEY_DESERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringDeserializer");
            props.Put(ConsumerConfig.VALUE_DESERIALIZER_CLASS_CONFIG, "org.apache.kafka.common.serialization.StringDeserializer");

            using (var consumer = new KafkaConsumer<string, string>(props))
            {
                consumer.Subscribe(Collections.singleton(topicToUse));
                while (true)
                {
                    var records = consumer.Poll((long)TimeSpan.FromMilliseconds(200).TotalMilliseconds);
                    foreach (var item in records)
                    {
                        Console.WriteLine($"Offset = {item.Offset}, Key = {item.Key}, Value = {item.Value}");
                    }
                }
            }
        }
    }
}

The example above can be found in the templates package. Its behavior is:

  • during initialization prepares the properties,
  • create a consumer using the properties
  • subscribe and starts consume
  • when data are received it logs to the console the information.
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.1 is compatible. 
.NET Framework net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (5)

Showing the top 5 NuGet packages that depend on MASES.KNet:

Package Downloads
MASES.EntityFrameworkCore.KNet.Serialization

EntityFrameworkCore KNet - Serialization support for EntityFrameworkCore provider for Apache Kafka

MASES.KNet.Serialization.Json

Json Serializer/Deserializer of .NET suite for Apache Kafka. KNet is a comprehensive .NET suite for Apache Kafka providing all features: Producer, Consumer, Admin, Streams, Connect, backends (ZooKeeper and Kafka).

MASES.KNet.Serialization.Avro

Avro Serializer/Deserializer of .NET suite for Apache Kafka. KNet is a comprehensive .NET suite for Apache Kafka providing all features: Producer, Consumer, Admin, Streams, Connect, backends (ZooKeeper and Kafka).

MASES.KNet.Serialization.MessagePack

MessagePack Serializer/Deserializer of .NET suite for Apache Kafka. KNet is a comprehensive .NET suite for Apache Kafka providing all features: Producer, Consumer, Admin, Streams, Connect, backends (ZooKeeper and Kafka).

MASES.KNet.Serialization.Protobuf

Protobuf Serializer/Deserializer of .NET suite for Apache Kafka. KNet is a comprehensive .NET suite for Apache Kafka providing all features: Producer, Consumer, Admin, Streams, Connect, backends (ZooKeeper and Kafka).

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.6.0 13,869 3/1/2024
2.5.0 476 2/28/2024
2.4.3 57,872 2/11/2024
2.4.2 47,066 1/27/2024
2.4.1 11,348 1/21/2024
2.4.0 107 1/20/2024
2.3.0 92,702 11/25/2023
2.2.0 48,017 10/19/2023
2.1.3 26,148 10/11/2023
2.1.2 26,442 10/6/2023
2.1.1 1,097 10/5/2023
2.1.0 726 9/27/2023
2.0.2 135,660 8/2/2023
2.0.1 9,886 7/11/2023
2.0.0 37,122 7/8/2023
1.5.5 32,386 7/1/2023
1.5.4 25,309 5/28/2023
1.5.3 46,026 4/16/2023
1.5.2 33,043 4/11/2023
1.5.1 65,024 3/15/2023
1.5.0 55,600 2/9/2023
1.4.8 143,477 11/28/2022
1.4.7 682 11/23/2022
1.4.6 758 11/22/2022
1.4.5 684 11/21/2022
1.4.4 19,670 11/1/2022
1.4.3 19,770 10/21/2022
1.4.2 782 10/17/2022
1.4.1 1,327 10/10/2022
1.4.0 52,574 10/6/2022
1.3.6 36,789 9/19/2022
1.3.5 54,151 9/8/2022
1.3.4 66,122 8/18/2022
1.3.3 800 8/5/2022
1.3.2 884 6/19/2022
1.3.1 35,413 5/23/2022
1.2.4 969 5/11/2022
1.2.3 872 5/7/2022
1.2.2 888 5/2/2022
1.2.1 5,885 3/28/2022
1.2.0 1,452 3/20/2022