JournaledGrain<TGrainState> Класс

Определение

Пространство имен:

Orleans.EventSourcing

Сборка:

Orleans.EventSourcing.dll

Пакет:

Microsoft.Orleans.EventSourcing v8.2.0

Базовый класс для параметров, согласованных с журналами, с использованием стандартной терминологии для источников событий. Все операции защищены повторной отступом.

public abstract class JournaledGrain<TGrainState> : Orleans.EventSourcing.JournaledGrain<TGrainState,object> where TGrainState : class, new()

type JournaledGrain<'GrainState (requires 'GrainState : null and 'GrainState : (new : unit -> 'GrainState))> = class
    inherit JournaledGrain<'GrainState, obj (requires 'GrainState : null and 'GrainState : (new : unit -> 'GrainState))>

Public MustInherit Class JournaledGrain(Of TGrainState)
Inherits JournaledGrain(Of TGrainState, Object)

Параметры типа

TGrainState

Тип состояния зерна, т. е. статистическое представление журнала событий.

Наследование

Object

Grain

LogConsistentGrain<TGrainState>

JournaledGrain<TGrainState,Object>

JournaledGrain<TGrainState>

Конструкторы

JournaledGrain<TGrainState>()

Инициализирует новый экземпляр класса JournaledGrain<TGrainState>.

Свойства

DefaultAdaptorFactory	Если не указан поставщик согласованности журналов, сохраните состояние версии с помощью поставщика хранилища по умолчанию. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
GrainContext	Базовый класс для параметров, согласованных с журналами, с использованием стандартной терминологии для источников событий. Все операции защищены повторной отступом. (Унаследовано от Grain)
GrainFactory	Получает объект, который можно использовать для доступа к другим зернам. Значение NULL, если это зерно не связано с средой выполнения, например при создании непосредственно для модульного тестирования. (Унаследовано от Grain)
GrainReference	Базовый класс для параметров, согласованных с журналами, с использованием стандартной терминологии для источников событий. Все операции защищены повторной отступом. (Унаследовано от Grain)
IdentityString	Строковое представление SiloIdentity зерна, включая тип и первичный ключ. (Унаследовано от Grain)
RuntimeIdentity	Уникальный идентификатор текущего сило. В этой строке нет семантического содержимого, но это может быть полезно для ведения журнала. (Унаследовано от Grain)
ServiceProvider	Возвращает IServiceProvider, управляемый средой выполнения. Значение NULL, если это зерно не связано с средой выполнения, например при создании непосредственно для модульного тестирования. (Унаследовано от Grain)
State	Возвращает текущее подтвержденное состояние. Включает только подтвержденные события. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
TentativeState	Возвращает текущее предварительное состояние. Включает как подтвержденные, так и неподтвержденные события. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
UnconfirmedEvents	Возвращает текущую очередь неподтвержденных событий. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
UnresolvedConnectionIssues	Возвращает список всех проблем с подключением, которые в настоящее время не решены. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
Version	Возвращает версию текущего подтвержденного состояния. Равно общему количеству подтвержденных событий. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)

Методы

