SmartSockets Java Tutorial

SmartSockets Java Tutorial Version 5.0 TALARIAN CORPORATE HEADQUARTERS 333 Distel Circle Los Altos, CA 94022 (800) 883-8050 FAX: (800) 883-8057 E-MAIL: info@talarian.com URL: http://www.talarian.comª ª In the United States, RTworks, SmartSockets, and Talarian are registered trademarks of Talarian Corporation. RTie, RTdaq, RThci, RTdraw, RTsdb, RTlm, RTserver, RTmon, RTgen, RTgredit, RTarchive, and RTplayback are trademarks of Talarian Corporation. All other products are trademarks, services, or registered trademarks of their respective vendors. Talarian Corporation reserves the right to make changes in specifications and other information contained in this publication without prior notice. The reader should in all cases consult Talarian Corporation to determine whether any such changes have been made. COPYRIGHT 1991-1998 TALARIAN CORPORATION. PORTIONS COPYRIGHT 1998 DATAVIEWS CORPORATION. ALL RIGHTS RESERVED. UNPUBLISHED – RIGHTS RESERVED UNDER THE COPYRIGHT LAWS OF THE UNITED STATES. USE OF A COPYRIGHT NOTICE IS PRECAUTIONARY ONLY AND DOES NOT IMPLY PUBLICATION OR DISCLOSURE. THIS DOCUMENT CONTAINS PROPRIETARY AND CONFIDENTIAL INFORMATION OF TALARIAN CORPORATION AND/OR ITS SUPPLIERS. USE, DISCLOSURE, OR REPRODUCTION IS PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF TALARIAN CORPORATION. RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. Talarian Corporation 333 Distel Circle, Los Altos, CA 94022Table of Contents Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii List of Figures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii CHAPTER 1 Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Intended Audience. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 How This Tutorial is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Conventions Used in This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 The Mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 The Keyboard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Terminal Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Typefaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Numeric Range Delimiters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Things to Remember . . . . . . . . . 1-4 Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Case Sensitivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 Reporting Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 CHAPTER 2 Introducing SmartSockets . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 What Makes up SmartSockets? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 SmartSockets Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Platform Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Source Code Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Programming Language Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Major Components of SmartSockets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Message Composition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Working with Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Message Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Connections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7 Connection Composition . . . . . . . . 2-7 Advantages of Connections Over Sockets . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7 SmartSockets Java Tutorial iiiTable of Contents RTserver and RTclient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-8 RTserver and RTclient Composition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-8 Projects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-9 Subjects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-9 RTserver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10 RTclient. . . . . . . . . . . . . 2-11 Connections Versus RTserver and RTclient . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11 RTmon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12 CHAPTER 3 Getting Started with the SmartSockets Java Library . . . . . . . . .3-1 Configuring Your System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1 Using the SmartSockets Java Class Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1 Java Class Library Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2 LESSON 1 Your First SmartSockets Java Program. . . . . . . . . . . . . . . . . . L1-1 A "Hello World!" Program . . . . . . . L1-2 Compiling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . L1-3 A Program to Read a Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . L1-4 Running the Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . L1-5 What’s Going On. . . . . . . . . . L1-6 A Word About Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . L1-6 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . L1-7 LESSON 2 Communicating Using a Publish-Subscribe Model . . . . . . . . L2-1 What is an RTserver? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . L2-2 Running an RTserver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . L2-4 Starting an RTserver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . L2-4 Starting an RTserver Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . L2-4 Auto-Sta