DreamineWeb.Services.LibraryCatalogSyncService에 대한 협력 다이어그램:

Public 멤버 함수
	LibraryCatalogSyncService (ILibraryStore store, DreamineOptions opts)
async Task< LibraryCatalogSyncResult >	SyncAsync ()

속성
bool	IsConfigured `[get]`

Private 멤버 함수
bool	ApplyProjectMetadata (LibraryInfo lib, ProjectMetadata project)
record	ProjectMetadata (string ProjectPath, string PackageId, string Version, string TargetFramework, string? Description, string? RepositoryUrl, string[] Tags, string[] Dependencies, string Category)

정적 Private 멤버 함수
static ? ProjectMetadata	ReadProject (string path)
static string	InferCategory (string packageId)
static int	CategoryRank (string category)
static string	ToId (string packageId)
static ? string	Normalize (string? value)
static string[]	SplitTags (string? tags)
static bool	SameSet (string[] left, string[] right)
static bool	SetString (string? current, string? value, Action< string?> assign)

Private 속성
readonly ILibraryStore	_store
readonly string	_libRoot
readonly string	_xmlDocRoot

정적 Private 속성
static readonly Regex	Whitespace = new(@"\s+", RegexOptions.Compiled)

상세한 설명

Library Catalog Sync Service 기능과 관련 상태를 캡슐화합니다.

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

생성자 & 소멸자 문서화

◆ LibraryCatalogSyncService()

DreamineWeb.Services.LibraryCatalogSyncService.LibraryCatalogSyncService	(	ILibraryStore	store,
		DreamineOptions	opts )

inline

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

매개변수

store	store에 사용할 `ILibraryStore` 값입니다.
opts	opts에 사용할 `DreamineOptions` 값입니다.

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

    {
        _store = store;
        _libRoot = opts.LibrarySourceRoot;
        _xmlDocRoot = Path.Combine(AppContext.BaseDirectory, "wwwroot", "xmldocs");
    }

다음을 참조함 : _libRoot, _store, _xmlDocRoot, DreamineWeb.Models.DreamineOptions.LibrarySourceRoot.

멤버 함수 문서화

◆ ApplyProjectMetadata()

bool DreamineWeb.Services.LibraryCatalogSyncService.ApplyProjectMetadata	(	LibraryInfo	lib,
		ProjectMetadata	project )

inlineprivate

Apply Project Metadata 작업을 수행합니다.

매개변수

lib	lib에 사용할 `LibraryInfo` 값입니다.
project	project에 사용할 `ProjectMetadata` 값입니다.

반환값: Apply Project Metadata 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

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

    {
        var dirty = false;
 
        if (SetString(lib.Name, project.PackageId, v => lib.Name = v ?? string.Empty)) dirty = true;
        if (SetString(lib.Category, project.Category, v => lib.Category = v ?? string.Empty)) dirty = true;
        if (SetString(lib.Version, project.Version, v => lib.Version = v ?? string.Empty)) dirty = true;
        if (SetString(lib.NuGetId, project.PackageId, v => lib.NuGetId = v)) dirty = true;
        if (SetString(lib.SourceProjectPath, project.ProjectPath, v => lib.SourceProjectPath = v)) dirty = true;
        if (SetString(lib.TargetFramework, project.TargetFramework, v => lib.TargetFramework = v)) dirty = true;
 
        if (!string.IsNullOrWhiteSpace(project.Description))
        {
            if (SetString(lib.DescriptionEn, project.Description, v => lib.DescriptionEn = v)) dirty = true;
            if (string.IsNullOrWhiteSpace(lib.Description))
            {
                lib.Description = project.Description;
                dirty = true;
            }
        }
 
        if (!string.IsNullOrWhiteSpace(project.RepositoryUrl))
        {
            if (SetString(lib.RepoUrl, project.RepositoryUrl, v => lib.RepoUrl = v)) dirty = true;
        }
 
        if (project.Tags.Length > 0 && !SameSet(lib.Tags, project.Tags))
        {
            lib.Tags = project.Tags;
            dirty = true;
        }
 
        if (!SameSet(lib.Dependencies, project.Dependencies))
        {
            lib.Dependencies = project.Dependencies;
            dirty = true;
        }
 
        var xmlPath = Path.Combine(_xmlDocRoot, project.PackageId, $"{project.PackageId}.xml");
        if (File.Exists(xmlPath))
        {
            if (SetString(lib.XmlDocPath, xmlPath, v => lib.XmlDocPath = v)) dirty = true;
        }
 
        if (dirty) lib.UpdatedAt = DateTime.UtcNow;
        return dirty;
    }

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

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

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

