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

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

[범례]

Public 멤버 함수
	LocalPhotoService (ITenantStore tenants, IMediaQuotaPolicyResolver policyResolver, IImageOptimizationService imageOptimization, IMediaUsageQueryService usageQuery)
async Task< IReadOnlyList< PhotoInfo > >	GetGalleryAsync (string slug, CancellationToken ct=default)
async Task< string >	UploadAsync (string slug, IBrowserFile file, CancellationToken ct=default)
async Task< string >	UploadHeroAsync (string slug, IBrowserFile file, CancellationToken ct=default)
async Task< string >	UploadRoadMapAsync (string slug, IBrowserFile file, CancellationToken ct=default)
async Task	DeleteAsync (string slug, string fileName, CancellationToken ct=default)
string	GetPhotoUrl (string slug, string fileName)
string	GetThumbUrl (string slug, string fileName)
string	GetHeroUrl (string slug, string fileName)
string	GetRoadMapUrl (string slug, string fileName)
async Task< string >	UploadMusicAsync (string slug, IBrowserFile file, CancellationToken ct=default)
string	GetMusicUrl (string slug, string fileName)
async Task< string >	UploadOgImageAsync (string slug, IBrowserFile file, CancellationToken ct=default)
async Task< string >	UploadVideoAsync (string slug, IBrowserFile file, CancellationToken ct=default)
async Task	DeleteVideoAsync (string slug, string fileName, CancellationToken ct=default)
string	GetVideoUrl (string slug, string fileName)

Private 멤버 함수
string	GalleryPath (string slug, string fileName)
async Task	ValidateImageQuotaAsync (TenantConfig config, EffectiveMediaPolicy policy, IBrowserFile file, bool countGalleryImage, CancellationToken ct)
async Task< string >	SaveImageFileAsync (string slug, IBrowserFile file, string destinationDirectory, string baseName, EffectiveMediaPolicy policy, CancellationToken ct)
string	ResolveWritableOutputFormat (string? preferredFormat, string? originalExtension)

정적 Private 멤버 함수
static void	ValidateImageFile (IBrowserFile file)
static string	NormalizeOutputExtension (string? outputFormat)
static string	UniqueFileName (string originalName)

Private 속성
readonly ITenantStore	_tenants
readonly IMediaQuotaPolicyResolver	_policyResolver
readonly IImageOptimizationService	_imageOptimization
readonly IMediaUsageQueryService	_usageQuery

정적 Private 속성
const long	MaxImageUploadBytes = 200 * 1024 * 1024
static readonly string[]	AllowedExts = [".jpg", ".jpeg", ".png", ".webp", ".gif"]

상세한 설명

Local Photo Service 기능과 관련 상태를 캡슐화합니다.

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

생성자 & 소멸자 문서화

◆ LocalPhotoService()

WeddingThankYou.Services.LocalPhotoService.LocalPhotoService	(	ITenantStore	tenants,
		IMediaQuotaPolicyResolver	policyResolver,
		IImageOptimizationService	imageOptimization,
		IMediaUsageQueryService	usageQuery )

inline

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

매개변수

tenants	tenants에 사용할 `ITenantStore` 값입니다.
policyResolver	policy Resolver에 사용할 `IMediaQuotaPolicyResolver` 값입니다.
imageOptimization	image Optimization에 사용할 `IImageOptimizationService` 값입니다.
usageQuery	usage Query에 사용할 `IMediaUsageQueryService` 값입니다.

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

    {
        _tenants = tenants;
        _policyResolver = policyResolver;
        _imageOptimization = imageOptimization;
        _usageQuery = usageQuery;
    }

다음을 참조함 : _imageOptimization, _policyResolver, _tenants, _usageQuery.

멤버 함수 문서화

◆ DeleteAsync()

async Task WeddingThankYou.Services.LocalPhotoService.DeleteAsync	(	string	slug,
		string	fileName,
		CancellationToken	ct = default )

inline

