Visual Smalltalk Enterprise ™ ™ User's Guide P46-0205-00 Copyright © 1999–2000 Cincom Systems, Inc. All rights reserved. Copyright © 1999–2000 Seagull Systems, Inc. All rights reserved. This product contains copyrighted third-party software. Part Number: P46-0205-00 Software Release 3.2 This document is subject to change without notice. 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. Trademark acknowledgments: CINCOM, CINCOM SYSTEMS, and the Cincom logo are registered trademarks of Cincom Systems, Inc. Visual Smalltalk is a trademark of Cincom Systems, Inc., its subsidiaries, or successors and are registered in the United States and other countries. Microsoft Windows is a registered trademark of Microsoft, Inc. Win32 is a trademark of Microsoft, Inc. OS/2 is a registered trademark of IBM Corporation. Other product names mentioned herein are used for identification purposes only, and may be trademarks of their respective companies. The following copyright notices apply to software that accompanies this documentation: Visual Smalltalk is furnished under a license and may not be used, copied, disclosed, and/or distributed except in accordance with the terms of said license. No class names, hierarchies, or protocols may be copied for implementation in other systems. This manual set and online system documentation copyright © 1999–2000 by Cincom Systems, Inc. All rights reserved. No part of it may be copied, photocopied, reproduced, translated, or reduced to any electronic medium or machine-readable form without prior written consent from Cincom. Cincom Systems, Inc. 55 Merchant Street Cincinnati, Ohio 45246 Phone: (513) 612-2300 Fax: (513) 612-2000 World Wide Web: http://www.cincom.com Contents Preface vii Overview ................................................................................vii System Requirements ...........................................................viii Getting Started ......................................................................viii About this Manual ..................................................................ix Related Documentation ..........................................................ix On-line Help and Documentation ................................xi Chapter 1 Introduction to Visual Smalltalk Overview ................................................................................13 Orienting Toward Objects .....................................................14 Objects ...................................................................................15 Classes and Instances ...................................................15 Methods and Messages ................................................16 Events ............................................................................17 Components .................................................................18 The World of Visual Smalltalk ...............................................19 Smalltalk ........................................................................19 Parts Workbench ..........................................................21 Visual Smalltalk Enterprise Extended Environment ...23 Chapter 2 Programming in Visual Smalltalk Organizing Application Source Files ....................................30 Organizing Code in Visual Smalltalk Enterprise .........30 Organizing Code in Visual Smalltalk ..........................31 The Transcript ........................................................................32 Service Manager .....................................................................32 The Workspace ......................................................................34 The Parts Workbench ............................................................34 Placing a Part on the Workbench ................................37 Creating Links ...............................................................38 Saving a Part File ..........................................................40 Launching a Part ...........................................................40 Closing a Workbench ...................................................41 Package Browser ...................................................................41 Parts of a Package Browser .........................................41 Working with Packages and Repositories ...................43 Working with Classes and Methods ............................49 Visual Smalltalk Enterprise User’s Guide iii Contents Class Hierarchy Browser .......................................................54 Parts of a Class Hierarchy Browser .............................54 Working with Classes ...................................................56 Working With Methods .................................................59 Method Editing Tools ............................................................60 Method Browser ...........................................................60 Message Browser ..........................................................61 Inspectors ...............................................................................63 Opening an Inspector ..................................................64 Editing Objects in an Inspector ...................................64 Using Special Inspectors ..............................................65 Debugging Tools ....................................................................66 Walkback .......................................................................66 Debugger ......................................................................68 Saving Smalltalk Source Code ...............................................70 Saving the Smalltalk Image ..........................................70 Saving Packages ............................................................71 Smalltalk Link Libraries ................................................71 File Out .........................................................................72 Object Filer ...................................................................72 Chapter 3 Maintaining Visual Smalltalk Overview ................................................................................73 Saving the Image ...................................................................74 Recovering from an Image Crash ..........................................75 Recovering in Visual Smalltalk .....................................75 Recovering in Visual Smalltalk Enterprise ...................77 Maintaining Log Files .............................................................79 Compressing the Change Log ......................................79 Compressing the Recovery Log ...................................79 Managing Memory .................................................................80 Finalization ....................................................................80 Removing Instances ......................................................80 .......................................................................................81 Chapter 4 Building an Application Overview ................................................................................83 Designing an Object-Oriented Application ..........................83 Object Roles ..................................................................83 Component Architecture ..............................................85 Visual Smalltalk Application Framework ...................86 Building the Application View ..............................................88 Exposing the View Interface ........................................89 iv Visual Smalltalk Enterprise User’s Guide Building the Business Model ................................................91 Defining Business Objects ...........................................91 Exposing the Model Interface ......................................93 Coordinating the View and Model .......................................94 Connecting View and Model Objects ..........................95 Simple Controllers ........................................................95 Representing Dynamic Objects ....................................96 Chapter 5 Delivering a Visual Smalltalk Application Overview ................................................................................99 Preparing a Stand-alone Application ..................................100 Starting Your Application ...........................................100 Creating a Shutdown Dialog ......................................101 Creating a Splash Screen ............................................101 Adding a Sign-on Dialog ............................................101 Capturing Command Line Arguments .......................102 Changing Application Icons .......................................102 Preparing Application Run-time Files .................................103 Creating Executable Parts ..........................................103 Building Application Smalltalk Libraries ...................104 Collecting Run-time Support Files .............................105 Bind Options for Smalltalk Libraries .........................107 Building the Application Image File ..........................108 A Simple Example ......................................................111 Packaging the Run-time Files ..............................................114 Chapter 6 Creating a Part in Smalltalk Overview ..............................................................................115