Blazor實戰——Known框架快速開始

Known是基于C#和Blazor開發的前后端分離快速開發框架，開箱即用，跨平臺，一處代碼，多處運行。
開源地址: https://gitee.com/known/Known

1. 安裝項目模板并創建新項目

• 打開命令行輸入如下命令安裝和創建。

-- 安裝模板
dotnet new install KnownTemplate
-- 創建項目
dotnet new known --name=KIMS

說明：KIMS為測試項目名稱

• 安裝和創建成功后，項目文件夾自動生成如下內容

├─KIMS          ->項目前后端共用庫，客戶端和實體類等。
├─KIMS.Client   ->Web前端，Blazor WebAssembly。
├─KIMS.Core     ->項目后端庫，控制器、服務、數據訪問等。
├─KIMS.Razor    ->項目前端庫，模塊頁面和表單。
├─KIMS.Server   ->Web后端。
├─KIMS.WinForm  ->WinForm窗體及Razor頁面。
├─KIMSAlone     ->桌面exe程序。
├─KIMS.db       ->默認SQLite數據庫。
├─KIMS.sln      ->VS解決方案文件。

2. 打開解決方案配置應用

• 使用 VS2022 打開 KIMS.sln 文件，打開 KIMS 項目下 AppConfig.cs 文件，配置App名稱，示例代碼如下：

public class AppConfig
{
    public static void Initialize()
    {
        Config.AppId = "KIMS";                           //系統ID，自動生成，默認項目名稱
        Config.AppName = "Known管理系統";                 //在此配置你的系統名稱
        Config.SysVersion = "1.0.0";                     //系統版本號
        Config.AppAssembly = typeof(AppConfig).Assembly; //實體模型程序集，用于模塊管理配置列表字段

        PagingCriteria.DefaultPageSize = 20;             //默認分頁大小
        DicCategory.AddCategories<AppDictionary>();      //自動加載數據字典類別，在AppDictionary中增加類別
        Cache.AttachCodes(typeof(AppConfig).Assembly);   //自動加載CodeTable特性類常量進入緩存
        //在此配置你的系統其他全局配置
    }
}

3. 配置后端數據庫連接

• 打開 KIMS.Server 項目文件，添加你的系統使用的數據庫訪問包，常用數據庫包如下

-- SQLite
<PackageReference Include="Microsoft.Data.Sqlite" Version="7.0.5" />
-- Access
<PackageReference Include="System.Data.OleDb" Version="7.0.0" />
-- MySQL
<PackageReference Include="MySqlConnector" Version="2.2.5" />

-- 打開項目下 AppServer.cs 文件修改數據庫連接，示例代碼如下：

class AppServer
{
    internal static void Initialize(WebApplicationBuilder builder)
    {
        //配置環境目錄
        KCConfig.WebRoot = builder.Environment.WebRootPath;
        KCConfig.ContentRoot = builder.Environment.ContentRootPath;
        //讀取appsettings.json配置
        var configuration = builder.Configuration;
        var dbFile = configuration.GetSection("DBFile").Get<string>();//數據庫配置
        var uploadPath = configuration.GetSection("UploadPath").Get<string>();//上傳文件存儲路徑
        Initialize(dbFile, uploadPath);
    }

    internal static void Initialize(string? dbFile, string? uploadPath)
    {
        //初始化配置
        AppConfig.Initialize();
        AppCore.Initialize();
        //轉換絕對路徑
        var path = KCConfig.ContentRoot;
        dbFile = Path.GetFullPath(Path.Combine(path, dbFile));
        uploadPath = Path.GetFullPath(Path.Combine(path, uploadPath));
        //注冊數據訪問提供者和初始化數據庫連接
        Database.RegisterProviders(new Dictionary<string, Type>
        {
            ["SQLite"] = typeof(Microsoft.Data.Sqlite.SqliteFactory)
        });
        var connInfo = new Known.Core.ConnectionInfo
        {
            Name = "Default",
            ProviderName = "SQLite",
            ConnectionString = $"Data Source={dbFile};"
        };
        KCConfig.App = new AppInfo
        {
            Connections = new List<Known.Core.ConnectionInfo> { connInfo },
            UploadPath = uploadPath
        };
    }
}

4. 配置完成運行項目

• 到此簡單配置已完成，現在可以點擊VS運行 KIMS.Server 項目啦，運行效果如下：