Delete Async 작업을 수행합니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
fileName	file Name에 사용할 `string` 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값: Delete Async 작업에서 생성한 Task 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

    {
        var galleryFile = GalleryPath(slug, fileName);
        var thumbFile = Path.Combine(_tenants.GetTenantDataPath(slug), "thumb", fileName);
        if (File.Exists(galleryFile)) File.Delete(galleryFile);
        if (File.Exists(thumbFile)) File.Delete(thumbFile);
 
        var config = await _tenants.GetAsync(slug, ct).ConfigureAwait(false);
        if (config is null) return;
        config.GalleryFileNames.Remove(fileName);
        await _tenants.SaveAsync(config, ct).ConfigureAwait(false);
    }

다음을 참조함 : _tenants, GalleryPath().

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

◆ DeleteVideoAsync()

async Task WeddingThankYou.Services.LocalPhotoService.DeleteVideoAsync	(	string	slug,
		string	fileName,
		CancellationToken	ct = default )

inline

Delete Video Async 작업을 수행합니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
fileName	file Name에 사용할 `string` 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값: Delete Video Async 작업에서 생성한 Task 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

    {
        var path = Path.Combine(_tenants.GetTenantDataPath(slug), fileName);
        if (File.Exists(path)) File.Delete(path);
 
        var config = await _tenants.GetAsync(slug, ct).ConfigureAwait(false);
        if (config is null) return;
        config.VideoFileNames.Remove(fileName);
        await _tenants.SaveAsync(config, ct).ConfigureAwait(false);
    }

다음을 참조함 : _tenants.

◆ GalleryPath()

string WeddingThankYou.Services.LocalPhotoService.GalleryPath	(	string	slug,
		string	fileName )

inlineprivate

Gallery Path 작업을 수행합니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
fileName	file Name에 사용할 `string` 값입니다.

반환값: Gallery Path 작업에서 생성한 string 결과입니다.

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

920 =>

921 Path.Combine(_tenants.GetTenantDataPath(slug), "gallery", fileName);

다음을 참조함 : _tenants.

다음에 의해서 참조됨 : DeleteAsync(), GetGalleryAsync().

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

◆ GetGalleryAsync()

async Task< IReadOnlyList< PhotoInfo > > WeddingThankYou.Services.LocalPhotoService.GetGalleryAsync	(	string	slug,
		CancellationToken	ct = default )

inline

Gallery Async 값을 가져옵니다.

매개변수

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

반환값: Get Gallery Async 작업에서 생성한 Task<IReadOnlyList<PhotoInfo>> 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

    {
        var config = await _tenants.GetAsync(slug, ct).ConfigureAwait(false);
        if (config is null) return [];
 
        var list = new List<PhotoInfo>();
        foreach (var fn in config.GalleryFileNames)
        {
            var full = GalleryPath(slug, fn);
            if (!File.Exists(full)) continue;
            var fi = new FileInfo(full);
            list.Add(new PhotoInfo
            {
                FileName = fn,
                Url = GetPhotoUrl(slug, fn),
                ThumbUrl = GetThumbUrl(slug, fn),
                SizeBytes = fi.Length,
                LastModified = fi.LastWriteTime
            });
        }
        return list;
    }

다음을 참조함 : _tenants, GalleryPath(), GetPhotoUrl(), GetThumbUrl().

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

◆ GetHeroUrl()

string WeddingThankYou.Services.LocalPhotoService.GetHeroUrl	(	string	slug,
		string	fileName )

inline

Hero Url 값을 가져옵니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
fileName	file Name에 사용할 `string` 값입니다.

반환값: Get Hero Url 작업에서 생성한 string 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

511 =>

512 $"/wedding-data/{slug}/{Uri.EscapeDataString(fileName)}";

◆ GetMusicUrl()

string WeddingThankYou.Services.LocalPhotoService.GetMusicUrl	(	string	slug,
		string	fileName )

inline

Music Url 값을 가져옵니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
fileName	file Name에 사용할 `string` 값입니다.

반환값: Get Music Url 작업에서 생성한 string 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

652 =>

