[#28] Clients: Make immutable parameters
All checks were successful
lint-build / dotnet8.0 (pull_request) Successful in 55s
DCO / DCO (pull_request) Successful in 1m4s
lint-build / dotnet8.0 (push) Successful in 1m13s

Signed-off-by: Pavel Gross <p.gross@yadro.com>
This commit is contained in:
Pavel Gross 2024-12-02 19:33:45 +03:00
parent 749000a090
commit 9bb7b5eff8
62 changed files with 2742 additions and 963 deletions

View file

@ -3,22 +3,42 @@ using System.Threading;
namespace FrostFS.SDK.Client;
public class CallContext()
public readonly struct CallContext(TimeSpan timeout, CancellationToken cancellationToken = default) : IEquatable<CallContext>
{
public CancellationToken CancellationToken { get; } = cancellationToken;
// internal Action<Exception>? PoolErrorHandler { get; set; }
public TimeSpan Timeout { get; } = timeout;
// public FrostFsOwner? OwnerId { get; set; }
internal readonly DateTime? GetDeadline()
{
return Timeout.Ticks > 0 ? DateTime.UtcNow.Add(Timeout) : null;
}
// public FrostFsVersion? Version { get; set; }
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not CallContext)
return false;
public CancellationToken CancellationToken { get; set; }
return Equals((CallContext)obj);
}
public TimeSpan Timeout { get; set; }
public bool Equals(CallContext other)
{
return Timeout == other.Timeout && CancellationToken.Equals(other.CancellationToken);
}
public DateTime? Deadline => Timeout.Ticks > 0 ? DateTime.UtcNow.Add(Timeout) : null;
public override int GetHashCode()
{
return CancellationToken.GetHashCode() ^ Timeout.GetHashCode();
}
// public Action<CallStatistics>? Callback { get; set; }
public static bool operator ==(CallContext left, CallContext right)
{
return left.Equals(right);
}
// public Collection<Interceptor> Interceptors { get; } = [];
public static bool operator !=(CallContext left, CallContext right)
{
return !(left == right);
}
}

View file

@ -1,10 +0,0 @@
using System.Security.Cryptography;
namespace FrostFS.SDK.Client;
public class Credentials(ECDsa key, FrostFsOwner ownerId)
{
public ECDsa Key { get; } = key;
public FrostFsOwner OwnerId { get; } = ownerId;
}

View file

@ -1,11 +0,0 @@
namespace FrostFS.SDK.Client;
public interface IContext
{
/// <summary>
/// The method call can be extended with additional behavior like canceling by timeout or user's request,
/// callbacks, interceptors.
/// </summary>
/// <value>Additional parameters for calling the method</value>
CallContext? Context { get; }
}

View file

@ -8,5 +8,5 @@ public interface ISessionToken
/// member. The session has a limited validity period, and applies to a strictly defined set of operations.
/// </summary>
/// <value>Instance of the session obtained from the server</value>
FrostFsSessionToken? SessionToken { get; set; }
FrostFsSessionToken? SessionToken { get; }
}

View file

@ -0,0 +1,43 @@
namespace FrostFS.SDK.Client;
public readonly struct PrmApeChainAdd(FrostFsChainTarget target, FrostFsChain chain, string[]? xheaders = null) : System.IEquatable<PrmApeChainAdd>
{
public FrostFsChainTarget Target { get; } = target;
public FrostFsChain Chain { get; } = chain;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmApeChainAdd)
return false;
return Equals((PrmApeChainAdd)obj);
}
public readonly bool Equals(PrmApeChainAdd other)
{
return Target == other.Target
&& Chain == other.Chain
&& XHeaders == other.XHeaders;
}
public override readonly int GetHashCode()
{
return Chain.GetHashCode() ^ Target.GetHashCode() ^ XHeaders.GetHashCode();
}
public static bool operator ==(PrmApeChainAdd left, PrmApeChainAdd right)
{
return left.Equals(right);
}
public static bool operator !=(PrmApeChainAdd left, PrmApeChainAdd right)
{
return !(left == right);
}
}

View file

