src.dir=./src
dist.dir=./dist
build.dir=./build

proxy.host=[your proxy server name or IP address]
proxy.user=[your proxy user id]
proxy.password=[your proxy password]

log4j.properties=log4j.properties

axis.home=[location where axis is installed]
activation.lib=[location of activation.jar]

authentication.wsdl=http://arcweb.esri.com/services/v2/Authentication.WSDL
mapimage.wsdl=http://arcweb.esri.com/services/v2/MapImage.WSDL

Listing 1: Contents of build.properties


<?xml version="1.0"?>
<project name="ArcWeb Services Test" default="run">
	<!-- add the properties file -->
	<property file="build.properties" />

	<!-- put axis libraries in the classpath -->
	<path id="axis.classpath">
		<fileset dir="${axis.home}/lib">
			<include name="**/*.jar" />
		</fileset>
		<pathelement location="${activation.lib}"/>
	</path>
	
	<!-- ================================= 
          target: init              
         ================================= -->
	<target name="init">
		<mkdir dir="${build.dir}"/>
		<mkdir dir="${dist.dir}"/>
		<mkdir dir="${dist.dir}/lib"/>
	</target>
	
	<!-- ================================= 
          target: WSDL2Java              
         ================================= -->
	<target name="WSDL2Java" description="Create Java file from WSDL">
		<!-- set proxy properties -->
		<setproxy proxyhost="{proxy.host}" proxyport="80" 
       proxyuser="{proxy.user}" proxypassword="{proxy.password}" />
		
		<!-- set conversion task -->
		<taskdef name="axis-wsdl2java" 
       classname="org.apache.axis.tools.ant.wsdl.Wsdl2javaAntTask">
			<classpath refid="axis.classpath" />
		</taskdef>

		<!-- convert WSDL to Java files -->
		<axis-wsdl2java url="${authentication.wsdl}" 
			output="${src.dir}" 
			typemappingversion="1.2" 
			timeout="-1"
			verbose="true">
		</axis-wsdl2java>
		
		<axis-wsdl2java url="${mapimage.wsdl}" 
			output="${src.dir}" 
			typemappingversion="1.2" 
			timeout="-1"
			verbose="true">
			<mapping 
       namespace="http://www.themindelectric.com/package/com.esri.is.services.common.v2/"  
       package="com.esri.arcweb.v2"/>
			<mapping 
namespace="http://www.themindelectric.com/package/com.esri.is.services.glue.v2.mapimage/" package="com.esri.arcweb.v2"/>
			<mapping 
       namespace="http://www.themindelectric.com/package/com.esri.is.services.common.v2.geom/"  package="com.esri.arcweb.v2"/>
		</axis-wsdl2java>
	</target>

	<!-- ====================================
	target: compile
	=========================================-->
	<target name="compile" depends="clean,init"
		description="compiles the source files">
		<copy file="${src.dir}/${log4j.properties}" 
       tofile="${build.dir}/${log4j.properties}"/>
        <javac
        	source="1.4"
        	failonerror="true"
        	verbose="false"
    		optimize="true"
        	srcdir="${src.dir}"
        	destdir="${build.dir}"
        	classpathref="axis.classpath">
        	<compilerarg value="-Xlint:unchecked"/>
        </javac>
	</target>

	<!-- ==================================
	target: dist
	=======================================-->
	<target name="dist" depends="compile"
		description="generate distribution">
		<copy todir="${dist.dir}/lib">
			<fileset dir="${axis.home}/lib">
				<include name="**/*.*"/>
				<exclude name="axis-ant.jar"/>
				<exclude name="log4j.properties"/>
			</fileset>
		</copy>
		<copy file="${activation.lib}"
			tofile="${dist.dir}/lib/activation.jar"/>
		<jar destfile="${dist.dir}/MapClient.jar"
			basedir="${build.dir}"
			manifest="mainClass.txt"/>
	</target>

	<!-- ===================================
	target: Run application
	======================================-->
	<target name="run" depends="dist"
		description="Run the project">
		<java jar="${dist.dir}/MapClient.jar"
			fork="true"
			failonerror="true">
			<classpath>
				<pathelement location="${dist.dir}/lib"/>
			</classpath>
		</java>
	</target>

	<!-- ====================================
	target: clean
	=========================================-->
	<target name="clean" description="removes created files">
		<delete dir="${build.dir}"/>
		<delete dir="${dist.dir}"/>
	</target>
</project>

Listing 2: Contents of build.xml

	<target name="WSDL2Java" description="Create Java file from WSDL">
<taskdef name="axis-wsdl2java" classname="org.apache.axis.tools.ant.wsdl.Wsdl2javaAntTask">
			<classpath refid="axis.classpath" />
		</taskdef>
	</target>
Listing 3: The core ant task <taskdef> is used to define the conversion task.

	<mapping 
       namespace="http://www.themindelectric.com/package/com.esri.is.services.common.v2/"  
       package="com.esri.arcweb.v2"/> etc.
Listing 4: Ant <mapping> tag