653 $"/wedding-data/{slug}/{Uri.EscapeDataString(fileName)}";

◆ GetPhotoUrl()

string WeddingThankYou.Services.LocalPhotoService.GetPhotoUrl	(	string	slug,
		string	fileName )

inline

Photo Url 값을 가져옵니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
fileName	file Name에 사용할 `string` 값입니다.

반환값: Get Photo Url 작업에서 생성한 string 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

441 =>

442 $"/wedding-data/{slug}/gallery/{Uri.EscapeDataString(fileName)}";

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

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

◆ GetRoadMapUrl()

string WeddingThankYou.Services.LocalPhotoService.GetRoadMapUrl	(	string	slug,
		string	fileName )

inline

Road Map Url 값을 가져옵니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
fileName	file Name에 사용할 `string` 값입니다.

반환값: Get Road Map Url 작업에서 생성한 string 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

546 =>

547 $"/wedding-data/{slug}/{Uri.EscapeDataString(fileName)}";

◆ GetThumbUrl()

string WeddingThankYou.Services.LocalPhotoService.GetThumbUrl	(	string	slug,
		string	fileName )

inline

Thumb Url 값을 가져옵니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
fileName	file Name에 사용할 `string` 값입니다.

반환값: Get Thumb Url 작업에서 생성한 string 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

476 =>

477 $"/wedding-data/{slug}/thumb/{Uri.EscapeDataString(fileName)}";

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

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

◆ GetVideoUrl()

string WeddingThankYou.Services.LocalPhotoService.GetVideoUrl	(	string	slug,
		string	fileName )

inline

Video Url 값을 가져옵니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
fileName	file Name에 사용할 `string` 값입니다.

반환값: Get Video Url 작업에서 생성한 string 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

885 =>

886 $"/wedding-data/{slug}/{Uri.EscapeDataString(fileName)}";

◆ NormalizeOutputExtension()

string WeddingThankYou.Services.LocalPhotoService.NormalizeOutputExtension ( string? outputFormat )

inlinestaticprivate

Normalize Output Extension 작업을 수행합니다.

매개변수

outputFormat output Format에 사용할 string? 값입니다.

반환값: Normalize Output Extension 작업에서 생성한 string 결과입니다.

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

    {
        var normalized = outputFormat?.Trim().TrimStart('.').ToLowerInvariant();
        return string.IsNullOrWhiteSpace(normalized) ? "webp" : normalized;
    }

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

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

◆ ResolveWritableOutputFormat()

string WeddingThankYou.Services.LocalPhotoService.ResolveWritableOutputFormat	(	string?	preferredFormat,
		string?	originalExtension )

inlineprivate

Resolve Writable Output Format 작업을 수행합니다.

매개변수

preferredFormat	preferred Format에 사용할 `string?` 값입니다.
originalExtension	original Extension에 사용할 `string?` 값입니다.

반환값: Resolve Writable Output Format 작업에서 생성한 string 결과입니다.

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

    {
        var preferred = NormalizeOutputExtension(preferredFormat);
        if (_imageOptimization.CanEncode(preferred)) return preferred;
 
        if (_imageOptimization.CanEncode("jpg")) return "jpg";
 
        var original = NormalizeOutputExtension(originalExtension);
        return _imageOptimization.CanEncode(original) ? original : "";
    }

다음을 참조함 : _imageOptimization, NormalizeOutputExtension().

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

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

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

◆ SaveImageFileAsync()

async Task< string > WeddingThankYou.Services.LocalPhotoService.SaveImageFileAsync	(	string	slug,
		IBrowserFile	file,
		string	destinationDirectory,
		string	baseName,
		EffectiveMediaPolicy	policy,
		CancellationToken	ct )

inlineprivate

