31

配置体系

简介

配置体系是项目中的核心模块之一,负责管理全局、应用和数据库的配置信息。这些配置直接影响系统的运行行为、功能扩展和性能优化。本文档将详细介绍配置体系的结构、常用参数及其使用方法。


全局配置

全局配置由 Shared/Config.cs 文件定义,包含系统级别的设置,如数据库类型、调试模式、系统路径等。

关键属性

  1. IsDebug: 控制是否启用调试模式。
    public static bool IsDebug { get; set; }
    
  2. DatabaseType: 定义当前系统的数据库类型。
    public static DatabaseType DatabaseType { get; set; }
    
  3. HostUrl: 系统的主机地址或域名。
    public static string HostUrl { get; set; }
    

方法

  • GetUploadPath: 获取上传文件的物理路径。
    public static string GetUploadPath(bool isWeb = false)
    

应用配置

应用配置由 Known/Config.csSample/Sample.Web/AppConfig.cs 文件定义,主要负责模块、菜单和服务的初始化。

关键属性

  1. AppMenus: 定义系统菜单信息。
    public static List<MenuInfo> AppMenus { get; set; } = [];
    
  2. RenderMode: 控制呈现类型(如 Server 或 Client)。
    public static RenderType RenderMode { get; set; } = RenderType.Server;
    

方法

  • AddModule: 添加模块程序集。
    public static void AddModule(Assembly assembly)
    

数据库配置

数据库配置主要通过 DatabaseType 属性和相关方法实现。支持的数据库类型包括 SQL Server、MySQL、SQLite 和 Oracle。

示例代码

public static DatabaseType DatabaseType { get; set; } = DatabaseType.SqlServer;

配置文件结构

配置文件通常包含以下部分:

  1. 全局设置:如调试模式、数据库类型。
  2. 应用设置:如菜单、模块初始化。
  3. 路径设置:如上传路径、静态文件路径。

常用参数

参数名称 描述 默认值
IsDebug 是否启用调试模式 false
DatabaseType 数据库类型 DatabaseType.SqlServer
HostUrl 系统主机地址 空字符串

修改方法

  1. 直接修改属性
    Config.IsDebug = true;
    
  2. 通过配置文件:某些属性支持通过配置文件动态加载。

对系统行为的影响

  • 调试模式:启用后会输出更多日志信息,便于排查问题。
  • 数据库类型:切换数据库类型需确保相关驱动和连接字符串正确。
  • 路径设置:错误的路径可能导致文件上传或读取失败。

总结

配置体系是项目运行的基础,合理设置各项参数能够优化系统性能和功能扩展性。建议在修改配置前充分测试,确保不影响系统稳定性。

classDiagram
  class Config {
    +IsDebug: bool
    +DatabaseType: DatabaseType
    +HostUrl: string
    +GetUploadPath(isWeb: bool): string
  }
  Config --> DatabaseType
  Config --> MenuInfo