◆ CategoryRank()

int DreamineWeb.Services.LibraryCatalogSyncService.CategoryRank ( string category )

inlinestaticprivate

Category Rank 작업을 수행합니다.

매개변수

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

반환값: Category Rank 작업에서 생성한 int 결과입니다.

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

                                                     => category switch
    {
        "MVVM" => 1,
        "Hybrid" => 2,
        "UI" => 3,
        "Identity" => 4,
        "Infrastructure" => 5,
        "Database" => 6,
        "Communication" => 7,
        "IO" => 8,
        "PLC" => 9,
        _ => 99
    };

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

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

◆ InferCategory()

string DreamineWeb.Services.LibraryCatalogSyncService.InferCategory ( string packageId )

inlinestaticprivate

Infer Category 작업을 수행합니다.

매개변수

packageId package Id에 사용할 string 값입니다.

반환값: Infer Category 작업에서 생성한 string 결과입니다.

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

    {
        if (packageId.StartsWith("Dreamine.MVVM.", StringComparison.OrdinalIgnoreCase)) return "MVVM";
        if (packageId.StartsWith("Dreamine.UI.", StringComparison.OrdinalIgnoreCase)) return "UI";
        if (packageId.StartsWith("Dreamine.Communication.", StringComparison.OrdinalIgnoreCase)) return "Communication";
        if (packageId.StartsWith("Dreamine.Database.", StringComparison.OrdinalIgnoreCase)) return "Database";
        if (packageId.StartsWith("Dreamine.PLC.", StringComparison.OrdinalIgnoreCase)) return "PLC";
        if (packageId.StartsWith("Dreamine.IO.", StringComparison.OrdinalIgnoreCase)) return "IO";
        if (packageId.StartsWith("Dreamine.Threading", StringComparison.OrdinalIgnoreCase)) return "Infrastructure";
        if (packageId.StartsWith("Dreamine.Logging", StringComparison.OrdinalIgnoreCase)) return "Infrastructure";
        if (packageId.StartsWith("Dreamine.Hybrid", StringComparison.OrdinalIgnoreCase)) return "Hybrid";
        if (packageId.StartsWith("Dreamine.Identity", StringComparison.OrdinalIgnoreCase)) return "Identity";
        return "Other";
    }

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

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

◆ Normalize()

? string DreamineWeb.Services.LibraryCatalogSyncService.Normalize ( string? value )

inlinestaticprivate

Normalize 작업을 수행합니다.

매개변수

value 적용할 값입니다.

반환값: Normalize 작업에서 생성한 string? 결과입니다.

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

    {
        if (string.IsNullOrWhiteSpace(value)) return null;
        return Whitespace.Replace(value.Trim(), " ");
    }

다음을 참조함 : Whitespace.

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

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

◆ ProjectMetadata()

record DreamineWeb.Services.LibraryCatalogSyncService.ProjectMetadata	(	string	ProjectPath,
		string	PackageId,
		string	Version,
		string	TargetFramework,
		string?	Description,
		string?	RepositoryUrl,
		string[]	Tags,
		string[]	Dependencies,
		string	Category )

sealedprivate

Project Metadata 기능과 관련 상태를 캡슐화합니다.

다음에 의해서 참조됨 : ApplyProjectMetadata(), ReadProject(), SyncAsync().

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

◆ ReadProject()

? ProjectMetadata DreamineWeb.Services.LibraryCatalogSyncService.ReadProject ( string path )

inlinestaticprivate

Project 데이터를 읽습니다.

매개변수

path	path에 사용할 `string` 값입니다.