Image File Async 데이터를 저장합니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
file	file에 사용할 `IBrowserFile` 값입니다.
destinationDirectory	destination Directory에 사용할 `string` 값입니다.
baseName	base Name에 사용할 `string` 값입니다.
policy	policy에 사용할 `EffectiveMediaPolicy` 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값: Save Image File Async 작업에서 생성한 Task<string> 결과입니다.

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

    {
        var root = _tenants.GetTenantDataPath(slug);
        var originalDir = Path.Combine(root, "original");
        var originalExt = Path.GetExtension(file.Name).ToLowerInvariant();
        var tempPath = Path.Combine(destinationDirectory, $"{baseName}.upload{originalExt}");
        Directory.CreateDirectory(destinationDirectory);
 
        await using (var dest = File.Create(tempPath))
        {
            await file.OpenReadStream(MaxImageUploadBytes, ct).CopyToAsync(dest, ct).ConfigureAwait(false);
        }
 
        if (policy.KeepOriginalImages)
        {
            Directory.CreateDirectory(originalDir);
            File.Copy(tempPath, Path.Combine(originalDir, $"{baseName}{originalExt}"), overwrite: true);
        }
 
        var outputFormat = ResolveWritableOutputFormat(policy.ImageOutputFormat, originalExt);
        if (!string.IsNullOrWhiteSpace(outputFormat))
        {
            var outputExt = $".{outputFormat}";
            var optimizedName = $"{baseName}{outputExt}";
            var optimizedPath = Path.Combine(destinationDirectory, optimizedName);
            var tempOptimizedPath = Path.Combine(destinationDirectory, $"{baseName}.optimized.tmp{outputExt}");
            var result = await _imageOptimization.OptimizeAsync(tempPath, tempOptimizedPath, policy, ct).ConfigureAwait(false);
            if (result.Succeeded && File.Exists(tempOptimizedPath))
            {
                File.Move(tempOptimizedPath, optimizedPath, overwrite: true);
                File.Delete(tempPath);
                return optimizedName;
            }
 
            if (File.Exists(tempOptimizedPath))
            {
                File.Delete(tempOptimizedPath);
            }
        }
 
        var fallbackName = $"{baseName}{originalExt}";
        var fallbackPath = Path.Combine(destinationDirectory, fallbackName);
        File.Move(tempPath, fallbackPath, overwrite: true);
        return fallbackName;
    }

다음을 참조함 : _imageOptimization, _tenants, WeddingThankYou.Models.EffectiveMediaPolicy.ImageOutputFormat, WeddingThankYou.Models.EffectiveMediaPolicy.KeepOriginalImages, MaxImageUploadBytes, ResolveWritableOutputFormat().

다음에 의해서 참조됨 : UploadAsync(), UploadHeroAsync(), UploadOgImageAsync(), UploadRoadMapAsync().

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

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

◆ UniqueFileName()

string WeddingThankYou.Services.LocalPhotoService.UniqueFileName ( string originalName )

inlinestaticprivate

Unique File Name 작업을 수행합니다.

매개변수

originalName original Name에 사용할 string 값입니다.

반환값: Unique File Name 작업에서 생성한 string 결과입니다.

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

    {
        var ext = Path.GetExtension(originalName).ToLowerInvariant();
        return $"{DateTime.Now:yyyyMMdd_HHmmss}_{Guid.NewGuid():N}{ext}";
    }

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

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

◆ UploadAsync()

async Task< string > WeddingThankYou.Services.LocalPhotoService.UploadAsync	(	string	slug,
		IBrowserFile	file,
		CancellationToken	ct = default )

inline

Upload Async 작업을 수행합니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
file	file에 사용할 `IBrowserFile` 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값: Upload Async 작업에서 생성한 Task<string> 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

    {
        ValidateImageFile(file);
        var config = await _tenants.GetAsync(slug, ct).ConfigureAwait(false) ?? new TenantConfig { Slug = slug };
        var policy = await _policyResolver.ResolveAsync(config, ct).ConfigureAwait(false);
        await ValidateImageQuotaAsync(config, policy, file, countGalleryImage: true, ct).ConfigureAwait(false);
 
        var baseName = Path.GetFileNameWithoutExtension(UniqueFileName(file.Name));
        var galleryDir = Path.Combine(_tenants.GetTenantDataPath(slug), "gallery");
        var thumbDir = Path.Combine(_tenants.GetTenantDataPath(slug), "thumb");
        Directory.CreateDirectory(galleryDir);
        Directory.CreateDirectory(thumbDir);
 
        var fileName = await SaveImageFileAsync(slug, file, galleryDir, baseName, policy, ct).ConfigureAwait(false);
        File.Copy(Path.Combine(galleryDir, fileName), Path.Combine(thumbDir, fileName), overwrite: true);
 
        if (!config.GalleryFileNames.Contains(fileName))
            config.GalleryFileNames.Add(fileName);
        await _tenants.SaveAsync(config, ct).ConfigureAwait(false);
 
        return fileName;
    }

