Executing component methods

After instantiating the stub class, use the stub class instance to invoke the component’s methods. Each method in the stub interface corresponds to a method in the component interface that you have narrowed the proxy object to.

Parameter and return datatypes

The following table lists the datatypes displayed in EAServer Manager, the equivalent CORBA IDL types, and the Java datatypes used in stub methods.

Binary, fixed-point, date/time, and ResultSet types The BCD and MJD IDL modules define types to represent common database column types such as binary data, fixed-point numeric data, dates, and times. The BCD::Binary CORBA type maps to a Java byte array. The other BCD and MJD types map to data representations that are optimized for network transport.

To convert between the IDL-mapped datatypes and from core java.* classes, use these classes from the com.sybase.CORBA.jdbc11 package:

Chapter 1, “Java Classes and Interfaces,” in the EAServer API Reference provides reference pages for these classes.

ResultSet types The TabularResults IDL module defines types used to represent tabular data. Result sets are typically used only as return types, though you can pass them as parameters. “Methods that return tabular results” describes how to process result sets returned by method calls.

User-defined IDL types A user-defined type is any type that is not in the set of predefined datatypes and is not one of the CORBA IDL base types. You can define methods with user-defined types in EAServer Manager, as described in “User-defined IDL datatypes”.

If a method definition includes user-defined types, the stub method will use the equivalent Java datatype as specified by the CORBA Java language mappings specification. See “Overview” for more information on this document.

Holder classes All Java types have an accompanying holder class that is used for passing parameters by reference. Each holder class has the following structure:

public class <Type>Holder {
    // Current value
    public <type> value;
    // Default constructor
    public <Type>Holder() {}
    // Constructor that sets initial value
    public <Type>Holder(<type> v) {
      this.value = v;
    }
}

This structure is defined by the CORBA Java-language bindings specification.

Methods that return tabular results

In EAServer Manager, a method’s property sheet indicates whether the method returns zero, one, or multiple result sets. This setting determines the return code of the stub method as follows:

• A method that returns 0 result sets returns void.

• A method that returns a single result set returns TabularResults.ResultSet.

• A method that returns multiple result sets returns an array of TabularResults.ResultSet.

The TabularResults IDL module defines the TabularResults::ResultSet CORBA IDL datatype, which maps to TabularResults.ResultSet in Java. Most applications will convert objects of this type to a java.sql.ResultSet by calling one of the following methods:

• com.sybase.CORBA.jdbc11.SQL.getResultSet (TabularResults.ResultSet) Accepts a TabularResults.ResultSet parameter and returns a java.sql.ResultSet object.

• com.sybase.CORBA.jdbc102.SQL.getResultSet (TabularResults.ResultSet) Accepts a TabularResults.ResultSet parameter and returns a jdbc.sql.ResultSet object. If your client application will run in a JDK 1.0.2 virtual machine, this method must be used instead of the previous method.

After converting the result set to java.sql.ResultSet, use standard JDBC calls to retrieve the rows and columns. Alternatively, pass the result set to a data-aware control that displays the data to the end user.

The example below calls a stub method returnsRows() that returns a single result set:

import com.sybase.CORBA.jdbc11.SQL;
...
    java.sql.ResultSet rs = 
       SQL.getResultSet(myStub.returnsRows());
    ... code to process rows or pass result set
        to a data-aware control ...

The example below calls a stub method returnsResults() which returns multiple result sets:

import com.sybase.CORBA.jdbc11.SQL;
...
  java.sql.ResultSet rs;
  TabularResults.ResultSet[] trs_array = 
      myStub.returnsResults();

  for (int i = 0; i < trs_array.length; i++)
  {
    rs = SQL.getResultSet(trs_array[i]);
    ... code to process rows or pass result set
        to a data-aware control ...
  }

Example method calls

See the EAServer tutorials and the examples provided with your EAServer software for example method calls. Chapter 2, “Creating CORBA Java Components and Clients,” in the EAServer Cookbook contains tutorials with sample Java clients.

An introductory sample Java client is provided in the html/classes/Sample/Intro subdirectory. The file readme.html in that directory describes how to compile the classes, install the required component, and run the sample client.

Copyright © 2005. Sybase Inc. All rights reserved.

View this book as PDF