RuntimeExtensions - класс

Методы-расширения для пространства имён Tessa.Platform.Runtime.

Definition

Пространство имён: Tessa.Platform.Runtime
Сборка: Tessa (в Tessa.dll) Версия: 3.6.0.22
C#
public static class RuntimeExtensions
Inheritance
Object    RuntimeExtensions

Методы

CheckSealed Выбрасывает исключение ConfigurationSealedException, если система находится в режиме защиты от изменений в конфигурации Sealed.
CheckStrictSecurity Выбрасывает исключение ConfigurationStrictSecurityException, если система находится в режиме защиты повышенной безопасности в конфигурации StrictSecurity.
CreateNestedSessionToken Создаёт токен SessionToken для сотрудника с заданными настройками, но наследующий информацию по серверу и текущей культуре из текущей сессии session. Используйте возвращённый токен в объекте SessionContext, который создаётся для выполнения действий в пределах уже существующей сессии, например, со стороны веб-сервисов.
CreateWcfServiceT(IUnityContainer, String, HttpClientCredentialType, String, ActionChannelFactoryT, FuncSessionServiceAttribute, Binding) Создаёт прокси для обращения к веб-сервису T с атрибутом SessionServiceAttribute.
CreateWcfServiceT(IUnityContainer, IConnectionSettings, String, HttpClientCredentialType, String, ActionChannelFactoryT, FuncSessionServiceAttribute, Binding) Создаёт прокси для обращения к веб-сервису T с атрибутом SessionServiceAttribute.
ExecuteWithExceptionCheckAsyncTExtension, TExtensionContext(IExtensionExecutorTExtension, ExpressionExtensionMethodReferenceAsyncTExtension, TExtensionContext, TExtensionContext, ILogger, FuncIExtensionStrategyContext, ValueTask, Boolean) Выполняет заданный метод расширений с обработкой исключений, при возникновении которых они логируются объектом Logger.
ExecuteWithExceptionCheckAsyncTExtension, TExtensionContext(IExtensionExecutorTExtension, ExpressionExtensionMethodReferenceAsyncTExtension, TExtensionContext, TExtensionContext, IMessageProvider, FuncIExtensionStrategyContext, ValueTask, Boolean) Выполняет заданный метод расширений с обработкой исключений, при возникновении которых они обрабатываются объектом IMessageProvider, например, логируются и выводятся пользователю.
FinalizeSessionsOnClient Выполняет финализацию для процесса регистрации сессий на стороне клиента. Метод должен быть вызван после того, как все регистрации в контейнере будут завершены.
GenerateSignature Создаёт подпись для заданных свойств, связанных с сессией.
GetLicenseCount Возвращает количество доступных лицензий для заданного типа licenseType. Для типа Unspecified возвращается -1.
GetNameWithBitness Возвращает имя приложения с суффиксом, указывающим на его 64-битность (если процесс 64-битный).
GetSessionExceptionCode Возвращает код исключения, выброшенного на сервере как SessionException, или Unknown, если код исключения получить не удалось.
IsAdministrator Возвращает признак того, что пользователь является администратором системы.
IsConcurrent Возвращает признак того, что лицензия заданного типа является конкурентной.
IsDesktopClient Возвращает признак того, что сессия была открыта с десктопного клиента (т.е. с "толстого" клиента). Это могут быть приложения TessaAdmin, TessaClient, консольный tadmin, интеграционный веб-сервис и др.
IsExceptionCritical Возвращает признак того, что указанное исключение относится в разряд критических и должно привести к завершению приложения.
IsInvalidLoginOrPassword Возвращает признак того, что заданный код ошибки связан с некорректным логином или паролем.
IsLoginHiddenException Возвращает признак того, что исключение не отображается пользователю, когда оно возникло при входе в систему. Например, пользователь не входит в домен.
IsNotWebOrDesktopClient Возвращает признак того, что сессия была открыта не с десктопного клиента и не с Web-клиента. Обычно это плагины Chronos, интеграционные веб-сервисы с собственной авторизацией и другие приложения.
IsPersonal Возвращает признак того, что лицензия заданного типа является персональной.
IsRegular Возвращает признак того, что пользователь является обычным пользователем.
IsUnauthorizedWebException Возвращает признак того, что исключение является ошибкой с кодом ошибки 401: Unauthorized. Обычно такое исключение происходит при неудачной авторизации Windows. Учитывает агрегирование асинхронных исключений.
IsWebClient Возвращает признак того, что сессия была открыта с Web-клиента (т.е. с "лёгкого" клиента). Это или Web-клиент Tessa, или интеграция через Web API.
RegisterApplicationExtensionTypes Выполняет регистрацию стандартных типов расширений для API инициализации на клиенте.
RegisterApplicationsTraceListeners Выполняет регистрацию объектов, отслеживающих события, происходящие при выполнении расширений на инициализацию приложения со стороны сервера, и записывающие результат выполнения в ValidationResult как информационное сообщение. Это полезно при отладке расширений, но сильно нагружает любое взаимодействие с плитками, поэтому рекомендуется не выполнять такую регистрацию в среде, с которой работают конечные пользователи.
RegisterConnectionSettingsFromConfiguration Регистрирует зависимость IConnectionSettings со значениями, полученными из менеджера конфигурации IConfigurationManager, также зарегистрированного в Unity (он может быть зарегистрирован вызовом RegisterPlatformSharedDependencies(IUnityContainer)). Обычно конфигурация расположена в файле app.json.
RegisterExtensionTracingOnServer Регистрирует зависимости, связанные с трассировкой расширений со стороны сервера.
RegisterSessionsOnClient Выполняет регистрацию сессии на стороне клиента по токену Tessa, а также регистрирует объект IApplicationDescriptor и некоторые другие зависимости для обеспечения работы сессии, в т.ч. RegisterWebProxyFactory(IUnityContainer). После выполнения всех регистраций в контейнере рекомендуется вызвать метод FinalizeSessionsOnClient(IUnityContainer).
RegisterSessionsOnServer Регистрирует реализацию сессий на сервере.
RegisterWcfServiceT(IUnityContainer, String) Регистрирует прокси для обращения к веб-сервису T с атрибутом SessionServiceAttribute.
RegisterWcfServiceT(IUnityContainer, IConnectionSettings, String) Регистрирует прокси для обращения к веб-сервису T с атрибутом SessionServiceAttribute.
RegisterWebProxyFactory Выполняет регистрацию фабрики прокси-объектов IWebProxyFactory и некоторых её зависимостей.
RemoveApplicationsTraceListeners Удаляет объекты, зарегистрированные методом RegisterApplicationsTraceListeners(IExtensionContainer, ExtensionTraceListenerType, NullableInt64). Частая регистрация с последующим удалением объектов значительно нагружает память и CPU.
ReportErrorSafeAsync Сообщает об ошибке с заданными параметрами и с необязательным дополнительным описанием, в т.ч. с файлами. Для ошибки создаётся карточка с детальным описанием и с заданным идентификатором, в которой можно выполнять поиск по категории и тексту. Если при отправке ошибки возникло любое исключение, то оно поглощается и заносится в лог Error Метод возвращает идентификатор фактически созданной ошибки или null, если при отправке ошибки возникло исключение.
SetExtensionTracingFromSettingsOnServer Настраивает зависимости, связанные с трассировкой расширений на карточки, по информации из настроек сервера ITessaServerSettings, зарегистрированных в контейнере.
ToFaultException Преобразует исключение SessionException в исключение FaultException с корректной информацией по коду ошибки.
VerifySignature(ISignatureProvider, ISessionToken) Выполняет проверку подписи для заданного токена ISessionToken и возвращает признак того, что подпись корректна.
VerifySignature(ISignatureProvider, Guid, String, String, String) Выполняет проверку подписи для заданных свойств, связанных с сессией, и возвращает признак того, что подпись корректна.
WhenAnyApplication Регистрирует политику фильтрации выполнения методов расширений по любым типам приложений. Используйте для замещения политики, назначенной посредством метода WhenApplications(IExtensionPolicyContainer, Guid). Для того, чтобы политика использовалась, требуется зарегистрировать политику ApplicationExtensionFilterPolicy.
WhenApplicationFunc Регистрирует политику фильтрации выполнения методов расширений IApplicationExtension в соответствии с функцией isAllowedFunc, которая проверяет контекст расширений. Если зарегистрировано несколько политик, то должны выполняться все из них.
WhenApplications Регистрирует политику фильтрации выполнения методов расширений по идентификатору типа приложения, который входит в заданный список идентификаторов. Для того, чтобы политика использовалась, требуется зарегистрировать политику ApplicationExtensionFilterPolicy. Регистрация добавляет значение к списку приложений, а не переопределяет его.

См. также