@ -1,6 +1,40 @@
namespace FrostFS.SDK.Client;
public sealed class PrmApeChainList(FrostFsChainTarget target, CallContext? ctx = null) : PrmBase(ctx)
public readonly struct PrmApeChainList(FrostFsChainTarget target, string[]? xheaders = null) : System.IEquatable<PrmApeChainList>
{
public FrostFsChainTarget Target { get; } = target;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmApeChainList)
return false;
return Equals((PrmApeChainList)obj);
}
public override readonly int GetHashCode()
{
return Target.GetHashCode() ^ XHeaders.GetHashCode();
}
public readonly bool Equals(PrmApeChainList other)
{
return Target == other.Target
&& XHeaders == other.XHeaders;
}
public static bool operator ==(PrmApeChainList left, PrmApeChainList right)
{
return left.Equals(right);
}
public static bool operator !=(PrmApeChainList left, PrmApeChainList right)
{
return !(left == right);
}
}

View file

@ -1,8 +1,46 @@
namespace FrostFS.SDK.Client;
public sealed class PrmApeChainRemove(FrostFsChainTarget target, FrostFsChain chain, CallContext? ctx = null) : PrmBase(ctx)
public readonly struct PrmApeChainRemove(
FrostFsChainTarget target,
FrostFsChain chain,
string[]? xheaders = null) : System.IEquatable<PrmApeChainRemove>
{
public FrostFsChainTarget Target { get; } = target;
public FrostFsChain Chain { get; } = chain;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmApeChainRemove)
return false;
return Equals((PrmApeChainRemove)obj);
}
public readonly bool Equals(PrmApeChainRemove other)
{
return Target == other.Target
&& Chain == other.Chain
&& XHeaders == other.XHeaders;
}
public override readonly int GetHashCode()
{
return Chain.GetHashCode() ^ Target.GetHashCode() ^ XHeaders.GetHashCode();
}
public static bool operator ==(PrmApeChainRemove left, PrmApeChainRemove right)
{
return left.Equals(right);
}
public static bool operator !=(PrmApeChainRemove left, PrmApeChainRemove right)
{
return !(left == right);
}
}

View file

@ -1,8 +0,0 @@
namespace FrostFS.SDK.Client;
public sealed class PrmApeChainAdd(FrostFsChainTarget target, FrostFsChain chain, CallContext? ctx = null) : PrmBase(ctx)
{
public FrostFsChainTarget Target { get; } = target;
public FrostFsChain Chain { get; } = chain;
}

View file

@ -1,5 +0,0 @@
namespace FrostFS.SDK.Client;
public sealed class PrmBalance(CallContext? ctx = null) : PrmBase(ctx)
{
}

View file

@ -1,14 +0,0 @@
using System.Collections.Specialized;
namespace FrostFS.SDK.Client;
public class PrmBase(CallContext? ctx, NameValueCollection? xheaders = null) : IContext
{
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public NameValueCollection XHeaders { get; } = xheaders ?? [];
/// <inheritdoc />
public CallContext Context { get; } = ctx ?? new CallContext();
}

View file

@ -1,17 +1,61 @@
namespace FrostFS.SDK.Client;
public sealed class PrmContainerCreate(FrostFsContainerInfo container, CallContext? ctx = null) : PrmBase(ctx), ISessionToken
public readonly struct PrmContainerCreate(
FrostFsContainerInfo container,
PrmWait waitParams,
FrostFsSessionToken? sessionToken = null,
string[]? xheaders = null) : ISessionToken, System.IEquatable<PrmContainerCreate>
{
public FrostFsContainerInfo Container { get; set; } = container;
public FrostFsContainerInfo Container { get; } = container;
/// <summary>
/// Since the container becomes available with some delay, it needs to poll the container status
/// </summary>
/// <value>Rules for polling the result</value>
public PrmWait? WaitParams { get; set; }
public PrmWait WaitParams { get; } = waitParams;
/// <summary>
/// Blank session token
/// </summary>
public FrostFsSessionToken? SessionToken { get; set; }
public FrostFsSessionToken? SessionToken { get; } = sessionToken;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmContainerCreate)
return false;
return Equals((PrmContainerCreate)obj);
}
public readonly bool Equals(PrmContainerCreate other)
{
return Container == other.Container
&& WaitParams == other.WaitParams
&& SessionToken == other.SessionToken
&& XHeaders == other.XHeaders;
}
public override readonly int GetHashCode()
{
return Container.GetHashCode()
^ WaitParams.GetHashCode()
^ (SessionToken == null ? 0 : SessionToken.GetHashCode())
^ XHeaders.GetHashCode();
}
public static bool operator ==(PrmContainerCreate left, PrmContainerCreate right)
{
return left.Equals(right);
}
public static bool operator !=(PrmContainerCreate left, PrmContainerCreate right)
{
return !(left == right);
}
}

