FamiliesAutoWriter.Services.PostWriterService 클래스 참조

더 자세히 ...

Public 멤버 함수
IReadOnlyList< AlbumInfo >	GetAlbums (string slug)
IReadOnlyList< string >	GetSlugs ()
async Task< bool >	SavePostAsync (string slug, PostEntry post, IEnumerable< string > localPhotoPaths)
IReadOnlyList< string >	GetExistingTitles (string slug)
DateTime? int LastNumber	GetCookingTimelineState (string slug)

Public 속성
DateTime?	LastPostedAt

속성
string	AppDataRoot = "" [get, set]

정적 Private 멤버 함수
static bool	IsCookingPost (string title)
static int	ExtractCookingNumber (string title)
static bool	TryGetPropertyIgnoreCase (JsonElement element, string name, out JsonElement value)
static string	Sanitize (string id)

정적 Private 속성
static readonly JsonSerializerOptions	_opts

상세한 설명

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

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

멤버 함수 문서화

ExtractCookingNumber()

int FamiliesAutoWriter.Services.PostWriterService.ExtractCookingNumber ( string title )

inlinestaticprivate

Extract Cooking Number 작업을 수행합니다.

매개변수

title

title에 사용할 string 값입니다.

반환값

Extract Cooking Number 작업에서 생성한 int 결과입니다.

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

    {
        var match = Regex.Match(title, @"#(?<n>\d+)");
        return match.Success && int.TryParse(match.Groups["n"].Value, out var n) ? n : 0;
    }

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

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

GetAlbums()

IReadOnlyList< AlbumInfo > FamiliesAutoWriter.Services.PostWriterService.GetAlbums ( string slug )

inline

Albums 값을 가져옵니다.

매개변수

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

반환값

Get Albums 작업에서 생성한 IReadOnlyList<AlbumInfo> 결과입니다.

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

    {
        var dir = Path.Combine(AppDataRoot, "Family", slug, "albums");
        if (!Directory.Exists(dir)) return [];
        var list = new List<AlbumInfo>();
        foreach (var f in Directory.GetFiles(dir, "*.json"))
        {
            try
            {
                var json = File.ReadAllText(f);
                var a = JsonSerializer.Deserialize<AlbumInfo>(json, _opts);
                if (a != null) list.Add(a);
            }
            catch { }
        }
        return list.OrderBy(a => a.SortOrder).ThenBy(a => a.Name).ToList();
    }

다음을 참조함 : _opts, AppDataRoot.

GetCookingTimelineState()

DateTime? int LastNumber FamiliesAutoWriter.Services.PostWriterService.GetCookingTimelineState ( string slug )

inline

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

    {
        var dir = Path.Combine(AppDataRoot, "Family", slug, "posts");
        if (!Directory.Exists(dir)) return (null, 0);
 
        DateTime? lastPostedAt = null;
        var lastNumber = 0;
 
        foreach (var f in Directory.GetFiles(dir, "*.json"))
        {
            try
            {
                var post = JsonSerializer.Deserialize<PostEntry>(File.ReadAllText(f), _opts);
                if (post is null || !IsCookingPost(post.Title)) continue;
 
                if (lastPostedAt is null || post.PostedAt > lastPostedAt.Value)
                    lastPostedAt = post.PostedAt;
 
                lastNumber = Math.Max(lastNumber, ExtractCookingNumber(post.Title));
            }
            catch { }
        }
 
        return (lastPostedAt, lastNumber);
    }

다음을 참조함 : _opts, AppDataRoot, ExtractCookingNumber(), IsCookingPost(), LastPostedAt.

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

GetExistingTitles()

IReadOnlyList< string > FamiliesAutoWriter.Services.PostWriterService.GetExistingTitles ( string slug )

inline

Existing Titles 값을 가져옵니다.

매개변수

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

반환값

Get Existing Titles 작업에서 생성한 IReadOnlyList<string> 결과입니다.

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

    {
        var dir = Path.Combine(AppDataRoot, "Family", slug, "posts");
        if (!Directory.Exists(dir)) return [];
        var titles = new List<string>();
        foreach (var f in Directory.GetFiles(dir, "*.json"))
        {
            try
            {
                using var doc = JsonDocument.Parse(File.ReadAllText(f));
                if (TryGetPropertyIgnoreCase(doc.RootElement, "title", out var t))
                {
                    var v = t.GetString();
                    if (!string.IsNullOrWhiteSpace(v)) titles.Add(v);
                }
            }
            catch { }
        }
        return titles;
    }

다음을 참조함 : AppDataRoot, TryGetPropertyIgnoreCase().

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

GetSlugs()

IReadOnlyList< string > FamiliesAutoWriter.Services.PostWriterService.GetSlugs ( )

inline

Slugs 값을 가져옵니다.

반환값

Get Slugs 작업에서 생성한 IReadOnlyList<string> 결과입니다.

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

    {
        var root = Path.Combine(AppDataRoot, "Family");
        if (!Directory.Exists(root)) return [];
        return Directory.GetDirectories(root)
            .Select(Path.GetFileName)
            .Where(s => s != null)
            .Cast<string>()
            .ToList();
    }

