PropertiesFile4Delphi

File Properti Untuk Delphi

PropertiesFile4Delphi terdiri dari perpustakaan untuk menangani file konfigurasi format key=value .

Tentang Proyek

Seringkali, karena berbagai alasan, parameterisasi aplikasi perlu dilakukan mulai dari mekanisme konfigurasi. Di Delphi biasa menggunakan file INI untuk menyimpan pengaturan, namun bekerja dengan file ini agak berulang dan tidak produktif. API PropertiesFile4Delphi memfasilitasi pekerjaan ini dengan file konfigurasi menggantikan penggunaan file INI. Ini adalah API untuk mengelola file teks sederhana, yang ditulis dengan sintaks key=value , menyimpan kunci unik per baris.

Fitur Utama

• Menyimpan dan memuat data melalui antarmuka yang disederhanakan;
• Petakan file konfigurasi ke kelas yang disederhanakan.

Dibangun Dengan

• Delphi Community Edition - IDE yang digunakan

Memulai

Untuk mengaktifkan dan menjalankan salinan lokal, ikuti langkah-langkah sederhana ini.

Prasyarat

Untuk menggunakan perpustakaan ini, diperlukan versi terbaru Delphi IDE (XE atau lebih tinggi).

Instalasi

Kloning reponya

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

Tambahkan "Jalur Pencarian" IDE atau proyek Anda ke direktori berikut:

 PropertiesFile4Delphisrc

Penggunaan

Buat atau edit file konfigurasi dengan mendeklarasikan variabel bertipe IPropertiesFile dan menggunakan implementasi TPropertiesFileStorage:

Menyimpan File Properti

 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;

Memuat File Properti

 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;

Kelas Dukungan dan Konfigurasi Pemetaan

Pustaka PropertiesFile4Delphi menyediakan sekumpulan kelas pemetaan. Dengan cara ini Anda dapat bekerja secara langsung dengan kelas daripada memanipulasi file dalam kode sumber Anda. Langkah pertama untuk menggunakan mekanisme konfigurasi dalam suatu aplikasi adalah membuat kelas tertentu untuk menyimpan parameter yang diinginkan dan menuliskannya dengan [PropertiesFile] dan mewarisi kelas TPropertiesFileObject .

Contoh pemetaan:

 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;

Ketika kelas dimusnahkan, file secara otomatis disimpan:

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

Saat membuat instance kelas, data dimuat:

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

Pemetaan lapangan yang didukung:

• PropertyItem: definisi bidang alias;
• NotNull: definisi bidang wajib;
• Abaikan: Bidang yang harus diabaikan;
• ReadOnly: Bidang yang bersifat read-only (dapat diterapkan di tingkat kelas).

Peta jalan

Lihat masalah yang masih terbuka untuk mengetahui daftar fitur yang diusulkan (dan masalah umum).

Berkontribusi

Kontribusi inilah yang membuat komunitas open source menjadi tempat yang luar biasa untuk belajar, menginspirasi, dan berkreasi. Setiap kontribusi yang Anda berikan sangat dihargai .

1. Garpu Proyek
2. Buat Cabang Fitur Anda ( git checkout -b feature/AmazingFeature )
3. Komit Perubahan Anda ( git commit -m 'Add some AmazingFeature' )
4. Dorong ke Cabang ( git push origin feature/AmazingFeature )
5. Buka Permintaan Tarik

Lisensi

Didistribusikan di bawah LISENSI APACHE. Lihat LICENSE untuk informasi lebih lanjut.

Kontak

Untuk menghubungi kami gunakan opsi:

• Email : [email protected]
• Twitter : @ezequieljuliano
• Linkedin: ezequiel-juliano-müller

Tautan Proyek

https://github.com/ezequieljuliano/PropertiesFile4Delphi