View file

@ -1,14 +1,52 @@
namespace FrostFS.SDK.Client;
public sealed class PrmContainerDelete(FrostFsContainerId containerId, CallContext? ctx = null) : PrmBase(ctx), ISessionToken
public readonly struct PrmContainerDelete(
FrostFsContainerId containerId,
PrmWait waitParams,
FrostFsSessionToken? sessionToken = null,
string[]? xheaders = null) : ISessionToken, System.IEquatable<PrmContainerDelete>
{
public FrostFsContainerId ContainerId { get; set; } = containerId;
public FrostFsContainerId ContainerId { get; } = containerId;
/// <summary>
/// Since the container is removed with some delay, it needs to poll the container status
/// </summary>
/// <value>Rules for polling the result</value>
public PrmWait? WaitParams { get; set; }
public PrmWait WaitParams { get; } = waitParams;
public FrostFsSessionToken? SessionToken { get; set; }
public FrostFsSessionToken? SessionToken { get; } = sessionToken;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmContainerDelete)
return false;
return Equals((PrmContainerDelete)obj);
}
public readonly bool Equals(PrmContainerDelete other)
{
return ContainerId == other.ContainerId
&& WaitParams.Equals(other.WaitParams);
}
public override int GetHashCode()
{
return ContainerId.GetHashCode() ^ WaitParams.GetHashCode();
}
public static bool operator ==(PrmContainerDelete left, PrmContainerDelete right)
{
return left.Equals(right);
}
public static bool operator !=(PrmContainerDelete left, PrmContainerDelete right)
{
return !(left == right);
}
}

View file

@ -1,6 +1,40 @@
namespace FrostFS.SDK.Client;
public sealed class PrmContainerGet(FrostFsContainerId container, CallContext? ctx = null) : PrmBase(ctx)
public readonly struct PrmContainerGet(FrostFsContainerId container, string[]? xheaders = null) : System.IEquatable<PrmContainerGet>
{
public FrostFsContainerId Container { get; set; } = container;
public FrostFsContainerId Container { get; } = container;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmContainerGet)
return false;
return Equals((PrmContainerGet)obj);
}
public readonly bool Equals(PrmContainerGet other)
{
return GetHashCode() == other.GetHashCode();
}
public override readonly int GetHashCode()
{
return Container.GetHashCode()
^ XHeaders.GetHashCode();
}
public static bool operator ==(PrmContainerGet left, PrmContainerGet right)
{
return left.Equals(right);
}
public static bool operator !=(PrmContainerGet left, PrmContainerGet right)
{
return !(left == right);
}
}

View file

@ -1,5 +1,39 @@
namespace FrostFS.SDK.Client;
using System;
public sealed class PrmContainerGetAll(CallContext? ctx = null) : PrmBase(ctx)
namespace FrostFS.SDK.Client;
public readonly struct PrmContainerGetAll(string[]? xheaders = null) : IEquatable<PrmContainerGetAll>
{
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmContainerGetAll)
return false;
return Equals((PrmContainerGetAll)obj);
}
public readonly bool Equals(PrmContainerGetAll other)
{
return XHeaders == other.XHeaders;
}
public override readonly int GetHashCode()
{
return XHeaders.GetHashCode();
}
public static bool operator ==(PrmContainerGetAll left, PrmContainerGetAll right)
{
return left.Equals(right);
}
public static bool operator !=(PrmContainerGetAll left, PrmContainerGetAll right)
{
return !(left == right);
}
}

