Tutorial Apache Ant – Property Files

0
2095

L’impostazione delle proprietà direttamente nel file di configurazione è bene, se si lavora con poche proprietà. Tuttavia, per un grande progetto, ha senso memorizzare le proprietà in un file di properties.

Memorizzazione le proprietà in un file separato offre i seguenti vantaggi:

  • Consente di riutilizzare lo stesso file, con diverse impostazioni di proprietà per ambienti di esecuzione diversi. Ad esempio, costruire le proprietà del file può essere mantenuta separatamente per DEV, TEST, e ambienti PROD.
  • È utile quando non si conoscono i valori di una proprietà (in un ambiente particolare) up-front. Ciò consente di eseguire la configurazione in altri ambienti in cui il valore della proprietà è noto.

Non c’è una regola su come chiamare il file, ma in genere il file  è denominato build.properties ed è posto sul lato lungo il build.xml file. Si potrebbe creare più proprietà di compilazione file in base agli ambienti di distribuzione – come build.properties.devbuild.properties.test.

Il contenuto del file di proprietà di compilazione sono simili al normale file di proprietà Java.Essi contengono una proprietà per riga.Ogni proprietà è rappresentata da un nome e una coppia di valori.Il nome e il valore coppie sono separate dal segno uguale (=) .Si consiglia vivamente che le proprietà sono annotati con commenti appropriati.I commenti sono elencati con il carattere cancelletto (#) .

L’esempio seguente mostra un build.xml di file e le sue associate build.properties File:

build.xml

<?xml version="1.0"?>
<project name="Hello World" default="info">

   <property file="build.properties"/>
   
   <target name="info">
      <echo>Apache Ant version is ${ant.version} - You are at ${sitename} </echo>
   </target>
   
</project>

build.properties

# The Site Name
sitename=www.quickgo.it
buildversion=3.3.2

Nell’esempio precedente, sitename è una proprietà personalizzata che  mappa solo il nome del sito. È possibile dichiarare un numero qualsiasi di proprietà personalizzate in questo modo. Un’altra proprietà personalizzate elencate nell’esempio sopra è la BuildVersion , che, in questo caso si riferisce alla versione .

In aggiunta a quanto sopra, Ant fornisce con una serie di proprietà di compilazione predefinite, elencate nella sezione precedente, ma è rappresentato seguito ancora una volta.

Proprietà Descrizione
ant.file La posizione completo del file build.
ant.version La versione della installazione di Apache Ant.
basedir Il basedir della generazione, come specificato nella basedir attributo progetto dell’elemento.
ant.java.version La versione del JDK che viene utilizzato da Ant.
ant.project.name Il nome del progetto, come specificato nel nome atrribute del progetto dell’elemento.
ant.project.default-target Il target di default del progetto attuale.
ant.project.invoked-targets Lista degli obiettivi che sono stati richiamati nel progetto corrente separato.
ant.core.lib La posizione completo del file jar Ant.
ant.home La home directory di installazione Ant.
ant.library.dir La home directory per i file di libreria Ant – tipicamente ANT_HOME / cartella lib.

L’esempio presentato in questo capitolo utilizza la ant.version proprietà incorporata.