FamiliesApp.Services.JsonPostStore 클래스 참조

더 자세히 ...

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

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

Public 멤버 함수
	JsonPostStore (IFamilyTenantStore tenants)
async Task< PostEntry?>	GetAsync (string slug, string postId, CancellationToken ct=default)
async Task< IReadOnlyList< PostEntry > >	GetAllAsync (string slug, CancellationToken ct=default)
async Task<(IReadOnlyList< PostEntry > Items, int TotalCount)>	GetPageAsync (string slug, int page, int pageSize, CancellationToken ct=default)
async Task< IReadOnlyList< PostEntry > >	GetByAlbumAsync (string slug, string albumId, CancellationToken ct=default)
async Task<(IReadOnlyList< PostEntry > Items, int TotalCount)>	GetByAlbumPageAsync (string slug, string albumId, int page, int pageSize, CancellationToken ct=default)
async Task	SaveAsync (string slug, PostEntry post, CancellationToken ct=default)
Task	DeleteAsync (string slug, string postId, CancellationToken ct=default)

Private 멤버 함수
string	PostsDir (string slug)
string	PostPath (string slug, string postId)

정적 Private 멤버 함수
static string	Sanitize (string id)

Private 속성
readonly IFamilyTenantStore	_tenants

정적 Private 속성
static readonly SemaphoreSlim	_gate = new(1, 1)
static readonly JsonSerializerOptions	_jsonOpts

상세한 설명

Json Post Store 기능과 관련 상태를 캡슐화합니다.

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

생성자 & 소멸자 문서화

JsonPostStore()

FamiliesApp.Services.JsonPostStore.JsonPostStore ( IFamilyTenantStore tenants )

inline

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

매개변수

tenants

tenants에 사용할 IFamilyTenantStore 값입니다.

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

=> _tenants = tenants;

다음을 참조함 : _tenants.

멤버 함수 문서화

DeleteAsync()

Task FamiliesApp.Services.JsonPostStore.DeleteAsync ( string slug, string postId, CancellationToken ct = default )

inline

Delete Async 작업을 수행합니다.

매개변수

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

반환값

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

FamiliesApp.Services.IPostStore를 구현.

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

    {
        var path = PostPath(slug, postId);
        if (File.Exists(path)) File.Delete(path);
 
        var mediaDir = Path.Combine(_tenants.GetTenantDataPath(slug), "media", postId);
        if (Directory.Exists(mediaDir)) Directory.Delete(mediaDir, recursive: true);
 
        return Task.CompletedTask;
    }

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

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

GetAllAsync()

async Task< IReadOnlyList< PostEntry > > FamiliesApp.Services.JsonPostStore.GetAllAsync ( string slug, CancellationToken ct = default )

inline

All Async 값을 가져옵니다.

매개변수

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

반환값

Get All Async 작업에서 생성한 Task<IReadOnlyList<PostEntry>> 결과입니다.

FamiliesApp.Services.IPostStore를 구현.

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

    {
        var dir = PostsDir(slug);
        if (!Directory.Exists(dir)) return [];
 
        var list = new List<PostEntry>();
        foreach (var file in Directory.GetFiles(dir, "*.json"))
        {
            await _gate.WaitAsync(ct).ConfigureAwait(false);
            try
            {
                await using var fs = File.OpenRead(file);
                var p = await JsonSerializer.DeserializeAsync<PostEntry>(fs, _jsonOpts, ct).ConfigureAwait(false);
                if (p != null) list.Add(p);
            }
            catch { /* 깨진 파일 하나로 전체 목록이 죽지 않도록 */ }
            finally { _gate.Release(); }
        }
        return list.OrderByDescending(p => p.IsPinned).ThenByDescending(p => p.PostedAt).ToList();
    }

다음을 참조함 : _gate, _jsonOpts, PostsDir().

다음에 의해서 참조됨 : GetByAlbumAsync(), GetPageAsync().

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

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

GetAsync()

async Task< PostEntry?> FamiliesApp.Services.JsonPostStore.GetAsync ( string slug, string postId, CancellationToken ct = default )

inline

Async 값을 가져옵니다.

매개변수

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

반환값

Get Async 작업에서 생성한 Task<PostEntry?> 결과입니다.

FamiliesApp.Services.IPostStore를 구현.

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

    {
        var path = PostPath(slug, postId);
        if (!File.Exists(path)) return null;
 
        await _gate.WaitAsync(ct).ConfigureAwait(false);
        try
        {
            await using var fs = File.OpenRead(path);
            return await JsonSerializer.DeserializeAsync<PostEntry>(fs, _jsonOpts, ct).ConfigureAwait(false);
        }
        finally { _gate.Release(); }
    }

다음을 참조함 : _gate, _jsonOpts, PostPath().

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

GetByAlbumAsync()

async Task< IReadOnlyList< PostEntry > > FamiliesApp.Services.JsonPostStore.GetByAlbumAsync ( string slug, string albumId, CancellationToken ct = default )

inline

By Album Async 값을 가져옵니다.

매개변수

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

반환값

Get By Album Async 작업에서 생성한 Task<IReadOnlyList<PostEntry>> 결과입니다.