View file

@ -1,5 +0,0 @@
namespace FrostFS.SDK.Client;
public sealed class PrmNetmapSnapshot(CallContext? ctx = null) : PrmBase(ctx)
{
}

View file

@ -1,5 +0,0 @@
namespace FrostFS.SDK.Client;
public sealed class PrmNetworkSettings(CallContext? ctx = null) : PrmBase(ctx)
{
}

View file

@ -1,5 +0,0 @@
namespace FrostFS.SDK.Client;
public sealed class PrmNodeInfo(CallContext? ctx = null) : PrmBase(ctx)
{
}

View file

@ -1,11 +1,51 @@
namespace FrostFS.SDK.Client;
public sealed class PrmObjectDelete(FrostFsContainerId containerId, FrostFsObjectId objectId, CallContext? ctx = null) : PrmBase(ctx), ISessionToken
public readonly struct PrmObjectDelete(
FrostFsContainerId containerId,
FrostFsObjectId objectId,
FrostFsSessionToken? sessionToken = null,
string[]? xheaders = null) : ISessionToken, System.IEquatable<PrmObjectDelete>
{
public FrostFsContainerId ContainerId { get; set; } = containerId;
public FrostFsContainerId ContainerId { get; } = containerId;
public FrostFsObjectId ObjectId { get; set; } = objectId;
public FrostFsObjectId ObjectId { get; } = objectId;
/// <inheritdoc />
public FrostFsSessionToken? SessionToken { get; set; }
public FrostFsSessionToken? SessionToken { get; } = sessionToken;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmObjectDelete)
return false;
return Equals((PrmObjectDelete)obj);
}
public readonly bool Equals(PrmObjectDelete other)
{
return ContainerId == other.ContainerId
&& ObjectId == other.ObjectId
&& SessionToken == other.SessionToken
&& XHeaders == other.XHeaders;
}
public override readonly int GetHashCode()
{
return ContainerId.GetHashCode() ^ ObjectId.GetHashCode() ^ (SessionToken != null ? SessionToken.GetHashCode() : 1);
}
public static bool operator ==(PrmObjectDelete left, PrmObjectDelete right)
{
return left.Equals(right);
}
public static bool operator !=(PrmObjectDelete left, PrmObjectDelete right)
{
return !(left == right);
}
}

View file

@ -1,11 +1,52 @@
namespace FrostFS.SDK.Client;
public sealed class PrmObjectGet(FrostFsContainerId containerId, FrostFsObjectId objectId, CallContext? ctx = null) : PrmBase(ctx), ISessionToken
public readonly struct PrmObjectGet(
FrostFsContainerId containerId,
FrostFsObjectId objectId,
FrostFsSessionToken? sessionToken = null,
string[]? xheaders = null) : ISessionToken, System.IEquatable<PrmObjectGet>
{
public FrostFsContainerId ContainerId { get; set; } = containerId;
public FrostFsContainerId ContainerId { get; } = containerId;
public FrostFsObjectId ObjectId { get; set; } = objectId;
public FrostFsObjectId ObjectId { get; } = objectId;
/// <inheritdoc />
public FrostFsSessionToken? SessionToken { get; set; }
public FrostFsSessionToken? SessionToken { get; } = sessionToken;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmObjectGet)
return false;
return Equals((PrmObjectGet)obj);
}
public override readonly int GetHashCode()
{
return ContainerId.GetHashCode()
^ ObjectId.GetHashCode()
^ (SessionToken == null ? 0 : SessionToken.GetHashCode());
}
public readonly bool Equals(PrmObjectGet other)
{
return ContainerId == other.ContainerId
&& ObjectId == other.ObjectId
&& SessionToken == other.SessionToken;
}
public static bool operator ==(PrmObjectGet left, PrmObjectGet right)
{
return left.Equals(right);
}
public static bool operator !=(PrmObjectGet left, PrmObjectGet right)
{
return !(left == right);
}
}

View file

