DreamineWeb.Services.PlaygroundMediaService 클래스 참조

더 자세히 ...

Public 멤버 함수
	PlaygroundMediaService ()
async Task< string >	SaveAsync (IBrowserFile file, string demoId, string platform, CancellationToken ct=default)

정적 Private 멤버 함수
static string	SafeSegment (string? value, string fallback)
static string	GuessExtension (string? contentType)

Private 속성
readonly string	_uploadRoot

정적 Private 속성
static readonly Regex	UnsafeName = new(@"[^a-zA-Z0-9._-]+", RegexOptions.Compiled)

상세한 설명

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

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

생성자 & 소멸자 문서화

PlaygroundMediaService()

DreamineWeb.Services.PlaygroundMediaService.PlaygroundMediaService ( )

inline

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

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

    {
        _uploadRoot = Path.Combine(AppContext.BaseDirectory, "wwwroot", "uploads", "playground");
    }

다음을 참조함 : _uploadRoot.

멤버 함수 문서화

GuessExtension()

string DreamineWeb.Services.PlaygroundMediaService.GuessExtension ( string? contentType )

inlinestaticprivate

Guess Extension 작업을 수행합니다.

매개변수

contentType

content Type에 사용할 string? 값입니다.

반환값

Guess Extension 작업에서 생성한 string 결과입니다.

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

                                                              => contentType?.ToLowerInvariant() switch
    {
        "image/png" => ".png",
        "image/jpeg" => ".jpg",
        "image/gif" => ".gif",
        "image/webp" => ".webp",
        "image/svg+xml" => ".svg",
        "video/mp4" => ".mp4",
        "video/webm" => ".webm",
        "video/quicktime" => ".mov",
        _ => ".bin"
    };

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

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

SafeSegment()

string DreamineWeb.Services.PlaygroundMediaService.SafeSegment ( string? value, string fallback )

inlinestaticprivate

Safe Segment 작업을 수행합니다.

매개변수

value	적용할 값입니다.
fallback	fallback에 사용할 string 값입니다.

반환값

Safe Segment 작업에서 생성한 string 결과입니다.

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

    {
        value = string.IsNullOrWhiteSpace(value) ? fallback : value.Trim();
        var safe = UnsafeName.Replace(value, "-").Trim('-', '.');
        return string.IsNullOrWhiteSpace(safe) ? fallback : safe;
    }

다음을 참조함 : UnsafeName.

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

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

SaveAsync()

async Task< string > DreamineWeb.Services.PlaygroundMediaService.SaveAsync ( IBrowserFile file, string demoId, string platform, CancellationToken ct = default )

inline

Async 데이터를 저장합니다.

매개변수

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

반환값

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

예외

InvalidOperationException

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

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

    {
        if (file.Size <= 0) throw new InvalidOperationException("Empty files cannot be uploaded.");
 
        var safeDemoId = SafeSegment(demoId, "demo");
        var safePlatform = SafeSegment(platform, "platform");
        var extension = Path.GetExtension(file.Name);
        if (string.IsNullOrWhiteSpace(extension)) extension = GuessExtension(file.ContentType);
 
        var targetDir = Path.Combine(_uploadRoot, safeDemoId);
        Directory.CreateDirectory(targetDir);
 
        var fileName = $"{safePlatform}-{DateTime.UtcNow:yyyyMMddHHmmss}-{Guid.NewGuid().ToString("N")[..8]}{extension.ToLowerInvariant()}";
        var path = Path.Combine(targetDir, fileName);
 
        await using var input = file.OpenReadStream(maxAllowedSize: 200 * 1024 * 1024, cancellationToken: ct);
        await using var output = File.Create(path);
        await input.CopyToAsync(output, ct);
 
        return $"/uploads/playground/{safeDemoId}/{fileName}";
    }

다음을 참조함 : _uploadRoot, GuessExtension(), SafeSegment().

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

멤버 데이터 문서화

_uploadRoot

readonly string DreamineWeb.Services.PlaygroundMediaService._uploadRoot

private

upload Root 값을 보관합니다.

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

다음에 의해서 참조됨 : PlaygroundMediaService(), SaveAsync().

UnsafeName

readonly Regex DreamineWeb.Services.PlaygroundMediaService.UnsafeName = new(@"[^a-zA-Z0-9._-]+", RegexOptions.Compiled)

staticprivate

Unsafe Name 값을 보관합니다.

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

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

---

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

• PlaygroundMediaService.cs