Table of Contents

There is also a listing of tables, figures, and captioned examples.

Part I: Overview of Tools.h++ Professional




Chapter 1: Introduction

• 1.1 Welcome
• 1.2 Software Requirements
• 1.3 Documentation
• 1.3.1 Printed Manuals
• 1.4 Using This Manual
• 1.4.1 Assumptions
• 1.4.2 Organization
• 1.5 Documentation Conventions
• 1.5.1 Type Conventions
• 1.5.2 Pathname Variables
• 1.5.3 Terminology and Notation
• 1.5.4 Naming Conventions
• 1.6 Technical Support
• 1.6.1 Before Contacting Technical Support
• 1.6.2 How to Contact Technical Support
• 1.7 Product Information

Chapter 2: Product Overview

• 2.1 What is Tools.h++ Professional?
• 2.2 Tools.h++
• 2.3 The Java/C++ Interoperability Module
• 2.4 The Networking Module
• 2.4.1 The net Library: Network Communication Classes
• 2.4.2 The int Library: Thread-Hot Internet Classes
• 2.5 The CORBA Module
• 2.5.1 The orb Library: CORBA Streaming with Orbix

Chapter 3: Using the Modules Together

• 3.1 Overview
• 3.2 Decisions to Make Before You Start
• 3.3 Common Themes
• 3.3.1 Creating Chains of Objects
• 3.3.2 Virtual Streams As Universal Translators
• 3.3.3 Transferring Data
• 3.4 Transferring Data Over a Socket
• 3.5 Transferring Data Between C++ and Java
• 3.5.1 Using the Tools.h++ Virtual Streams Format
• 3.6 Transferring Data Over an ORB Connection
• 3.6.1 Classes that Define Virtual Stream Shift Operators
• 3.6.2 Classes that Derive from RWCollectable
• 3.6.3 Deciding Which Classes To Use



Part II: Java/C++ Interoperability Module




Chapter 4: Introduction to the Java/C++ Interoperability Module

• 4.1 Description of the Product
• 4.2 Organization of the Documentation

Chapter 5: Using Virtual Streams for Java

• 5.1 Overview
• 5.2 Exchanging Basic Types
• 5.2.1 The Virtual Streams
• 5.2.2 Ranges of Values
• 5.2.3 Character Encodings
• 5.2.4 Concrete Portable Streams
• 5.3 Exchanging Objects
• 5.3.1 Prebuilt Streamers
• 5.3.2 Required Components
• 5.3.3 Example
• 5.3.4 ObjectStreamers
• 5.3.5 Simple Streamers
• 5.3.6 Refresher: Persistence in Tools.h++
• 5.3.7 Complex Streamers
• 5.3.8 Class PersistableStreamer and the DefinePersistable Interface
• 5.3.9 Class CollectableStreamer and the DefineCollectable Interface

Chapter 6: Using the jtools  Collection Classes

• 6.1 Introduction
• 6.2 Shared Methods
• 6.2.1 The Collection Interface
• 6.2.2 The Sequence Interface
• 6.3 Auxiliary Interfaces
• 6.3.1 The BidirectionalEnumeration Interface
• 6.3.2 The BinaryFunction and UnaryFunction Interfaces
• 6.3.3 The Comparator Interface
• 6.4 Basic Collection Classes
• 6.4.1 BTree
• 6.4.2 BinaryTree
• 6.4.3 Bag
• 6.4.4 Set
• 6.4.5 IdentitySet
• 6.5 Sequenceable Classes
• 6.5.1 Dlist
• 6.5.2 Slist
• 6.5.3 Queue
• 6.6 Dictionary Classes
• 6.6.1 BTreeDictionary
• 6.6.2 HashDictionary
• 6.6.3 IdentityDictionary
• 6.7 Choosing a Collection Class
• 6.7.1 The Decision Tree
• 6.8 Creating Your Own Collection Class

Chapter 7: Using the jtools Regular  Expression Class

• 7.1 Introduction
• 7.2 One-Character Regular Expressions
• 7.3 Multicharacter Regular Expressions
• 7.4 Anchoring within a Line
• 7.5 Control Characters
• 7.6 A Regular Expression Example

Chapter 8: Using the jtools  Format Package

