public static void setmaxconnections(int maxconnections);

protected idmrequestoptions createidmrequestoptions() {
     idmrequestoptions idmrequestoptions = new idmrequestoptions();
     idmrequestoptions.setoffset(0);
     idmrequestoptions.setmaxreturn(10);
     idmrequestoptions.setaddressenvelopeformat("a4p");
     idmrequestoptions.setaddresssearchlevel(enumaddresslevel.premise);
      idmrequestoptions.setaddresssearchtype(enumaddresssearchtype.register);
     idmrequestoptions.setcasing(enumcasing.mixed);
     return idmrequestoptions;
}

// the url of idm globalservices v15b
final string endpoint_url = <br>  "https://idmp.gb.co.uk/idm-globalservices-ws/<latestwsdlversion>";
// profile guid for uk address lookups
final string address_profile_guid = "6c49bc44-c104-41b2-bb62-2ae45a09dd54";
// maximum time to wait for a connection to become available from the pool
final int timeout_ms = 10000;
 
// create the request
// first, we need a profilerequestcapture object to hold all the information
profilerequestcapture profilerequestcapture = new profilerequestcapture();
 
// within the profilerequestcapture, data is held in a profilerequestcapturedata object
profilerequestcapturedata profilerequestcapturedata = new profilerequestcapturedata();
 
// setup some basic options
idmrequestoptions idmrequestoptions = createidmrequestoptions();
// put those options into the capture data
profilerequestcapturedata.setoptions(idmrequestoptions);
 
// for an address lookup, we need a search address object
idmdatasearchaddress idmdatasearchaddress = new idmdatasearchaddress();
// in this case, we just have the postcode
idmdatasearchaddress.setpostcode(postcode);
// put the address into the capture data
profilerequestcapturedata.setaddress(idmdatasearchaddress);
 
// now put the capture data into the overall request
profilerequestcapture.setrequestdata(profilerequestcapturedata);
// set the configuration id of the configuration we are licensed for (usually 1)
profilerequestcapture.setconfigurationid(1);
// set a descriptive reference
profilerequestcapture.setcustomerreference("gbg sample code");
 
// important: set the profile we are going to use - in this case for uk address web service
profilerequestcapture.setprofileguid(address_profile_guid);
 
 
// now make the call using a static method on the idmclientwrapper
//   this is a capture request.
//
//   we pass in the authentication credentials, the actual globalservices wsdl url,
//        a timeout limit in millisecond,
//        and the request itself.
//
//   we expect back a profileresponse object.
 
try {
   system.out.println("postcode address lookup running ...");
   profileresponse profileresponse = idmclientwrapper
     .performcapturerequest(
        username,
        password,
        endpoint_url,
        timeout_ms,
        profilerequestcapture);
   system.out.println("... postcode address lookup has returned.");
 
   // disassemble the response to see what happened
   system.out.println("results from the postcode address lookup:");
   profileresponsedisassembler.disassemble(profileresponse);
} catch (exception e) {
    // in case something went wrong
    e.printstacktrace();
}
system.out.println("postcode address lookup complete.");

// the url of idm globalservices v15b
final string endpoint_url = "https://idmp.gb.co.uk/idm-globalservices-ws/<latestwsdlversion>";
// profile guid for global telephone validation
final string telephone_profile_guid = "454f13ca-8c71-40d6-9fef-a88d821c99e4";
// maximum time to wait for a connection to become available from the pool
final int timeout_ms = 10000;
 
 
// create the request
// first, we need a profilerequestcapture object to hold all the information
profilerequestcapture profilerequestcapture = new profilerequestcapture();
 
// within the profilerequestcapture, data is held in a profilerequestcapturedata object
profilerequestcapturedata profilerequestcapturedata = new profilerequestcapturedata();
 
// setup some basic options
idmrequestoptions idmrequestoptions = createidmrequestoptions();
// put those options into the capture data
profilerequestcapturedata.setoptions(idmrequestoptions);
 
// for an global telephone validation lookup, we need a list of telephone objects
list<idmdatacapturetelephone> listoftelephone = new arraylist<idmdatacapturetelephone>();
// add the mobile
if ((null != mobile) && !mobile.isempty()) {
idmdatacapturetelephone phone = new idmdatacapturetelephone();
phone.setnumber(mobile);
phone.settype(enumtelephone.mobile);
listoftelephone.add(phone);
}
// add the landline
if ((null != landline) && !landline.isempty()) {
idmdatacapturetelephone phone = new idmdatacapturetelephone();
phone.setnumber(landline);
phone.settype(enumtelephone.landline);
listoftelephone.add(phone);
}
// put the list of telephones into the capture data
profilerequestcapturedata.gettelephone().addall(listoftelephone);
 
// now put the capture data into the overall request
profilerequestcapture.setrequestdata(profilerequestcapturedata);
// set the configuration id of the configuration we are licensed for (usually 1)
profilerequestcapture.setconfigurationid(1);
// set a descriptive reference
profilerequestcapture.setcustomerreference("gbg sample code");
 
// important: set the profile we are going to use - in this case for global telephone validation web service
profilerequestcapture.setprofileguid(telephone_profile_guid);
 
 
// now make the call using a static method on the idmclientwrapper
//   this is a capture request.
//
//   we pass in the authentication credentials, the actual globalservices wsdl url,
//        a timeout limit in millisecond,
//        and the request itself.
//
//   we expect back a profileresponse object.
 
