WeddingThankYou.Services.FileSystemMediaUsageQueryService에 대한 상속 다이어그램 :

WeddingThankYou.Services.FileSystemMediaUsageQueryService에 대한 협력 다이어그램:

[범례]

Public 멤버 함수
	FileSystemMediaUsageQueryService (ITenantStore tenants, IMediaMigrationService migrations)
async Task< TenantMediaUsageSummary >	GetTenantUsageAsync (TenantConfig tenant, CancellationToken ct=default)
async Task< IReadOnlyDictionary< string, TenantMediaUsageSummary > >	GetTenantUsageAsync (IEnumerable< TenantConfig > tenants, CancellationToken ct=default)

정적 Private 멤버 함수
static MediaMigrationState	InferMigrationState (TenantConfig tenant)
static long	SumTenantVideos (string root, IEnumerable< string > fileNames, out DateTime? lastModified)
static long	SumFiles (string path, ISet< string > allowedExtensions, out DateTime? lastModified)
static void	AddFile (string path, ref long total, ref DateTime? lastModified)
static ? DateTime	MaxDate (params DateTime?[] values)

Private 속성
readonly ITenantStore	_tenants
readonly IMediaMigrationService	_migrations

정적 Private 속성
static readonly HashSet< string >	ImageExtensions
static readonly HashSet< string >	VideoExtensions
static readonly HashSet< string >	RootMediaExtensions

상세한 설명

App_Data 파일 구조를 기준으로 테넌트별 미디어 사용량을 계산합니다.

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

생성자 & 소멸자 문서화

◆ FileSystemMediaUsageQueryService()

WeddingThankYou.Services.FileSystemMediaUsageQueryService.FileSystemMediaUsageQueryService	(	ITenantStore	tenants,
		IMediaMigrationService	migrations )

inline

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

매개변수

tenants	tenants에 사용할 `ITenantStore` 값입니다.
migrations	migrations에 사용할 `IMediaMigrationService` 값입니다.

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

    {
        _tenants = tenants;
        _migrations = migrations;
    }

다음을 참조함 : _migrations, _tenants.

멤버 함수 문서화

◆ AddFile()

void WeddingThankYou.Services.FileSystemMediaUsageQueryService.AddFile	(	string	path,
		ref long	total,
		ref DateTime?	lastModified )

inlinestaticprivate

File 항목을 추가합니다.

매개변수

path	path에 사용할 `string` 값입니다.
total	total에 사용할 `long` 값입니다.
lastModified	last Modified에 사용할 `DateTime?` 값입니다.

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

    {
        try
        {
            var info = new FileInfo(path);
            total += info.Length;
            lastModified = MaxDate(lastModified, info.LastWriteTime);
        }
        catch
        {
            // 파일이 동시에 삭제되는 경우 사용량 계산에서만 제외합니다.
        }
    }

다음을 참조함 : MaxDate().

다음에 의해서 참조됨 : SumFiles(), SumTenantVideos().

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

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

◆ GetTenantUsageAsync() [1/2]

async Task< IReadOnlyDictionary< string, TenantMediaUsageSummary > > WeddingThankYou.Services.FileSystemMediaUsageQueryService.GetTenantUsageAsync	(	IEnumerable< TenantConfig >	tenants,
		CancellationToken	ct = default )

inline

Tenant Usage Async 값을 가져옵니다.

매개변수

tenants	tenants에 사용할 `IEnumerable<TenantConfig>` 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값: Get Tenant Usage Async 작업에서 생성한 Task<IReadOnlyDictionary<string, TenantMediaUsageSummary>> 결과입니다.

WeddingThankYou.Services.IMediaUsageQueryService를 구현.

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

    {
        var result = new Dictionary<string, TenantMediaUsageSummary>(StringComparer.OrdinalIgnoreCase);
        foreach (var tenant in tenants)
        {
            result[tenant.Slug] = await GetTenantUsageAsync(tenant, ct).ConfigureAwait(false);
        }
 
        return result;
    }

다음을 참조함 : GetTenantUsageAsync().

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

◆ GetTenantUsageAsync() [2/2]

async Task< TenantMediaUsageSummary > WeddingThankYou.Services.FileSystemMediaUsageQueryService.GetTenantUsageAsync	(	TenantConfig	tenant,
		CancellationToken	ct = default )

inline

