WeddingThankYou.Program 클래스 참조

정적 Public 멤버 함수
static void	Main ()

정적 Private 멤버 함수
static void	Run ()
static bool	IsTcpPortAvailable (int port, bool listenAnyIp)
static int	GetFreeLoopbackPort ()
static void	WriteStartupFailureLog (Exception ex)
static int	GetInt (IConfiguration cfg, string key, int fallback)
static bool	GetBool (IConfiguration cfg, string key, bool fallback)
static string	ResolvePath (string? configuredPath, string fallback)

상세한 설명

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

멤버 함수 문서화

GetBool()

bool WeddingThankYou.Program.GetBool ( IConfiguration cfg, string key, bool fallback )

inlinestaticprivate

Bool 값을 가져옵니다.

매개변수

cfg	cfg에 사용할 IConfiguration 값입니다.
key	key에 사용할 string 값입니다.
fallback	fallback에 사용할 bool 값입니다.

반환값

Get Bool 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

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

                                                                               =>
        bool.TryParse(cfg[key], out bool v) ? v : fallback;

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

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

GetFreeLoopbackPort()

int WeddingThankYou.Program.GetFreeLoopbackPort ( )

inlinestaticprivate

Free Loopback Port 값을 가져옵니다.

반환값

Get Free Loopback Port 작업에서 생성한 int 결과입니다.

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

    {
        var listener = new TcpListener(IPAddress.Loopback, 0);
        listener.Start();
        try
        {
            return ((IPEndPoint)listener.LocalEndpoint).Port;
        }
        finally
        {
            listener.Stop();
        }
    }

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

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

GetInt()

int WeddingThankYou.Program.GetInt ( IConfiguration cfg, string key, int fallback )

inlinestaticprivate

Int 값을 가져옵니다.

매개변수

cfg	cfg에 사용할 IConfiguration 값입니다.
key	key에 사용할 string 값입니다.
fallback	fallback에 사용할 int 값입니다.

반환값

Get Int 작업에서 생성한 int 결과입니다.

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

                                                                            =>
        int.TryParse(cfg[key], out int v) ? v : fallback;

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

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

IsTcpPortAvailable()

bool WeddingThankYou.Program.IsTcpPortAvailable ( int port, bool listenAnyIp )

inlinestaticprivate

Is Tcp Port Available 조건을 확인합니다.

매개변수

port	port에 사용할 int 값입니다.
listenAnyIp	listen Any Ip에 사용할 bool 값입니다.

반환값

Is Tcp Port Available 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

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

    {
        if (port <= 0) return false;
 
        TcpListener? listener = null;
        try
        {
            listener = new TcpListener(listenAnyIp ? IPAddress.Any : IPAddress.Loopback, port);
            listener.Start();
            return true;
        }
        catch (SocketException)
        {
            return false;
        }
        finally
        {
            listener?.Stop();
        }
    }

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

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

Main()

void WeddingThankYou.Program.Main ( )

inlinestatic

Main 작업을 수행합니다.

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

    {
        try
        {
            Run();
        }
        catch (Exception ex)
        {
            WriteStartupFailureLog(ex);
            System.Windows.MessageBox.Show(
                $"Wedding ThankYou 실행 중 오류가 발생했습니다.\n\n{ex.Message}\n\n자세한 내용은 로그를 확인하세요.",
                "Wedding ThankYou",
                System.Windows.MessageBoxButton.OK,
                System.Windows.MessageBoxImage.Error);
        }
    }

다음을 참조함 : Run(), WriteStartupFailureLog().

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

ResolvePath()

string WeddingThankYou.Program.ResolvePath ( string? configuredPath, string fallback )

inlinestaticprivate

Resolve Path 작업을 수행합니다.

매개변수

configuredPath	configured Path에 사용할 string? 값입니다.
fallback	fallback에 사용할 string 값입니다.

반환값

Resolve Path 작업에서 생성한 string 결과입니다.

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

    {
        if (string.IsNullOrWhiteSpace(configuredPath))
        {
            return fallback;
        }
 
        return Path.IsPathRooted(configuredPath)
            ? configuredPath
            : Path.GetFullPath(Path.Combine(AppContext.BaseDirectory, configuredPath));
    }

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

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

Run()

void WeddingThankYou.Program.Run ( )

inlinestaticprivate

