IBM Content Manager OnDemand Web …

1 Content Manager OnDemand Web enablement Kit Java APIsThe Basics and BeyondWei-Dong ZhuMark MikealHassan A. ShazlyElliott WadeSebastian WelterDevelop Web applications by using ODWEK Java APIsGain insightful best practices, hints, and tipsTune and troubleshoot OnDemand Web applicationsFront coverIBM Content Manager OnDemand Web enablement Kit Java APIs: The Basics and BeyondDecember 2008 International Technical Support OrganizationSG24-7646-00 Copyright International Business Machines Corporation 2008. All rights to Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADPS chedule Contract with IBM Edition (December 2008)This edition applies to Version 8 Release 4 of IBM Content Manager OnDemand (program number 5724-J33).

2 Note: Before using this information and the product it supports, read the information in Notices on page ix. Copyright IBM Corp. 2008. All rights .. ixTrademarks .. xPreface .. xiThe team that wrote this book .. xiiBecome a published author .. xivComments welcome .. xivPart 1. Programming with the ODWEK Java APIs .. 1 Chapter 1. ODWEK Java API overview .. Origin of the ODWEK Java APIs .. Content Manager OnDemand system overview .. Content Manager OnDemand Library Server and Object Servers .. Content Manager OnDemand data .. Content Manager OnDemand data model.

3 Content Manager OnDemand data indexing and loading .. ODWEK Java APIs function overview .. Typical Web applications developed by using the ODWEK Java APIs .. ODWEK Java APIs architecture .. ODWEK Java APIs components .. ODWEK Java and native shared library .. Viewers .. ODWEK Java API distribution files .. WEBi client .. 17 Chapter 2. ODWEK Java API classes .. Core API classes and their functional relationship .. Core API classes.. Functional relationship .. Server connection classes .. Content Manager OnDemand data model classes.

4 Search classes .. Document data retrieval classes .. Error handling class .. Sample console application.. Setting up a Web development environment by using Rational Application Developer .. 43iv IBM Content Manager OnDemand Web enablement Kit Java APIs: The Basics and BeyondChapter 3. ODWEK Java API examples.. Examples overview .. Example files .. Program flow and control .. Making a connection to Content Manager OnDemand .. Obtaining a list of cabinets and folders .. Displaying OnDemand folder information .. Obtaining a list of OnDemand folder search fields.

5 Displaying an Content Manager OnDemand search results list .. Retrieving and displaying an OnDemand document .. Viewing line data documents with the applet .. Disconnecting from OnDemand .. 88 Chapter 4. Internet use case .. Use case overview .. Connection pooling consideration for the use case.. Sample application for the use case .. 98 Part 2. Best practices, hints, and tips.. 105 Chapter 5. Introduction to best practices, hints, and tips.. 107 Chapter 6. Connection pooling and connection handling .. Connection pooling overview .. Benefits of connection pooling.

6 Connection pooling objects and pooling technique .. The ODServer class .. ODWEK Java API objects and threads .. The ODWEK Java API pool levels .. A simple connection pool code example .. The pooling mechanism .. Connection pool code functions .. Connection pool code sample .. Thread safety .. Instance variables .. Synchronization.. Implementing synchronization in the ODWEK Java APIs .. Synchronizing servlet code .. Resource consumption control .. Connection initialization .. Logging off and terminating a client connection.

7 Allocation and release of resources and sessions .. Timeout .. Inactivity timeout .. 138 Contents Other timeouts.. Implementing an application timeout by using the () method .. Recommended timeout implementation for a Web application .. 141 Chapter 7. Globalization.. Globalization overview .. Content Manager OnDemand character conversion architecture .. Index data and annotations conversions.. UTF conversion .. Document data conversions .. Code page conversion in ODWEK .. API conversions .. Browser conversions .. Document data conversions.

8 The ICU conversion library .. Using Unicode as the database code page.. ODWEK language configuration .. Integrating custom code pages .. Locations that require configuration .. ICU and ICONV.. Customizing code page mappings for ICU .. Globalizing applications by using ICU .. 158 Chapter 8. Folder searching.. Criteria and SQL searches .. Criteria search .. SQL search .. Sort fundamentals .. Search results .. Query and display order .. Search result size .. Searching by date .. Selecting a document from the search result list.

9 Callbacks .. Why use callbacks .. Searching with callbacks .. Callback search example .. 173 Chapter 9. Document retrieval.. The importance of a retrieval strategy .. AFP documents.. Large objects versus small objects .. Requiring only a small part of a large object .. 181vi IBM Content Manager OnDemand Web enablement Kit Java APIs: The Basics and Delivering documents .. Retrieval API overview .. Retrieval APIs in the ODHit class .. AFP resource retrieval and custom caching .. Segmented retrieval and large object support.. Retrieving segmented documents.

10 Obtaining segment information .. Avoiding memory issues for large files .. Getting document type information .. Retrieving converted data .. Supported data conversions and viewers .. 195 Chapter 10. Applets, plug-ins, and transforms.. ODWEK plug-ins .. AFP plug-in .. Image viewer plug-in .. ODWEK Java applets .. Configuring and using the ODWEK applets .. Line data applet.. AFP2 HTML applet.. AFP2 WEB Transform .. Configuring the AFP2 WEB Transform .. Integrating the AFP2 WEB Transform in ODWEK .. Xenos transforms .. Configuring ODWEK to use Xenos transforms.