ShopPlatform.Middleware.OgBotMiddleware(RequestDelegate next) 클래스 참조

더 자세히 ...

Public 멤버 함수
async Task	InvokeAsync (HttpContext ctx, IShopTenantStore store, ShopOptions opts)

정적 Private 멤버 함수
static bool	IsBot (string ua)
static bool	IsShopPath (string path, out string slug)
static async Task	WriteOgHtml (HttpContext ctx, ShopConfig cfg, ShopOptions opts, string slug)
static string	HtmlEncode (string s)

정적 Private 속성
static readonly string[]	BotKeywords
static readonly HashSet< string >	Reserved

상세한 설명

카카오톡·SNS 크롤러가 /{slug} 에 접근하면 Blazor 없이 OG 메타태그만 담긴 최소 HTML을 즉시 반환합니다. 일반 브라우저는 그대로 통과시킵니다.

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

멤버 함수 문서화

HtmlEncode()

string ShopPlatform.Middleware.OgBotMiddleware.HtmlEncode ( string s )

inlinestaticprivate

Html Encode 작업을 수행합니다.

매개변수

s	이벤트를 발생시킨 객체입니다.

반환값

Html Encode 작업에서 생성한 string 결과입니다.

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

        => System.Net.WebUtility.HtmlEncode(s);

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

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

InvokeAsync()

async Task ShopPlatform.Middleware.OgBotMiddleware.InvokeAsync ( HttpContext ctx, IShopTenantStore store, ShopOptions opts )

inline

Invoke Async 작업을 수행합니다.

매개변수

ctx	ctx에 사용할 HttpContext 값입니다.
store	store에 사용할 IShopTenantStore 값입니다.
opts	opts에 사용할 ShopOptions 값입니다.

반환값

Invoke Async 작업에서 생성한 Task 결과입니다.

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

    {
        var ua   = ctx.Request.Headers.UserAgent.ToString().ToLowerInvariant();
        var path = ctx.Request.Path.Value ?? string.Empty;
 
        // 봇이고 /{slug} 패턴이면 OG HTML 반환
        if (IsBot(ua) && IsShopPath(path, out var slug))
        {
            var config = await store.GetAsync(slug);
            if (config != null && config.IsActive)
            {
                await WriteOgHtml(ctx, config, opts, slug);
                return;
            }
        }
 
        await next(ctx);
    }

다음을 참조함 : ShopPlatform.Services.IShopTenantStore.GetAsync(), IsBot(), IsShopPath(), WriteOgHtml().

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

IsBot()

bool ShopPlatform.Middleware.OgBotMiddleware.IsBot ( string ua )

inlinestaticprivate

Is Bot 조건을 확인합니다.

매개변수

ua	ua에 사용할 string 값입니다.

반환값

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

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

        => BotKeywords.Any(k => ua.Contains(k));

다음을 참조함 : BotKeywords.

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

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

IsShopPath()

bool ShopPlatform.Middleware.OgBotMiddleware.IsShopPath ( string path, out string slug )

inlinestaticprivate

Is Shop Path 조건을 확인합니다.

매개변수

path	path에 사용할 string 값입니다.
slug	slug에 사용할 string 값입니다.

반환값

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

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

    {
        slug = string.Empty;
        var trimmed = path.Trim('/');
        // 루트(/) 또는 하위경로 제외, 단일 세그먼트만 처리
        if (string.IsNullOrEmpty(trimmed) || trimmed.Contains('/')) return false;
        if (Reserved.Contains(trimmed)) return false;
        slug = trimmed;
        return true;
    }

다음을 참조함 : Reserved.

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

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

WriteOgHtml()

async Task ShopPlatform.Middleware.OgBotMiddleware.WriteOgHtml ( HttpContext ctx, ShopConfig cfg, ShopOptions opts, string slug )

inlinestaticprivate

Og Html 데이터를 씁니다.

매개변수

ctx	ctx에 사용할 HttpContext 값입니다.
cfg	cfg에 사용할 ShopConfig 값입니다.
opts	opts에 사용할 ShopOptions 값입니다.
slug	slug에 사용할 string 값입니다.