다음을 참조함 : AppDataRoot.

IsCookingPost()

bool FamiliesAutoWriter.Services.PostWriterService.IsCookingPost ( string title )

inlinestaticprivate

Is Cooking Post 조건을 확인합니다.

매개변수

title

title에 사용할 string 값입니다.

반환값

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

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

                                                    =>
        title.Contains("1983", StringComparison.OrdinalIgnoreCase) &&
        title.Contains("집밥육아", StringComparison.OrdinalIgnoreCase);

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

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

Sanitize()

string FamiliesAutoWriter.Services.PostWriterService.Sanitize ( string id )

inlinestaticprivate

Sanitize 작업을 수행합니다.

매개변수

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

반환값

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

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

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

SavePostAsync()

async Task< bool > FamiliesAutoWriter.Services.PostWriterService.SavePostAsync ( string slug, PostEntry post, IEnumerable< string > localPhotoPaths )

inline

Post Async 데이터를 저장합니다.

매개변수

slug	slug에 사용할 string 값입니다.
post	post에 사용할 PostEntry 값입니다.
localPhotoPaths	local Photo Paths에 사용할 IEnumerable<string> 값입니다.

반환값

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

예외

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

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

    {
        if (string.IsNullOrWhiteSpace(AppDataRoot))
            throw new InvalidOperationException("App_Data 경로가 비어 있습니다.");
        if (string.IsNullOrWhiteSpace(slug))
            throw new InvalidOperationException("가족 슬러그가 비어 있습니다.");
        if (string.IsNullOrWhiteSpace(post.Id))
            post.Id = Guid.NewGuid().ToString("N");
 
        var tenantDir = Path.Combine(AppDataRoot, "Family", slug);
        var postsDir = Path.Combine(tenantDir, "posts");
        var mediaDir = Path.Combine(tenantDir, "media", post.Id);
 
        Directory.CreateDirectory(postsDir);
        Directory.CreateDirectory(mediaDir);
 
        // 로컬 사진 복사
        foreach (var src in localPhotoPaths)
        {
            if (!File.Exists(src)) continue;
            var fn = Path.GetFileName(src);
            var dst = Path.Combine(mediaDir, fn);
            File.Copy(src, dst, overwrite: true);
            if (!post.PhotoFileNames.Contains(fn))
                post.PhotoFileNames.Add(fn);
        }
 
        var path = Path.Combine(postsDir, $"{Sanitize(post.Id)}.json");
        var tmp = Path.Combine(postsDir, $"{Sanitize(post.Id)}.{Guid.NewGuid():N}.tmp");
        try
        {
            await using (var fs = File.Create(tmp))
                await JsonSerializer.SerializeAsync(fs, post, _opts);
            File.Move(tmp, path, overwrite: true);
        }
        catch (Exception ex)
        {
            throw new IOException($"JSON 저장 실패: {path} ({ex.Message})", ex);
        }
        finally
        {
            try
            {
                if (File.Exists(tmp)) File.Delete(tmp);
            }
            catch { }
        }
        return true;
    }

다음을 참조함 : _opts, AppDataRoot, FamiliesAutoWriter.Models.PostEntry.Id.

TryGetPropertyIgnoreCase()

bool FamiliesAutoWriter.Services.PostWriterService.TryGetPropertyIgnoreCase ( JsonElement element, string name, out JsonElement value )

inlinestaticprivate

Get Property Ignore Case 작업을 시도하고 성공 여부를 반환합니다.

매개변수

element	element에 사용할 JsonElement 값입니다.
name	name에 사용할 string 값입니다.
value	적용할 값입니다.

반환값

Try Get Property Ignore Case 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

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

    {
        foreach (var prop in element.EnumerateObject())
        {
            if (string.Equals(prop.Name, name, StringComparison.OrdinalIgnoreCase))
            {
                value = prop.Value;
                return true;
            }
        }
 
        value = default;
        return false;
    }

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

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

멤버 데이터 문서화

_opts

readonly JsonSerializerOptions FamiliesAutoWriter.Services.PostWriterService._opts

staticprivate

초기값:

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

opts 값을 보관합니다.

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

    {
        WriteIndented = true,
        PropertyNameCaseInsensitive = true,
    };

다음에 의해서 참조됨 : GetAlbums(), GetCookingTimelineState(), SavePostAsync().

LastPostedAt

DateTime? FamiliesAutoWriter.Services.PostWriterService.LastPostedAt

Cooking Timeline State 값을 가져옵니다.

매개변수

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

반환값

Get Cooking Timeline State 작업에서 생성한 (DateTime? LastPostedAt, int LastNumber) 결과입니다.

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

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

속성 문서화

AppDataRoot

string FamiliesAutoWriter.Services.PostWriterService.AppDataRoot = ""

getset

App Data Root 값을 가져오거나 설정합니다.

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

{ get; set; } = "";

다음에 의해서 참조됨 : GetAlbums(), GetCookingTimelineState(), GetExistingTitles(), GetSlugs(), SavePostAsync().

---

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

• PostWriterService.cs