ConfirmEvents()	Ожидает, пока все ранее поднятые события не были подтверждены. дождитесь этого после вызова одного или нескольких событий, чтобы обеспечить сохранение событий перед продолжением или обеспечить надежную согласованность (линейнейность), даже если существует несколько экземпляров этого зерна. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
DeactivateOnIdle()	Деактивируйте эту активацию зерна после завершения текущего вызова метода зерна. Этот вызов помечает эту активацию текущего зерна, который будет деактивирован и удален в конце текущего метода. Следующий вызов этого зерна приведет к использованию другой активации, что обычно означает, что новая активация будет создана автоматически средой выполнения. (Унаследовано от Grain)
DelayDeactivation(TimeSpan)	Задержка деактивации этой активации по крайней мере в течение указанного периода времени. Положительное значение timeSpan означает "запретить GC этой активации в течение этого периода времени". Отрицательное значение timeSpan означает "отмена предыдущего параметра вызова DelayDeactivation и выполнение этой активации в зависимости от обычных параметров сборки мусора активации". Метод ДеактивацииOnIdle отменяет или переопределяет любой текущий параметр "сохранить в живых", что делает это зерно немедленно доступным для деактивации. (Унаследовано от Grain)
DisableStatsCollection()	Базовый класс для параметров, согласованных с журналами, с использованием стандартной терминологии для источников событий. Все операции защищены повторной отступом. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
EnableStatsCollection()	Базовый класс для параметров, согласованных с журналами, с использованием стандартной терминологии для источников событий. Все операции защищены повторной отступом. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
GetLogger()	Возвращает объект средства ведения журнала, который код этого зерна может использовать для трассировки. Имя средства ведения журнала будет производным от имени класса зерна. (Унаследовано от Grain)
GetLogger(String)	Возвращает объект средства ведения журнала, который код этого зерна может использовать для трассировки. (Унаследовано от Grain)
GetReminder(String)	Возвращает ранее зарегистрированное напоминание. (Унаследовано от Grain)
GetReminders()	Возвращает список всех напоминаний, зарегистрированных зерном. (Унаследовано от Grain)
GetStats()	Базовый класс для параметров, согласованных с журналами, с использованием стандартной терминологии для источников событий. Все операции защищены повторной отступом. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
GetStreamProvider(String)	Базовый класс для параметров, согласованных с журналами, с использованием стандартной терминологии для источников событий. Все операции защищены повторной отступом. (Унаследовано от Grain)
GetStreamProviders()	Базовый класс для параметров, согласованных с журналами, с использованием стандартной терминологии для источников событий. Все операции защищены повторной отступом. (Унаследовано от Grain)
InstallAdaptor(ILogViewAdaptorFactory, Object, String, IGrainStorage, ILogConsistencyProtocolServices)	Вызывается сразу после создания зерна, чтобы установить адаптер. Поставщик согласованности журналов содержит метод фабрики, который создает адаптер с выбранными типами для этого зерна. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
InstallAdaptor(ILogViewAdaptorFactory, Object, String, IGrainStorage, ILogConsistencyProtocolServices)	Вызывается сразу после создания зерна, чтобы установить адаптер. Поставщик согласованности журналов содержит метод фабрики, который создает адаптер с выбранными типами для этого зерна. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
MigrateOnIdle()	Запускает попытку переноса этого экземпляра в другое расположение. Миграция фиксирует текущую RequestContext, что делает его доступным для директора размещения активации, чтобы он смог рассмотреть его при выборе нового расположения. Миграция будет выполняться асинхронно, если запросы не выполняются, и не произойдет, если директор размещения активации не выбирает альтернативное расположение. (Унаследовано от Grain)
OnActivateAsync()	По умолчанию после активации журнальное зерно ожидает, пока он не загрузит последнее представление из хранилища. Подклассы могут переопределить это поведение и пропустить ожидание при необходимости. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
OnActivateAsync(CancellationToken)	По умолчанию после активации журнальное зерно ожидает, пока он не загрузит последнее представление из хранилища. Подклассы могут переопределить это поведение и пропустить ожидание при необходимости. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
OnConnectionIssue(ConnectionIssue)	Вызывается, когда базовый протокол сохраняемости или репликации возникает в некоторых проблемах подключения. Переопределите это для отслеживания работоспособности протокола согласованности журналов и (или) настройки задержек повторных попыток. Все создаваемые исключения перехватываются и регистрируются ILogViewAdaptorFactory. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
OnConnectionIssue(ConnectionIssue)	Вызывается, когда базовый протокол сохраняемости или репликации возникает в некоторых проблемах подключения. Переопределите это для отслеживания работоспособности протокола согласованности журналов и (или) настройки задержек повторных попыток. Все создаваемые исключения перехватываются и регистрируются ILogConsistencyProvider. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
OnConnectionIssueResolved(ConnectionIssue)	Вызывается при устранении ранее сообщаемой проблемы подключения. Переопределите это, чтобы отслеживать работоспособность протокола согласованности журналов. Все создаваемые исключения перехватываются и регистрируются ILogConsistencyProvider. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
OnConnectionIssueResolved(ConnectionIssue)	Вызывается при устранении ранее сообщаемой проблемы подключения. Переопределите это, чтобы отслеживать работоспособность протокола согласованности журналов. Все создаваемые исключения перехватываются и регистрируются ILogViewAdaptorFactory. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
OnDeactivateAsync()	Этот метод вызывается в начале процесса деактивации зерна. (Унаследовано от Grain)
OnDeactivateAsync(DeactivationReason, CancellationToken)	Этот метод вызывается в начале процесса деактивации зерна. (Унаследовано от Grain)
OnStateChanged()	Вызывается после изменения подтвержденного состояния (т. е. подтвержденного номера версии больше). Переопределите это, чтобы реагировать на изменения подтвержденного состояния. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
OnTentativeStateChanged()	Вызывается всякий раз, когда предварительное состояние может измениться из-за локальных или удаленных событий. Переопределите это, чтобы реагировать на изменения состояния. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
Participate(IGrainLifecycle)	Базовый класс для параметров, согласованных с журналами, с использованием стандартной терминологии для источников событий. Все операции защищены повторной отступом. (Унаследовано от LogConsistentGrain<TView>)
RaiseConditionalEvent<TEvent>(TEvent)	Условное создание события. Выполняется только в том случае, если нет конфликтов, то есть никакие другие события не были вызваны в то же время. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
RaiseConditionalEvents<TEvent>(IEnumerable<TEvent>)	Вызывает несколько событий, как атомарную последовательность, условно. Выполняется только в том случае, если нет конфликтов, то есть никакие другие события не были вызваны в то же время. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
RaiseEvent<TEvent>(TEvent)	Вызывает событие. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
RaiseEvents<TEvent>(IEnumerable<TEvent>)	Вызов нескольких событий в виде атомарной последовательности. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
RefreshNow()	Извлекает последнее состояние и подтверждает все ранее созданные события. Фактически это обеспечивает синхронизацию с глобальным состоянием. Дождитесь этого перед чтением состояния, чтобы обеспечить строжную согласованность (линейная доступность) даже в нескольких экземплярах этого зерна. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
RegisterOrUpdateReminder(String, TimeSpan, TimeSpan)	Регистрирует постоянное, надежное напоминание для отправки регулярных уведомлений (напоминаний) на зерно. Зерно должно реализовать интерфейс Orleans.IRemindable, а напоминания об этом зерне будут отправлены в метод обратного вызова ReceiveReminder. Если текущее зерно деактивируется при срабатывании таймера, для получения этого напоминания будет создана новая активация этого зерна. Если существующее напоминание с тем же именем уже существует, это напоминание будет перезаписан с этим новым напоминанием. Напоминания всегда будут получены одной активацией этого зерна, даже если для этого зерна существует несколько активаций. (Унаследовано от Grain)
RegisterTimer(Func<Object,Task>, Object, TimeSpan, TimeSpan)	Устаревшие.. Регистрирует таймер для отправки периодических обратных вызовов в это зерно. (Унаследовано от Grain)
RetrieveConfirmedEvents(Int32, Int32)	Извлекает сегмент подтвержденной последовательности событий, возможно, из хранилища. Вызывает NotSupportedException, если события недоступны для чтения. Доступны ли события и насколько долго они зависят от используемых поставщиков и способа их настройки. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
TransitionState(TGrainState, TEventBase)	Определяет, как применять события к состоянию. Если она не переопределяется в подклассе, она вызывает динамическую функцию Apply в состоянии с событием в качестве параметра. Все исключения, создаваемые этим методом, перехватываются и регистрируются поставщиком представления журнала. Переопределите эту настройку, чтобы настроить переход состояния для данного события. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
UnregisterReminder(IGrainReminder)	Отменяет регистрацию ранее зарегистрированного напоминания. (Унаследовано от Grain)

