FamiliesApp.Services.LocalMediaService 클래스 참조

더 자세히 ...

FamiliesApp.Services.LocalMediaService에 대한 상속 다이어그램 :

FamiliesApp.Services.LocalMediaService에 대한 협력 다이어그램:

Public 멤버 함수
	LocalMediaService (IFamilyTenantStore tenants, IGlobalSettingsStore globalSettings)
async Task< string >	UploadPostMediaAsync (string slug, string postId, IBrowserFile file, CancellationToken ct=default)
async Task< string >	UploadCoverAsync (string slug, IBrowserFile file, CancellationToken ct=default)
Task	DeletePostMediaAsync (string slug, string postId, string fileName, CancellationToken ct=default)
Task< IReadOnlyList< MediaInfo > >	GetPostMediaAsync (string slug, string postId, CancellationToken ct=default)
string	GetMediaUrl (string slug, string postId, string fileName)
string	GetThumbUrl (string slug, string postId, string fileName)
string	GetCoverUrl (string slug, string fileName)

Private 멤버 함수
async Task<(long ImageBytes, long VideoBytes)>	GetLimitsAsync (string slug, CancellationToken ct)

정적 Private 멤버 함수
static long	ToBytes (int mb)
static string	FormatLimit (long bytes)

Private 속성
readonly IFamilyTenantStore	_tenants
readonly IGlobalSettingsStore	_globalSettings

정적 Private 속성
static readonly string[]	AllowedImageExts = [".jpg", ".jpeg", ".png", ".webp", ".gif"]
static readonly string[]	AllowedVideoExts = [".mp4", ".webm", ".mov", ".m4v"]

상세한 설명

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

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

생성자 & 소멸자 문서화

LocalMediaService()

FamiliesApp.Services.LocalMediaService.LocalMediaService ( IFamilyTenantStore tenants, IGlobalSettingsStore globalSettings )

inline

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

매개변수

tenants	tenants에 사용할 IFamilyTenantStore 값입니다.
globalSettings	global Settings에 사용할 IGlobalSettingsStore 값입니다.

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

    {
        _tenants = tenants;
        _globalSettings = globalSettings;
    }

다음을 참조함 : _globalSettings, _tenants.

멤버 함수 문서화

DeletePostMediaAsync()

Task FamiliesApp.Services.LocalMediaService.DeletePostMediaAsync ( string slug, string postId, string fileName, CancellationToken ct = default )

inline

Delete Post Media Async 작업을 수행합니다.

매개변수

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

반환값

Delete Post Media Async 작업에서 생성한 Task 결과입니다.

FamiliesApp.Services.IMediaService를 구현.

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

    {
        var path = Path.Combine(_tenants.GetTenantDataPath(slug), "media", postId, fileName);
        if (File.Exists(path)) File.Delete(path);
        return Task.CompletedTask;
    }

다음을 참조함 : _tenants.

FormatLimit()

string FamiliesApp.Services.LocalMediaService.FormatLimit ( long bytes )

inlinestaticprivate

Format Limit 작업을 수행합니다.

매개변수

bytes

bytes에 사용할 long 값입니다.

반환값

Format Limit 작업에서 생성한 string 결과입니다.

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

                                                  =>
        bytes == long.MaxValue ? "무제한" : $"{bytes / (1024 * 1024)}MB";

GetCoverUrl()

string FamiliesApp.Services.LocalMediaService.GetCoverUrl ( string slug, string fileName )

inline

Cover Url 값을 가져옵니다.

매개변수

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

반환값

Get Cover Url 작업에서 생성한 string 결과입니다.

FamiliesApp.Services.IMediaService를 구현.

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

                                                            =>
        $"/family-data/{slug}/{Uri.EscapeDataString(fileName)}";

GetLimitsAsync()

async Task<(long ImageBytes, long VideoBytes)> FamiliesApp.Services.LocalMediaService.GetLimitsAsync ( string slug, CancellationToken ct )

inlineprivate

Limits Async 값을 가져옵니다.

매개변수

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

반환값