• 8.1 Introduction
• 8.2 NumericFormat
• 8.3 NumericPicture
• 8.4 TextAlignment
• 8.5 TextPicture
• 8.6 QuickFormat



Part III: Networking Module




Chapter 9: Introduction to the  Networking Module

• 9.1 Description
• 9.2 Organization
• 9.2.1 The net Library: Organization
• 9.2.2 The int Library: Organization

Chapter 10: The net Architecture

• 10.1 Introduction
• 10.2 The Three-Layer Architecture
• 10.2.1 Foundation
• 10.2.2 Communication Adapters Layer
• 10.2.3 Portal Layer
• 10.2.4 Communication Services Layer
• 10.3 The net Library Roadmap
• 10.4 Possibilities for Future net Library Modules

Chapter 11: The net Class RWPortal

• 11.1 Using Portals to Write Client Programs
• 11.2 A Simple Client
• 11.2.1 Where's the Portal?
• 11.3 But What If Something Goes Wrong?
• 11.4 Reading From a Portal
• 11.5 Architecture of a Portal
• 11.5.1 The Portal and PortalImpl Classes

Chapter 12: Iostreams and the net Library

• 12.1 Iostreams for Input and Output
• 12.2 Formatted I/O
• 12.3 Architecture of a Portal Stream
• 12.4 Using Rogue Wave Virtual Streams

Chapter 13: The net Socket Address Adapter

• 13.1 Constructing and Manipulating Socket Addresses
• 13.2 The Address Classes
• 13.3 Socket Address Base Class
• 13.3.1 Preparing Socket Addresses
• 13.3.2 Printing Socket Addresses
• 13.4 Generic Socket Addresses
• 13.4.1 Constructing Generic Addresses
• 13.4.2 How It Is Implemented
• 13.5 Internet Addresses
• 13.5.1 Internet Hosts
• 13.5.2 Building Internet Addresses
• 13.6 Socket Types
• 13.6.1 Representing a Socket Type

Chapter 14: The net Socket Adapter

• 14.1 Interface to the Berkeley Sockets API
• 14.2 Using RWSocket
• 14.2.1 Closing Sockets
• 14.3 Sockets and Socket Portals
• 14.4 Using Communications Services with Sockets
• 14.5 Socket Multiplexing
• 14.5.1 RWSocketAttribute
• 14.5.2 rwSocketSelect

Chapter 15: The net Windows Socket  Adapter

• 15.1 Introduction
• 15.2 Initializing and Cleaning Up
• 15.2.1 Using the net Library in Global Objects

Chapter 16: The net Collection Server  Example

• 16.1 A Collection Server
• 16.2 A Hypertext Document Server
• 16.2.1 RWCollectable and Virtual Streams
• 16.3 Running the Demo
• 16.4 The Hypertext Document Class
• 16.4.1 Implementation of Document
• 16.5 Using the Collection Server
• 16.5.1 Inserting Elements
• 16.5.2 Retrieving a Web from the Server
• 16.6 The Document Server Protocol
• 16.6.1 Find Protocol
• 16.6.2 Insert Protocol
• 16.7 Client Implementation
• 16.8 Server Implementation

Chapter 17: The net Receptionist  Example

• 17.1 The Receptionist
• 17.2 Receptionist Strategies
• 17.2.1 Sequential Receptionist
• 17.2.2 Concurrent Receptionist
• 17.2.3 Event-Driven Receptionist
• 17.3 Greeting Protocol
• 17.3.1 Client Application
• 17.4 Our First Greeter
• 17.5 Treating the Receptionist as an Object
• 17.5.1 Coordinating Receptionists and Workers: Callbacks
• 17.5.2 The Receptionist Class
• 17.5.3 Using the Sequential Receptionist
• 17.6 Event-Driven Receptionist
• 17.6.1 Event-Driven Receptionist Interface
• 17.6.2 Event-Driven Greeter Callback
• 17.6.3 The Event-Driven Greeting Program

Chapter 18: Other net Examples

• 18.1 Overview
• 18.2 Look Up Host: hostinfo
• 18.3 TCP Sockets "hello world": greet
• 18.4 Get a WWW Page: wwwget

Chapter 19: Architecture of int

