BaseProtocolServer

BaseProtocolServer

protected BaseProtocolServer(TSettings settings, IAuthorization authorization)

baseProtocolServer = BaseProtocolServer(settings, authorization)

Initializes a new instance.

settings

Server settings.

authorization

The customer authentication.

Address

public abstract EndPoint Address { get; set; }

value = baseProtocolServer.Address
baseProtocolServer.Address = value

Where the server listens.

Authorization

public IAuthorization Authorization { get; }

value = baseProtocolServer.Authorization

The customer authentication.

LoginRateLimiter

protected LoginRateLimiter LoginRateLimiter { get; private set; }

value = baseProtocolServer.LoginRateLimiter
baseProtocolServer.LoginRateLimiter = value

登录尝试的速率限制器( 在所有听众中共享) 。

Sessions

public IEnumerable<IMessageListenerSession> Sessions { get; }

value = baseProtocolServer.Sessions

活跃会话.

Settings

public TSettings Settings { get; }

value = baseProtocolServer.Settings

设置。

State

public ChannelStates State { get; protected set; }

value = baseProtocolServer.State
baseProtocolServer.State = value

获得基础状态存储.

StockSharp#Server#Core#IHostedProtocolServer#Settings

AcceptClientsAsync

protected Task AcceptClientsAsync(TcpListener listener, Func<TcpClient, CancellationToken, Task> handleClient, CancellationToken cancellationToken)

result = baseProtocolServer.AcceptClientsAsync(listener, handleClient, cancellationToken)

Accept clients on a listener for as long as the server runs.

listener

The listener to accept on.

handleClient

What the protocol does with an accepted client. It is not awaited, so one client's session does not hold up the next accept.

cancellationToken

Cancellation token.

AddSubscription

public void AddSubscription(ServerSubscription subscription)

baseProtocolServer.AddSubscription(subscription)

增加订阅.

subscription

订阅.

AlwaysWrites

private static Func<TSubscription, TClientSession, string, CancellationToken, ValueTask<bool>> AlwaysWrites(Func<TSubscription, TClientSession, string, CancellationToken, ValueTask> handler)

result = BaseProtocolServer.AlwaysWrites(handler)

Wrap a handler that always writes so it reports the write the way the session's pump expects.

ClearState

protected virtual void ClearState()

baseProtocolServer.ClearState()

清除所有状态:听众,会话,订阅.

ClientOrderIdsOf

protected ClientOrderIdRegistry ClientOrderIdsOf(TClientSession session, string clientCode)

result = baseProtocolServer.ClientOrderIdsOf(session, clientCode)

The ClOrdIds a client's live orders hold, whichever of its connections placed them.

session

A session of the client.

clientCode

The client an order command of a service login names; ignored for any other login.

返回值: The client's registry.

Convert

protected string Convert(string value)

result = baseProtocolServer.Convert(value)

如果配置, 将文本转换为 latin 。

CreateOrderFailure

protected static ExecutionMessage CreateOrderFailure(OrderRegisterMessage command, Exception error)

result = BaseProtocolServer.CreateOrderFailure(command, error)

The report an order command refused before it reached the venue is answered with. It repeats what the command asked for, because the client has nothing else to match the failure against: the order never got an id on the venue.

command

The refused order command.

error

Why it was refused.

返回值: The execution report to send back.

CreateOrderSubscription

protected abstract TSubscription CreateOrderSubscription(TClientSession session, string clOrdId, long transactionId)

result = baseProtocolServer.CreateOrderSubscription(session, clOrdId, transactionId)

The subscription an order's reports reach its client by.

session

The connection the reports go to.

clOrdId

The ClOrdId the client gave the order.

transactionId

The number the order goes by.

返回值: The subscription.

CreateSubscription

protected abstract TSubscription CreateSubscription(TClientSession session, string requestId, ServerSubscription subscription, MessageTypes type)

result = baseProtocolServer.CreateSubscription(session, requestId, subscription, type)

创建订阅信息实例 。

Disconnect

public void Disconnect(IMessageListenerSession session)

baseProtocolServer.Disconnect(session)

断开会话 。

session

届会。

DisposeManaged