try {
    system.out.println("global telephone lookup running ...");
    profileresponse profileresponse = idmclientwrapper
        .performcapturerequest(
            username,
            password,
            endpoint_url,
            timeout_ms,
            profilerequestcapture);
    system.out.println("... global telephone lookup has returned.");
 
    // disassemble the response to see what happened
    system.out.println("results from the global telephone lookup:");
    profileresponsedisassembler.disassemble(profileresponse);
} catch (exception e) {
    // in case something went wrong
    e.printstacktrace();
}
system.out.println("global telephone lookup complete.");

// create a simple thread pool for this exercise
examplesimplethreadpool examplesimplethreadpool = new examplesimplethreadpool(
        username,
        password,
        endpoint_url,
        poolsize,
        numthreads);
 
// run the thread pool
system.out.println("postcode address lookup multi-threaded running ...");
 
examplesimplethreadpool.runpool();
 
system.out.println("... postcode address lookup multi-threaded has returned.");

//
//public method to start running the threads, and wait for them all to finish
//
public void runpool() {
    // create a standard java executorservice for running the threads
    executorservice executor = executors.newfixedthreadpool(poolsize);
 
    //create the individual threads, and add each one to the executor service
    for (int threadindex = 0; threadindex < numthreads; threadindex++) {
        // create individual instances of the credentials
        idmcredentials credentials = idmcredentials.createcredentials(username, password);
        // pick a postcode from the list
        int postcodeindex = threadindex % (postcodes.length);
        string postcode = postcodes[postcodeindex];
 
        // create the worker thread
        runnable worker = new exampleworkerthread(
                this.endpoint,
                credentials,
                postcode,
                threadindex);
        // ask the executor service to run it
        executor.execute(worker);
    }
 
    // close down the executor service (when it has finished) - we don't need it any more
    executor.shutdown();
    // ensure that it has finished before the java garbage disposal gets rid of it
    while (!executor.isterminated()) {
    }
    // done
    system.out.println("finished all threads");
}

// list of postcodes to pick from
private static final string[] postcodes = {
        "sw1a 1aa", "eh6 6sb", "ng11 7ep", "tw9 1px", "ec2a 2gu", "g2 4jr", "l3 4ae", "ip5 3re"};

public class exampleworkerthread implements runnable {
     ...
    @override
    //
    // implementation method for the runnable interface - this is called by the executorservice
    //
    public void run() {
        system.out.println(thread.currentthread().getname()+" start. index="+integer.tostring(this.threadindex)+", postcode = "+this.postcode);
        // process the request
        try {
            this.processrequest(this.threadindex);
        }
        catch(exception e) {
            system.err.println("exception caught in thread "+integer.tostring(this.threadindex)+"=> "+e.getmessage());
        }
        // back from processing
        system.out.println(thread.currentthread().getname()+" end. index="+integer.tostring(this.threadindex));
    }
 
    //
    // this method actually performs the address lookup
    // @param threadindex index of this thread
    //
    protected void processrequest(final int threadindex) {
        // create the request
        // first, we need a profilerequestcapture object to hold all the information
        profilerequestcapture profilerequestcapture = new profilerequestcapture();
 
        // within the profilerequestcapture, data is held in a profilerequestcapturedata object
        profilerequestcapturedata profilerequestcapturedata = new profilerequestcapturedata();
 
        // setup some basic options
        idmrequestoptions idmrequestoptions = exampleapplication.createidmrequestoptions();
        // put those options into the capture data
        profilerequestcapturedata.setoptions(idmrequestoptions);
 
        // for an address lookup, we need a search address object
        idmdatasearchaddress idmdatasearchaddress = new idmdatasearchaddress();
        // in this case, we just have the postcode
        idmdatasearchaddress.setpostcode(postcode);
        // put the address into the capture data
        profilerequestcapturedata.setaddress(idmdatasearchaddress);
 
        // now put the capture data into the overall request
        profilerequestcapture.setrequestdata(profilerequestcapturedata);
        // set the configuration id of the configuration we are licensed for (usually 1)
        profilerequestcapture.setconfigurationid(1);
        // set a descriptive reference
        profilerequestcapture.setcustomerreference("multithreaded sample: thread index="+integer.tostring(threadindex));
 
        // important: set the profile we are going to use - in this case for uk address web service
        profilerequestcapture.setprofileguid(exampleapplication.address_profile_guid);
 
 
 
        // now make the call using a static method on the idmclientwrapper
        //   this is a capture request.
        //
        //   we pass in the authentication credentials, the actual globalservices wsdl url,
        //        a timeout limit in millisecond,
        //        and the request itself.
        //
        //   we expect back a profileresponse object.
 
        try {
            system.out.println("postcode address lookup running for thread index="+integer.tostring(threadindex)+" ...");
            profileresponse profileresponse = idmclientwrapper
                    .performcapturerequest(
                            this.idmcredentials.getusername(),
                            this.idmcredentials.getpassword(),
                            this.endpoint,
                            timeout_ms,
                            profilerequestcapture);
            system.out.println("... postcode address lookup has returned for thread index="+integer.tostring(threadindex)+".");
 
            // disassemble the response to see what happened,
            system.out.println("results from the postcode address lookup for thread index="+integer.tostring(threadindex)+":");
            this.profileresponsedisassembler.disassemble(profileresponse);
        } catch (exception e) {
            e.printstacktrace();
        }
    }
}