package com.nstar.arcweb;

import java.util.Properties;

import org.apache.log4j.Logger;

import com.esri.arcweb.v2.CircleDescription;
import com.esri.arcweb.v2.IMapImage;
import com.esri.arcweb.v2.Layer;
import com.esri.arcweb.v2.MapImageInfo;
import com.esri.arcweb.v2.MapImageLocator;
import com.esri.arcweb.v2.MapImageOptions;
import com.esri.arcweb.v2.MapImageSize;
import com.esri.arcweb.v2.Point;

public class MapClient {
	private static final Logger log = Logger.getLogger(MapClient.class);
	/**
	 * &#64;param args
	 */
	public static void main(String[] args) {
		try{
			// set the proxy server properties
			Properties properties = System.getProperties();
			properties.put("http.proxyHost", "your proxy server name or IP 
       address");
			properties.put("http.proxyPort", "your proxy port");
			properties.put("http.proxyUser", "your proxy user id");
			properties.put("http.proxyPassword", "your proxy password");
			Properties newprops = new Properties(properties);
			System.setProperties(newprops);

			// set esri global account information.
			String username = "Esri Global Account username";
			String password = "Esri Global Account Password";
			//int expiration = 60; // in seconds

			//set the data source
			String dataSource = "Esri.Basemap.World";

			//Locate Authentication Web services 
			com.esri.arcweb.v2.AuthenticationLocator  loc = new 
       com.esri.arcweb.v2.AuthenticationLocator();
			com.esri.arcweb.v2.IAuthentication auth = 
       loc.getIAuthentication();
						
			//set the map size
			MapImageSize miSize = new MapImageSize();
			miSize.setHeight(400);
			miSize.setWidth(600);
			
			//set the point of interest
			double cirRadius = 5.0;
			String cirUnits = "Miles";
			double cirX = -117.175;
			double cirY = 34.055;

			Point cirPoint = new Point();
			cirPoint.setX(cirX);
			cirPoint.setY(cirY);

			CircleDescription circle[] = new CircleDescription[1];
			CircleDescription circle1 = new CircleDescription();
			
			circle1.setCenter(cirPoint);
			circle1.setRadius(cirRadius);
			circle1.setRadiusUnits(cirUnits);
			circle[0] = circle1;

			//Obtain a layers collection array.
			MapImageLocator miLocator = new MapImageLocator();
			IMapImage mi = miLocator.getIMapImage();
			Layer[] layers = mi.getLayerInfo(dataSource);

			//set map image options
			MapImageOptions miOptions = new MapImageOptions();
			miOptions.setDataSource(dataSource);
			miOptions.setDisplayLayers(layers);
			miOptions.setMapImageFormat("jpg");
			miOptions.setMapImageSize(miSize);
			miOptions.setReturnLegend(true);
			miOptions.setCircles( circle);
			
			//get the map url
			MapImageInfo miInfo = mi.getBestMap(miOptions, 
       auth.getToken(username, password));
			log.info(miInfo.getMapUrl());
			log.info(miInfo.getLegendUrl());
			
		}catch (Exception e){
			log.warn(e);
			e.printStackTrace();
		}
		
	}

}

Listing 5: Source code for MapClient.java

	Properties properties = System.getProperties();
	properties.put("http.proxyHost", [your proxy host name];
	properties.put("http.proxyPort", "80");
	properties.put("http.proxyUser", [your proxy account name];
	properties.put("http.proxyPassword", [your proxy account password];
	Properties newprops = new Properties(properties);
	System.setProperties(newprops);
Figure 6: Properties settings for the proxy server


	AuthenticationLocator loc = new AuthenticationLocator();
	IAuthentication auth = loc.getIAuthentication();
	String token = auth.getToken(username, password);
Figure 7:Obtaining a taken from the Authentication Web Service


	MapImageSize miSize = new MapImageSize();
	miSize.setHeight(400);
	miSize.setWidth(600);
			
	Point cirPoint = new Point();
	cirPoint.setX(-117.199577);
	cirPoint.setY(34.048364);

	CircleDescription circle[] = new CircleDescription[1];
	CircleDescription circle1 = new CircleDescription();
			
	circle1.setCenter(cirPoint);
	circle1.setRadius(5.0);
	circle1.setRadiusUnits("Miles");
	circle[0] = circle1;
Listing 8: Code for generating a map of Redlands within a five-mile radius of Esri


	MapImageOptions miOptions = new MapImageOptions();
	miOptions.setDataSource(dataSource);
	miOptions.setDisplayLayers(layers);
	miOptions.setMapImageFormat("jpg");
	miOptions.setMapImageSize(miSize);
	miOptions.setReturnLegend(true);
	miOptions.setCircles( circle);
Listing 9: Using the MapImageOPtions object to communicate with the MapImage Web Service. 


	MapImageInfo miInfo = mi.getBestMap(miOptions, auth.getToken(username, 
       password));
	log.info(miInfo.getMapUrl());
	log.info(miInfo.getLegendUrl());
Listing 10: 	MapImageObject