Lotus Instant Messaging/ Web Conferencing ... - IBM Redbooks

When to use the Collaborative ComponentsThe goal of the Collaborative Components is to expose the most commonly usedaspects of the Lotus collaborative technologies through a simple and consistentAPI. The components are not a replacement of the core product APIs, but ratherare complementary. Developers may choose to use the CollaborativeComponents when they need quick and easy access to Lotus technologies, andmay also use the core product APIs in other portions of their applications whenmore advanced integration with the Lotus Collaborative technologies is required.10.3.3 Technical overview of the Collaborative ComponentsThe Collaborative Components consist of infrastructure objects, service objects(and their subordinate objects), and tag language descriptors for custom tags.This section provides a high-level overview of these key objects and tags.For more details on each class, tag, and the available methods, see the IBMWebSphere Portal V4.2 Info Center, found at:http://publib.boulder.ibm.com/pvc/wp/42/ext/en/InfoCenter/index.htmlOnce there, look for Collaborative Components API under the DevelopingPortlets link.Infrastructure objectsThe infrastructure objects are as follows:►►►CSEnvironmentInitializes the server environment and retrieves credentials for the logged-inuser.CSCredentialsRepresents the authentication information for the logged-in user. CSFactoryuses these credentials to authenticate against the worker servers (Sametime,QuickPlace, and so on).CSFactoryConstructs the Java service objects and generates a connection to theappropriate worker server.Java service objectsThe CSFactory object instantiates these service objects. The developer isresponsible for calling the cleanup() member function on each object before theygo out of scope. This cleanup function releases any resources a service objectholds.Chapter 10. Sametime-enabling portlets 283