/* * Copyright (c) 2023 Vaughn Nugent * * Library: VNLib * Package: VNLib.Data.Caching.Extensions * File: CacheNodeAdvertisment.cs * * CacheNodeAdvertisment.cs is part of VNLib.Data.Caching.Extensions which is part of the larger * VNLib collection of libraries and utilities. * * VNLib.Data.Caching.Extensions is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * VNLib.Data.Caching.Extensions is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see https://www.gnu.org/licenses/. */ using System; using System.Text.Json.Serialization; namespace VNLib.Data.Caching.Extensions.Clustering { /// /// Represents a node that can be advertised to clients /// public class CacheNodeAdvertisment : IEquatable { /// /// The endpoint for clients to connect to to access the cache /// [JsonIgnore] public Uri? ConnectEndpoint { get; set; } /// /// Gets the address for clients to connect to to discover other discovertable nodes /// [JsonIgnore] public Uri? DiscoveryEndpoint { get; set; } /// /// Gets the unique identifier for this node /// [JsonPropertyName("iss")] public string NodeId { get; set; } [JsonPropertyName("url")] public string? url { get => ConnectEndpoint?.ToString(); set => ConnectEndpoint = value == null ? null : new Uri(value); } [JsonPropertyName("dis")] public string? dis { get => DiscoveryEndpoint?.ToString(); set => DiscoveryEndpoint = value == null ? null : new Uri(value); } /// /// Determines if the given node is equal to this node, by comparing the node ids /// /// The other node advertisment to compare /// True if the nodes are equal, false otherwise public override bool Equals(object? obj) => obj is CacheNodeAdvertisment ad && Equals(ad); /// /// Gets the hash code for this node, based on the node id /// /// The instance hash-code public override int GetHashCode() => string.GetHashCode(NodeId, StringComparison.OrdinalIgnoreCase); /// /// Determines if the given node is equal to this node, by comparing the node ids /// /// The other node advertisment to compare /// True if the nodes are equal, false otherwise public bool Equals(CacheNodeAdvertisment? other) => string.Equals(NodeId, other?.NodeId, StringComparison.OrdinalIgnoreCase); /// /// Formats a string representation of this node /// /// The formatted information string public override string ToString() { return $"NodeId: {NodeId} Connect: {url}, Discover?: {dis}"; } } }