protected override void DisposeManaged()

baseProtocolServer.DisposeManaged()

释放资源。

EnqueueMessage

protected void EnqueueMessage(TSubscription[] subscribers, Func<TSubscription, TClientSession, string, CancellationToken, ValueTask> handler, CancellationToken cancellationToken)

baseProtocolServer.EnqueueMessage(subscribers, handler, cancellationToken)

多个订阅者的队列消息 。

subscribers

Subscribers to write to.

handler

Writes the message for one subscriber. It always writes.

cancellationToken

Cancellation token.

EnqueueMessage

protected void EnqueueMessage(TSubscription[] subscribers, Func<TSubscription, TClientSession, string, CancellationToken, ValueTask<bool>> handler, CancellationToken cancellationToken)

baseProtocolServer.EnqueueMessage(subscribers, handler, cancellationToken)

多个订阅者的语句( 有 bul results) 。

subscribers

Subscribers to write to.

handler

Writes the message for one subscriber and answers when it wrote nothing.

cancellationToken

Cancellation token.

EnqueueMessage

protected void EnqueueMessage(TSubscription subscription, Func<TSubscription, TClientSession, string, CancellationToken, ValueTask> handler, CancellationToken cancellationToken)

baseProtocolServer.EnqueueMessage(subscription, handler, cancellationToken)

单项订阅的队列消息 。

subscription

The subscription the write belongs to. Its session and request id address the write.

handler

Writes the message. It always writes.

cancellationToken

Cancellation token.

EnqueueMessage

protected void EnqueueMessage(TSubscription subscription, Func<TSubscription, TClientSession, string, CancellationToken, ValueTask<bool>> handler, CancellationToken cancellationToken)

baseProtocolServer.EnqueueMessage(subscription, handler, cancellationToken)

单项订阅的队列消息( 带有 bul results) 。

subscription

The subscription the write belongs to. Its session and request id address the write.

handler

Writes the message and answers when it wrote nothing.

cancellationToken

Cancellation token.

EnqueueMessage

protected void EnqueueMessage(TClientSession session, Func<TClientSession, CancellationToken, ValueTask> handler, CancellationToken cancellationToken)

baseProtocolServer.EnqueueMessage(session, handler, cancellationToken)

Enqueue a write addressed to a session rather than to a subscription: session-level traffic answers no request, so the handler takes neither a subscription nor a request id.

session

Session to write to.

handler

Writes the message. It always writes.

cancellationToken

Cancellation token.

EnqueueMessage

private void EnqueueMessage(TSubscription subscription, TClientSession session, string requestId, Func<TSubscription, TClientSession, string, CancellationToken, ValueTask<bool>> handler, CancellationToken cancellationToken)

baseProtocolServer.EnqueueMessage(subscription, session, requestId, handler, cancellationToken)

核心入会:安排客户会话的工作.

GetRawId

protected static string GetRawId(long id)

result = BaseProtocolServer.GetRawId(id)

The transaction id as text, for an answer the client named no id of its own for.

id

The transaction id.

返回值: The id as text, or an empty string when there is no id.

GetSessionKey

protected abstract string GetSessionKey(TClientSession session)

result = baseProtocolServer.GetSessionKey(session)

获取用于分组客户端会话的密钥(e.g. SenderCompId) 。

GetSubscriptions

public IEnumerable<ServerSubscription> GetSubscriptions(IMessageListenerSession session)

result = baseProtocolServer.GetSubscriptions(session)

获取指定会话的订阅 。

session

届会。

返回值: 订阅.

HandLiveOrderToLiveConnection

protected void HandLiveOrderToLiveConnection(TClientSession addressee, Message message)

baseProtocolServer.HandLiveOrderToLiveConnection(addressee, message)

Hands a report of a live order to a connection of the client that placed it, when the connection that placed it has gone.

addressee

The connection the module addressed the report to, or .

message

What the module sent.

HasSubscriptions

public bool HasSubscriptions(DataType dataType, SecurityId securityId)

result = baseProtocolServer.HasSubscriptions(dataType, securityId)

Are there subscribers.

IsAnotherSessionsSubscription

protected bool IsAnotherSessionsSubscription(TClientSession session, long transactionId)