@ -1,11 +1,56 @@
namespace FrostFS.SDK.Client;
public sealed class PrmObjectHeadGet(FrostFsContainerId containerId, FrostFsObjectId objectId, CallContext? ctx = null) : PrmBase(ctx), ISessionToken
public readonly struct PrmObjectHeadGet(
FrostFsContainerId containerId,
FrostFsObjectId objectId,
bool raw = false,
FrostFsSessionToken? sessionToken = null,
string[]? xheaders = null)
: ISessionToken, System.IEquatable<PrmObjectHeadGet>
{
public FrostFsContainerId ContainerId { get; set; } = containerId;
public FrostFsContainerId ContainerId { get; } = containerId;
public FrostFsObjectId ObjectId { get; set; } = objectId;
public FrostFsObjectId ObjectId { get; } = objectId;
public bool Raw { get; } = raw;
/// <inheritdoc />
public FrostFsSessionToken? SessionToken { get; set; }
public FrostFsSessionToken? SessionToken { get; } = sessionToken;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmObjectHeadGet)
return false;
return Equals((PrmObjectHeadGet)obj);
}
public readonly bool Equals(PrmObjectHeadGet other)
{
return ContainerId == other.ContainerId
&& ObjectId == other.ObjectId
&& SessionToken == other.SessionToken;
}
public override readonly int GetHashCode()
{
return ContainerId.GetHashCode()
^ ObjectId.GetHashCode()
^ (SessionToken == null ? 0 : SessionToken.GetHashCode());
}
public static bool operator ==(PrmObjectHeadGet left, PrmObjectHeadGet right)
{
return left.Equals(right);
}
public static bool operator !=(PrmObjectHeadGet left, PrmObjectHeadGet right)
{
return !(left == right);
}
}

View file

@ -2,23 +2,70 @@
namespace FrostFS.SDK.Client;
public sealed class PrmObjectPatch(FrostFsAddress address, CallContext? ctx = null) : PrmBase(ctx), ISessionToken
public readonly struct PrmObjectPatch(
FrostFsAddress address,
FrostFsRange range,
Stream? payload,
int maxChunkLength,
FrostFsSessionToken? sessionToken = null,
bool replaceAttributes = false,
FrostFsAttributePair[]? newAttributes = null,
string[]? xheaders = null) : ISessionToken, System.IEquatable<PrmObjectPatch>
{
public FrostFsAddress Address { get; } = address;
public FrostFsRange Range { get; set; }
public FrostFsRange Range { get; } = range;
/// <summary>
/// A stream with source data
/// </summary>
public Stream? Payload { get; set; }
public Stream? Payload { get; } = payload;
public FrostFsAttributePair[]? NewAttributes { get; set; }
public FrostFsAttributePair[]? NewAttributes { get; } = newAttributes;
public bool ReplaceAttributes { get; set; }
public bool ReplaceAttributes { get; } = replaceAttributes;
public int MaxPayloadPatchChunkLength { get; set; }
public int MaxChunkLength { get; } = maxChunkLength;
/// <inheritdoc />
public FrostFsSessionToken? SessionToken { get; set; }
public FrostFsSessionToken? SessionToken { get; } = sessionToken;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmObjectPatch)
return false;
return Equals((PrmObjectPatch)obj);
}
public readonly bool Equals(PrmObjectPatch other)
{
return GetHashCode() == other.GetHashCode();
}
public override readonly int GetHashCode()
{
return Address.GetHashCode()
^ Range.GetHashCode()
^ (Payload == null ? 0 : Payload.GetHashCode())
^ (NewAttributes == null ? 0 : NewAttributes.GetHashCode())
^ (SessionToken == null ? 0 : SessionToken.GetHashCode())
^ (ReplaceAttributes ? 1 : 0)
^ MaxChunkLength;
}
public static bool operator ==(PrmObjectPatch left, PrmObjectPatch right)
{
return left.Equals(right);
}
public static bool operator !=(PrmObjectPatch left, PrmObjectPatch right)
{
return !(left == right);
}
}

View file