• 19.1 Introduction
• 19.2 The Two-Tier Architecture
• 19.2.1 Foundation
• 19.2.2 The Client and Agent Tiers
• 19.2.3 The Handle-Body Implementation
• 19.2.4 Protocol Replies
• 19.2.5 Protocol Command Sequence
• 19.3 Multithreading and IOUs
• 19.3.1 RWIOUResults
• 19.3.2 RWIOUResult Callbacks
• 19.3.3 RWIOUResult Polling
• 19.4 A Common Multithreading Mistake

Chapter 20: Simple int Examples

• 20.1 About the Examples
• 20.2 Basic Concepts
• 20.2.1 Protocol Clients
• 20.2.2 Protocol Agents
• 20.2.3 Protocol Replies
• 20.2.4 IOUs
• 20.3 File Retrieval: Using the FTP Agent (Part I)
• 20.3.1 Code and Explanation
• 20.4 File Retrieval: Using the FTP Agent (Part II)
• 20.4.1 Code and Explanation
• 20.4.2 Further Discussion
• 20.5 WWW Page Retrieval: Using the HTTP Agent
• 20.5.1 Code and Explanation
• 20.5.2 Further Discussion
• 20.6 Mail Sender: Using the SMTP Agent
• 20.6.1 Code and Explanation
• 20.6.2 Further Discussion
• 20.7 Mail Retrieval: Using the POP3 Client
• 20.7.1 Code and Explanation
• 20.7.2 Further Discussion
• 20.8 FTP Command Demo: Using the FTP Client
• 20.8.1 Code and Explanation
• 20.8.2 Further Discussion

Chapter 21: The int FTP Client and Agent

• 21.1 Introduction
• 21.2 FTP Protocol Replies
• 21.3 FTP Specific

Chapter 22: The int HTTP Client and  Agent

• 22.1 Introduction
• 22.2 The Scalable Architecture
• 22.2.1 HTTP Versions and Methods
• 22.3 HTTP Protocol Replies
• 22.4 HTTP Headers
• 22.5 Handling Firewalls

Chapter 23: The int POP3 Client and  Agent

• 23.1 Introduction
• 23.2 POP3 Protocol Replies
• 23.3 POP3 Specific

Chapter 24: The int SMTP Client and  Agent

• 24.1 Introduction
• 24.2 SMTP Protocol Replies
• 24.3 SMTP Specific



Part IV: CORBA Module




Chapter 25: Introduction to the  CORBA Module

• 25.1 Description
• 25.2 Organization

Chapter 26: How the orb Library Relates to CORBA

• 26.1 Main Concepts
• 26.2 Common Object Request Broker Architecture (CORBA)
• 26.3 Object Request Brokers (ORBs) and the Interface Definition Language (IDL)
• 26.3.1 Object Request Brokers (ORBs)
• 26.3.2 Interface Definition Language (IDL)
• 26.4 Objects by Value
• 26.4.1 Orbix and Opaque
• 26.5 The orb Library

Chapter 27: Using the orb Library

• 27.1 Overview
• 27.2 Passing User-Defined Objects
• 27.2.1 Defining an Object as an Opaque Type
• 27.2.2 Insertion and Extraction Operators
• 27.2.3 Communicating an Object's State with a CORBA::Request
• 27.3 Writing to a Virtual Stream Instead of a CORBA::Request
• 27.3.1 Advantages
• 27.3.2 What are RWreqistream and RWreqostream?
• 27.4 Macros that Create Insertion and Extraction Operators For You
• 27.4.1 The Insertion and Extraction Operators
• 27.4.2 RWDEFINE_OPAQUE and RWDEFINE_OPAQUE_COLLECTABLE
• 27.4.3 Example of RWDEFINE_OPAQUE
• 27.5 Passing Rogue Wave Classes as Opaque Types
• 27.5.1 Example
• 27.5.2 Rogue Wave Classes with Opaque Support
• 27.6 Using Memory Management Rules
• 27.6.1 Parameters
• 27.6.2 Memory Management Rules at a Glance
• 27.7 Passing Non-Opaque Parameters
• 27.7.1 Integers
• 27.7.2 Overloading
• 27.7.3 Nil Pointers



Part V: Resources




Chapter 28: Glossary

Chapter 29: Bibliography

• 29.1 Books and Articles
• 29.2 Web Sites

Chapter 30: Examples

• 30.1 The C++ Examples Directory
• 30.2 The Java Examples Directory

Topic Index