Tenant Usage Async 값을 가져옵니다.

매개변수

tenant	tenant에 사용할 `TenantConfig` 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값: Get Tenant Usage Async 작업에서 생성한 Task<TenantMediaUsageSummary> 결과입니다.

WeddingThankYou.Services.IMediaUsageQueryService를 구현.

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

    {
        var root = _tenants.GetTenantDataPath(tenant.Slug);
        var galleryDir = Path.Combine(root, "gallery");
        var thumbDir = Path.Combine(root, "thumb");
        var originalDir = Path.Combine(root, "original");
        var status = await _migrations.GetTenantStatusAsync(tenant.Slug, ct).ConfigureAwait(false);
 
        var summary = new TenantMediaUsageSummary
        {
            Slug = tenant.Slug,
            ImageCount = tenant.GalleryFileNames.Count,
            VideoCount = tenant.VideoFileNames.Count,
            MigrationState = status?.State ?? InferMigrationState(tenant),
            LastModified = tenant.CreatedAt,
        };
 
        summary.OptimizedImageBytes = SumFiles(galleryDir, ImageExtensions, out var galleryModified);
        var thumbBytes = SumFiles(thumbDir, ImageExtensions, out var thumbModified);
        summary.OriginalImageBytes = SumFiles(originalDir, ImageExtensions, out var originalModified);
        summary.VideoBytes = SumTenantVideos(root, tenant.VideoFileNames, out var videoModified);
        var rootMediaBytes = SumFiles(root, RootMediaExtensions, out var rootModified);
        summary.TotalBytes = summary.OptimizedImageBytes + thumbBytes + summary.OriginalImageBytes + summary.VideoBytes + rootMediaBytes;
        summary.LastModified = MaxDate(galleryModified, thumbModified, originalModified, videoModified, rootModified) ?? tenant.CreatedAt;
 
        return summary;
    }

다음을 참조함 : _migrations, _tenants, WeddingThankYou.Models.TenantConfig.CreatedAt, WeddingThankYou.Models.TenantConfig.GalleryFileNames, ImageExtensions, InferMigrationState(), MaxDate(), RootMediaExtensions, WeddingThankYou.Models.TenantConfig.Slug, SumFiles(), SumTenantVideos(), WeddingThankYou.Models.TenantConfig.VideoFileNames.

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

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

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

◆ InferMigrationState()

MediaMigrationState WeddingThankYou.Services.FileSystemMediaUsageQueryService.InferMigrationState ( TenantConfig tenant )

inlinestaticprivate

Infer Migration State 작업을 수행합니다.

매개변수

tenant tenant에 사용할 TenantConfig 값입니다.

반환값: Infer Migration State 작업에서 생성한 MediaMigrationState 결과입니다.

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

    {
        if (tenant.GalleryFileNames.Count == 0) return MediaMigrationState.Skipped;
        return tenant.GalleryFileNames.All(x => Path.GetExtension(x).Equals(".webp", StringComparison.OrdinalIgnoreCase))
            ? MediaMigrationState.Completed
            : MediaMigrationState.Pending;
    }

다음을 참조함 : WeddingThankYou.Models.Completed, WeddingThankYou.Models.TenantConfig.GalleryFileNames.

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

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

◆ MaxDate()

? DateTime WeddingThankYou.Services.FileSystemMediaUsageQueryService.MaxDate ( params DateTime?[] values )

inlinestaticprivate

Max Date 작업을 수행합니다.

매개변수

values values에 사용할 DateTime?[] 값입니다.

반환값: Max Date 작업에서 생성한 DateTime? 결과입니다.

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

    {
        var concrete = values.Where(x => x.HasValue).Select(x => x!.Value).ToArray();
        return concrete.Length == 0 ? null : concrete.Max();
    }

다음에 의해서 참조됨 : AddFile(), GetTenantUsageAsync().

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

◆ SumFiles()

long WeddingThankYou.Services.FileSystemMediaUsageQueryService.SumFiles	(	string	path,
		ISet< string >	allowedExtensions,
		out DateTime?	lastModified )

inlinestaticprivate

Sum Files 작업을 수행합니다.

매개변수

path	path에 사용할 `string` 값입니다.
allowedExtensions	allowed Extensions에 사용할 `ISet<string>` 값입니다.
lastModified	last Modified에 사용할 `DateTime?` 값입니다.