Get Limits Async 작업에서 생성한 Task<(long ImageBytes, long VideoBytes)> 결과입니다.

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

    {
        var config = await _tenants.GetAsync(slug, ct).ConfigureAwait(false);
        var settings = await _globalSettings.GetAsync(ct).ConfigureAwait(false);
 
        var imageMb = config?.MaxImageSizeMb ?? settings.MaxImageSizeMb;
        var videoMb = config?.MaxVideoSizeMb ?? settings.MaxVideoSizeMb;
        return (ToBytes(imageMb), ToBytes(videoMb));
    }

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

다음에 의해서 참조됨 : UploadCoverAsync(), UploadPostMediaAsync().

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

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

GetMediaUrl()

string FamiliesApp.Services.LocalMediaService.GetMediaUrl ( string slug, string postId, string fileName )

inline

Media Url 값을 가져옵니다.

매개변수

slug	slug에 사용할 string 값입니다.
postId	post Id에 사용할 string 값입니다.
fileName	file Name에 사용할 string 값입니다.

반환값

Get Media Url 작업에서 생성한 string 결과입니다.

FamiliesApp.Services.IMediaService를 구현.

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

                                                                           =>
        $"/family-data/{slug}/media/{postId}/{Uri.EscapeDataString(fileName)}";

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

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

GetPostMediaAsync()

Task< IReadOnlyList< MediaInfo > > FamiliesApp.Services.LocalMediaService.GetPostMediaAsync ( string slug, string postId, CancellationToken ct = default )

inline

Post Media Async 값을 가져옵니다.

매개변수

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

반환값

Get Post Media Async 작업에서 생성한 Task<IReadOnlyList<MediaInfo>> 결과입니다.

FamiliesApp.Services.IMediaService를 구현.

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

    {
        var dir = Path.Combine(_tenants.GetTenantDataPath(slug), "media", postId);
        if (!Directory.Exists(dir)) return Task.FromResult<IReadOnlyList<MediaInfo>>([]);
 
        var list = Directory.GetFiles(dir)
            .Select(f =>
            {
                var fi = new FileInfo(f);
                return new MediaInfo
                {
                    FileName = fi.Name,
                    Url = GetMediaUrl(slug, postId, fi.Name),
                    ThumbUrl = GetThumbUrl(slug, postId, fi.Name),
                    SizeBytes = fi.Length,
                    LastModified = fi.LastWriteTime
                };
            })
            .ToList();
 
        return Task.FromResult<IReadOnlyList<MediaInfo>>(list);
    }

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

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

GetThumbUrl()

string FamiliesApp.Services.LocalMediaService.GetThumbUrl ( string slug, string postId, string fileName )

inline

Thumb Url 값을 가져옵니다.

매개변수

slug	slug에 사용할 string 값입니다.
postId	post Id에 사용할 string 값입니다.
fileName	file Name에 사용할 string 값입니다.

반환값

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

FamiliesApp.Services.IMediaService를 구현.

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

                                                                           =>
        GetMediaUrl(slug, postId, fileName);

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

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

ToBytes()

long FamiliesApp.Services.LocalMediaService.ToBytes ( int mb )

inlinestaticprivate

To Bytes 작업을 수행합니다.

매개변수

mb	mb에 사용할 int 값입니다.

반환값

To Bytes 작업에서 생성한 long 결과입니다.

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

=> mb <= 0 ? long.MaxValue : mb * 1024L * 1024L;

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

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

UploadCoverAsync()

async Task< string > FamiliesApp.Services.LocalMediaService.UploadCoverAsync ( string slug, IBrowserFile file, CancellationToken ct = default )

inline

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

매개변수

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

반환값

Upload Cover Async 작업에서 생성한 Task<string> 결과입니다.

예외

InvalidOperationException

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

