[CONF] Apache Felix: iPOJO Ant Task (page edited)

Tue, 14 Aug 2007 08:03:31 -0700

Page Edited : FELIX : iPOJO Ant Task

iPOJO Ant Task has been edited by Clement Escoffier (Aug 14, 2007).

(View changes)

Content:

IPOJO Ant Task allows automating the iPOJO manipulation process. This page explains how to use the iPOJO Ant Task and how to combine them with the BND Tasks.

Downloading the iPOJO Ant Task

The iPOJO Ant Task is available here. Sources are available on the Felix trunk (instructions to downlad and build).

How to use the Ant Task

The iPOJO Ant task take an input bundle and a metadata file and create the final (i.e. manipulated) bundle.
To use the task declare a target in your build.xml as: 

<target name="main">
	<taskdef name="ipojo" classpath="org.apache.felix.ipojo.ant-0.7.3-SNAPSHOT.jar" classname="org.apache.felix.ipojo.task.IPojoTask"/> 
	<ipojo
		input="foo.jar"
		metadata = "meta.xml"
	/>
</target>

First, define the new task. Then simply use it. The input argument describe the input bundle (must exists) and the metadata argument describes the metadata file (must exist too). The input bundle must be a well-formed bundle.



Ant Task Arguments


The iPOJO Ant Task as three different arguments:


    
	
  • Input: describes the input bundle. This argument is mandatory.
    • 
	
  • Output: describes the output bundle. This argument is optional. If not present, the output file will be input file.
    • 
	
  • Metadata: describes the metadata file. This argument is optional. By default, it tries with a metadata.xml file (in the same directory as the build.xml file). If the default file is not present, it tries to use only iPOJO annotations.
    • 





Combining the iPOJO Ant Task and BND


The iPOJO Ant Task requires an input bundle. BND is a tools simplifying bundle creation. So, it is possible to combine the two tools to create your bundle automatically. The following build.xml shows you an example of combination.




<project default="main" basedir=".">
	<target name="bnd"> 
	   <taskdef resource="aQute/bnd/ant/taskdef.properties"
	      classpath="bnd-0.0.178.jar"/> 
	   <bnd 
	      classpath="src" 
	      eclipse="true" 
	      failok="false" 
	      exceptions="true" 
	      files="foo.bnd"/> 
	 </target>	

 <target name="main" depends="bnd">
	<echo message="Call main"/> 
	<taskdef name="ipojo" classpath="org.apache.felix.ipojo.ant-0.7.3-SNAPSHOT.jar" classname="org.apache.felix.ipojo.task.PojoTask"/> 
	<ipojo
		input="foo.jar"
		metadata = "meta.xml"
	/>
</target>
</project>




The first target creates the bundle with BND. More details on the BND Ant Task are available here. To combine the BND output and the iPOJO input, the iPOJO input need to be the same as the BND file but with the ".jar" extension. For instance, the BND file is foo.bnd, so the input jar must be foo.jar.

To be sure that the BND bundle is already created, you can add the "depends" clause in the iPOJO Target.



However, it is possible to create only one target doing the two operations as:




<target name="main"> 
   <taskdef resource="aQute/bnd/ant/taskdef.properties"
	      classpath="bnd-0.0.178.jar"/> 
   <taskdef name="ipojo" classpath="org.apache.felix.ipojo.ant-0.7.3-SNAPSHOT.jar" classname="org.apache.felix.ipojo.task.IPojoTask"/> 

        <bnd 
	      classpath="src" 
	      eclipse="true" 
	      failok="false" 
	      exceptions="true" 
	      files="foo.bnd"/> 
	<ipojo
	      input="foo.jar"
	      metadata = "meta.xml"/>
</target>

Powered by Atlassian Confluence (Version: 2.2.9 Build:#527 Sep 07, 2006) - Bug/feature request

Unsubscribe or edit your notifications preferences

Reply via email to