WeddingThankYou.Services.CsvGuestbookStorage 클래스 참조

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

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

Public 멤버 함수
	CsvGuestbookStorage (IHostEnvironment env)
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	Sanitize (string slug)
static bool	IsHeader (string line)
static string	EscapeCsv (string value)
static List< string >	ParseCsvLine (string line)

Private 속성
readonly string	_dataDir

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

상세한 설명

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

생성자 & 소멸자 문서화

CsvGuestbookStorage()

WeddingThankYou.Services.CsvGuestbookStorage.CsvGuestbookStorage ( IHostEnvironment env )

inline

생성자.

매개변수

env	호스트 환경(컨텐츠 루트 경로 계산).

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

        {
            _dataDir = Path.Combine(env.ContentRootPath, "App_Data", "Guestbook");
            Directory.CreateDirectory(_dataDir);
        }

다음을 참조함 : _dataDir.

멤버 함수 문서화

CsvPath()

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

inlineprivate

Csv Path 작업을 수행합니다.

매개변수

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

반환값

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

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

                                            =>
            Path.Combine(_dataDir, $"{Sanitize(slug)}.csv");

다음을 참조함 : _dataDir.

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

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

EscapeCsv()

string WeddingThankYou.Services.CsvGuestbookStorage.EscapeCsv ( string value )

inlinestaticprivate

CSV 필드 이스케이프(RFC4180 준수).

매개변수

value

적용할 값입니다.

반환값

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

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

        {
            value ??= string.Empty;
            bool needQuote = value.Contains(',') || value.Contains('"') || value.Contains('\n') || value.Contains('\r');
            if (!needQuote) return value;
            return $"\"{value.Replace("\"", "\"\"")}\"";
        }

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

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

IsHeader()

bool WeddingThankYou.Services.CsvGuestbookStorage.IsHeader ( string line )

inlinestaticprivate

CSV 헤더 여부를 대략 판별합니다.

매개변수

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

반환값

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

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

        {
            var l = line.Trim().ToLowerInvariant();
            return l.StartsWith("name,contact,message,createdlocal");
        }

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

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

LoadAsync()

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

inline

Async 데이터를 불러옵니다.

매개변수

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

반환값

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

WeddingThankYou.Services.IGuestbookStorage를 구현.

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

        {
            var csvPath = CsvPath(slug);
            await _gate.WaitAsync(ct).ConfigureAwait(false);
            try
            {
                var result = new List<GuestbookEntry>();
                if (!File.Exists(csvPath)) return result;
 
                using var fs = new FileStream(csvPath, FileMode.Open, FileAccess.Read, FileShare.Read);
                using var sr = new StreamReader(fs, Encoding.UTF8);
                string? line;
 
                // 헤더 지원: 첫 줄이 헤더 같으면 스킵
                bool first = true;
                while ((line = await sr.ReadLineAsync().ConfigureAwait(false)) != null)
                {
                    ct.ThrowIfCancellationRequested();
                    if (string.IsNullOrWhiteSpace(line)) continue;
 
                    if (first && IsHeader(line)) { 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(), IsHeader(), ParseCsvLine().

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

ParseCsvLine()

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

inlinestaticprivate

CSV 한 줄 파싱(따옴표, 이스케이프 처리).

매개변수

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

반환값

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

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

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

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

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

Sanitize()

string WeddingThankYou.Services.CsvGuestbookStorage.Sanitize ( string slug )

inlinestaticprivate

Sanitize 작업을 수행합니다.

매개변수

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

반환값

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

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

                                                    =>
            string.Concat((slug ?? string.Empty).ToLowerInvariant().Split(Path.GetInvalidFileNameChars()));

SaveAsync()

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

inline

Async 데이터를 저장합니다.

매개변수

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

반환값

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

WeddingThankYou.Services.IGuestbookStorage를 구현.

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

        {
            var csvPath = CsvPath(slug);
            await _gate.WaitAsync(ct).ConfigureAwait(false);
            try
            {
                var tmp = csvPath + ".tmp";
                using (var fs = new FileStream(tmp, FileMode.Create, FileAccess.Write, FileShare.None))
                using (var sw = new StreamWriter(fs, new UTF8Encoding(encoderShouldEmitUTF8Identifier: false)))
                {
                    // 헤더 작성
                    await sw.WriteLineAsync("Name,Contact,Message,CreatedLocal").ConfigureAwait(false);
 
                    foreach (var e in entries)
                    {
                        ct.ThrowIfCancellationRequested();
                        var line = string.Join(",",
                            EscapeCsv(e.Name),
                            EscapeCsv(e.Contact),
                            EscapeCsv(e.Message),
                            EscapeCsv(e.CreatedLocal.ToString("yyyy-MM-dd HH:mm:ss")));
                        await sw.WriteLineAsync(line).ConfigureAwait(false);
                    }
                }
 
                File.Copy(tmp, csvPath, overwrite: true);
                File.Delete(tmp);
            }
            finally
            {
                _gate.Release();
            }
        }

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

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

멤버 데이터 문서화

_dataDir

readonly string WeddingThankYou.Services.CsvGuestbookStorage._dataDir

private

data Dir 값을 보관합니다.

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

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

_gate

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

staticprivate

gate 값을 보관합니다.

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

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

---

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

• CsvGuestbookStorage.cs