다음을 참조함 : _policyResolver, _tenants, SaveImageFileAsync(), UniqueFileName(), ValidateImageFile(), ValidateImageQuotaAsync().

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

◆ UploadHeroAsync()

async Task< string > WeddingThankYou.Services.LocalPhotoService.UploadHeroAsync	(	string	slug,
		IBrowserFile	file,
		CancellationToken	ct = default )

inline

Upload Hero Async 작업을 수행합니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
file	file에 사용할 `IBrowserFile` 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값: Upload Hero Async 작업에서 생성한 Task<string> 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

    {
        ValidateImageFile(file);
        var config = await _tenants.GetAsync(slug, ct).ConfigureAwait(false) ?? new TenantConfig { Slug = slug };
        var policy = await _policyResolver.ResolveAsync(config, ct).ConfigureAwait(false);
        await ValidateImageQuotaAsync(config, policy, file, countGalleryImage: false, ct).ConfigureAwait(false);
 
        var dir = _tenants.GetTenantDataPath(slug);
        Directory.CreateDirectory(dir);
 
        var fileName = await SaveImageFileAsync(slug, file, dir, "hero", policy, ct).ConfigureAwait(false);
        config.HeroImageFileName = fileName;
        await _tenants.SaveAsync(config, ct).ConfigureAwait(false);
 
        return fileName;
    }

다음을 참조함 : _policyResolver, _tenants, SaveImageFileAsync(), ValidateImageFile(), ValidateImageQuotaAsync().

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

◆ UploadMusicAsync()

async Task< string > WeddingThankYou.Services.LocalPhotoService.UploadMusicAsync	(	string	slug,
		IBrowserFile	file,
		CancellationToken	ct = default )

inline

Upload Music Async 작업을 수행합니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
file	file에 사용할 `IBrowserFile` 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값: Upload Music Async 작업에서 생성한 Task<string> 결과입니다.

예외

InvalidOperationException 현재 객체 상태에서 Upload Music Async 작업을 수행할 수 없는 경우 발생합니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

    {
        var ext = Path.GetExtension(file.Name).ToLowerInvariant();
        if (ext is not (".mp3" or ".ogg" or ".wav" or ".aac" or ".m4a"))
            throw new InvalidOperationException($"허용되지 않는 오디오 형식입니다: {ext}");
        if (file.Size > 30 * 1024 * 1024)
            throw new InvalidOperationException("음악 파일은 30MB 이하여야 합니다.");
 
        var dir = _tenants.GetTenantDataPath(slug);
        Directory.CreateDirectory(dir);
 
        var fileName = $"bgmusic{ext}";
        var destPath = Path.Combine(dir, fileName);
        await using (var dest = File.Create(destPath))
            await file.OpenReadStream(30 * 1024 * 1024, ct).CopyToAsync(dest, ct).ConfigureAwait(false);
 
        var config = await _tenants.GetAsync(slug, ct).ConfigureAwait(false) ?? new TenantConfig { Slug = slug };
        config.MusicFileName = fileName;
        await _tenants.SaveAsync(config, ct).ConfigureAwait(false);
 
        return fileName;
    }

다음을 참조함 : _tenants.

◆ UploadOgImageAsync()

async Task< string > WeddingThankYou.Services.LocalPhotoService.UploadOgImageAsync	(	string	slug,
		IBrowserFile	file,
		CancellationToken	ct = default )