result = baseProtocolServer.IsAnotherSessionsSubscription(session, transactionId)

Whether the subscription a session named is one only another session holds.

session

The session asking.

transactionId

The subscription it named.

返回值: when the subscription belongs to somebody else.

IsOrphanStatusRow

protected bool IsOrphanStatusRow(ExecutionMessage execMsg)

result = baseProtocolServer.IsOrphanStatusRow(execMsg)

Whether an order row names no portfolio, so no status subscription is handed it: client connectors refuse an order with an empty portfolio. The answer to a command goes out regardless.

execMsg

The execution report.

返回值: when status subscriptions are not handed the row.

IsStubSubscription

protected abstract bool IsStubSubscription(TSubscription subscription)

result = baseProtocolServer.IsStubSubscription(subscription)

检查订阅是否为分页( 位置持有者) 。

LoadAsync

public override Task LoadAsync(SettingsStorage storage, CancellationToken cancellationToken)

result = baseProtocolServer.LoadAsync(storage, cancellationToken)

Load settings.

storage

Settings storage.

cancellationToken

CancellationToken

返回值: Task

OnClearListenerState

protected abstract void OnClearListenerState()

baseProtocolServer.OnClearListenerState()

清除协议特定听众状态(停止听众等).

OnStartListeners

protected abstract void OnStartListeners(CancellationToken cancellationToken)

baseProtocolServer.OnStartListeners(cancellationToken)

Start protocol-specific listeners (TCP, etc.). Add tasks to _backgroundTasks.

ProcessInMessage

protected abstract void ProcessInMessage(IMessageListenerSession addressee, Message message, CancellationToken cancellationToken)

baseProtocolServer.ProcessInMessage(addressee, message, cancellationToken)

Process an incoming message and route to subscribed clients.

addressee

The only session the message is for, or when it is for every subscriber to it.

ProcessLogout

protected virtual void ProcessLogout(TClientSession session)

baseProtocolServer.ProcessLogout(session)

处理客户端的登录/断开连接.

RaiseNewOutMessage

protected void RaiseNewOutMessage(IMessageListenerSession session, Message message)

baseProtocolServer.RaiseNewOutMessage(session, message)

将发送的消息写入频道 。

RaiseSessionConnected

protected void RaiseSessionConnected(IMessageListenerSession session)

baseProtocolServer.RaiseSessionConnected(session)

提高会话连接事件 。

RaiseSessionDisconnected

protected void RaiseSessionDisconnected(IMessageListenerSession session)

baseProtocolServer.RaiseSessionDisconnected(session)

提升会话断开的事件 。

ReleaseClOrdIdOfEndedOrder

protected void ReleaseClOrdIdOfEndedOrder(TSubscription[] subscriptions, ExecutionMessage execMsg)

baseProtocolServer.ReleaseClOrdIdOfEndedOrder(subscriptions, execMsg)

Gives a client order id back once the order holding it has ended, so the client may number its next order the same way.

subscriptions

The subscriptions the report is going to.

execMsg

The execution report.

ReleaseOrderTransactionId

protected void ReleaseOrderTransactionId(TClientSession session, string clientCode, long transactionId)

baseProtocolServer.ReleaseOrderTransactionId(session, clientCode, transactionId)

Gives back the number an order holds, once the order has ended or its command did not go on after all.

session

A session of the client.

clientCode

The client an order of a service login belongs to; ignored for any other login.

transactionId

The transaction the order travels under.

RemoveSubscription

public bool RemoveSubscription(ServerSubscription subscription)

result = baseProtocolServer.RemoveSubscription(subscription)

删除订阅 。

subscription

订阅.

返回值: ,否则。

RequestIdOf

protected static string RequestIdOf(long transactionId)

result = BaseProtocolServer.RequestIdOf(transactionId)

The id a transaction goes out under, or for none.

transactionId

The transaction id.

返回值: The id as text, or when there is no id.

Resume

public bool Resume(ServerSubscription subscription)

result = baseProtocolServer.Resume(subscription)

继续订阅。

subscription

订阅.

返回值: ,否则。

Resume

public void Resume(IMessageListenerSession session)

