Apache ESME has an integration with Apache Ant. It is now possible to send messages to Apache ESME that describe the progress of your build steps. This is especially useful when Apache ESME is being used in development projects where individual developers can be made aware of the status of various-build related actions. For example, a development team could be informed that a build is broken or if it is successful.  

Setup

  1. Install Apache Ant
  2. Install Apache Maven
  3. Download the Apache Commons packages "Codec" and Logger. We also need Apache "Httpclient" . Please note that we are currently using the legacy 3.1 version of the HTTP Client. 
  4. Check-out the ESME java client: https://svn.apache.org/repos/asf/esme/trunk/esme-java-client
  5. Perform a maven build in this directory with the following command "mvn compile package -Dmaven.test.skip=true" . This will create a jar file "esme-rest-api-0.1.jar" in the target directory. 
  6. Create lib directory and copy "rest-api-0.1-SNAPSHOT.jar", "commons-codec-1.2.jar", "commons-httpclient-3.1.jar" and "commons-logging-1.1.1.jar" into this directory. 
  7. Create src directory and copy the "EsmeAntTask.java" file to this directory
  8. Change the build.xml file to point to the appropriate directories
  9. Change the token in the "esme" target in the build.xml file to a correct token.
  10. Change the proxy in the "esme" target in the build.xml file to a correct proxy.
  11. call ant dist esme to test the application

Here is what the result looks like:

ant blog.jpg

Note: We wrote a version of this blog two years ago on our old blog. I've updated it and added an image plus more details. 

Build.xml

"EsmeViaAnt" default="dist" basedir=".">
  
  "src" location="src"/>
  "build" location="build"/>
  "dist"  location="dist"/>

    "project.class.path">
    "./dist/lib/EsmeViaAnt.jar:./lib/esme-rest-api-0.1.jar:./lib/commons-codec-1.4.jar:./lib/commons-logging-1.1.1.jar:./lib/commons-httpclient-3.1.jar"/>
  


  "init">
    
    
    
    "${build}"/>
  

  "compile" depends="init"
        description="compile the source " >
    
    "${src}" destdir="${build}">
       "project.class.path"/>
    
  

  "dist" depends="compile"
        description="generate the distribution" >
    
    "${dist}/lib"/>

    
    "${dist}/lib/EsmeViaAnt.jar" basedir="${build}"/>
  

  "esme"
        description="Send Esme" >
        "true"
         classname="EsmeAntTask">
         "http://esmecloudserverapache.dickhirsch.staxapps.net/api"/>
         "31EL0R0M15NTD2LSOS0BKC5Y0P5JOVAZ6"/>
         "myproxy:81"/>
         "A message from the ant build process"/>
         
           "./dist/lib/EsmeViaAnt.jar:./lib/esme-rest-api-0.1.jar:./lib/commons-codec-1.4.jar:./lib/commons-logging-1.1.1.jar:./lib/commons-httpclient-3.1.jar"/>
         

       
  


EsmeAntTask java class

import org.apache.esme.api.EsmeRestApi;
import org.apache.esme.model.Message;

public class EsmeAntTask
{

public static void main (String[] args) {

 String apiUrl;
 String authToken;
 String localProxy;
 String message;
 EsmeRestApi esme;

 apiUrl = args[0];
 authToken = args[1];
 localProxy = args[2];
 message = args[3];

 try {

         esme = new EsmeRestApi(apiUrl);

         if ((localProxy != null) && !("".equals(localProxy)))
         {
                // Split proxyHost:port into two parts
                String[] proxy = localProxy.split(":");
                esme.setProxy(proxy[0], Integer.parseInt(proxy[1]));
         }

         esme.login(authToken);

         Message esmeMsg = new Message();

         esmeMsg.setBody(message);

         String[] tags = new String[1];
         tags[0] = "Ant Task";

         esmeMsg.setTags(tags);

         esmeMsg.setSource("Ant");

         esme.sendMsg(esmeMsg);
 }
 catch (Exception e) {}
 }

}