Dreamine.Hybrid.Wpf.Hosting.DreamineBlazorServerHostedService< TRootComponent >에 대한 상속 다이어그램 :

Dreamine.Hybrid.Wpf.Hosting.DreamineBlazorServerHostedService< TRootComponent >에 대한 협력 다이어그램:

[범례]

Public 멤버 함수
	DreamineBlazorServerHostedService (IServiceProvider rootServiceProvider, IHybridMessageBus messageBus, DreamineBlazorServerHostOptions options)
async Task	StartAsync (CancellationToken cancellationToken)
async Task	StopAsync (CancellationToken cancellationToken)

Private 멤버 함수
void	RegisterSharedServices (IServiceCollection services)

정적 Private 멤버 함수
static void	RegisterViewModels (IServiceCollection services, Assembly assembly)
static bool	TryGetPublishedIndexPath (string contentRootPath, HttpRequest request, out string? indexPath)

Private 속성
readonly IServiceProvider	_rootServiceProvider
readonly IHybridMessageBus	_messageBus
readonly DreamineBlazorServerHostOptions	_options
IHost?	_webHost

상세한 설명

WPF 프로세스 내부에서 Blazor Server 애플리케이션의 생명 주기를 호스팅합니다.

템플릿 파라메터

TRootComponent 매핑할 루트 Razor 구성 요소 형식입니다.

타입 한정자들

TRootComponent

:

IComponent

DreamineBlazorServerHostedService.cs 파일의 35 번째 라인에서 정의되었습니다.

멤버 함수 문서화

◆ DreamineBlazorServerHostedService()

Dreamine.Hybrid.Wpf.Hosting.DreamineBlazorServerHostedService< TRootComponent >.DreamineBlazorServerHostedService	(	IServiceProvider	rootServiceProvider,
		IHybridMessageBus	messageBus,
		DreamineBlazorServerHostOptions	options )

inline

루트 서비스 공급자, 공유 메시지 버스 및 호스트 옵션으로 새 호스팅 서비스를 초기화합니다.

매개변수

rootServiceProvider	WPF 루트 서비스 공급자입니다.
messageBus	공유 하이브리드 메시지 버스입니다.
options	Blazor Server 호스트 옵션입니다.

예외

ArgumentNullException 인수 중 하나가 null인 경우 발생합니다.

DreamineBlazorServerHostedService.cs 파일의 115 번째 라인에서 정의되었습니다.

        {
            _rootServiceProvider = rootServiceProvider ?? throw new ArgumentNullException(nameof(rootServiceProvider));
            _messageBus = messageBus ?? throw new ArgumentNullException(nameof(messageBus));
            _options = options ?? throw new ArgumentNullException(nameof(options));
        }

다음을 참조함 : _messageBus, _options, _rootServiceProvider.

◆ RegisterSharedServices()

void Dreamine.Hybrid.Wpf.Hosting.DreamineBlazorServerHostedService< TRootComponent >.RegisterSharedServices ( IServiceCollection services )

inlineprivate

WPF 루트 공급자의 구성된 서비스 인스턴스를 Blazor Server 컨테이너에 공유합니다.

매개변수

services 공유 서비스를 등록할 Blazor Server 서비스 컬렉션입니다.

예외

InvalidOperationException 공유 서비스가 루트 공급자에 없거나 허용되지 않은 해제 가능 서비스인 경우 발생합니다.

DreamineBlazorServerHostedService.cs 파일의 300 번째 라인에서 정의되었습니다.

        {
            foreach (Type serviceType in _options.SharedServiceTypes)
            {
                object? instance = _rootServiceProvider.GetService(serviceType);
 
                if (instance is null)
                {
                    throw new InvalidOperationException(
                        $"Shared service '{serviceType.FullName}' was not found in the root service provider.");
                }
 
                if (!_options.AllowDisposableSharedServices &&
                    (instance is IDisposable || instance is IAsyncDisposable))
                {
                    throw new InvalidOperationException(
                        $"Shared service '{serviceType.FullName}' implements IDisposable/IAsyncDisposable. " +
                        "Blazor Server would own disposal for services registered into its container. " +
                        "Share a non-disposable facade or explicitly enable AllowDisposableSharedServices when that ownership is intended.");
                }
 
                services.AddSingleton(serviceType, instance);
            }
        }

다음을 참조함 : _options, _rootServiceProvider.

다음에 의해서 참조됨 : StartAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ RegisterViewModels()

