PropertiesFile4Delphi

Delphi 的屬性文件

PropertiesFile4Delphi 包含一個用於處理key=value格式設定檔的函式庫。

關於該項目

很多時候，由於各種原因，需要從配置機制開始對應用程式進行參數化。在 Delphi 中，通常使用 INI 檔案來儲存設置，但使用這些檔案有點重複且效率低。 API PropertiesFile4Delphi 透過設定檔取代 INI 檔案來促進這項工作。它是一個用於管理簡單文字檔案的 API，這些檔案使用key=value語法編寫，每行儲存一個唯一的鍵。

主要特點

• 透過簡化的介面儲存和載入資料；
• 將設定檔對應到簡化的類別。

內建

• Delphi 社群版 - 使用的 IDE

入門

若要啟動並執行本機副本，請按照以下簡單步驟操作。

先決條件

要使用此程式庫，需要更新版本的 Delphi IDE（XE 或更高版本）。

安裝

克隆儲存庫

 git clone https://github.com/ezequieljuliano/PropertiesFile4Delphi.git

將 IDE 或專案的「搜尋路徑」新增至以下目錄：

 PropertiesFile4Delphisrc

用法

透過宣告 IPropertiesFile 類型的變數並使用 TPropertiesFileStorage 實作來建立或編輯設定檔：

儲存屬性文件

 uses
  
  PropertiesFile,
  PropertiesFile.Storage;

procedure Save;
var
  propertiesFile: IPropertiesFile;
begin
  propertiesFile := TPropertiesFileStorage.Create;
  propertiesFile.PropertyItem['app.title'] := 'Properties File For Delphi';
  propertiesFile.PropertyItem['app.version'] := '1.0.0';
  propertiesFile.SaveToFile('application.properties');
end;

載入屬性文件

 uses
  
  PropertiesFile,
  PropertiesFile.Storage;

procedure Load;
var
  propertiesFile: IPropertiesFile;
begin
  propertiesFile := TPropertiesFileStorage.Create;
  propertiesFile.LoadFromFile('application.properties');
  Self.Caption := propertiesFile.PropertyItem['app.title'] + '-' + propertiesFile.PropertyItem['app.version'];
end;

映射支援和配置類

PropertiesFile4Delphi 函式庫提供了一組映射類別。這樣您就可以直接使用類，而不是在原始程式碼中操作文件。在應用程式中使用配置機制的第一步是建立一個特定的類別來儲存所需的參數，並使用[PropertiesFile]將其寫下來並繼承TPropertiesFileObject類別。

映射範例：

 uses
  
  PropertiesFile.Mapping;

type

  [PropertiesFile('security.properties')]
  TSecurityConfig = class(TPropertiesFileObject)
  private
    [NotNull]
    [PropertyItem('username')]
    fUsername: string;

    [NotNull]
    [PropertyItem('password')]
    fPassword: string;
  public
    property Username: string read fUsername write fUsername;
    property Password: string read fPassword write fPassword;
  end;

當類別被銷毀時，檔案會自動儲存：

 procedure Load;
var
  securityConfig: TSecurityConfig;
begin
  securityConfig := TSecurityConfig.Create;
  try
    securityConfig.Username := 'admin';
    securityConfig.Password := 'admin';
  finally
    securityConfig.Free;
  end;
end;

實例化類別時載入資料：

 procedure Login;
var
  securityConfig: TSecurityConfig;
begin
  securityConfig := TSecurityConfig.Create;
  try
    Login(securityConfig.Username, securityConfig.Password);
  finally
    securityConfig.Free;
  end;
end;

支援的字段映射：

• PropertyItem：別名段定義；
• NotNull：強製字段定義；
• Ignore：應該忽略的欄位；
• ReadOnly：唯讀欄位（可在類別層級套用）。

路線圖

請參閱未決問題以取得建議功能（和已知問題）的清單。

貢獻

正是貢獻使開源社群成為學習、啟發和創造的絕佳場所。我們非常感謝您所做的任何貢獻。

1. 分叉項目
2. 建立您的功能分支（ git checkout -b feature/AmazingFeature ）
3. 提交您的更改（ git commit -m 'Add some AmazingFeature' ）
4. 推到分支（ git push origin feature/AmazingFeature ）
5. 打開拉取請求

執照

根據 APACHE 許可證分發。請參閱LICENSE以了解更多資訊。

接觸

若要聯絡我們，請使用以下選項：

• 電子郵件：[email protected]
• 推特：@ezequieljuliano
• Linkedin: 埃澤奎爾-朱利亞諾-穆勒

項目連結

https://github.com/ezequieljuliano/PropertiesFile4Delphi