inline

Upload Og Image Async 작업을 수행합니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
file	file에 사용할 `IBrowserFile` 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값: Upload Og Image Async 작업에서 생성한 Task<string> 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

    {
        ValidateImageFile(file);
        var config = await _tenants.GetAsync(slug, ct).ConfigureAwait(false) ?? new TenantConfig { Slug = slug };
        var policy = await _policyResolver.ResolveAsync(config, ct).ConfigureAwait(false);
        await ValidateImageQuotaAsync(config, policy, file, countGalleryImage: false, ct).ConfigureAwait(false);
 
        var dir = _tenants.GetTenantDataPath(slug);
        Directory.CreateDirectory(dir);
 
        var fileName = await SaveImageFileAsync(slug, file, dir, "og", policy, ct).ConfigureAwait(false);
        config.OgImageFileName = fileName;
        await _tenants.SaveAsync(config, ct).ConfigureAwait(false);
 
        return fileName;
    }

다음을 참조함 : _policyResolver, _tenants, SaveImageFileAsync(), ValidateImageFile(), ValidateImageQuotaAsync().

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

◆ UploadRoadMapAsync()

async Task< string > WeddingThankYou.Services.LocalPhotoService.UploadRoadMapAsync	(	string	slug,
		IBrowserFile	file,
		CancellationToken	ct = default )

inline

Upload Road Map Async 작업을 수행합니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
file	file에 사용할 `IBrowserFile` 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값: Upload Road Map Async 작업에서 생성한 Task<string> 결과입니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

    {
        ValidateImageFile(file);
        var config = await _tenants.GetAsync(slug, ct).ConfigureAwait(false) ?? new TenantConfig { Slug = slug };
        var policy = await _policyResolver.ResolveAsync(config, ct).ConfigureAwait(false);
        await ValidateImageQuotaAsync(config, policy, file, countGalleryImage: false, ct).ConfigureAwait(false);
 
        var dir = _tenants.GetTenantDataPath(slug);
        Directory.CreateDirectory(dir);
 
        var fileName = await SaveImageFileAsync(slug, file, dir, "roadmap", policy, ct).ConfigureAwait(false);
        config.RoadMapFileName = fileName;
        await _tenants.SaveAsync(config, ct).ConfigureAwait(false);
 
        return fileName;
    }

다음을 참조함 : _policyResolver, _tenants, SaveImageFileAsync(), ValidateImageFile(), ValidateImageQuotaAsync().

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

◆ UploadVideoAsync()

async Task< string > WeddingThankYou.Services.LocalPhotoService.UploadVideoAsync	(	string	slug,
		IBrowserFile	file,
		CancellationToken	ct = default )

inline

Upload Video Async 작업을 수행합니다.

매개변수

slug	slug에 사용할 `string` 값입니다.
file	file에 사용할 `IBrowserFile` 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값: Upload Video Async 작업에서 생성한 Task<string> 결과입니다.

예외

InvalidOperationException 현재 객체 상태에서 Upload Video Async 작업을 수행할 수 없는 경우 발생합니다.

