Web Service Howto:

Step 1: Setup your development environment

Step 2: Authentication
  2A> Generating Java Classes from WSDL
  2B> Using these classes to authenticate

Step 3: Post Authentication: Processing Opportunity Records
  3A> Generating Java Classes from WSDL
  3B> Using these classes to process Opportunity Records
  3C> More Sample Code: Save one Opportunity Data

package com.ebsuite.common.tutorial;

import java.io.*;
import java.util.*;
import com.ebsuite.login.SessionAuthenticatorAPIServiceSoapBindingStub;

public class SimpleTest1 {
  public static void doTest() throws Exception
  {
    java.net.URL _endpoint = new java.net.URL( "https://www.ebsuite.com/cxf/SessionAuthenticatorAPI" );
    SessionAuthenticatorAPIServiceSoapBindingStub _stub = 
      new SessionAuthenticatorAPIServiceSoapBindingStub(_endpoint, new org.apache.axis.client.Service() );
    System.out.println( "[" + _stub.simpleAuthenticate( "******", "*************************" ) + "]" );
  }

  public static void main ( String[] params )
  {
    try { doTest(); } catch (Exception e) { e.printStackTrace(); }
  }
}

package com.ebsuite.common.tutorial;

import java.io.*;
import java.util.*;
import com.ebsuite.login.SessionAuthenticatorAPIServiceSoapBindingStub;

public class SimpleTest1 {
  public static void doTest() throws Exception
  {
    java.net.URL _endpoint = new java.net.URL( "https://www.ebsuite.com/cxf/SessionAuthenticatorAPI" );
    SessionAuthenticatorAPIServiceSoapBindingStub _stub = 
      new SessionAuthenticatorAPIServiceSoapBindingStub(_endpoint, new org.apache.axis.client.Service() );
    System.out.println( "[" + _stub.loginAuthenticate( "*****", "*****", "*****" ) + "]" );
  }

  public static void main ( String[] params )
  {
    try { doTest(); } catch (Exception e) { e.printStackTrace(); }
  }
}

package com.ebsuite.common.tutorial;

import java.io.*;
import java.util.*;
import com.ebsuite.login.SessionAuthenticatorAPIServiceSoapBindingStub;
import com.ebsuite.sales.api.OppAPIServiceSoapBindingStub;
import com.ebsuite.sales.api.OpportunityList;
import com.ebsuite.sales.api.Opportunity;

public class OppTest2 {

  public static void doTest() throws Exception
  {
    java.net.URL _endpoint = new java.net.URL( "https://www.ebsuite.com/cxf/SessionAuthenticatorAPI" );
    SessionAuthenticatorAPIServiceSoapBindingStub _stub =
        new SessionAuthenticatorAPIServiceSoapBindingStub(_endpoint, new org.apache.axis.client.Service() );
    String authResult = _stub.loginAuthenticate( "****", "****", "****" );
    System.out.println( "[" + authResult + "]" );

    if ( authResult.startsWith("SESSIONID:") )
    {
      String sessId = authResult.substring( 10 );
      OppAPIServiceSoapBindingStub oppApiStub = new OppAPIServiceSoapBindingStub( 
        new java.net.URL( "https://www.ebsuite.com/cxf/OppAPI" ), new org.apache.axis.client.Service() );
      OpportunityList oppList = oppApiStub.searchOpportunities( sessId, "William" );
      Opportunity[]   opps = oppList.getList();
      for (int i=0; i < opps.length; i++)
      {
        System.out.println( " ( " + opps[i].getOppNumber() + " ) " + opps[i].getOppName() );
      }
    }
  }

  public static void main ( String[] params )
  {
    try { doTest(); } catch (Exception e) { e.printStackTrace(); }
  }
}

package com.ebsuite.common.tutorial;

import java.io.*;
import java.util.*;
import com.ebsuite.login.SessionAuthenticatorAPIServiceSoapBindingStub;
import com.ebsuite.sales.api.OppAPIServiceSoapBindingStub;
import com.ebsuite.sales.api.Opportunity;
import com.ebsuite.sales.api.BaseCustomFieldData;

public class OppTest3 {

  public static void doTest() throws Exception
  {
    java.net.URL _endpoint = new java.net.URL( "https://www.ebsuite.com/cxf/SessionAuthenticatorAPI" );
    SessionAuthenticatorAPIServiceSoapBindingStub _stub =
        new SessionAuthenticatorAPIServiceSoapBindingStub(_endpoint, new org.apache.axis.client.Service() );
    String authResult = _stub.loginAuthenticate( "***", "****", "***" );
    System.out.println( "[" + authResult + "]" );

    if ( authResult.startsWith("SESSIONID:") )
    {
      String sessId = authResult.substring( 10 );
      OppAPIServiceSoapBindingStub oppApiStub = new OppAPIServiceSoapBindingStub( 
        new java.net.URL( "https://www.ebsuite.com/cxf/OppAPI" ), new org.apache.axis.client.Service() );
      System.out.println( " Now attempting to create a new Opportunity." );

      Opportunity o = new Opportunity();
      o.setOppId( -1 );  // indicating new record
      o.setOppName( "Web Service API Test " );  // this should generate a unique name
      o.setCustomerId( 258621 );   // Please use a real, valid customer id.

      BaseCustomFieldData[] cfdatas = new BaseCustomFieldData[1];
      cfdatas[0] = new BaseCustomFieldData();
      cfdatas[0].setCfDataId( -1 );  // indicating new record
      cfdatas[0].setFieldDefinitionId(-1);
      cfdatas[0].setFieldDefinition( "Rental City" );
      cfdatas[0].setCfDataValue( "San Francisco" );
      cfdatas[0].setOlLastUpdateDate( Calendar.getInstance() );  // touch the date stamp, so the server know to process this record
      o.setCustomFields( cfdatas );

      Opportunity result = oppApiStub.saveOpportunityRecord( sessId, o );
      System.out.println( "\n\n --- saveOppRecord() --- " );
      if ( result != null && result.getOppId() > 0 )
      {
        System.out.println( " Record saved successfully. New record ID ="+ result.getOppId() );

        System.out.println( " Calling retrieve detail again. " );
        Opportunity refresh = oppApiStub.getOpportunityDetail( sessId, result.getOppId() );
        System.out.println( refresh.getOppName() );
      }
      else
      {
        System.out.println( " Transaction Failed. " );
        if ( result != null )
          System.out.println( " Msg = "+ result.getErrorMsg() );
      }
    }
  }

  public static void main ( String[] params )
  {
    try { doTest(); } catch (Exception e) { e.printStackTrace(); }
  }
}