ECLIPSE RICH CLIENT PLATFORM

Transcription

1 ECLIPSE RICH CLIENT PLATFORM DESIGNING, CODING, AND PACKAGING JAVA TM APPLICATIONS Jeff McAffer Jean-Michel Lemieux v:addison-wesley Upper Saddle River, NJ Boston Indianapolis San Francisco New York Toronto Montreal London Munich Paris Madrid Capetown Sydney Tokyo Singapore Mexico City

2 Contents Foreword by John Wiegand xix Foreword by Jeff Norris xxi Acknowledgments xxv Preface xxvii Part 1 0 Introduction 1 Chapter 1 Eclipse as a Rich Client Platform Eclipse The Eclipse Rich Client Platform Eclipse RCP Over the Years Uses of RCP IBM Workplace Client TechnologyTM NASA and Eclipse RCP Summary 12 Chapter 2 Eclipse RCP Concepts A Community of Plug-ins Inside Plug-ins Putting a System Together OSGi Framework The Runtime Applications Products Extension Registry SWT JFace 23 vii

3 viii Contents 2.8 UI Workbench Contribution-based Extensibility Perspectives, Views, and Editors 2.9 Summary Part II 0 RCP by Example Chapter 3 Tutorial Introduction What Is Hyperbola? The Evolution of Hyperbola Development Environment Installation Target Setup Checkpoint Sample Code Moving from Chapter to Chapter Comparing Learning by Example Summary 40 Chapter 4 The Hyperbola Application 4 I 4.1 Hyperbola Hello World Tour of the Code Application WorkbenchAdvisor Perspective WorkbenchWindowAdvisor ActionBarAdvisor Summary Running and Debugging Debugging Launch Configurations Summary 59 Chapter 5 Starting the Hyperbola Prototype 6 I 5.1 Continuing from the Shell Saving Window Location and Size Adding a Contacts View Adding the Contacts. View to a Perspective The Chat Model 68

4 Contents ix 5.4 Filling in the Contacts View The ContactsView Content Providers Overview The Label Provider Adding Images Summary Pointers 80 Chapter 6 Adding Actions Adding to the Menus and Toolbar Create Top-Level Menu Menu Managers The Add Contact Action Adding the "Add Contact" Action Customizable Toolbars Adding to the Status Line Status Line A Shared Resource System Tray Integration Obtaining a Display Creating the Tray Item Summary Pointers 99 Chapter 7 Adding a Chat Editor Views and Editors Defining the Chat Editor Editor Input The Chat Action Checkpoint Summary Pointers 112 Chapter 8 Branding Hyperbola Defining the Hyperbola Product Window Images Customizing the Launcher Splash Screen About Information Product About Information Plug-in About Information Summary 125

5 xii Contents 15.4 ActionBarAdvisor IActionBarConfigurer Workbench Overview Workbench Extension Point Reference Actions Scalability Contributions Perspectives Startup Summary 234 Chapter 16 Perspectives, Views, and Editors Perspectives Adding Perspectives Adding the Debug Perspective and Console View IPageLayout Reference Perspective Bar Perspective Menu Programmatic Perspective Control Views and Editors Multiple Instances of the Same View Sticky Views Showing Contributed Views View Registry Connecting Parts Together Multiple Workbench Windows Window Navigation Menu Drag and Drop with Editors Summary 259 Chapter 17 Actions Overview Declarative Actions in Hyperbola Declarative Actions Allowing Contribution Declaring Actions Context Menus Standard Workbench Actions Retargetable Actions Consolidating Declarative Actions 276

6 Contents xiii 17.6 Toolbar Action Tricks Showing Images and Text Adding Controls to the Toolbar Adding Contributions to the Status Line Reporting Progress Non-modal Progress Progress View Customizing Progress Writing a ProgressProvider Summary 289 Chapter 18 Customizing Workbench Windows Customization Defined Customizing a Workbench Window Example: Hide and Show FormLayout Hiding the Toolbar Adding the Toggle Actions Quick Search Panel Checkpoint Custom Window Shapes Creating the Shape Creating the Window Defining the Window Contents Summary 306 Chapter 19 Customizing the Presentation ofviews and Editors Presentations Sample Presentations The R21 Presentation Example Presentations Writing a Presentation Widget Hierarchy StackPresentation Example Presentation The Presentation Factory The Stack Presentation Size and Position Adding, Selecting, and Removing Parts Menus Summary 322

7 xvi Contents 24.8 Tweaking the Build Managing the Base Fetching from CVS Fetching the Maps Auto-substitution of Version Numbers Qualifying Version Numbers Controlling the Output Names 24.9 Summary Chapter 25 The Last Mile 25.1 Archives 25.2 Native Installers 25.3 Java Web Start (JNLP) How Java Web Start Works Hyperbola and Java Web Start JAR Signing Exporting for Java Web Start Building JNLP Manifests Java Web Start and Update 25.4 Update Sites 25.5 Initializing the Install 25.6 Pre-initialized Configurations 25.7 Multi-user Install Scenarios Shared Installs Shared Configurations Multiple Configurations 25.8 Summary 25.9 Pointers Part V 0 Reference Chapter OSGi Essentials OSGi and the Eclipse Runtime The Shape of Plug-ins Fragments Version Numbering Services Singletons Bundle Lifecycle BundleActivator (Plugin Class)

8 Contents xvii The Downside of Activators Uses for Activators Early Activation Early Activation Extensions osgi.bundles Start Levels Auto-activation Classloading Class Lookup Algorithm Declaring Imports and Exports Importing versus Requiring Optionality Re-exporting x-internal and x-friends Data Areas Putting It All Together Summary 477 Chapter 27 Eclipse.org Plug-ins Where to Find Plug-ins Eclipse Platform Plug-ins Product Introduction Resources Overview of Resources Key Features Getting Started with Resources Resources in the Workbench Text Editing Text Plug-ins Editing versus Editor Text and StyledText IDocument TextViewers and TextEditors What Is Missing? Consoles Variables Outline and Property Views Forms Browser Summary 492 Index 495