A PowerBuilder application can act as a client to a Jaguar CTS server. To access a method associated with a component on the Jaguar server, the PowerBuilder client needs to connect to the server, instantiate the component, and invoke the component method.
PowerBuilder includes two wizards for building Jaguar clients:
- Connection Object wizard Adds code required to connect to the Jaguar server
- Jaguar Proxy wizard Helps you create projects for building proxy objects for the Jaguar components you want to access from the client
To build and deploy a Jaguar client, you need to complete the following steps:
- Use the Jaguar Connection Object Wizard (or the Template Application Start Wizard) to create a standard class user object inherited from the Connection object. You can then use this object in a script to establish a connection.
- Use the Jaguar Proxy Wizard to create a project for building proxy objects. Then generate the proxy objects.
- Create the windows, menus, and scripts required to implement the user interface.
- Write the code required to create the Jaguar component instance and call one or more component methods from the client.
- Test and debug the client.
- Deploy the application.
The simplest way to access a Jaguar server is to use the capabilities of the Connection object, a nonvisual object that handles communications with the server. Connecting to a Jaguar server by using the Connection object is very similar to connecting to a distributed PowerBuilder server application. For more information about using the Connection object to connect to a Jaguar server, see Connecting to a Jaguar server.
If you want to create a CORBA-compatible client, you can use the JaguarORB object instead of the Connection object to establish the connection to the server. By using the JaguarORB object, a PowerBuilder client can access Jaguar in the same way that a C++ client would. For more information on creating a CORBA-compatible client, see JaguarORB.
The JaguarORB object supports two techniques for proxy instantiation:
- Instantiation by using the Naming Service
To instantiate a proxy by using the CORBA Naming Service, you use the Resolve_Initial_References function of the JaguarORB object in conjunction with the NamingContext interface.
- Instantiation without using the Naming Service
To instantiate a proxy without using the CORBA Naming Service, you use the String_To_Object function of the JaguarORB object in conjunction with the Manager and Session interfaces.
If you want your client to behave the way an Enterprise JavaBean client would, you can use the Lookup function of the Connection object. For more information on creating an EJB-compatible client, see Lookup.
PowerBuilder also allows you to establish Secure Sockets Layer (SSL) connections to a Jaguar server. To take advantage of SSL support, you can use the GetGlobalProperty and SetGlobalProperty functions of the SSLServiceProvider object. Alternatively, you can specify SSL connection parameters by using the Options property of the Connection object.
For more information on SSL connections, see SSLServiceProvider object.