void Dreamine.Hybrid.Wpf.Hosting.DreamineBlazorServerHostedService< TRootComponent >.RegisterViewModels	(	IServiceCollection	services,
		Assembly	assembly )

inlinestaticprivate

지정한 어셈블리의 공개 비추상 ViewModel 클래스를 Scoped 서비스로 등록합니다.

매개변수

services	ViewModel을 등록할 서비스 컬렉션입니다.
assembly	검색할 어셈블리입니다.

DreamineBlazorServerHostedService.cs 파일의 349 번째 라인에서 정의되었습니다.

        {
            foreach (Type type in assembly.GetTypes()
                         .Where(type =>
                             type.IsClass &&
                             !type.IsAbstract &&
                             type.IsPublic &&
                             type.Name.EndsWith("ViewModel", StringComparison.Ordinal)))
            {
                services.AddScoped(type);
            }
        }

다음에 의해서 참조됨 : StartAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ StartAsync()

async Task Dreamine.Hybrid.Wpf.Hosting.DreamineBlazorServerHostedService< TRootComponent >.StartAsync ( CancellationToken cancellationToken )

inline

Kestrel, Razor 구성 요소, 공유 서비스 및 미들웨어를 구성하고 내부 웹 호스트를 시작합니다.

매개변수

cancellationToken 호스트 시작 취소 토큰입니다.

반환값: 내부 웹 호스트 시작 작업입니다.

DreamineBlazorServerHostedService.cs 파일의 149 번째 라인에서 정의되었습니다.

        {
            Assembly blazorAssembly = typeof(TRootComponent).Assembly;
 
            WebApplicationBuilder builder = WebApplication.CreateBuilder(new WebApplicationOptions
            {
                Args = Array.Empty<string>(),
                ContentRootPath = _options.ContentRootPath,
                ApplicationName = blazorAssembly.GetName().Name
            });
 
            StaticWebAssetsLoader.UseStaticWebAssets(builder.Environment, builder.Configuration);
 
            builder.Services
                .AddRazorComponents()
                .AddInteractiveServerComponents();
 
            builder.Services.AddSingleton(_messageBus);
 
            RegisterSharedServices(builder.Services);
            _options.ConfigureServices?.Invoke(builder.Services);
 
            if (_options.AutoRegisterViewModels)
            {
                RegisterViewModels(builder.Services, blazorAssembly);
            }
 
            builder.WebHost.ConfigureKestrel(options =>
            {
                if (_options.ListenAnyIp)
                {
                    options.ListenAnyIP(_options.Port);
                    return;
                }
 
                if (string.Equals(_options.Host, "localhost", StringComparison.OrdinalIgnoreCase))
                {
                    options.ListenLocalhost(_options.Port);
                    return;
                }
 
                if (IPAddress.TryParse(_options.Host, out IPAddress? address))
                {
                    options.Listen(address, _options.Port);
                    return;
                }
 
                options.ListenLocalhost(_options.Port);
            });
 
            WebApplication app = builder.Build();
 
            app.UseStaticFiles();
            app.Use(async (context, next) =>
            {
                if (TryGetPublishedIndexPath(app.Environment.ContentRootPath, context.Request, out string? indexPath))
                {
                    context.Response.ContentType = "text/html; charset=utf-8";
                    await context.Response.SendFileAsync(indexPath!);
                    return;
                }
 
                await next();
            });
 
            // 추가 정적 파일(업로드 데이터 등)을 UseRouting 이전에 등록해야
            // Blazor catch-all 라우터보다 먼저 처리됩니다.
            _options.ConfigurePipeline?.Invoke(app);
 
            app.UseRouting();
 
            _options.ConfigurePipelineAfterRouting?.Invoke(app);
 
            app.UseAntiforgery();
 
            app.MapGet("/_dreamine/instance", () => _options.InstanceId);
 
            app.MapRazorComponents<TRootComponent>()
               .AddInteractiveServerRenderMode();
 
            _webHost = app;
 
            await app.StartAsync(cancellationToken);
        }

다음을 참조함 : _messageBus, _options, _webHost, RegisterSharedServices(), RegisterViewModels(), TryGetPublishedIndexPath().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ StopAsync()

async Task Dreamine.Hybrid.Wpf.Hosting.DreamineBlazorServerHostedService< TRootComponent >.StopAsync ( CancellationToken cancellationToken )

inline

실행 중인 내부 웹 호스트를 중지하고 해제합니다.

매개변수

cancellationToken 호스트 중지 취소 토큰입니다.

반환값: 내부 웹 호스트 중지 작업입니다.