Run 작업을 수행합니다.

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

    {
        HostApplicationBuilder builder = Host.CreateApplicationBuilder();
        builder.Configuration.AddUserSecrets("codemaru-oauth-2ba4e1b2");
 
        int serverPort = GetInt(builder.Configuration, "WeddingServer:Port", 4088);
        bool listenAnyIp = GetBool(builder.Configuration, "WeddingServer:ListenAnyIp", true);
        bool useEmbeddedWebView = GetBool(builder.Configuration, "WeddingShell:UseEmbeddedWebView", true);
        if (!IsTcpPortAvailable(serverPort, listenAnyIp))
        {
            serverPort = GetFreeLoopbackPort();
            listenAnyIp = false;
        }
 
        AuthOptions authOptions =
            builder.Configuration.GetSection(AuthOptions.SectionName).Get<AuthOptions>() ?? new AuthOptions();
        string usersDbPath = ResolvePath(
            builder.Configuration[$"{AuthOptions.SectionName}:UsersDbPath"],
            Path.Combine(AppContext.BaseDirectory, "App_Data", "codemaru.db"));
 
        builder.Services.AddDreamineHybridWpf();
        builder.Services.AddDreamineIdentityWpfHost();
 
        // ── Wedding 서비스 ─────────────────────────────────────────
        var weddingOpts = WeddingOptions.From(builder.Configuration);
        builder.Services.AddSingleton(weddingOpts);
        builder.Services.AddSingleton<ITenantStore, JsonTenantStore>();
        builder.Services.AddSingleton<IGuestbookStorage, CsvGuestbookStorage>();
        builder.Services.AddSingleton<IGlobalSettingsStore, JsonGlobalSettingsStore>();
        builder.Services.AddSingleton<IMediaQuotaPolicyResolver, MediaQuotaPolicyResolver>();
        builder.Services.AddSingleton<IImageOptimizationService, SystemDrawingImageOptimizationService>();
        builder.Services.AddSingleton<IMediaMigrationService, JsonMediaMigrationService>();
        builder.Services.AddSingleton<IMediaUsageQueryService, FileSystemMediaUsageQueryService>();
        builder.Services.AddSingleton<ISuperAdminSessionTokenService, SuperAdminSessionTokenService>();
        builder.Services.AddSingleton<IPhotoService, LocalPhotoService>();
 
        builder.Services.AddSingleton<Views.MainWindow>();
 
        builder.Services.AddDreamineBlazorServer<AppShell>(options =>
        {
            options.Port = serverPort;
            options.ListenAnyIp = listenAnyIp;
            options.UseEmbeddedWebView = useEmbeddedWebView;
            // Wedding 서비스 Blazor 호스트에 공유 (ViewModel은 AutoRegisterViewModels로 자동 등록)
            options.SharedServiceTypes.Add(typeof(WeddingOptions));
            options.SharedServiceTypes.Add(typeof(ITenantStore));
            options.SharedServiceTypes.Add(typeof(IGuestbookStorage));
            options.SharedServiceTypes.Add(typeof(IGlobalSettingsStore));
            options.SharedServiceTypes.Add(typeof(IMediaQuotaPolicyResolver));
            options.SharedServiceTypes.Add(typeof(IImageOptimizationService));
            options.SharedServiceTypes.Add(typeof(IMediaMigrationService));
            options.SharedServiceTypes.Add(typeof(IMediaUsageQueryService));
            options.SharedServiceTypes.Add(typeof(ISuperAdminSessionTokenService));
            options.SharedServiceTypes.Add(typeof(IPhotoService));
            // 업로드된 사진/미디어를 /wedding-data/ URL로 제공
            options.AddPhysicalStaticFiles(weddingOpts.ResolvedDataPath, "/wedding-data");
 
            // InputFile(동영상 등 대용량 업로드)은 SignalR 회선을 통해 청크 단위로 전송되는데,
            // 기본 SignalR 메시지 크기 제한(32KB)과 짧은 타임아웃 때문에 큰 파일은 매우 느리거나
            // 응답 없이 멈춘 것처럼 보입니다. 업로드 용량 검증은 LocalPhotoService에서 별도로
            // 하고 있으므로 전송 한도 자체는 풀어줍니다.
            options.ConfigureServices = services =>
            {
                services.AddServerSideBlazor()
                    .AddHubOptions(o =>
                    {
                        o.MaximumReceiveMessageSize = null; // 무제한 (용량 검증은 LocalPhotoService에서 수행)
                        o.ClientTimeoutInterval = TimeSpan.FromMinutes(10);
                        o.HandshakeTimeout = TimeSpan.FromMinutes(2);
                        o.KeepAliveInterval = TimeSpan.FromSeconds(10);
                    });
 
                services.AddAntiforgery(o =>
                {
                    o.Cookie.SameSite = Microsoft.AspNetCore.Http.SameSiteMode.Lax;
                    o.Cookie.SecurePolicy = Microsoft.AspNetCore.Http.CookieSecurePolicy.SameAsRequest;
                });
 
                services.Configure<CircuitOptions>(o =>
                {
                    o.DisconnectedCircuitMaxRetained = 100;
                    o.DisconnectedCircuitRetentionPeriod = TimeSpan.FromMinutes(3);
                    o.JSInteropDefaultCallTimeout = TimeSpan.FromMinutes(1);
                    o.MaxBufferedUnacknowledgedRenderBatches = 10;
                });
 
                services.AddScoped<ThankYouUserContext>();
            };
 
            options.AddDreamineIdentity(authOptions, usersDbPath);
        });
 
        builder.Build().RunDreamineWpfApp<App>();
    }

다음을 참조함 : WeddingThankYou.Services.WeddingOptions.From(), GetBool(), GetFreeLoopbackPort(), GetInt(), IsTcpPortAvailable(), ResolvePath().

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

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

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

WriteStartupFailureLog()

void WeddingThankYou.Program.WriteStartupFailureLog ( Exception ex )

inlinestaticprivate

Startup Failure Log 데이터를 씁니다.

매개변수

ex	ex에 사용할 Exception 값입니다.

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

    {
        try
        {
            var dir = Path.Combine(
                Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
                "WeddingThankYou",
                "Logs");
            Directory.CreateDirectory(dir);
            var path = Path.Combine(dir, "startup-error.log");
            File.AppendAllText(path, $"[{DateTime.Now:yyyy-MM-dd HH:mm:ss}] {ex}\r\n\r\n");
        }
        catch
        {
            // 마지막 안전망: 오류 로그 작성 실패가 앱 종료 원인이 되지 않게 둡니다.
        }
    }

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

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

---

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

• Program.cs