WeddingPlatform.Services.CsvGuestbookStorage 클래스 참조

더 자세히 ...

WeddingPlatform.Services.CsvGuestbookStorage에 대한 상속 다이어그램 :

WeddingPlatform.Services.CsvGuestbookStorage에 대한 협력 다이어그램:

Public 멤버 함수
	CsvGuestbookStorage (ITenantStore tenants)
async Task< IReadOnlyList< GuestbookEntry > >	LoadAsync (string slug, CancellationToken ct=default)
async Task	SaveAsync (string slug, IReadOnlyList< GuestbookEntry > entries, CancellationToken ct=default)

Private 멤버 함수
string	CsvPath (string slug)

정적 Private 멤버 함수
static string	Esc (string v)
static List< string >	ParseCsvLine (string line)

Private 속성
readonly ITenantStore	_tenants

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

상세한 설명

Csv Guestbook Storage 기능과 관련 상태를 캡슐화합니다.

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

생성자 & 소멸자 문서화

CsvGuestbookStorage()

WeddingPlatform.Services.CsvGuestbookStorage.CsvGuestbookStorage ( ITenantStore tenants )

inline

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

매개변수

tenants

tenants에 사용할 ITenantStore 값입니다.

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

=> _tenants = tenants;

다음을 참조함 : _tenants.

멤버 함수 문서화

CsvPath()

string WeddingPlatform.Services.CsvGuestbookStorage.CsvPath ( string slug )

inlineprivate

Csv Path 작업을 수행합니다.

매개변수

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

반환값

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

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

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

다음을 참조함 : _tenants.

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

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

Esc()

string WeddingPlatform.Services.CsvGuestbookStorage.Esc ( string v )

inlinestaticprivate

Esc 작업을 수행합니다.

매개변수

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

반환값

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

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

    {
        if (v.Contains(',') || v.Contains('"') || v.Contains('\n'))
            return $"\"{v.Replace("\"", "\"\"")}\"";
        return v;
    }

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

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

LoadAsync()

async Task< IReadOnlyList< GuestbookEntry > > WeddingPlatform.Services.CsvGuestbookStorage.LoadAsync ( string slug, CancellationToken ct = default )

inline

Async 데이터를 불러옵니다.

매개변수

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

반환값

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

WeddingPlatform.Services.IGuestbookStorage를 구현.

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

    {
        var path = CsvPath(slug);
        await _gate.WaitAsync(ct).ConfigureAwait(false);
        try
        {
            var result = new List<GuestbookEntry>();
            if (!File.Exists(path)) return result;
 
            using var sr = new StreamReader(path, Encoding.UTF8);
            bool first = true;
            string? line;
            while ((line = await sr.ReadLineAsync().ConfigureAwait(false)) != null)
            {
                if (string.IsNullOrWhiteSpace(line)) continue;
                if (first && line.TrimStart().StartsWith("Name,")) { first = false; continue; }
                first = false;
 
                var f = ParseCsvLine(line);
                if (f.Count < 4) continue;
                if (!DateTime.TryParseExact(f[3], "yyyy-MM-dd HH:mm:ss",
                        CultureInfo.InvariantCulture, DateTimeStyles.AssumeLocal, out var when))
                    when = DateTime.Now;
 
                result.Add(new GuestbookEntry { Name = f[0], Contact = f[1], Message = f[2], CreatedLocal = when });
            }
            return result;
        }
        finally { _gate.Release(); }
    }

다음을 참조함 : _gate, CsvPath(), ParseCsvLine().

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

ParseCsvLine()

List< string > WeddingPlatform.Services.CsvGuestbookStorage.ParseCsvLine ( string line )

inlinestaticprivate

Parse Csv Line 작업을 수행합니다.

매개변수

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

반환값

Parse Csv Line 작업에서 생성한 List<string> 결과입니다.

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

    {
        var list = new List<string>();
        var sb = new StringBuilder();
        bool inQ = false;
        for (int i = 0; i < line.Length; i++)
        {
            var ch = line[i];
            if (inQ) { if (ch == '"') { if (i + 1 < line.Length && line[i + 1] == '"') { sb.Append('"'); i++; } else inQ = false; } else sb.Append(ch); }
            else { if (ch == ',') { list.Add(sb.ToString()); sb.Clear(); } else if (ch == '"') inQ = true; else sb.Append(ch); }
        }
        list.Add(sb.ToString());
        return list;
    }

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

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

SaveAsync()

async Task WeddingPlatform.Services.CsvGuestbookStorage.SaveAsync ( string slug, IReadOnlyList< GuestbookEntry > entries, CancellationToken ct = default )

inline

Async 데이터를 저장합니다.

매개변수

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

반환값

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

WeddingPlatform.Services.IGuestbookStorage를 구현.

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

    {
        var path = CsvPath(slug);
        Directory.CreateDirectory(Path.GetDirectoryName(path)!);
        var tmp = path + ".tmp";
 
        await _gate.WaitAsync(ct).ConfigureAwait(false);
        try
        {
            using (var sw = new StreamWriter(tmp, false, new UTF8Encoding(false)))
            {
                await sw.WriteLineAsync("Name,Contact,Message,CreatedLocal").ConfigureAwait(false);
                foreach (var e in entries)
                {
                    ct.ThrowIfCancellationRequested();
                    await sw.WriteLineAsync(string.Join(",",
                        Esc(e.Name), Esc(e.Contact), Esc(e.Message),
                        Esc(e.CreatedLocal.ToString("yyyy-MM-dd HH:mm:ss")))).ConfigureAwait(false);
                }
            }
            File.Copy(tmp, path, overwrite: true);
            File.Delete(tmp);
        }
        finally { _gate.Release(); }
    }

다음을 참조함 : _gate, CsvPath(), Esc().

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

멤버 데이터 문서화

_gate

readonly SemaphoreSlim WeddingPlatform.Services.CsvGuestbookStorage._gate = new(1, 1)

staticprivate

gate 값을 보관합니다.

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

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

_tenants

readonly ITenantStore WeddingPlatform.Services.CsvGuestbookStorage._tenants

private

tenants 값을 보관합니다.

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

다음에 의해서 참조됨 : CsvGuestbookStorage(), CsvPath().

---

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

• CsvGuestbookStorage.cs