반환값: Read Project 작업에서 생성한 ProjectMetadata? 결과입니다.

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

    {
        try
        {
            var doc = XDocument.Load(path);
            var root = doc.Root;
            if (root is null) return null;
 
            #pragma warning disable CS1587
            string? Property(string name) => root.Elements("PropertyGroup")
                .Elements(name)
                .Select(x => x.Value.Trim())
                .FirstOrDefault(x => !string.IsNullOrWhiteSpace(x));
            #pragma warning restore CS1587
 
            var assemblyName = Path.GetFileNameWithoutExtension(path);
            var packageId = Property("PackageId") ?? Property("AssemblyName") ?? assemblyName;
            var version = Property("Version");
            if (string.IsNullOrWhiteSpace(version) || version.Contains("$(", StringComparison.Ordinal))
                version = "1.0.0";
 
            var targetFramework = Property("TargetFramework") ?? Property("TargetFrameworks") ?? string.Empty;
            var description = Normalize(Property("Description"));
            var tags = SplitTags(Property("PackageTags"));
            var dependencies = root.Elements("ItemGroup")
                .Elements("ProjectReference")
                .Select(x => x.Attribute("Include")?.Value)
                .Where(x => !string.IsNullOrWhiteSpace(x))
                .Select(x => Path.GetFileNameWithoutExtension(x!))
                .Where(x => !string.IsNullOrWhiteSpace(x))
                .Distinct(StringComparer.OrdinalIgnoreCase)
                .OrderBy(x => x, StringComparer.OrdinalIgnoreCase)
                .ToArray();
 
            return new ProjectMetadata(
                path,
                packageId,
                version,
                targetFramework,
                description,
                Property("RepositoryUrl") ?? Property("PackageProjectUrl"),
                tags,
                dependencies,
                InferCategory(packageId));
        }
        catch
        {
            return null;
        }
    }

다음을 참조함 : InferCategory(), Normalize(), ProjectMetadata(), DreamineWeb.Models.Property, SplitTags().

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

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

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

◆ SameSet()

bool DreamineWeb.Services.LibraryCatalogSyncService.SameSet	(	string[]	left,
		string[]	right )

inlinestaticprivate

Same Set 작업을 수행합니다.

매개변수

left	left에 사용할 `string[]` 값입니다.
right	right에 사용할 `string[]` 값입니다.

반환값: Same Set 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

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

                                                               =>
        left.OrderBy(x => x, StringComparer.OrdinalIgnoreCase)
            .SequenceEqual(right.OrderBy(x => x, StringComparer.OrdinalIgnoreCase), StringComparer.OrdinalIgnoreCase);

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

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

◆ SetString()

bool DreamineWeb.Services.LibraryCatalogSyncService.SetString	(	string?	current,
		string?	value,
		Action< string?>	assign )

inlinestaticprivate

String 값을 설정합니다.

매개변수

current	current에 사용할 `string?` 값입니다.
value	적용할 값입니다.
assign	assign에 사용할 `Action<string?>` 값입니다.

반환값: Set String 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

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

    {
        value = string.IsNullOrWhiteSpace(value) ? null : value;
        if (string.Equals(current, value, StringComparison.Ordinal)) return false;
        assign(value);
        return true;
    }

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

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

◆ SplitTags()

string[] DreamineWeb.Services.LibraryCatalogSyncService.SplitTags ( string? tags )

inlinestaticprivate

Split Tags 작업을 수행합니다.

매개변수

tags	tags에 사용할 `string?` 값입니다.

반환값: Split Tags 작업에서 생성한 string[] 결과입니다.

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

                                                    =>
        string.IsNullOrWhiteSpace(tags)
            ? []
            : tags.Split([';', ','], StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries)
                  .Distinct(StringComparer.OrdinalIgnoreCase)
                  .OrderBy(x => x, StringComparer.OrdinalIgnoreCase)
                  .ToArray();

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

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

◆ SyncAsync()

async Task< LibraryCatalogSyncResult > DreamineWeb.Services.LibraryCatalogSyncService.SyncAsync ( )

inline

Sync Async 작업을 수행합니다.

