Appendix A Jaguar 1.1 Java Classes and Interfaces

jaguar.beans.CommunicationDriver interface

Description

package com.sybase.jaguar.beans.enterprise;

public interface CommunicationDriver

The interface implemented by driver classes that handle communication between a Java client and a Jaguar server.

Constructors

None. See CommunicationManager.getDriver(String) and Stub.getCommunicationDriver().

Methods

• acceptsURL(String) - Returns true if the communication driver instantiates stubs for the protocol identified in the given URL.
• createInstance(String, Class) - Attempts to create a stub instance for the component identified by the given URL.
• getMajorVersion() - Returns the major version number of the driver.
• getMinorVersion() - Returns the minor version number of the driver.

See Also

jaguar.beans.enterprise.CommunicationManager class

CommunicationDriver.acceptsURL(String)

Description

Returns true if the communication driver instantiates stubs for the protocol identified in the given URL.

Syntax

public abstract boolean acceptsURL(String url)
           throws EnterpriseBeanException;

Parameters

URL

A URL that identifies an Enterprise JavaBean. See CommunicationManager.createInstance(String, Class) for details on the URL format.

Return Values

true if the communication driver instantiates stubs for the protocol identified in the given URL.

See Also

CommunicationManager.getDriver(String)

CommunicationDriver.createInstance(String, Class)

Description

Attempts to create a stub instance for the component identified by the given URL.

Syntax

public static synchronized Stub createInstance
          (String URL, Class typeView) 
          throws EnterpriseBeanException

Parameters

URL

A Uniform Resource Locator (URL) of the form:

ejb:protocol[//subprotocol1]

where protocol identifies which CommunicationDriver instance will be used to instantiate the stub class and the rest of the URL indicates a server component and the particulars that are required to establish communication with the server. Each implementation of CommunicationDriver recognizes a different protocol. See the CommunicationManager.createInstance(String, Class) for a description of the URL to use for Jaguar components.

typeView

Not used. Pass as null .

Return Values

An instance of the stub class for the component specified by URL. Throws an exception if the driver cannot instantiate the specified component.

Usage

CommunicationDriver.createInstance is called by the CommunicationManager class. To instantiate stubs for use in client applications, call CommunicationManager.createInstance(String, Class).

See Also

CommunicationManager.createInstance(String, Class)

CommunicationDriver.getMajorVersion()

Description

Returns the major version number of the driver.

Syntax

public abstract int getMajorVersion();

Return Values

The major (high) component of the driver's version number.

See Also

getMinorVersion()

CommunicationDriver.getMinorVersion()

Description

Returns the minor version number of the driver.

Syntax

public abstract int getMinorVersion();

Return Values

The major (low) component of the driver's version number.

See Also

getMajorVersion()

Copyright © 2000 Sybase, Inc. All rights reserved.