Codemaru.Services.JsonCardProfileStore 클래스 참조

더 자세히 ...

Codemaru.Services.JsonCardProfileStore에 대한 상속 다이어그램 :

Codemaru.Services.JsonCardProfileStore에 대한 협력 다이어그램:

Public 멤버 함수
	JsonCardProfileStore ()
async Task< CardHybridSnapshot?>	LoadAsync (string userId, CancellationToken cancellationToken=default)
async Task	SaveAsync (string userId, CardHybridSnapshot snapshot, CancellationToken cancellationToken=default)
async Task< CardHybridSnapshot?>	LoadBySlugAsync (string slug, CancellationToken cancellationToken=default)
Task	DeleteAsync (string userId, CancellationToken cancellationToken=default)

Private 멤버 함수
string	GetSnapshotPath (string userId)

정적 Private 멤버 함수
static bool	IsGuest (string userId)
static string	SanitizeUserId (string userId)

Private 속성
readonly string	_rootDirectory

정적 Private 속성
const string	SnapshotFileName = "snapshot.json"
static readonly JsonSerializerOptions	SerializerOptions

상세한 설명

CardHybrid 스냅샷을 프로젝트의 App_Data/Cards/{userId}/snapshot.json 에 저장합니다.

Guest 사용자의 데이터는 파일로 저장하지 않습니다 (서킷 메모리만 사용).

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

생성자 & 소멸자 문서화

JsonCardProfileStore()

Codemaru.Services.JsonCardProfileStore.JsonCardProfileStore ( )

inline

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

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

    {
        _rootDirectory = Path.Combine(AppContext.BaseDirectory, "App_Data", "Cards");
        Directory.CreateDirectory(_rootDirectory);
    }

다음을 참조함 : _rootDirectory.

멤버 함수 문서화

DeleteAsync()

Task Codemaru.Services.JsonCardProfileStore.DeleteAsync ( string userId, CancellationToken cancellationToken = default )

inline

Delete Async 작업을 수행합니다.

매개변수

userId	user Id에 사용할 string 값입니다.
cancellationToken	취소 요청을 감시하는 토큰입니다.

반환값

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

Codemaru.Services.ICardProfileStore를 구현.

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

    {
        if (IsGuest(userId))
        {
            return Task.CompletedTask;
        }
 
        var filePath = GetSnapshotPath(userId);
        if (File.Exists(filePath))
        {
            File.Delete(filePath);
        }
 
        return Task.CompletedTask;
    }

다음을 참조함 : GetSnapshotPath(), IsGuest().

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

GetSnapshotPath()

string Codemaru.Services.JsonCardProfileStore.GetSnapshotPath ( string userId )

inlineprivate

Snapshot Path 값을 가져옵니다.

매개변수

userId

user Id에 사용할 string 값입니다.

반환값

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

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

    {
        return Path.Combine(_rootDirectory, SanitizeUserId(userId), SnapshotFileName);
    }

다음을 참조함 : _rootDirectory, SanitizeUserId(), SnapshotFileName.

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

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

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

IsGuest()

bool Codemaru.Services.JsonCardProfileStore.IsGuest ( string userId )

inlinestaticprivate

Is Guest 조건을 확인합니다.

매개변수

userId

user Id에 사용할 string 값입니다.

반환값

Is Guest 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

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

                                               =>
        string.IsNullOrWhiteSpace(userId) ||
        string.Equals(userId, CardHybridUser.Guest.Id, StringComparison.OrdinalIgnoreCase);

다음을 참조함 : Codemaru.Models.CardHybridUser().

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

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

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

LoadAsync()

async Task< CardHybridSnapshot?> Codemaru.Services.JsonCardProfileStore.LoadAsync ( string userId, CancellationToken cancellationToken = default )

inline

Async 데이터를 불러옵니다.

매개변수

userId	user Id에 사용할 string 값입니다.
cancellationToken	취소 요청을 감시하는 토큰입니다.

반환값

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

Codemaru.Services.ICardProfileStore를 구현.

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

    {
        if (IsGuest(userId))
        {
            return null;
        }
 
        var filePath = GetSnapshotPath(userId);
        if (!File.Exists(filePath))
        {
            return null;
        }
 
        await using var stream = File.OpenRead(filePath);
        var snapshot = await JsonSerializer.DeserializeAsync<CardHybridSnapshot>(
            stream, SerializerOptions, cancellationToken).ConfigureAwait(false);
 
        return snapshot?.UserId == userId ? snapshot : snapshot;
    }

다음을 참조함 : Codemaru.Models.CardHybridSnapshot(), GetSnapshotPath(), IsGuest(), SerializerOptions.

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