@ -2,19 +2,26 @@ using System.IO;
namespace FrostFS.SDK.Client;
public sealed class PrmObjectPut(CallContext? ctx = null) : PrmBase(ctx), ISessionToken
public readonly struct PrmObjectPut(
FrostFsObjectHeader? header,
Stream? payload,
bool clientCut,
int bufferMaxSize = 0,
FrostFsSessionToken? sessionToken = null,
byte[]? customBuffer = null,
string[]? xheaders = null) : ISessionToken, System.IEquatable<PrmObjectPut>
{
/// <summary>
/// Need to provide values like <c>ContainerId</c> and <c>ObjectType</c> to create and object.
/// Optional parameters ike <c>Attributes</c> can be provided as well.
/// </summary>
/// <value>Header with required parameters to create an object</value>
public FrostFsObjectHeader? Header { get; set; }
public FrostFsObjectHeader? Header { get; } = header;
/// <summary>
/// A stream with source data
/// </summary>
public Stream? Payload { get; set; }
public Stream? Payload { get; } = payload;
/// <summary>
/// Object size is limited. In the data exceeds the limit, the object will be splitted.
@ -22,25 +29,60 @@ public sealed class PrmObjectPut(CallContext? ctx = null) : PrmBase(ctx), ISessi
/// as a stream and will be cut on server side.
/// </summary>
/// <value>Is client cut is applied</value>
public bool ClientCut { get; set; }
public bool ClientCut { get; } = clientCut;
/// <summary>
/// Overrides default size of the buffer for stream transferring.
/// </summary>
/// <value>Size of the buffer</value>
public int BufferMaxSize { get; set; }
public int BufferMaxSize { get; } = bufferMaxSize;
/// <summary>
/// Allows to define a buffer for chunks to manage by the memory allocation and releasing.
/// </summary>
public byte[]? CustomBuffer { get; set; }
public byte[]? CustomBuffer { get; } = customBuffer;
/// <inheritdoc />
public FrostFsSessionToken? SessionToken { get; set; }
public FrostFsSessionToken? SessionToken { get; } = sessionToken;
internal int MaxObjectSizeCache { get; set; }
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
internal ulong CurrentStreamPosition { get; set; }
internal PutObjectContext PutObjectContext { get; } = new();
internal ulong FullLength { get; set; }
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmObjectPut)
return false;
return Equals((PrmObjectPut)obj);
}
public readonly bool Equals(PrmObjectPut other)
{
return GetHashCode() == other.GetHashCode();
}
public override readonly int GetHashCode()
{
return BufferMaxSize
^ (Header == null ? 0 : Header.GetHashCode())
^ (Payload == null ? 0 : Payload.GetHashCode())
^ (ClientCut ? 1 : 0)
^ (CustomBuffer == null ? 0 : CustomBuffer.GetHashCode())
^ (SessionToken == null ? 0 : SessionToken.GetHashCode())
^ XHeaders.GetHashCode();
}
public static bool operator ==(PrmObjectPut left, PrmObjectPut right)
{
return left.Equals(right);
}
public static bool operator !=(PrmObjectPut left, PrmObjectPut right)
{
return !(left == right);
}
}

View file

@ -1,21 +1,59 @@
using System.Collections.Generic;
namespace FrostFS.SDK.Client;
namespace FrostFS.SDK.Client;
public sealed class PrmObjectSearch(FrostFsContainerId containerId, CallContext? ctx = null, params IObjectFilter[] filters) : PrmBase(ctx), ISessionToken
public readonly struct PrmObjectSearch(
FrostFsContainerId containerId,
FrostFsSessionToken? token,
string[]? xheaders = null,
params IObjectFilter[] filters) : ISessionToken, System.IEquatable<PrmObjectSearch>
{
/// <summary>
/// Defines container for the search
/// </summary>
/// <value></value>
public FrostFsContainerId ContainerId { get; set; } = containerId;
public FrostFsContainerId ContainerId { get; } = containerId;
/// <summary>
/// Defines the search criteria
/// </summary>
/// <value>Collection of filters</value>
public IEnumerable<IObjectFilter> Filters { get; set; } = filters;
public IObjectFilter[] Filters { get; } = filters;
/// <inheritdoc />
public FrostFsSessionToken? SessionToken { get; set; }
public FrostFsSessionToken? SessionToken { get; } = token;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmObjectSearch)
return false;
return Equals((PrmObjectSearch)obj);
}
public readonly bool Equals(PrmObjectSearch other)
{
return GetHashCode() == other.GetHashCode();
}
public override readonly int GetHashCode()
{
return ContainerId.GetHashCode()
^ Filters.GetHashCode()
^ (SessionToken == null ? 0 : SessionToken.GetHashCode())
^ XHeaders.GetHashCode();
}
public static bool operator ==(PrmObjectSearch left, PrmObjectSearch right)
{
return left.Equals(right);
}
public static bool operator !=(PrmObjectSearch left, PrmObjectSearch right)
{
return !(left == right);
}
}

