Ant-typen
ID:
org.eclipse.ant.core.antTypes
Beschrijving:
Hiermee kunt u in plugins willekeurige Ant-gegevenstypen definiëren voor gebruik
in de Ant-infrastructuur. Het is ook mogelijk om gegevenstypen aan de standaard Ant-infrastructuur toe te voegen.
Het is echter onwaarschijnlijk dat de klassen die voor deze gegevenstypen vereist zijn, zich in het klassenpad van de Ant-plugin
(of die van een van de vereiste onderdelen) bevinden.
Om dit te verhelpen moeten clients een extensie definiëren die in dit extensiepunt wordt ingevoegd
en een gegevenstypenaam aan een klasse koppelt. De Ant-plugin kan vervolgens een aanvragen indienen om de opgegeven klasse in de declarerende plugin te laden.
Configuratiemarkup:
<!ELEMENT extension (antType*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
- point - een volledig gekwalificeerd ID van het doelextensiepunt.
- id - een optioneel ID van de extensie-instance.
- name - een optionele naam van de extensie-instance.
<!ELEMENT antType EMPTY>
<!ATTLIST antType
name CDATA #REQUIRED
uri CDATA #IMPLIED
class CDATA #REQUIRED
library CDATA #REQUIRED
headless (true | false)
eclipseRuntime (true | false) >
- name - de naam van het type dat u wilt definiëren.
- uri - de URI waarop deze definitie zich bevindt. Wordt alleen gebruikt vanaf Ant 1.6.
- class - de volledig gekwalificeerde naam van een Java-klasse waarmee het gegevenstype wordt geïmplementeerd.
Normaal gesproken is deze klasse een subklasse van
org.apache.tools.ant.types.DataType
.
- library - een relatief pad ten opzichte van de installatielocatie van de plugin voor de bibliotheek met het type.
- headless - geeft aan of dit type kan worden gebruikt in een "headless" Ant-omgeving. Als de headless-werkstand actief is en het kenmerk is
false
, wordt het type niet geladen of gedefinieerd. Bovendien wordt de pluginklassenlader niet toegevoegd als een bovenliggende klassenlader aan de Ant-klassenlader.
Als dit kenmerk niet is opgegeven, is de geïmpliceerde waarde true
.
- eclipseRuntime - geeft aan of voor dit type een Eclipse-runtime vereist is (op dezelfde VM als Eclipse moet worden uitgevoerd). Als dit kenmerk niet is opgegeven, is de geïmpliceerde waarde
true
.
Voorbeelden:
Dit is een voorbeeld van de extensie antTypes:
<extension point=
"org.eclipse.ant.core.antTypes"
>
<antType name=
"coolType"
class=
"com.example.CoolType"
library=
"lib/antSupport.jar"
/>
</extension>
Copyright (c) 2000, 2006 IBM Corporation en anderen.
Alle rechten voorbehouden. Dit programma en het begeleidende materiaal zijn beschikbaar gesteld onder de voorwaarden van de Eclipse Public License v1.0 die bij deze distributie is geleverd en beschikbaar is op http://www.eclipse.org/legal/epl-v10.html.