Явные реализации интерфейса

IConnectionIssueListener.OnConnectionIssue(ConnectionIssue)	вызывается адаптером по проблемам подключения. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
IConnectionIssueListener.OnConnectionIssueResolved(ConnectionIssue)	Вызывается адаптером при устранении проблемы с подключением. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
ILogConsistencyProtocolParticipant.DeactivateProtocolParticipant()	Уведомление адаптера представления журнала об деактивации (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
ILogConsistencyProtocolParticipant.PostActivateProtocolParticipant()	Уведомлять адаптер представления журнала активации (вызывается после активации на уровне пользователя) (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
ILogConsistencyProtocolParticipant.PreActivateProtocolParticipant()	Уведомлять адаптер представления журнала активации (вызывается до активации на уровне пользователя) (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
ILogViewAdaptorHost<TGrainState,TEventBase>.OnViewChanged(Boolean, Boolean)	Вызывается адаптером при изменении состояния. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)
ILogViewAdaptorHost<TGrainState,TEventBase>.UpdateView(TGrainState, TEventBase)	Вызывается адаптером для обновления представления при добавлении записей. (Унаследовано от JournaledGrain<TGrainState,TEventBase>)

Методы расширения

DeactivateOnIdle(IGrainBase)	Деактивируйте эту активацию зерна после завершения текущего вызова метода зерна. Этот вызов помечает эту активацию текущего зерна, который будет деактивирован и удален в конце текущего метода. Следующий вызов этого зерна приведет к использованию другой активации, что обычно означает, что новая активация будет создана автоматически средой выполнения.
MigrateOnIdle(IGrainBase)	Запускает попытку переноса этого экземпляра в другое расположение. Миграция фиксирует текущую RequestContext, что делает его доступным для директора размещения активации, чтобы он смог рассмотреть его при выборе нового расположения. Миграция будет выполняться асинхронно, если запросы не выполняются, и не произойдет, если директор размещения активации не выбирает альтернативное расположение.
RegisterGrainTimer(IGrainBase, Func<CancellationToken,Task>, GrainTimerCreationOptions)	Создает таймер зерна.
RegisterGrainTimer(IGrainBase, Func<CancellationToken,Task>, TimeSpan, TimeSpan)	Создает таймер зерна.
RegisterGrainTimer(IGrainBase, Func<Task>, GrainTimerCreationOptions)	Базовый класс для параметров, согласованных с журналами, с использованием стандартной терминологии для источников событий. Все операции защищены повторной отступом.
RegisterGrainTimer(IGrainBase, Func<Task>, TimeSpan, TimeSpan)	Создает таймер зерна.
RegisterGrainTimer<TState>(IGrainBase, Func<TState,CancellationToken,Task>, TState, GrainTimerCreationOptions)	Создает таймер зерна.
RegisterGrainTimer<TState>(IGrainBase, Func<TState,CancellationToken,Task>, TState, TimeSpan, TimeSpan)	Создает таймер зерна.
RegisterGrainTimer<TState>(IGrainBase, Func<TState,Task>, TState, GrainTimerCreationOptions)	Базовый класс для параметров, согласованных с журналами, с использованием стандартной терминологии для источников событий. Все операции защищены повторной отступом.
RegisterGrainTimer<TState>(IGrainBase, Func<TState,Task>, TState, TimeSpan, TimeSpan)	Создает таймер зерна.
AsReference(IAddressable, Type)	Возвращает типизированные ссылки на предоставленное зерно.
AsReference<TGrainInterface>(IAddressable)	Возвращает типизированные ссылки на предоставленное зерно.
Cast(IAddressable, Type)	Возвращает типизированные ссылки на предоставленное зерно.
Cast<TGrainInterface>(IAddressable)	Возвращает типизированные ссылки на предоставленное зерно.
GetGrainId(IAddressable)	Возвращает идентификатор зерна, соответствующий предоставленному зерне.
GetPrimaryKey(IAddressable)	Возвращает Guid представление первичного ключа зерна.
GetPrimaryKey(IAddressable, String)	Возвращает Guid представление первичного ключа зерна.
GetPrimaryKeyLong(IAddressable)	Возвращает long представление первичного ключа зерна.
GetPrimaryKeyLong(IAddressable, String)	Возвращает long представление первичного ключа зерна.
GetPrimaryKeyString(IAddressable)	Возвращает первичный ключ string зерна.
IsPrimaryKeyBasedOnLong(IAddressable)	Возвращает, является ли часть первичного ключа типом long.
GetReminder(Grain, String)	Возвращает ранее зарегистрированное напоминание.
GetReminder(IGrainBase, String)	Возвращает ранее зарегистрированное напоминание.
GetReminders(Grain)	Возвращает список всех напоминаний, зарегистрированных зерном.
GetReminders(IGrainBase)	Возвращает список всех напоминаний, зарегистрированных зерном.
RegisterOrUpdateReminder(Grain, String, TimeSpan, TimeSpan)	Регистрирует постоянное, надежное напоминание для отправки регулярных уведомлений (напоминаний) на зерно. Зерно должно реализовать интерфейс Orleans.IRemindable, а напоминания об этом зерне будут отправлены в метод обратного вызова ReceiveReminder. Если текущее зерно деактивируется при срабатывании таймера, для получения этого напоминания будет создана новая активация этого зерна. Если существующее напоминание с тем же именем уже существует, это напоминание будет перезаписан с этим новым напоминанием. Напоминания всегда будут получены одной активацией этого зерна, даже если для этого зерна существует несколько активаций.
RegisterOrUpdateReminder(IGrainBase, String, TimeSpan, TimeSpan)	Регистрирует постоянное, надежное напоминание для отправки регулярных уведомлений (напоминаний) на зерно. Зерно должно реализовать интерфейс Orleans.IRemindable, а напоминания об этом зерне будут отправлены в метод обратного вызова ReceiveReminder. Если текущее зерно деактивируется при срабатывании таймера, для получения этого напоминания будет создана новая активация этого зерна. Если существующее напоминание с тем же именем уже существует, это напоминание будет перезаписан с этим новым напоминанием. Напоминания всегда будут получены одной активацией этого зерна, даже если для этого зерна существует несколько активаций.
UnregisterReminder(Grain, IGrainReminder)	Отменяет регистрацию ранее зарегистрированного напоминания.
UnregisterReminder(IGrainBase, IGrainReminder)	Отменяет регистрацию ранее зарегистрированного напоминания.
GetStreamProvider(Grain, String)	Возвращает поставщик потоков с указанным name.
GetStreamProvider(IGrainBase, String)	Возвращает поставщик потоков с указанным name.