Descarga de PropertiesFile4Delphi - Descarga del código fuente PropertiesFile4Delphi

PropertiesFile4Delphi

código fuente de delphi

1.0.0

Descargar

Archivo de propiedades para Delphi

PropertiesFile4Delphi consta de una biblioteca para manejar archivos de configuración de formato clave=valor .

Acerca del proyecto

Muchas veces, por diversos motivos, es necesario parametrizar la aplicación a partir de un mecanismo de configuración. En Delphi es común usar archivos INI para almacenar la configuración, pero trabajar con estos archivos es un poco repetitivo e improductivo. La API PropertiesFile4Delphi facilita este trabajo con archivos de configuración que reemplazan el uso de archivos INI. Es una API para gestionar archivos de texto simples, que se escriben con la sintaxis clave=valor , almacenando una clave única por línea.

Características clave

Almacene y cargue datos a través de una interfaz simplificada;
Asigne archivos de configuración a clases simplificadas.

Construido con

Delphi Community Edition: el IDE utilizado

Empezando

Para tener una copia local en funcionamiento, siga estos sencillos pasos.

Requisitos previos

Para utilizar esta biblioteca se requiere una versión actualizada de Delphi IDE (XE o superior).

Instalación

Clonar el repositorio

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

Añade a la "Ruta de Búsqueda" de tu IDE o de tu proyecto los siguientes directorios:

 PropertiesFile4Delphisrc

Uso

Cree o edite archivos de configuración declarando una variable de tipo IPropertiesFile y utilizando la implementación TPropertiesFileStorage:

Guardar un archivo de propiedades

 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;

Cargando un archivo de propiedades

 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;

Mapeo de clases de configuración y soporte

La biblioteca PropertiesFile4Delphi proporciona un conjunto de clases de mapeo. De esta manera, puede trabajar directamente con las clases en lugar de tener que manipular archivos en su código fuente. El primer paso para utilizar el mecanismo de configuración en una aplicación es crear una clase específica para almacenar los parámetros deseados y escribirlos con [PropertiesFile] y heredar la clase TPropertiesFileObject .

Ejemplo de mapeo:

 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;

Cuando se destruye la clase, el archivo se guarda automáticamente:

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

Al crear una instancia de la clase se cargan los datos:

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

Asignaciones de campos admitidos:

PropertyItem: definición del campo alias;
NotNull: definición de campo obligatorio;
Ignorar: campos que deben ignorarse;
ReadOnly: campos que son de solo lectura (se pueden aplicar a nivel de clase).

Hoja de ruta

Consulte los problemas abiertos para obtener una lista de funciones propuestas (y problemas conocidos).

Contribuyendo

Las contribuciones son las que hacen de la comunidad de código abierto un lugar increíble para aprender, inspirar y crear. Cualquier contribución que hagas será muy apreciada .