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();
        }
    }
}