WeddingThankYou.Services.IPhotoService를 구현.

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

    {
        var ext = Path.GetExtension(file.Name).ToLowerInvariant();
        if (ext is not (".mp4" or ".webm" or ".mov" or ".m4v"))
            throw new InvalidOperationException($"허용되지 않는 동영상 형식입니다: {ext}. mp4/webm/mov 권장");
 
        var config = await _tenants.GetAsync(slug, ct).ConfigureAwait(false) ?? new TenantConfig { Slug = slug };
        var policy = await _policyResolver.ResolveAsync(config, ct).ConfigureAwait(false);
 
        var effectiveCount = policy.VideoMaxCount;
        if (effectiveCount > 0 && config.VideoFileNames.Count >= effectiveCount)
            throw new InvalidOperationException($"동영상은 최대 {effectiveCount}개까지 업로드할 수 있습니다.");
 
        var effectiveMb = policy.VideoMaxFileSizeMb;
        var maxBytes = policy.VideoMaxFileSizeBytes;
 
        if (file.Size > maxBytes)
            throw new InvalidOperationException($"동영상 파일은 {effectiveMb}MB 이하여야 합니다.");
 
        if (policy.VideoMaxStorageMb > 0)
        {
            var usage = await _usageQuery.GetTenantUsageAsync(config, ct).ConfigureAwait(false);
            if (usage.VideoBytes + file.Size > policy.VideoMaxStorageBytes)
            {
                throw new InvalidOperationException($"동영상 저장 용량은 최대 {policy.VideoMaxStorageMb}MB까지 사용할 수 있습니다.");
            }
        }
 
        var dir = _tenants.GetTenantDataPath(slug);
        Directory.CreateDirectory(dir);
 
        var fileName = $"video-{DateTime.Now:yyyyMMdd_HHmmss}_{Guid.NewGuid().ToString("N")[..8]}{ext}";
        var destPath = Path.Combine(dir, fileName);
        await using (var dest = File.Create(destPath))
            await file.OpenReadStream(maxBytes, ct).CopyToAsync(dest, ct).ConfigureAwait(false);
 
        config.VideoFileNames.Add(fileName);
        await _tenants.SaveAsync(config, ct).ConfigureAwait(false);
 
        return fileName;
    }

다음을 참조함 : _policyResolver, _tenants, _usageQuery.

◆ ValidateImageFile()

void WeddingThankYou.Services.LocalPhotoService.ValidateImageFile ( IBrowserFile file )

inlinestaticprivate

Image File 값의 유효성을 검사합니다.

매개변수

file	file에 사용할 `IBrowserFile` 값입니다.

예외

InvalidOperationException 현재 객체 상태에서 Validate Image File 작업을 수행할 수 없는 경우 발생합니다.

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

    {
        var ext = Path.GetExtension(file.Name).ToLowerInvariant();
        if (!Array.Exists(AllowedExts, e => e == ext))
            throw new InvalidOperationException($"허용되지 않는 파일 형식입니다: {ext}");
        if (file.Size > MaxImageUploadBytes)
            throw new InvalidOperationException("이미지 파일 크기는 200MB 이하여야 합니다.");
    }

다음을 참조함 : AllowedExts, MaxImageUploadBytes.

다음에 의해서 참조됨 : UploadAsync(), UploadHeroAsync(), UploadOgImageAsync(), UploadRoadMapAsync().

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

◆ ValidateImageQuotaAsync()

async Task WeddingThankYou.Services.LocalPhotoService.ValidateImageQuotaAsync	(	TenantConfig	config,
		EffectiveMediaPolicy	policy,
		IBrowserFile	file,
		bool	countGalleryImage,
		CancellationToken	ct )

inlineprivate

Image Quota Async 값의 유효성을 검사합니다.

매개변수

config	config에 사용할 `TenantConfig` 값입니다.
policy	policy에 사용할 `EffectiveMediaPolicy` 값입니다.
file	file에 사용할 `IBrowserFile` 값입니다.
countGalleryImage	count Gallery Image에 사용할 `bool` 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값: Validate Image Quota Async 작업에서 생성한 Task 결과입니다.

예외

InvalidOperationException 현재 객체 상태에서 Validate Image Quota Async 작업을 수행할 수 없는 경우 발생합니다.

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

    {
        if (countGalleryImage && policy.ImageMaxCount > 0 && config.GalleryFileNames.Count >= policy.ImageMaxCount)
        {
            throw new InvalidOperationException($"이미지는 최대 {policy.ImageMaxCount}장까지 업로드할 수 있습니다.");
        }
 
        if (policy.ImageOptimizedMaxStorageMb > 0)
        {
            var usage = await _usageQuery.GetTenantUsageAsync(config, ct).ConfigureAwait(false);
            if (usage.OptimizedImageBytes + file.Size > policy.ImageOptimizedMaxStorageBytes)
            {
                throw new InvalidOperationException($"이미지 저장 용량은 최대 {policy.ImageOptimizedMaxStorageMb}MB까지 사용할 수 있습니다.");
            }
        }
    }