반환값

Write Og Html 작업에서 생성한 Task 결과입니다.

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

    {
        var baseUrl = opts.BaseUrl.TrimEnd('/');
        var title   = !string.IsNullOrEmpty(cfg.OgTitle)       ? cfg.OgTitle       : cfg.ShopName;
        var desc    = !string.IsNullOrEmpty(cfg.OgDescription) ? cfg.OgDescription
                    : !string.IsNullOrEmpty(cfg.Description)   ? cfg.Description
                    : $"{cfg.ShopName}에서 쇼핑하세요";
        var url     = $"{baseUrl}/{slug}";
 
        // OG 이미지: OgImagePath → LogoPath → 자동 생성
        string imgUrl;
        if (!string.IsNullOrEmpty(cfg.OgImagePath))
            imgUrl = cfg.OgImagePath.StartsWith("http") ? cfg.OgImagePath : $"{baseUrl}{cfg.OgImagePath}";
        else if (!string.IsNullOrEmpty(cfg.LogoPath))
            imgUrl = cfg.LogoPath.StartsWith("http") ? cfg.LogoPath : $"{baseUrl}{cfg.LogoPath}";
        else
            imgUrl = $"{baseUrl}/img/og/og-{slug}.png";
 
        var html = $"""
            <!DOCTYPE html>
            <html lang="ko">
            <head>
              <meta charset="utf-8" />
              <title>{HtmlEncode(title)}</title>
              <meta name="description" content="{HtmlEncode(desc)}" />
              <meta property="og:type"        content="website" />
              <meta property="og:url"         content="{url}" />
              <meta property="og:title"       content="{HtmlEncode(title)}" />
              <meta property="og:description" content="{HtmlEncode(desc)}" />
              <meta property="og:image"       content="{imgUrl}" />
              <meta property="og:image:width"  content="1200" />
              <meta property="og:image:height" content="630" />
              <meta property="og:site_name"   content="ShopPlatform" />
              <meta name="twitter:card"       content="summary_large_image" />
              <meta name="twitter:title"      content="{HtmlEncode(title)}" />
              <meta name="twitter:description" content="{HtmlEncode(desc)}" />
              <meta name="twitter:image"      content="{imgUrl}" />
            </head>
            <body>
              <script>location.href="{url}";</script>
              <a href="{url}">{HtmlEncode(title)}</a>
            </body>
            </html>
            """;
 
        ctx.Response.ContentType = "text/html; charset=utf-8";
        ctx.Response.StatusCode  = 200;
        await ctx.Response.WriteAsync(html);
    }

다음을 참조함 : ShopPlatform.Models.ShopOptions.BaseUrl, ShopPlatform.Models.ShopConfig.Description, HtmlEncode(), ShopPlatform.Models.ShopConfig.LogoPath, ShopPlatform.Models.ShopConfig.OgDescription, ShopPlatform.Models.ShopConfig.OgImagePath, ShopPlatform.Models.ShopConfig.OgTitle, ShopPlatform.Models.ShopConfig.ShopName.

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

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

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

멤버 데이터 문서화

BotKeywords

readonly string [] ShopPlatform.Middleware.OgBotMiddleware.BotKeywords

staticprivate

초기값:

                                           =
[
    "kakaotalk", "facebookexternalhit", "twitterbot", "linkedinbot",
    "slackbot", "telegrambot", "whatsapp", "discordbot",
    "baiduspider", "yeti", "naverbot", "daumoa",
    "googlebot", "bingbot"
]

Bot Keywords 값을 보관합니다.

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

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

Reserved

readonly HashSet<string> ShopPlatform.Middleware.OgBotMiddleware.Reserved

staticprivate

초기값:

                                         = new(StringComparer.OrdinalIgnoreCase)
{
    "admin", "pay", "healthz", "_framework", "_blazor",
    "css", "js", "img", "shop-img", "favicon.ico"
}

Reserved 값을 보관합니다.

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

    {
        "admin", "pay", "healthz", "_framework", "_blazor",
        "css", "js", "img", "shop-img", "favicon.ico"
    };

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

---

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

• OgBotMiddleware.cs