baseProtocolServer.Resume(session)

复会.

session

届会。

RunAsync

public IAsyncEnumerable<ValueTuple<IMessageListenerSession, Message>> RunAsync(CancellationToken cancellationToken)

result = baseProtocolServer.RunAsync(cancellationToken)

运行同步消息处理并返回发送的消息为 IAsyncEnumerable 。 打开服务器开始, 关闭结束 。

SaveAsync

public override Task SaveAsync(SettingsStorage storage, CancellationToken cancellationToken)

result = baseProtocolServer.SaveAsync(storage, cancellationToken)

Save settings.

storage

Settings storage.

cancellationToken

CancellationToken

返回值: Task

ScheduleSessionWork

protected abstract void ScheduleSessionWork(TClientSession session, ServerSubscription subscription, string requestId, Func<TClientSession, string, CancellationToken, ValueTask<bool>> handler)

baseProtocolServer.ScheduleSessionWork(session, subscription, requestId, handler)

客户端会话的出行队列的进度安排 。

SendInMessage

public virtual bool SendInMessage(IMessageListenerSession session, Message message)

result = baseProtocolServer.SendInMessage(session, message)

Send a message to one named session.

session

The session the message is for.

message

The message.

返回值: when it was taken for sending.

SendInMessage

public virtual bool SendInMessage(Message message)

result = baseProtocolServer.SendInMessage(message)

将收到的邮件发送到服务器,以便处理和路由给客户端.

StartServer

protected void StartServer(CancellationToken cancellationToken)

baseProtocolServer.StartServer(cancellationToken)

启动服务器:初始化状态,启动听众和背景任务.

StateConditionalOrderType

protected static void StateConditionalOrderType(OrderReplaceMessage replace)

BaseProtocolServer.StateConditionalOrderType(replace)

Takes a replace carrying a condition for the replace of a conditional order, as a registration carrying one places one: a replace may leave its type unsaid.

replace

The replace as it was read.

StopServer

protected void StopServer()

baseProtocolServer.StopServer()

停止服务器:取消任务,完整频道,清晰状态.

Suspend

public bool Suspend(ServerSubscription subscription)

result = baseProtocolServer.Suspend(subscription)

暂停订阅 。

subscription

订阅.

返回值: ,否则。

Suspend

public void Suspend(IMessageListenerSession session)

baseProtocolServer.Suspend(session)

暂停会话。

session

届会。

ToTransactionId

protected static long ToTransactionId(string requestId)

result = BaseProtocolServer.ToTransactionId(requestId)

The transaction id a request runs under: the number its client gave it.

requestId

The id the client gave the request.

返回值: The transaction id.

TryAuthorizeAsync

protected Task<ValueTuple<string, long>> TryAuthorizeAsync(string login, string password, EndPoint remoteEndPoint, CancellationToken cancellationToken)

result = baseProtocolServer.TryAuthorizeAsync(login, password, remoteEndPoint, cancellationToken)

Check a client's credentials, honouring the login rate limiter.

login

The login the client offered.

password

The password the client offered.

remoteEndPoint

Where the client connected from.

cancellationToken

CancellationToken

返回值: The session token and the broker user behind the login, or when the client is refused. A refusal carries no reason: rate limited, unknown login and wrong password are one answer, so nothing here tells a caller which half of the credentials it got right.

TryClaimOrderTransactionId

protected bool TryClaimOrderTransactionId(TClientSession session, string clientCode, string clOrdId, long? orderId, long transactionId, Exception refusal)

result = baseProtocolServer.TryClaimOrderTransactionId(session, clientCode, clOrdId, orderId, transactionId, refusal)

Claims the ClOrdId an order command opens under, which is also the transaction id it runs on.

session

Client session.

clientCode

The client the order is for, which a service login names.

clOrdId

The id the client gave the order.

orderId

The id the order is written down under, or when the command names none.

transactionId

The transaction id the order runs on.

refusal

Why the order is refused, when it is.

返回值: when the order may go on.

TryReadCancelTransactionId

protected bool TryReadCancelTransactionId(TClientSession session, string clientCode, string clOrdId, long transactionId, Exception refusal)