다음을 참조함 : _usageQuery, WeddingThankYou.Models.TenantConfig.GalleryFileNames, WeddingThankYou.Models.EffectiveMediaPolicy.ImageMaxCount, WeddingThankYou.Models.EffectiveMediaPolicy.ImageOptimizedMaxStorageBytes, WeddingThankYou.Models.EffectiveMediaPolicy.ImageOptimizedMaxStorageMb.

다음에 의해서 참조됨 : UploadAsync(), UploadHeroAsync(), UploadOgImageAsync(), UploadRoadMapAsync().

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

멤버 데이터 문서화

◆ _imageOptimization

readonly IImageOptimizationService WeddingThankYou.Services.LocalPhotoService._imageOptimization

private

image Optimization 값을 보관합니다.

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

다음에 의해서 참조됨 : LocalPhotoService(), ResolveWritableOutputFormat(), SaveImageFileAsync().

◆ _policyResolver

readonly IMediaQuotaPolicyResolver WeddingThankYou.Services.LocalPhotoService._policyResolver

private

policy Resolver 값을 보관합니다.

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

다음에 의해서 참조됨 : LocalPhotoService(), UploadAsync(), UploadHeroAsync(), UploadOgImageAsync(), UploadRoadMapAsync(), UploadVideoAsync().

◆ _tenants

readonly ITenantStore WeddingThankYou.Services.LocalPhotoService._tenants

private

tenants 값을 보관합니다.

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

다음에 의해서 참조됨 : DeleteAsync(), DeleteVideoAsync(), GalleryPath(), GetGalleryAsync(), LocalPhotoService(), SaveImageFileAsync(), UploadAsync(), UploadHeroAsync(), UploadMusicAsync(), UploadOgImageAsync(), UploadRoadMapAsync(), UploadVideoAsync().

◆ _usageQuery

readonly IMediaUsageQueryService WeddingThankYou.Services.LocalPhotoService._usageQuery

private

usage Query 값을 보관합니다.

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

다음에 의해서 참조됨 : LocalPhotoService(), UploadVideoAsync(), ValidateImageQuotaAsync().

◆ AllowedExts

readonly string [] WeddingThankYou.Services.LocalPhotoService.AllowedExts = [".jpg", ".jpeg", ".png", ".webp", ".gif"]

staticprivate

Allowed Exts 값을 보관합니다.

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

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

◆ MaxImageUploadBytes

const long WeddingThankYou.Services.LocalPhotoService.MaxImageUploadBytes = 200 * 1024 * 1024

staticprivate

Max Image Upload Bytes 값을 보관합니다.

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

다음에 의해서 참조됨 : SaveImageFileAsync(), ValidateImageFile().

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

LocalPhotoService.cs

Public 멤버 함수

Private 멤버 함수

정적 Private 멤버 함수

Private 속성

정적 Private 속성

상세한 설명

생성자 & 소멸자 문서화

◆ LocalPhotoService()

멤버 함수 문서화

◆ DeleteAsync()

◆ DeleteVideoAsync()

◆ GalleryPath()

◆ GetGalleryAsync()

◆ GetHeroUrl()

◆ GetMusicUrl()

◆ GetPhotoUrl()

◆ GetRoadMapUrl()

◆ GetThumbUrl()

◆ GetVideoUrl()

◆ NormalizeOutputExtension()

◆ ResolveWritableOutputFormat()

◆ SaveImageFileAsync()

◆ UniqueFileName()

◆ UploadAsync()

◆ UploadHeroAsync()

◆ UploadMusicAsync()

◆ UploadOgImageAsync()

◆ UploadRoadMapAsync()

◆ UploadVideoAsync()

◆ ValidateImageFile()

◆ ValidateImageQuotaAsync()

멤버 데이터 문서화

◆ _imageOptimization

◆ _policyResolver

◆ _tenants

◆ _usageQuery

◆ AllowedExts

◆ MaxImageUploadBytes