DreamineBlazorServerHostedService.cs 파일의 258 번째 라인에서 정의되었습니다.

        {
            if (_webHost is null)
            {
                return;
            }
 
            try
            {
                await _webHost.StopAsync(cancellationToken);
            }
            finally
            {
                _webHost.Dispose();
                _webHost = null;
            }
        }

다음을 참조함 : _webHost.

◆ TryGetPublishedIndexPath()

bool Dreamine.Hybrid.Wpf.Hosting.DreamineBlazorServerHostedService< TRootComponent >.TryGetPublishedIndexPath	(	string	contentRootPath,
		HttpRequest	request,
		out string?	indexPath )

inlinestaticprivate

안전한 디렉터리형 GET 또는 HEAD 요청을 게시된 wwwroot/index.html 파일에 매핑합니다.

매개변수

contentRootPath	애플리케이션 콘텐츠 루트입니다.
request	검사할 HTTP 요청입니다.
indexPath	성공하면 확인된 index.html 절대 경로입니다.

반환값: 안전하고 존재하는 인덱스 파일을 찾았는지 여부입니다.

DreamineBlazorServerHostedService.cs 파일의 402 번째 라인에서 정의되었습니다.

        {
            indexPath = null;
 
            if (!HttpMethods.IsGet(request.Method) && !HttpMethods.IsHead(request.Method))
            {
                return false;
            }
 
            string? requestPath = request.Path.Value;
            if (string.IsNullOrWhiteSpace(requestPath) ||
                string.Equals(requestPath, "/", StringComparison.Ordinal) ||
                !requestPath.EndsWith("/", StringComparison.Ordinal))
            {
                return false;
            }
 
            string[] segments = requestPath
                .Trim('/')
                .Split('/', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
 
            if (segments.Length == 0 ||
                segments.Any(segment => segment is "." or ".." || Path.GetFileName(segment) != segment))
            {
                return false;
            }
 
            string webRoot = Path.GetFullPath(Path.Combine(contentRootPath, "wwwroot"));
            string targetDirectory = webRoot;
            foreach (string segment in segments)
            {
                targetDirectory = Path.Combine(targetDirectory, segment);
            }
 
            string candidate = Path.GetFullPath(Path.Combine(targetDirectory, "index.html"));
            string webRootPrefix = webRoot.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal)
                ? webRoot
                : webRoot + Path.DirectorySeparatorChar;
 
            if (!candidate.StartsWith(webRootPrefix, StringComparison.OrdinalIgnoreCase) || !File.Exists(candidate))
            {
                return false;
            }
 
            indexPath = candidate;
            return true;
        }

다음에 의해서 참조됨 : StartAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

◆ _messageBus

readonly IHybridMessageBus Dreamine.Hybrid.Wpf.Hosting.DreamineBlazorServerHostedService< TRootComponent >._messageBus

private

message Bus 값을 보관합니다.

DreamineBlazorServerHostedService.cs 파일의 55 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : DreamineBlazorServerHostedService(), StartAsync().

◆ _options

readonly DreamineBlazorServerHostOptions Dreamine.Hybrid.Wpf.Hosting.DreamineBlazorServerHostedService< TRootComponent >._options

private

options 값을 보관합니다.

DreamineBlazorServerHostedService.cs 파일의 64 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : DreamineBlazorServerHostedService(), RegisterSharedServices(), StartAsync().

◆ _rootServiceProvider

readonly IServiceProvider Dreamine.Hybrid.Wpf.Hosting.DreamineBlazorServerHostedService< TRootComponent >._rootServiceProvider

private

root Service Provider 값을 보관합니다.

DreamineBlazorServerHostedService.cs 파일의 46 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : DreamineBlazorServerHostedService(), RegisterSharedServices().

◆ _webHost

IHost? Dreamine.Hybrid.Wpf.Hosting.DreamineBlazorServerHostedService< TRootComponent >._webHost

private

web Host 값을 보관합니다.

DreamineBlazorServerHostedService.cs 파일의 73 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : StartAsync(), StopAsync().

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

DreamineBlazorServerHostedService.cs

Public 멤버 함수

Private 멤버 함수

정적 Private 멤버 함수

Private 속성

상세한 설명

멤버 함수 문서화

◆ DreamineBlazorServerHostedService()

◆ RegisterSharedServices()

◆ RegisterViewModels()

◆ StartAsync()

◆ StopAsync()

◆ TryGetPublishedIndexPath()

멤버 데이터 문서화

◆ _messageBus

◆ _options

◆ _rootServiceProvider

◆ _webHost