반환값: Sync Async 작업에서 생성한 Task<LibraryCatalogSyncResult> 결과입니다.

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

    {
        if (!IsConfigured) return new LibraryCatalogSyncResult(-1, 0, 0);
 
        var projects = Directory.EnumerateFiles(_libRoot, "*.csproj", SearchOption.AllDirectories)
            .Select(ReadProject)
            .Where(p => p is not null)
            .Cast<ProjectMetadata>()
            .Where(p => !p.PackageId.EndsWith(".Tests", StringComparison.OrdinalIgnoreCase))
            .OrderBy(p => CategoryRank(p.Category))
            .ThenBy(p => p.PackageId, StringComparer.OrdinalIgnoreCase)
            .ToList();
 
        var libraries = await _store.GetAllAsync();
        var byName = libraries.ToDictionary(x => x.Name, StringComparer.OrdinalIgnoreCase);
        var nextSortByCategory = libraries
            .GroupBy(x => string.IsNullOrWhiteSpace(x.Category) ? "Other" : x.Category)
            .ToDictionary(g => g.Key, g => g.Max(x => x.SortOrder), StringComparer.OrdinalIgnoreCase);
 
        var added = 0;
        var updated = 0;
 
        foreach (var project in projects)
        {
            var isNew = !byName.TryGetValue(project.PackageId, out var lib);
            if (isNew)
            {
                var sortBase = nextSortByCategory.TryGetValue(project.Category, out var current)
                    ? current
                    : CategoryRank(project.Category) * 10;
 
                lib = new LibraryInfo
                {
                    Id = ToId(project.PackageId),
                    Name = project.PackageId,
                    Category = project.Category,
                    SortOrder = sortBase + 1,
                    IsVisible = true,
                    Status = "stable",
                    Version = "1.0.0"
                };
 
                nextSortByCategory[project.Category] = lib.SortOrder;
                added++;
            }
 
            if (ApplyProjectMetadata(lib!, project) || isNew)
            {
                await _store.SaveAsync(lib!);
                if (!isNew) updated++;
            }
 
            byName[project.PackageId] = lib!;
        }
 
        return new LibraryCatalogSyncResult(added, updated, projects.Count);
    }

다음을 참조함 : _libRoot, _store, ApplyProjectMetadata(), CategoryRank(), IsConfigured, DreamineWeb.Services.LibraryCatalogSyncResult(), ProjectMetadata(), ReadProject(), DreamineWeb.Models.LibraryInfo.SortOrder, ToId().

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

◆ ToId()

string DreamineWeb.Services.LibraryCatalogSyncService.ToId ( string packageId )

inlinestaticprivate

To Id 작업을 수행합니다.

매개변수

packageId package Id에 사용할 string 값입니다.

반환값: To Id 작업에서 생성한 string 결과입니다.

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

    {
        var id = packageId.StartsWith("Dreamine.", StringComparison.OrdinalIgnoreCase)
            ? packageId["Dreamine.".Length..]
            : packageId;
 
        return Regex.Replace(id.ToLowerInvariant(), @"[^a-z0-9]+", "-").Trim('-');
    }

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

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

멤버 데이터 문서화

◆ _libRoot

readonly string DreamineWeb.Services.LibraryCatalogSyncService._libRoot

private

lib Root 값을 보관합니다.

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

다음에 의해서 참조됨 : LibraryCatalogSyncService(), SyncAsync().

◆ _store

readonly ILibraryStore DreamineWeb.Services.LibraryCatalogSyncService._store

private

store 값을 보관합니다.

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

다음에 의해서 참조됨 : LibraryCatalogSyncService(), SyncAsync().

◆ _xmlDocRoot

readonly string DreamineWeb.Services.LibraryCatalogSyncService._xmlDocRoot

private

xml Doc Root 값을 보관합니다.

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

다음에 의해서 참조됨 : ApplyProjectMetadata(), LibraryCatalogSyncService().

◆ Whitespace

readonly Regex DreamineWeb.Services.LibraryCatalogSyncService.Whitespace = new(@"\s+", RegexOptions.Compiled)

staticprivate

Whitespace 값을 보관합니다.

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

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

속성 문서화

◆ IsConfigured

bool DreamineWeb.Services.LibraryCatalogSyncService.IsConfigured

get

Is Configured 값을 가져옵니다.

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

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

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

LibraryCatalogSyncService.cs

Public 멤버 함수

속성

Private 멤버 함수

정적 Private 멤버 함수

Private 속성

정적 Private 속성

상세한 설명

생성자 & 소멸자 문서화

◆ LibraryCatalogSyncService()

멤버 함수 문서화

◆ ApplyProjectMetadata()

◆ CategoryRank()

◆ InferCategory()

◆ Normalize()

◆ ProjectMetadata()

◆ ReadProject()

◆ SameSet()

◆ SetString()

◆ SplitTags()

◆ SyncAsync()

◆ ToId()

멤버 데이터 문서화

◆ _libRoot

◆ _store

◆ _xmlDocRoot

◆ Whitespace

속성 문서화

◆ IsConfigured