Codemaru.Services.SitePreviewService 클래스 참조

더 자세히 ...

Codemaru.Services.SitePreviewService에 대한 상속 다이어그램 :

Codemaru.Services.SitePreviewService에 대한 협력 다이어그램:

Public 멤버 함수
	SitePreviewService (ILogger< SitePreviewService > logger, IConfiguration config)
override void	Dispose ()

Protected 멤버 함수
override async Task	ExecuteAsync (CancellationToken stoppingToken)

Private 멤버 함수
async Task	FetchAllAsync (CancellationToken ct)
async Task	FetchOneAsync (string key, string siteUrl, string outputDir, CancellationToken ct)

정적 Private 멤버 함수
static	readonly (string Key, string Url)[] Sites

Private 속성
readonly string	_wwwRoot
readonly ILogger< SitePreviewService >	_logger
readonly TimeSpan	_interval
readonly HttpClient	_http

정적 Private 속성
static readonly Regex	OgImageRegex
static readonly Regex	OgImageRegex2

상세한 설명

외부 사이트의 og:image를 주기적으로 가져와 wwwroot/img/previews/ 에 캐시합니다.

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

생성자 & 소멸자 문서화

SitePreviewService()

Codemaru.Services.SitePreviewService.SitePreviewService ( ILogger< SitePreviewService > logger, IConfiguration config )

inline

지정한 설정으로 SitePreviewService 클래스의 새 인스턴스를 초기화합니다.

매개변수

logger	logger에 사용할 ILogger<SitePreviewService> 값입니다.
config	config에 사용할 IConfiguration 값입니다.

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

    {
        _logger = logger;
        _interval = TimeSpan.FromHours(config.GetValue("SitePreview:RefreshHours", 6));
        _wwwRoot = Path.Combine(AppContext.BaseDirectory, "wwwroot");
        _http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = true });
        _http.DefaultRequestHeaders.UserAgent.ParseAdd(
            "Mozilla/5.0 (compatible; CodemaruBot/1.0; +https://codemaru.co.kr)");
        _http.Timeout = TimeSpan.FromSeconds(15);
    }

다음을 참조함 : _http, _interval, _logger, _wwwRoot.

멤버 함수 문서화

Dispose()

override void Codemaru.Services.SitePreviewService.Dispose ( )

inline

이 인스턴스가 소유한 리소스를 해제합니다.

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

    {
        _http.Dispose();
        base.Dispose();
    }

다음을 참조함 : _http.

ExecuteAsync()

override async Task Codemaru.Services.SitePreviewService.ExecuteAsync ( CancellationToken stoppingToken )

inlineprotected

Execute Async 작업을 수행합니다.

매개변수

stoppingToken

stopping Token에 사용할 CancellationToken 값입니다.

반환값

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

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

    {
        while (!stoppingToken.IsCancellationRequested)
        {
            await FetchAllAsync(stoppingToken);
 
            try { await Task.Delay(_interval, stoppingToken); }
            catch (OperationCanceledException) { break; }
        }
    }

다음을 참조함 : _interval, FetchAllAsync().

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

FetchAllAsync()

async Task Codemaru.Services.SitePreviewService.FetchAllAsync ( CancellationToken ct )

inlineprivate

Fetch All Async 작업을 수행합니다.

매개변수

ct	취소 요청을 감시하는 토큰입니다.

반환값

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

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

    {
        var outputDir = Path.Combine(_wwwRoot, "img", "previews");
        Directory.CreateDirectory(outputDir);
 
        foreach (var (key, url) in Sites)
        {
            if (ct.IsCancellationRequested) break;
            await FetchOneAsync(key, url, outputDir, ct);
        }
    }

다음을 참조함 : _wwwRoot, FetchOneAsync().

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

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

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

FetchOneAsync()

async Task Codemaru.Services.SitePreviewService.FetchOneAsync ( string key, string siteUrl, string outputDir, CancellationToken ct )

inlineprivate

Fetch One Async 작업을 수행합니다.

매개변수

key	key에 사용할 string 값입니다.
siteUrl	site Url에 사용할 string 값입니다.
outputDir	output Dir에 사용할 string 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값

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

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

    {
        var destPath = Path.Combine(outputDir, $"{key}.jpg");
        var tempPath = destPath + ".tmp";
 
        try
        {
            // 1. 사이트 HTML 가져오기
            var html = await _http.GetStringAsync(siteUrl, ct);
 
            // 2. og:image URL 파싱
            var match = OgImageRegex.Match(html);
            if (!match.Success) match = OgImageRegex2.Match(html);
            if (!match.Success)
            {
                _logger.LogWarning("og:image 없음: {Key}", key);
                return;
            }
 
            var imageUrl = match.Groups[1].Value.Trim();
 
            // 상대 경로면 절대 경로로 변환
            if (!imageUrl.StartsWith("http", StringComparison.OrdinalIgnoreCase))
            {
                var base64 = new Uri(siteUrl);
                imageUrl = new Uri(base64, imageUrl).ToString();
            }
 
            // 3. 이미지 다운로드
            var imageBytes = await _http.GetByteArrayAsync(imageUrl, ct);
            await File.WriteAllBytesAsync(tempPath, imageBytes, ct);
            File.Move(tempPath, destPath, overwrite: true);
 
            _logger.LogInformation("OG 이미지 캐시 완료: {Key} ← {ImageUrl}", key, imageUrl);
        }
        catch (Exception ex)
        {
            _logger.LogWarning(ex, "OG 이미지 fetch 실패: {Key} ({Url})", key, siteUrl);
            if (File.Exists(tempPath)) File.Delete(tempPath);
        }
    }

다음을 참조함 : _http, _logger, OgImageRegex, OgImageRegex2.

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

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

readonly()

Codemaru.Services.SitePreviewService.readonly ( string Key, string Url )

staticprivate

Sites 값을 보관합니다.

멤버 데이터 문서화

_http

readonly HttpClient Codemaru.Services.SitePreviewService._http

private

http 값을 보관합니다.

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

다음에 의해서 참조됨 : Dispose(), FetchOneAsync(), SitePreviewService().

_interval

readonly TimeSpan Codemaru.Services.SitePreviewService._interval

private

interval 값을 보관합니다.

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

다음에 의해서 참조됨 : ExecuteAsync(), SitePreviewService().

_logger

readonly ILogger<SitePreviewService> Codemaru.Services.SitePreviewService._logger

private

logger 값을 보관합니다.

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

다음에 의해서 참조됨 : FetchOneAsync(), SitePreviewService().

_wwwRoot

readonly string Codemaru.Services.SitePreviewService._wwwRoot

private

www Root 값을 보관합니다.

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

다음에 의해서 참조됨 : FetchAllAsync(), SitePreviewService().

OgImageRegex

readonly Regex Codemaru.Services.SitePreviewService.OgImageRegex

staticprivate

초기값:

                                       = new(
@"<meta[^>]+property=[""']og:image[""'][^>]+content=[""']([^""']+)[""']",
RegexOptions.IgnoreCase | RegexOptions.Compiled)

Og Image Regex 값을 보관합니다.

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

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

OgImageRegex2

readonly Regex Codemaru.Services.SitePreviewService.OgImageRegex2

staticprivate

초기값:

                                        = new(
@"<meta[^>]+content=[""']([^""']+)[""'][^>]+property=[""']og:image[""']",
RegexOptions.IgnoreCase | RegexOptions.Compiled)

Og Image Regex2 값을 보관합니다.

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

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

---

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

• SitePreviewService.cs