View file

@ -1,11 +1,12 @@
namespace FrostFS.SDK.Client;
public sealed class PrmRangeGet(
public readonly struct PrmRangeGet(
FrostFsContainerId containerId,
FrostFsObjectId objectId,
FrostFsRange range,
bool raw = false,
CallContext? ctx = null) : PrmBase(ctx), ISessionToken
FrostFsSessionToken? sessionToken = null,
string[]? xheaders = null) : ISessionToken, System.IEquatable<PrmRangeGet>
{
public FrostFsContainerId ContainerId { get; } = containerId;
@ -16,5 +17,41 @@ public sealed class PrmRangeGet(
public bool Raw { get; } = raw;
/// <inheritdoc />
public FrostFsSessionToken? SessionToken { get; set; }
public FrostFsSessionToken? SessionToken { get; } = sessionToken;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmRangeGet)
return false;
return Equals((PrmRangeGet)obj);
}
public readonly bool Equals(PrmRangeGet other)
{
return GetHashCode() == other.GetHashCode();
}
public override readonly int GetHashCode()
{
return ContainerId.GetHashCode()
^ ObjectId.GetHashCode()
^ Range.GetHashCode()
^ Raw.GetHashCode();
}
public static bool operator ==(PrmRangeGet left, PrmRangeGet right)
{
return left.Equals(right);
}
public static bool operator !=(PrmRangeGet left, PrmRangeGet right)
{
return !(left == right);
}
}

View file

@ -1,11 +1,12 @@
namespace FrostFS.SDK.Client;
public sealed class PrmRangeHashGet(
public readonly struct PrmRangeHashGet(
FrostFsContainerId containerId,
FrostFsObjectId objectId,
FrostFsRange[] ranges,
byte[] salt,
CallContext? ctx = null) : PrmBase(ctx), ISessionToken
FrostFsSessionToken? sessionToken = null,
string[]? xheaders = null) : ISessionToken, System.IEquatable<PrmRangeHashGet>
{
public FrostFsContainerId ContainerId { get; } = containerId;
@ -16,5 +17,42 @@ public sealed class PrmRangeHashGet(
public byte[] Salt { get; } = salt;
/// <inheritdoc />
public FrostFsSessionToken? SessionToken { get; set; }
public FrostFsSessionToken? SessionToken { get; } = sessionToken;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmRangeHashGet)
return false;
return Equals((PrmRangeHashGet)obj);
}
public readonly bool Equals(PrmRangeHashGet other)
{
return GetHashCode() == other.GetHashCode();
}
public override readonly int GetHashCode()
{
return ContainerId.GetHashCode()
^ ObjectId.GetHashCode()
^ Ranges.GetHashCode()
^ Salt.GetHashCode()
^ (SessionToken == null ? 0 : SessionToken.GetHashCode());
}
public static bool operator ==(PrmRangeHashGet left, PrmRangeHashGet right)
{
return left.Equals(right);
}
public static bool operator !=(PrmRangeHashGet left, PrmRangeHashGet right)
{
return !(left == right);
}
}

View file