FamiliesApp.Services.IPostStore를 구현.

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

    {
        var all = await GetAllAsync(slug, ct).ConfigureAwait(false);
        return all.Where(p => p.AlbumId == albumId).ToList();
    }

다음을 참조함 : GetAllAsync().

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

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

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

GetByAlbumPageAsync()

async Task<(IReadOnlyList< PostEntry > Items, int TotalCount)> FamiliesApp.Services.JsonPostStore.GetByAlbumPageAsync ( string slug, string albumId, int page, int pageSize, CancellationToken ct = default )

inline

By Album Page Async 값을 가져옵니다.

매개변수

slug	slug에 사용할 string 값입니다.
albumId	album Id에 사용할 string 값입니다.
page	page에 사용할 int 값입니다.
pageSize	page Size에 사용할 int 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값

Get By Album Page Async 작업에서 생성한 Task<(IReadOnlyList<PostEntry> Items, int TotalCount)> 결과입니다.

FamiliesApp.Services.IPostStore를 구현.

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

    {
        var filtered = await GetByAlbumAsync(slug, albumId, ct).ConfigureAwait(false);
        var items = filtered.Skip((page - 1) * pageSize).Take(pageSize).ToList();
        return (items, filtered.Count);
    }

다음을 참조함 : GetByAlbumAsync().

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

GetPageAsync()

async Task<(IReadOnlyList< PostEntry > Items, int TotalCount)> FamiliesApp.Services.JsonPostStore.GetPageAsync ( string slug, int page, int pageSize, CancellationToken ct = default )

inline

Page Async 값을 가져옵니다.

매개변수

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

반환값

Get Page Async 작업에서 생성한 Task<(IReadOnlyList<PostEntry> Items, int TotalCount)> 결과입니다.

FamiliesApp.Services.IPostStore를 구현.

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

    {
        var all = await GetAllAsync(slug, ct).ConfigureAwait(false);
        var items = all.Skip((page - 1) * pageSize).Take(pageSize).ToList();
        return (items, all.Count);
    }

다음을 참조함 : GetAllAsync().

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

PostPath()

string FamiliesApp.Services.JsonPostStore.PostPath ( string slug, string postId )

inlineprivate

Post Path 작업을 수행합니다.

매개변수

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

반환값

Post Path 작업에서 생성한 string 결과입니다.

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

                                                        =>
        Path.Combine(PostsDir(slug), $"{Sanitize(postId)}.json");

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

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

PostsDir()

string FamiliesApp.Services.JsonPostStore.PostsDir ( string slug )

inlineprivate

Posts Dir 작업을 수행합니다.

매개변수

slug	slug에 사용할 string 값입니다.

반환값

Posts Dir 작업에서 생성한 string 결과입니다.

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

                                         =>
        Path.Combine(_tenants.GetTenantDataPath(slug), "posts");

다음을 참조함 : _tenants.

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

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

Sanitize()

string FamiliesApp.Services.JsonPostStore.Sanitize ( string id )

inlinestaticprivate

Sanitize 작업을 수행합니다.

매개변수

id	id에 사용할 string 값입니다.

반환값

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

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

                                              =>
        string.Concat(id.Split(Path.GetInvalidFileNameChars()));

SaveAsync()

async Task FamiliesApp.Services.JsonPostStore.SaveAsync ( string slug, PostEntry post, CancellationToken ct = default )

inline

Async 데이터를 저장합니다.

매개변수

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

반환값

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

FamiliesApp.Services.IPostStore를 구현.

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

    {
        var dir = PostsDir(slug);
        Directory.CreateDirectory(dir);
        Directory.CreateDirectory(Path.Combine(_tenants.GetTenantDataPath(slug), "media", post.Id));
 
        var path = PostPath(slug, post.Id);
        var tmp = path + ".tmp";
 
        await _gate.WaitAsync(ct).ConfigureAwait(false);
        try
        {
            await using (var fs = File.Create(tmp))
                await JsonSerializer.SerializeAsync(fs, post, _jsonOpts, ct).ConfigureAwait(false);
 
            File.Copy(tmp, path, overwrite: true);
            File.Delete(tmp);
        }
        finally { _gate.Release(); }
    }

다음을 참조함 : _gate, _jsonOpts, _tenants, FamiliesApp.Models.PostEntry.Id, PostPath(), PostsDir().

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

멤버 데이터 문서화

_gate

readonly SemaphoreSlim FamiliesApp.Services.JsonPostStore._gate = new(1, 1)

staticprivate

gate 값을 보관합니다.

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

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

_jsonOpts

readonly JsonSerializerOptions FamiliesApp.Services.JsonPostStore._jsonOpts

staticprivate

초기값:

                                                        = new()
{
    WriteIndented = true,
    PropertyNameCaseInsensitive = true,
    Converters = { new JsonStringEnumConverter() }
}

json Opts 값을 보관합니다.

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

    {
        WriteIndented = true,
        PropertyNameCaseInsensitive = true,
        Converters = { new JsonStringEnumConverter() }
    };

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

_tenants

readonly IFamilyTenantStore FamiliesApp.Services.JsonPostStore._tenants

private

tenants 값을 보관합니다.

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

다음에 의해서 참조됨 : DeleteAsync(), JsonPostStore(), PostsDir(), SaveAsync().

---

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

• JsonPostStore.cs