FamiliesApp.Services.IMediaService를 구현.

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

    {
        var ext = Path.GetExtension(file.Name).ToLowerInvariant();
        if (!Array.Exists(AllowedImageExts, e => e == ext))
            throw new InvalidOperationException($"허용되지 않는 이미지 형식입니다: {ext}");
 
        var (imageLimit, _) = await GetLimitsAsync(slug, ct).ConfigureAwait(false);
        if (file.Size > imageLimit)
            throw new InvalidOperationException($"커버 이미지는 {FormatLimit(imageLimit)} 이하여야 합니다.");
 
        var dir = _tenants.GetTenantDataPath(slug);
        Directory.CreateDirectory(dir);
 
        var fileName = $"cover{ext}";
        await using var dest = File.Create(Path.Combine(dir, fileName));
        await file.OpenReadStream(imageLimit, ct).CopyToAsync(dest, ct).ConfigureAwait(false);
 
        var config = await _tenants.GetAsync(slug, ct).ConfigureAwait(false) ?? new Models.FamilyConfig { Slug = slug };
        config.CoverImageFileName = fileName;
        await _tenants.SaveAsync(config, ct).ConfigureAwait(false);
 
        return fileName;
    }

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

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

UploadPostMediaAsync()

async Task< string > FamiliesApp.Services.LocalMediaService.UploadPostMediaAsync ( string slug, string postId, IBrowserFile file, CancellationToken ct = default )

inline

Upload Post Media Async 작업을 수행합니다.

매개변수

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

반환값

Upload Post Media Async 작업에서 생성한 Task<string> 결과입니다.

예외

InvalidOperationException

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

FamiliesApp.Services.IMediaService를 구현.

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

    {
        var ext = Path.GetExtension(file.Name).ToLowerInvariant();
        bool isVideo = Array.Exists(AllowedVideoExts, e => e == ext);
        bool isImage = Array.Exists(AllowedImageExts, e => e == ext);
 
        if (!isVideo && !isImage)
            throw new InvalidOperationException($"허용되지 않는 파일 형식입니다: {ext}");
 
        var (imageLimit, videoLimit) = await GetLimitsAsync(slug, ct).ConfigureAwait(false);
        var limit = isVideo ? videoLimit : imageLimit;
        if (file.Size > limit)
            throw new InvalidOperationException(isVideo
                ? $"동영상은 {FormatLimit(videoLimit)} 이하여야 합니다."
                : $"이미지는 {FormatLimit(imageLimit)} 이하여야 합니다.");
 
        var mediaDir = Path.Combine(_tenants.GetTenantDataPath(slug), "media", postId);
        Directory.CreateDirectory(mediaDir);
 
        var fileName = $"{DateTime.Now:yyyyMMdd_HHmmss}_{Guid.NewGuid():N}{ext}";
        var destPath = Path.Combine(mediaDir, fileName);
 
        await using var dest = File.Create(destPath);
        await file.OpenReadStream(limit, ct).CopyToAsync(dest, ct).ConfigureAwait(false);
 
        return fileName;
    }

다음을 참조함 : _tenants, AllowedImageExts, AllowedVideoExts, GetLimitsAsync().

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

멤버 데이터 문서화

_globalSettings

readonly IGlobalSettingsStore FamiliesApp.Services.LocalMediaService._globalSettings

private

global Settings 값을 보관합니다.

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

다음에 의해서 참조됨 : GetLimitsAsync(), LocalMediaService().

_tenants

readonly IFamilyTenantStore FamiliesApp.Services.LocalMediaService._tenants

private

tenants 값을 보관합니다.

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

다음에 의해서 참조됨 : DeletePostMediaAsync(), GetLimitsAsync(), GetPostMediaAsync(), LocalMediaService(), UploadCoverAsync(), UploadPostMediaAsync().

AllowedImageExts

readonly string [] FamiliesApp.Services.LocalMediaService.AllowedImageExts = [".jpg", ".jpeg", ".png", ".webp", ".gif"]

staticprivate

Allowed Image Exts 값을 보관합니다.

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

다음에 의해서 참조됨 : UploadCoverAsync(), UploadPostMediaAsync().

AllowedVideoExts

readonly string [] FamiliesApp.Services.LocalMediaService.AllowedVideoExts = [".mp4", ".webm", ".mov", ".m4v"]

staticprivate

Allowed Video Exts 값을 보관합니다.

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

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

---

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

• LocalMediaService.cs