LoadBySlugAsync()

async Task< CardHybridSnapshot?> Codemaru.Services.JsonCardProfileStore.LoadBySlugAsync ( string slug, CancellationToken cancellationToken = default )

inline

By Slug Async 데이터를 불러옵니다.

매개변수

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

반환값

Load By Slug Async 작업에서 생성한 Task<CardHybridSnapshot?> 결과입니다.

Codemaru.Services.ICardProfileStore를 구현.

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

    {
        if (string.IsNullOrWhiteSpace(slug))
        {
            return null;
        }
 
        var normalizedSlug = slug.Trim().Trim('/').ToLowerInvariant();
 
        foreach (var userDirectory in Directory.EnumerateDirectories(_rootDirectory))
        {
            cancellationToken.ThrowIfCancellationRequested();
 
            var filePath = Path.Combine(userDirectory, SnapshotFileName);
            if (!File.Exists(filePath))
            {
                continue;
            }
 
            try
            {
                await using var stream = File.OpenRead(filePath);
                var snapshot = await JsonSerializer.DeserializeAsync<CardHybridSnapshot>(
                    stream, SerializerOptions, cancellationToken).ConfigureAwait(false);
 
                if (snapshot?.Profile is null)
                {
                    continue;
                }
 
                var profileSlug = snapshot.Profile.LandingSlug.Trim().Trim('/').ToLowerInvariant();
                if (profileSlug == $"card/{normalizedSlug}" || profileSlug == normalizedSlug)
                {
                    return snapshot;
                }
            }
            catch
            {
                // skip corrupt files
            }
        }
 
        return null;
    }

다음을 참조함 : _rootDirectory, Codemaru.Models.CardHybridSnapshot(), SerializerOptions, SnapshotFileName.

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

SanitizeUserId()

string Codemaru.Services.JsonCardProfileStore.SanitizeUserId ( string userId )

inlinestaticprivate

Sanitize User Id 작업을 수행합니다.

매개변수

userId

user Id에 사용할 string 값입니다.

반환값

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

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

    {
        var safe = new string((string.IsNullOrWhiteSpace(userId) ? "guest" : userId)
            .Select(static c => char.IsLetterOrDigit(c) || c is '-' or '_' ? c : '_')
            .ToArray());
        return string.IsNullOrWhiteSpace(safe) ? "guest" : safe;
    }

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

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

SaveAsync()

async Task Codemaru.Services.JsonCardProfileStore.SaveAsync ( string userId, CardHybridSnapshot snapshot, CancellationToken cancellationToken = default )

inline

Async 데이터를 저장합니다.

매개변수

userId	user Id에 사용할 string 값입니다.
snapshot	snapshot에 사용할 CardHybridSnapshot 값입니다.
cancellationToken	취소 요청을 감시하는 토큰입니다.

반환값

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

Codemaru.Services.ICardProfileStore를 구현.

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

    {
        ArgumentNullException.ThrowIfNull(snapshot);
 
        if (IsGuest(userId))
        {
            return;
        }
 
        var filePath = GetSnapshotPath(userId);
        var directory = Path.GetDirectoryName(filePath)!;
        Directory.CreateDirectory(directory);
 
        var tempPath = filePath + ".tmp";
        await using (var stream = File.Create(tempPath))
        {
            await JsonSerializer.SerializeAsync(stream, snapshot, SerializerOptions, cancellationToken)
                .ConfigureAwait(false);
        }
 
        File.Copy(tempPath, filePath, overwrite: true);
        File.Delete(tempPath);
    }

다음을 참조함 : Codemaru.Models.CardHybridSnapshot(), GetSnapshotPath(), IsGuest(), SerializerOptions.

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

멤버 데이터 문서화

_rootDirectory

readonly string Codemaru.Services.JsonCardProfileStore._rootDirectory

private

root Directory 값을 보관합니다.

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

다음에 의해서 참조됨 : GetSnapshotPath(), JsonCardProfileStore(), LoadBySlugAsync().

SerializerOptions

readonly JsonSerializerOptions Codemaru.Services.JsonCardProfileStore.SerializerOptions

staticprivate

초기값:

                                                                = new(JsonSerializerDefaults.Web)
{
    WriteIndented = true
}

Serializer Options 값을 보관합니다.

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

    {
        WriteIndented = true
    };

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

SnapshotFileName

const string Codemaru.Services.JsonCardProfileStore.SnapshotFileName = "snapshot.json"

staticprivate

Snapshot File Name 값을 보관합니다.

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

다음에 의해서 참조됨 : GetSnapshotPath(), LoadBySlugAsync().

---

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

• JsonCardProfileStore.cs