반환값: Sum Files 작업에서 생성한 long 결과입니다.

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

    {
        long total = 0;
        lastModified = null;
        if (!Directory.Exists(path)) return 0;
 
        foreach (var file in Directory.EnumerateFiles(path, "*", SearchOption.TopDirectoryOnly))
        {
            if (!allowedExtensions.Contains(Path.GetExtension(file))) continue;
            AddFile(file, ref total, ref lastModified);
        }
 
        return total;
    }

다음을 참조함 : AddFile().

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

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

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

◆ SumTenantVideos()

long WeddingThankYou.Services.FileSystemMediaUsageQueryService.SumTenantVideos	(	string	root,
		IEnumerable< string >	fileNames,
		out DateTime?	lastModified )

inlinestaticprivate

Sum Tenant Videos 작업을 수행합니다.

매개변수

root	root에 사용할 `string` 값입니다.
fileNames	file Names에 사용할 `IEnumerable<string>` 값입니다.
lastModified	last Modified에 사용할 `DateTime?` 값입니다.

반환값: Sum Tenant Videos 작업에서 생성한 long 결과입니다.

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

    {
        long total = 0;
        lastModified = null;
 
        foreach (var fileName in fileNames)
        {
            var path = Path.Combine(root, fileName);
            if (!File.Exists(path) || !VideoExtensions.Contains(Path.GetExtension(path))) continue;
            AddFile(path, ref total, ref lastModified);
        }
 
        return total;
    }

다음을 참조함 : AddFile(), VideoExtensions.

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

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

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

멤버 데이터 문서화

◆ _migrations

readonly IMediaMigrationService WeddingThankYou.Services.FileSystemMediaUsageQueryService._migrations

private

migrations 값을 보관합니다.

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

다음에 의해서 참조됨 : FileSystemMediaUsageQueryService(), GetTenantUsageAsync().

◆ _tenants

readonly ITenantStore WeddingThankYou.Services.FileSystemMediaUsageQueryService._tenants

private

tenants 값을 보관합니다.

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

다음에 의해서 참조됨 : FileSystemMediaUsageQueryService(), GetTenantUsageAsync().

◆ ImageExtensions

readonly HashSet<string> WeddingThankYou.Services.FileSystemMediaUsageQueryService.ImageExtensions

staticprivate

초기값:

                                                = new(StringComparer.OrdinalIgnoreCase)
{
    ".jpg", ".jpeg", ".png", ".webp", ".gif"
}

Image Extensions 값을 보관합니다.

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

    {
        ".jpg", ".jpeg", ".png", ".webp", ".gif"
    };

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

◆ RootMediaExtensions

readonly HashSet<string> WeddingThankYou.Services.FileSystemMediaUsageQueryService.RootMediaExtensions

staticprivate

초기값:

                                                    = new(StringComparer.OrdinalIgnoreCase)
{
    ".jpg", ".jpeg", ".png", ".webp", ".gif", ".mp3", ".ogg", ".wav", ".aac", ".m4a"
}

Root Media Extensions 값을 보관합니다.

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

    {
        ".jpg", ".jpeg", ".png", ".webp", ".gif", ".mp3", ".ogg", ".wav", ".aac", ".m4a"
    };

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

◆ VideoExtensions

readonly HashSet<string> WeddingThankYou.Services.FileSystemMediaUsageQueryService.VideoExtensions

staticprivate

초기값:

                                                = new(StringComparer.OrdinalIgnoreCase)
{
    ".mp4", ".webm", ".mov", ".m4v"
}

Video Extensions 값을 보관합니다.

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

    {
        ".mp4", ".webm", ".mov", ".m4v"
    };

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

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

FileSystemMediaUsageQueryService.cs

Public 멤버 함수

정적 Private 멤버 함수

Private 속성

정적 Private 속성

상세한 설명

생성자 & 소멸자 문서화

◆ FileSystemMediaUsageQueryService()

멤버 함수 문서화

◆ AddFile()

◆ GetTenantUsageAsync() [1/2]

◆ GetTenantUsageAsync() [2/2]

◆ InferMigrationState()

◆ MaxDate()

◆ SumFiles()

◆ SumTenantVideos()

멤버 데이터 문서화

◆ _migrations

◆ _tenants

◆ ImageExtensions

◆ RootMediaExtensions

◆ VideoExtensions