Migrating to 9.3.1

In this topic

• Migrating to the ArcGIS WebServices toolkit
• Deployment

Migrating to the ArcGIS WebServices toolkit

1. Copy the 9.3.1 Java Archive (JAR) file, Javascript, Cascading Style Sheets (CSS), Java, Images, Properties, Extensible Style Language (XSL), and XML files from <ARCGISHOME>\java\web\webcontrols and <ARCGISHOME>\java\web\web_mapping_application folders into the appropriate folders for the Web application’s project or Web Application Archive (WAR) file. This process is similar to upgrading Web applications to a newer service pack.
2. Remove the following Axis specific libraries from the application's WEB-INF\lib folder:
• axis.jar
• axis-ant.jar
• axis-schema.jar
• wsdl4j-1.5.1.jar
• saaj.jar
  

• The old SOAP API used to throw java.rmi.RemoteException or org.apache.axis.AxisFault. The new SOAP API throws java.lang.RuntimeException.
• The old SOAP API used classes (and string constants internally) for enumerations, such as EsriImageFormat. The new SOAP API uses Java enums.
• The old SOAP APIs used org.apache.axis.types.UnsignedByte types shorts for elements of the type xs:unsignedByte in the WSDLs, for example, RGBColor::setBlue(). The new SOAP API uses primitives.
• The SOAP API used java.util.Calendar for dates. The new SOAP API uses javax.xml.XmlGregorianCalendar.
• The old SOAP API used ArrayOfIntHolder and ArrayOfDoubleHolder classes. The new SOAP API replaces these with a Holder class.

• The parameterized constructor of ***ServerBindingStub objects is being deprecated to encourage users to change from and to the following code example:
  

// Change from the following:

MapServerBindingStub stub = new MapServerBindingStub(URL, null);

// Change to the following:

MapServerBindingStub stub = new MapServerBindingStub(url);

// Change from the following:

Record record = new Record(values);

// Change to the following:

Record record = new Record();
record.setValues(values);

// Change from the following:

mapServer._setProperty(org.apache.axis.client.Call.TRANSPORT_NAME,
    AGSLocalTransport.AGS_LOCAL_TRANSPORT_NAME);
mapServer._setProperty(AGSLocalSender.AGS_LOCAL_HANDLER, serverobject);
mapServer._setProperty(AGSLocalSender.AGS_LOCAL_CAPABILITIES, capabilities);

// Change to the following:

mapServer.setSoapOverDCOM(serverobject, capabilities);

// Change from the following:

mapServer._setProperty(javax.xml.rpc.USERNAME_PROPERTY, username);
mapServer._setProperty(javax.xml.rpc.PASSWORD_PROPERTY, password);
mapServer._setProperty(ADFFilter.HTTP_REFERRER, referrer);

// Change to the following:

mapServer.setEndPointAddress(URL, userName, password);
mapServer.setHttpReffer(referer);

• All ESRI constants do not have "_" static members. For example, EsriJobStatus has _esriJobCancelled, _esriJobExecuting, _esriJobSucceeded, and so on. Static string members in Axis generated stubs. JaxB generated stubs do not have these members.
  
  If your Web ADF application uses Axis as shown in the following code example, you will have to change it while upgrading to the new ArcGIS Java WebService toolkit:

// If your Web ADF uses Axis as follows:

if (jobStat.toString().equals(EsriJobStatus._esriJobSubmitted)){
    System.out.println("SubmitJob()");
}


// Change to the following while upgrading to the new ArcGIS Java WebService toolkit:

if (jobStat.toString().equals(EsriJobStatus.esriJobSubmitted.toString())){
    System.out.println("SubmitJob()");
}

• The com.esri.arcgisws.holders package is no longer available. Instead, use com.esri.arcgisws.runtime.Holder class from the new ArcGIS Java WebServices toolkit. This is a generic class that can take any type.
  
  For example, if your Web ADF application has the following Axis based usage, change it in the new ArcGIS Java WebServices toolkit:

// If the Web ADF has the following Axis based usage:

ArrayOfDoubleHolder areas = new ArrayOfDoubleHolder();
ArrayOfDoubleHolder lengths = new ArrayOfDoubleHolder();
geomStub.getAreasAndLengths(sf, polys, areas, lengths);


// Change it as follows in the new ArcGIS Java WebServices toolkit:

Holder < double[] > areas = new Holder < double[] > ();
Holder < double[] > lengths = new Holder < double[] > ();
geomStub.getAreasAndLengths(sf, polys, areas, lengths);

Deployment

<?xml version="1.0" encoding="UTF-8"?>
<!-- weblogic.xml -->
<weblogic-web-app>
  <container-descriptor>
    <prefer-web-inf-classes>true</prefer-web-inf-classes>
  </container-descriptor>
</weblogic-web-app>

<?xml version="1.0"?>
<!-- Orion-web.xml -->
<orion-web-app
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:noNamespaceSchemaLocation="http://xmlns.oracle.com/oracleas/schema/orion-web-10_0.xsd"
  deployment-version="10.1.3.0.0"
  jsp-cache-directory="./persistence"
  jsp-cache-tlds="standard"
  temporary-directory="./temp"
  schema-major-version="10"
  schema-minor-version="0">
  <web-app-class-loader search-local-classes-first="true"/>
  <web-app/>
</orion-web-app>