Das PropertiesFile4Delphi besteht aus einer Bibliothek zur Handhabung von Konfigurationsdateien im Schlüssel=Wert- Format.
Aus verschiedenen Gründen ist es häufig erforderlich, die Anwendung ausgehend von einem Konfigurationsmechanismus zu parametrisieren. In Delphi werden häufig INI-Dateien zum Speichern der Einstellungen verwendet, die Arbeit mit diesen Dateien ist jedoch etwas eintönig und unproduktiv. Die API PropertiesFile4Delphi erleichtert diese Arbeit, indem Konfigurationsdateien die Verwendung von INI-Dateien ersetzen. Es handelt sich um eine API zum Verwalten einfacher Textdateien, die mit der Schlüssel=Wert -Syntax geschrieben werden und einen eindeutigen Schlüssel pro Zeile speichern.
Um eine lokale Kopie zum Laufen zu bringen, befolgen Sie diese einfachen Schritte.
Um diese Bibliothek nutzen zu können, ist eine aktualisierte Version der Delphi IDE (XE oder höher) erforderlich.
Klonen Sie das Repo
git clone https://github.com/ezequieljuliano/PropertiesFile4Delphi.git
Fügen Sie dem „Suchpfad“ Ihrer IDE oder Ihres Projekts die folgenden Verzeichnisse hinzu:
PropertiesFile4Delphisrc
Erstellen oder bearbeiten Sie Konfigurationsdateien, indem Sie eine Variable vom Typ IPropertiesFile deklarieren und die TPropertiesFileStorage-Implementierung verwenden:
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;
Die Bibliothek PropertiesFile4Delphi stellt eine Reihe von Zuordnungsklassen bereit. Auf diese Weise können Sie direkt mit Klassen arbeiten, anstatt Dateien in Ihrem Quellcode zu manipulieren. Der erste Schritt zur Verwendung des Konfigurationsmechanismus in einer Anwendung besteht darin, eine bestimmte Klasse zum Speichern der gewünschten Parameter zu erstellen und diese mit [PropertiesFile] aufzuschreiben und die TPropertiesFileObject -Klasse zu erben.
Mapping-Beispiel:
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;
Wenn die Klasse zerstört wird, wird die Datei automatisch gespeichert:
procedure Load;
var
securityConfig: TSecurityConfig;
begin
securityConfig := TSecurityConfig.Create;
try
securityConfig.Username := 'admin';
securityConfig.Password := 'admin';
finally
securityConfig.Free;
end;
end;
Beim Instanziieren der Klasse werden die Daten geladen:
procedure Login;
var
securityConfig: TSecurityConfig;
begin
securityConfig := TSecurityConfig.Create;
try
Login(securityConfig.Username, securityConfig.Password);
finally
securityConfig.Free;
end;
end;
Unterstützte Feldzuordnungen:
Eine Liste der vorgeschlagenen Funktionen (und bekannten Probleme) finden Sie unter „Offene Probleme“.
Beiträge machen die Open-Source-Community zu einem so wunderbaren Ort zum Lernen, Inspirieren und Schaffen. Jeder Beitrag, den Sie leisten, wird sehr geschätzt .
git checkout -b feature/AmazingFeature
)git commit -m 'Add some AmazingFeature'
)git push origin feature/AmazingFeature
) Verteilt unter der APACHE-LIZENZ. Weitere Informationen finden Sie unter LICENSE
.
Um mit uns Kontakt aufzunehmen, nutzen Sie die Möglichkeiten:
https://github.com/ezequieljuliano/PropertiesFile4Delphi