Chapter 34 Creating and Using Jaguar Pseudocomponents

Creating pseudocomponents

For the most part, pseudocomponents can be created and implemented like any Jaguar CORBA/Java or C++ component. However, since they are not executed by the component dispatcher, there are additional restrictions on their implementation and use. This section explains the implementation restrictions and required property settings for pseudocomponents. For additional information on creating components, see "Defining components".

Implementation restrictions

Pseudocomponents must be implemented in C++ or Java. If using Java, the component type must be Java/CORBA; you cannot instantiate an Enterprise JavaBean as a pseudocomponent.

Since pseudocomponents execute outside of the Jaguar dispatcher, their execution is not governed by component properties defined in Jaguar Manager. Thus, components that run as pseudocomponents are subject to these restrictions:

They cannot participate in server-managed transactions.
Lifecycle interface methods, such as those in CtsComponents::ObjectControl, are not called and instances are never pooled or reused. Each time a client program instantiates a proxy instance of a pseudocomponent, a new instance of the implementation class is constructed.
They are not affected by component threading properties. A pseudocomponent's methods run in the same process of the calling program, on the same thread from which they are called.
Pseudocomponents executed in standalone programs cannot use server-side classes and methods such as connection management, client credential access, and so forth. These classes and methods are available only to components executed by the Jaguar component dispatcher. A pseudocomponent that is executed by a server-dispatched component can use server-side features, but does so in the context of the server-dispatched component that instantiated the pseudocomponent.
They are not affected by access control restraints. Any client with local access to a component's implementation library or class can instantiate the component as a pseudocomponent.

Defining a pseudocomponent

A pseudocomponent must be defined in Jaguar Manager in order to generate stubs and skeletons. Stubs and skeletons are required to execute the pseudocomponent. You can use any of the techniques described in "Defining components" to define the component in Jaguar Manager. You must configure the properties described in this section.

Using existing components You can also instantiate existing C++ or CORBA/Java components as pseudocomponents, provided the implementation abides by the restrictions listed in this document.

Properties for a Java pseudocomponent

For a Java pseudocomponent, set the following properties and leave other properties at their default settings. Properties other than these have no affect on the behavior of the pseudocomponent:

Component Type - Choose Java - CORBA.
Java Class - Enter the dot-notation Java class name, for example com.sybase.sample.PseudoJavaImpl .

Properties for a C++ pseudocomponent

The Component Properties dialog box appears. Set the following fields for a C++ pseudocomponent, leaving other fields at their default settings. Properties other than these have no affect on the behavior of the pseudocomponent:

Component Type - Choose C++.
DLL Name - Enter the base name for the shared library or DLL that will contain the component implementation. For example, the setting mypseudo indicates the Windows file mypseudo.dll on Windows.
C++ Class - Leave at the default setting (the name of the component, appended with "Impl", as in PseudoCPPImpl ).