result = baseProtocolServer.TryReadCancelTransactionId(session, clientCode, clOrdId, transactionId, refusal)

The transaction id a command that opens no order runs on: a cancel, a mass cancel, or a replace that names its order by the order's id alone.

session

Client session.

clientCode

The client the command is for, which a service login names.

clOrdId

The id the client gave the command.

transactionId

The transaction id the command runs on.

refusal

Why the command is refused, when it is.

返回值: when the command may go on.

TryReadOrderTransactionId

protected static bool TryReadOrderTransactionId(string clOrdId, long transactionId, Exception refusal)

result = BaseProtocolServer.TryReadOrderTransactionId(clOrdId, transactionId, refusal)

The transaction id of the order a ClOrdId names.

clOrdId

The ClOrdId.

transactionId

The transaction id.

refusal

Why the ClOrdId is refused, when it is not a positive whole number.

返回值: when the ClOrdId is such a number.

TryReadOrigTransactionId

protected static bool TryReadOrigTransactionId(string origClOrdId, long transactionId, Exception refusal)

result = BaseProtocolServer.TryReadOrigTransactionId(origClOrdId, transactionId, refusal)

The client's number of the order a cancel or a replace names, or zero when it names the order by the order's id alone.

origClOrdId

The OrigClOrdId the command carries.

transactionId

The order's number, or zero.

refusal

Why the command is refused, when it is.

返回值: when the command may go on.

TryTakeReplaceTransactionId

protected bool TryTakeReplaceTransactionId(TClientSession session, string clientCode, string clOrdId, long? orderId, bool isMove, long transactionId, Exception refusal)

result = baseProtocolServer.TryTakeReplaceTransactionId(session, clientCode, clOrdId, orderId, isMove, transactionId, refusal)

The transaction id a replace runs on.

session

Client session.

clientCode

The client the replace is for, which a service login names.

clOrdId

The id the client gave the replace.

orderId

The id the order is written down under, or when the replace names none.

isMove

Whether the replace names the client's previous number of the order.

transactionId

The transaction id the replace runs on.

refusal

Why the replace is refused, when it is.

返回值: when the replace may go on.

TryToTransactionId

protected static bool TryToTransactionId(string requestId, long transactionId)

result = BaseProtocolServer.TryToTransactionId(requestId, transactionId)

The transaction id a request names, when the id its client gave is a positive whole number.

requestId

The id the client gave the request.

transactionId

The transaction id.

返回值: when the id is such a number.

SessionConnected

public event Action<IMessageListenerSession> SessionConnected

baseProtocolServer.SessionConnected += handler

会话连接事件 。

SessionDisconnected

public event Action<IMessageListenerSession> SessionDisconnected

baseProtocolServer.SessionDisconnected += handler

会话断开事件 。

StateChanged

public event Action StateChanged

baseProtocolServer.StateChanged += handler

州变事.

SubscriptionChanged

public event Action<ServerSubscription> SubscriptionChanged

baseProtocolServer.SubscriptionChanged += handler

客户订阅更改事件 。

_backgroundTasks

protected readonly List<Task> _backgroundTasks

value = baseProtocolServer._backgroundTasks

背景任务(接受客户端,处理消息等).

_changedSubscriptions

protected readonly SynchronizedSet<ServerSubscription> _changedSubscriptions

value = baseProtocolServer._changedSubscriptions

更改订阅,等待通知。

_clientSessions

protected readonly CachedSynchronizedDictionary<string, CachedSynchronizedList<TClientSession>> _clientSessions

value = baseProtocolServer._clientSessions

按会话键分组的客户会话(e.g. SenderCompId.).

_incomingMessages

protected readonly Channel<ValueTuple<IMessageListenerSession, Message>> _incomingMessages

value = baseProtocolServer._incomingMessages

来电消息频道.

_outgoingMessages

protected readonly Channel<ValueTuple<IMessageListenerSession, Message>> _outgoingMessages

value = baseProtocolServer._outgoingMessages

正在发送消息通道(会话+消息对).

_subscriptions

protected readonly SessionSubscriptions<TSubscription, TClientSession> _subscriptions

value = baseProtocolServer._subscriptions

订阅机持有者.