@ -1,6 +1,40 @@
namespace FrostFS.SDK.Client;
public sealed class PrmSessionCreate(ulong expiration, CallContext? ctx = null) : PrmBase(ctx)
public readonly struct PrmSessionCreate(ulong expiration, string[]? xheaders = null) : System.IEquatable<PrmSessionCreate>
{
public ulong Expiration { get; set; } = expiration;
public ulong Expiration { get; } = expiration;
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmSessionCreate)
return false;
return Equals((PrmSessionCreate)obj);
}
public override readonly int GetHashCode()
{
return Expiration.GetHashCode() ^ XHeaders.GetHashCode();
}
public readonly bool Equals(PrmSessionCreate other)
{
return Expiration == other.Expiration
&& XHeaders == other.XHeaders;
}
public static bool operator ==(PrmSessionCreate left, PrmSessionCreate right)
{
return left.Equals(right);
}
public static bool operator !=(PrmSessionCreate left, PrmSessionCreate right)
{
return !(left == right);
}
}

View file

@ -1,9 +1,46 @@
namespace FrostFS.SDK.Client;
public sealed class PrmSingleObjectPut(FrostFsObject frostFsObject, CallContext? ctx = null) : PrmBase(ctx), ISessionToken
public struct PrmSingleObjectPut(
FrostFsObject frostFsObject,
string[]? xheaders = null) : ISessionToken, System.IEquatable<PrmSingleObjectPut>
{
public FrostFsObject FrostFsObject { get; set; } = frostFsObject;
/// <inheritdoc />
public FrostFsSessionToken? SessionToken { get; set; }
/// <summary>
/// FrostFS request X-Headers
/// </summary>
public string[] XHeaders { get; } = xheaders ?? [];
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmSingleObjectPut)
return false;
return Equals((PrmSingleObjectPut)obj);
}
public override readonly int GetHashCode()
{
return FrostFsObject.GetHashCode()
^ (SessionToken == null ? 0 : SessionToken.GetHashCode());
}
public readonly bool Equals(PrmSingleObjectPut other)
{
return FrostFsObject == other.FrostFsObject
&& SessionToken == other.SessionToken;
}
public static bool operator ==(PrmSingleObjectPut left, PrmSingleObjectPut right)
{
return left.Equals(right);
}
public static bool operator !=(PrmSingleObjectPut left, PrmSingleObjectPut right)
{
return !(left == right);
}
}

View file

@ -2,7 +2,7 @@
namespace FrostFS.SDK.Client;
public class PrmWait(TimeSpan timeout, TimeSpan pollInterval)
public readonly struct PrmWait(TimeSpan timeout, TimeSpan pollInterval) : IEquatable<PrmWait>
{
private static TimeSpan DefaultTimeout = TimeSpan.FromSeconds(120);
private static TimeSpan DefaultPollInterval = TimeSpan.FromSeconds(5);
@ -13,12 +13,40 @@ public class PrmWait(TimeSpan timeout, TimeSpan pollInterval)
public static PrmWait DefaultParams { get; } = new PrmWait(DefaultTimeout, DefaultPollInterval);
public TimeSpan Timeout { get; set; } = timeout.Ticks == 0 ? DefaultTimeout : timeout;
public TimeSpan Timeout { get; } = timeout.Ticks == 0 ? DefaultTimeout : timeout;
public TimeSpan PollInterval { get; set; } = pollInterval.Ticks == 0 ? DefaultPollInterval : pollInterval;
public TimeSpan PollInterval { get; } = pollInterval.Ticks == 0 ? DefaultPollInterval : pollInterval;
public DateTime GetDeadline()
public readonly DateTime GetDeadline()
{
return DateTime.UtcNow.AddTicks(Timeout.Ticks);
}
public override readonly bool Equals(object obj)
{
if (obj == null || obj is not PrmWait)
return false;
return Equals((PrmWait)obj);
}
public override readonly int GetHashCode()
{
return DefaultTimeout.GetHashCode() ^ DefaultPollInterval.GetHashCode();
}
public readonly bool Equals(PrmWait other)
{
return Timeout == other.Timeout && PollInterval == other.PollInterval;
}
public static bool operator ==(PrmWait left, PrmWait right)
{
return left.Equals(right);
}
public static bool operator !=(PrmWait left, PrmWait right)
{
return !(left == right);
}
}

View file

@ -0,0 +1,10 @@
namespace FrostFS.SDK.Client;
internal sealed class PutObjectContext
{
internal int MaxObjectSizeCache { get; set; }
internal ulong CurrentStreamPosition { get; set; }
internal ulong FullLength { get; set; }
}