Asserts De Ant

A S S E R T S D E A N T

La tarea Assert añade una capacidad de afirmación de los proyectos de Ant. Esta tarea trabaja de una manera muy similar a la palabra clave de Java assert, y ofrece un número limitado de "diseño por contrato de" instalación de Ant. Esto es muy útil para probar los scripts de creación antes de su puesta en producción.

La tarea Assert verifica que una determinada propiedad tenga un valor determinado y lanza un BuildException si el valor de la propiedad no es el esperado o la propiedad no existe.

También, como afirma la palabra clave assert de Java, la tarea Assert debe ser 'encendido' usando la propiedad ant.enable.asserts. Si no se establece o se establece en false, la tarea Assert funciona exactamente igual que la tarea sequential. Si la variable task se utiliza para definir esta propiedad, entonces se puede activar y desactivar según sea necesario a lo largo de una generación.

Esta tarea puede tener otras tareas como Assert.

La tarea de Assert puede contener un elemento 'bool’. El elemento 'bool' es idéntico a la ConditionTask, pero a diferencia del ConditionTask, es en realidad una tarea. El elemento 'bool' puede contener todas las condiciones permitidas por el ConditionTask, además de las IsPropertyTrue , IsPropertyFalse , StartsWith , EndsWith , IsGreaterThan , IsLessThan y condiciones. Consulte if task para ejemplos del uso de estos condicionales.

Table 4.1. Assert Task Attributes

Atributo Descripción Default Requerida

name El nombre de la propiedad para probar none Yes

exists Prueba de la existencia o no existencia de la propiedad. True No

value El valor para probar, implica "exists = true '. Si el valor del proyecto es diferente a este valor, un BuildException serán arrojados, y la construcción o el build se detendrá. none No

execute Deben las tareas contenidas en esta tarea ser ejecutadas? Puede ser útil para establecer este a false cuando se prueban archivos de creación. True No

failonerror Debe suspenderse la construcción si la afirmación falla? Si se establece en falso es contrario al uso que vayan de las afirmaciones, pero puede ser útil en determinadas situaciones.

True No

Como se indicó anteriormente, la tarea de Assert puede contener una tarea "bool" anidada, de lo contrario, la tarea Assert no es compatible con todos los elementos anidados aparte de las tareas de hormigas. Cualquier tarea Ant válido puede ser embebido dentro de la tarea assert.

En el ejemplo siguiente, la primera tarea assert checa que la propiedad wait (de espera) existe y no ejecuta las tareas de echo y sleep. La segunda tarea de la afirmación checa que la propiedad wait (de espera) existe, tiene un valor de 2, y ejecuta la tarea echo.

<property name="wait" value="2"/>

<assert name="wait" execute="false">

<echo>

Waiting ${wait} seconds...

Click the red button to stop waiting.

</echo>

<sleep seconds="${wait}"/>

</assert>

<assert name="wait" value="2" execute="true">

<echo>done waiting!</echo>

</assert>

el siguiente ejemplo Muestra como Assert se utiliza en una prueba unitaria para el "límite" de tareas:

<property name="ant.enable.asserts" value="true"/>

<target name="test2">

<!-- should not stop 'sleep' task, should print out '_passed_' -->

<stopwatch name="timer"/>

<limit maxwait="5">

<sleep seconds="1"/>

<echo>_passed_</echo>

</limit>

<stopwatch name="timer" action="total"/>

<assert message="Too much time.">

<bool>

<islessthan arg1="${timer}" arg2="2"/>

</bool>

</assert>

</target>

Si la propiedad ant.enable.asserts se establece en false, entonces en el ejemplo de arriba, echo , sleep , and y todas las tareas de echo serán ejecutadas.

Glosario

La variable task proporciona una propiedad mutable de ant y funciona muy parecido a la asignación de variables en Java. Esta tarea es similar a la tarea de la propiedad Ant estándar, excepto que estas propiedades son mutables. Si bien esto va en contra del uso de las propiedades estándar de Ant, en ocasiones, es útil ser capaz de cambiar el valor de la propiedad dentro de la construcción (build). En general, el uso de esta tarea no es recomendable, y la propiedad estándar de Ant se debe utilizar si es posible.

Más condiciones

Estas condiciones son adecuadas para su uso en el elemento <bool>. Desafortunadamente, ellos no se pueden utilizar en la tarea <condition>, aunque todas las condiciones para la tarea <condition> se puede utilizar con la <bool> y la <bool> se puede utilizar dondequiera que <condition> puede ser utilizado.

IfPropertyTrue

Dado un nombre de la propiedad, comprueba si el valor de esa propiedad es igual a "true" (or "yes" or "on").

Table 5.2. atributos de IfPropertyTrue

Attributo Descripción Requerido

...