Flynk.Net.Services.Transmit.Grpc.Common 1.5.0

Flynk.Net.Services.Transmit.Grpc.Common

Shared infrastructure components for the Flynk Transmission Service gRPC implementation.

Overview

This package contains shared types and utilities used by both the Client and Server packages:

• Proto Definitions: transmission.proto and generated gRPC client/server stubs
• RpcHandlerRegistry: Static registry for registering and routing RPC handlers
• Port Utilities: Port availability checking and conflict detection
• PortInUseException: Exception for port binding conflicts

Installation

You typically don't need to install this package directly. It's automatically included when you install either:

• Flynk.Net.Services.Transmit.Grpc.Client (for client applications)
• Flynk.Net.Services.Transmit.Grpc.Server (for server applications)

However, if you need to reference the shared types directly:

dotnet add package Flynk.Net.Services.Transmit.Grpc.Common

What's Included

Proto Definitions

The transmission.proto file defines the gRPC service contract:

• TransmissionService with Send and Receive RPCs
• TransmissionRequest and TransmissionResponse messages
• ReceiveRequest for streaming

RpcHandlerRegistry

Static registry for routing RPC requests to handlers:

using Flynk.Net.Services.Transmit.Grpc.Client;

// Register a handler
RpcHandlerRegistry.Register("client-123", async request => {
    // Process request
    return new TransmissionResponse { Success = true };
});

// Register server handler
RpcHandlerRegistry.RegisterServerHandler(async request => {
    // Process server-side request
    return new TransmissionResponse { Success = true };
});

Port Utilities

Check port availability and handle conflicts:

using Flynk.Net.Services.Transmit.Grpc.Utilities;

// Check if port is available
if (PortUtility.IsPortAvailable(5000))
{
    Console.WriteLine("Port 5000 is available");
}

// Validate port or throw exception
try
{
    PortUtility.ValidatePortAvailable(5000, "My Service");
}
catch (PortInUseException ex)
{
    Console.WriteLine(ex.GetDetailedMessage());
}

// Find an available port
var port = PortUtility.FindAvailablePort(5000, 5100);

Version Compatibility

All three packages should use matching versions.

Dependencies

• Google.Protobuf 3.32.1
• Grpc.Net.Client 2.71.0
• Microsoft.Extensions.Logging.Abstractions 8.0.2+ (net8.0) or 9.0.0+ (net9.0)

Target Frameworks

• .NET 8.0
• .NET 9.0

License

See LICENSE.txt

More Information

• Client Package Documentation
• Server Package Documentation
• API Reference
• Implementation Guide