Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

Page of 508
   
4-18
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 8.0(1)
Chapter 4      Building Your Application
Using the Java CIL Libraries
To register for an event, you use the appropriate AddEventListener method on the Session object:
// Initialize the event sink
m_pEventSink = new CEventSink(&m_ctiSession, &m_ctiAgent, this);
// Add event sink as an event listener
m_ctiSession.AddAllInOneEventListener((IAllInOne *) m_pEventSink);
To remove an event listener (upon program termination), use the appropriate RemoveEventListener on 
the Session object:
// Tell session object to remove our event sink
m_ctiSession.RemoveSessionEventListener((IAllInOne *) m_pEventSink);
STLPort 
Version 7.1(1)(0) of the Cisco CTI OS Toolkit no longer uses STLPort. Instead, it uses Microsoft’s 
version of STL, thereby removing any special configuration of the build environment. 
Next Steps
For detailed information on the CTI OS client start up and shut down sequence, see the section 
For detailed information on the CTI OS Client Interface Library objects, see Chapters 6 through 11.
For a complete sample application that uses the CIL interface with C++ static libraries, see the 
C++phone sample application on the CTI OS CD.
Using the Java CIL Libraries
The Java CIL provides a powerful cross-platform library for developing Java CTI applications. This Java 
API allows the creation of multiplatform client application that can be executed either in MS Windows 
or Linux. JavaTM CIL is built to supports the 1.6 Java Development Kit  (JDK) and JREIt is built using 
a similar architecture to the C++ CIL and the interface is also similar to C++ with some differences. As 
a result, a developer porting a C++ CIL application to Java or working between a Java and C++ should 
find it fairly easy to switch between the two.
The Java CIL consists of two packages contained in a single JAR file called JavaCIL.jar. The packages 
are com.cisco.cti.ctios.util and com.cisco.cti.ctios.cil. The Java CIL can be installed on Windows using 
the CTI OS Client Install or it can be copied directly from the CTIOS_JavaCIL directory on the CTI OS 
media under Installs\CTIOSClient. The Java CIL also includes JavaDoc with the distribution. No install 
is provided for Linux. Users will need to mount the CDROM and copy the CTIOS_JavaCIL directory 
from the media. The Java CIL version can be checked by using the CheckVersion.bat program in 
Windows or the checkversion shell script on Linux. Both of these can be found in the same directory as 
the JAR file.
Sun JRE installers are also included on the media as a convenience for developers who need to obtain 
the correct version of the JRE. CTI OS Java CIL 8.0(1) has been updated to compile and run with the 
latest version of JDK/JRE.