ForteTM for JavaTM (Community Edition) User's Guide



Forte for Java (Community Edition) User's Guide

Copyright 2000 Sun Microsystems, Inc., 901 San Antonio Road,
Palo Alto, California 94303 U.S.A. All rights reserved.

This product or documentation is protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or documentation may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers.

Sun, Sun Microsystems, the Sun logo, Java, JavaBeans, Forte, and NetBeans are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.

U.S. Government approval required when exporting the product.

DOCUMENTATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, ANY KIND OF IMPLIED OR EXPRESS WARRANTY OF NON-INFRINGEMENT OR THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Copyright 2000 Sun Microsystems, Inc., 901 San Antonio Road,
Palo Alto, Californie 94303 Etats-Unis. Tous droits réservés.

Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l'utilisation, la copie, la distribution, et la décompilation. Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme, par quelque moyen que ce soit, sans l'autorisation préalable et écrite de Sun et de ses bailleurs de licence, s'il y en a. Le logiciel détenu par des tiers, et qui comprend la technologie relative aux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun.

Sun, Sun Microsystems, le logo Sun, Java, JavaBeans, Forte, et NetBeans sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.

LA DOCUMENTATION EST FOURNIE "EN L'ETAT" ET TOUTES AUTRES CONDITIONS, DÉCLARATIONS ET GARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT EXCLUES DANS LA MESURE AUTORISÉE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT TOUTE GARANTIE IMPLICITE RELATIVE À LA QUALITÉ MARCHANDE, À L'APTITUDE À UNE UTILISATION PARTICULÈRE OU À L'ABSENCE DE CONTREFAÇON.



Contents


Preface

Before you read this book
How this book is organized
Conventions Used In This Document
Look and feel of graphics
Contact Information

Chapter 1: Welcome to Forte for Java, Community Edition

Product features

Chapter 2: IDE Essentials

User interface
Main Window
The Explorer
Navigation
Default operations
Property sheets
Accessing the property sheet
Contents of the property sheet
Property sheet toolbar
Custom property editors
Form Editor
Form Editor window
Component Inspector
Editor window
Project Settings and Global Options windows
JavaHelp, context help, and tool tips
JavaHelp
Context Help
Tool tips
QuickStart and Tutorials
Installation Guide
Browsing the documentation with an external web browser
Printing the user's documentation

Chapter 3: Developing Java Applications

Creating new classes
Editing Java sources
Integration with other components
The Editor window and its layout
Opening files in the Editor
Asterisks in Editor window tabs
Editor window contextual menu
Mouse and clipboard functions
Editor abbreviations
File navigation features
Standard navigation and text selection shortcuts
Text scrolling shortcuts
Navigating files with the jump list
Using Editor bookmarks
Find and replace
Java code completion
Adding your own classes to the parser database
Other Java shortcuts
Word match
Other Editing shortcuts
Working with braces
Formatting code
Editor Settings
Compiling Java sources
Compiling single classes
Compiling packages
Deleting .class files
Built-in compiler support
Switching the default compiler type
Switching compilers by class
Disabling compilation for a class
Configuring compilers
Setting compiler types in templates
Running Java classes
Execution View
Execution categories and executors
Setting execution
Switching the default executor
Configuring external executors
Setting executors in templates
Passing command-line arguments to executed applications
Execution Settings node
Applet viewer settings
Debugging Java classes
Debugger Window
Breakpoints
Threads
Watches
The debugging session
Suspending and resuming debugging
Changing the current thread
Connecting the Debugger to a running process
Setting the debugger
Switching the default debugger type
Configuring debuggers
Setting debugger types in templates
Using the Output Window
Internal web browser

Chapter 4: The Explorer and Object Browser

Guide to the Explorer
Filesystems
File systems and the class path
Mounting file systems
Order of file systems
Adding a file to the IDE
Working with packages
Working with objects
Searching for files in Filesystems
Runtime
Processes node
Debugger node
Javadoc
Project
Guide to the Object Browser
Using the Object Browser
Creating package filters
Browsing and exploring objects and their elements
Elements of Java objects and member accessibility
Creating and modifying elements using the customizer
Source synchronization
Source Synchronization property sheet
Synchronizing source

Chapter 5: Developing and Customizing JavaBeans Components

Developing JavaBeans components
Creating properties
Creating indexed properties
Creating event sets
Deleting properties and event sets
Generating Bean Info
Bean Info node
Properties and Event Sources nodes
Subnodes of the Properties and Event Sources nodes
Editing BeanInfo source
Regenerating BeanInfo
Customizing JavaBeans components
Adding JavaBeans components to the IDE
Is Container property
Adding JavaBeans from a JAR or local directory
Adding JavaBeans using the beans directory

Chapter 6: Designing Visual Classes with the Form Editor

Opening the Form Editor
Creating a new form
Working with components
Adding new components
Selecting components
Connection mode
Moving components to a different container
Copying components
Reordering components within the same container
Property Sheet pane in the Component Inspector
Custom property editors for component properties
Reverting to the default value for a property
Working with layouts
Setting and changing layout managers
Setting layout properties and constraints
Layout properties
Constraints properties
Standard layout managers
Border Layout
Flow Layout
Grid Layout
Card Layout
GridBag Layout
Box Layout
Absolute Layout
Null Layout
Using the GridBag customizer
Support for custom layout managers
Working with source code
Guarded text
Modifying generated code for components
Other code generation options
Code Generation properties for containers
External modifications
Form Editor modes
Events
Defining event handlers
Removing event handlers
Renaming event handlers
Adding multiple handlers for one event
Using the Connection Wizard
Using the Form Connection property editor
Pre- and post-initialization code
Menu editor
Creating a menu bar
Adding menus to the menu bar
Creating a popup menu
Adding menu items
Menu item events
Components with special support
JScrollPane, ScrollPane
JTabbedPane
JTable, JList
MDI Applications: Using JDesktopPane and JInternalFrames
JSplitPane
Configuring the Form Editor

Chapter 7: Developing Java Server Pages

Creating and editing Java Server Pages
Compiling JSPs
Handling compilation errors
Selecting a compiler
Included beans, others JSPs, and error pages in compilation
Running JSPs
Specifying query parameters
Restarting the server
Configuring JSP Execution Types
Setting the web browser

Chapter 8: Organizing work into projects

What is a "project" in Forte for Java?
Creating projects
The default project
Creating new projects
Working with projects
Adding packages and files to a project
Setting the main class in the project
Accessing and working with files in projects
Mounting different file systems for different projects
Compiling, building, executing, and debugging projects
Adjusting Project Settings
Saving projects
Switching between projects
Importing projects

Chapter 9: Integrating a CVS version control system

How the CVS support works
Using the CVS module
Before you begin
Setting up the repository and working directory
Creating a CVS project
CVS commands

Chapter 10: Searching and Creating Javadoc Documentation

Searching and browsing Javadoc
Preparing the Explorer's Javadoc tab
Browsing documentation for the selected class or element
Searching in Javadoc directories
Search dialog box
Using Javadoc Auto Comment
Auto Comment Tool dialog box
Javadoc Comment dialog box
Generating Javadoc documentation
Javadoc properties
Changing the directory for generated Javadoc documentation

Chapter 11: Configuring and customizing the IDE

Project Settings
Filesystems Settings
Workspaces
Execution Types
Debugger Types
Compiler Types
Search Types
Java Sources
Object Browser
Project Options
Global Options
Modules
Toolbars
Actions
Menu
Templates
Object Types
Startup
Component Palette
Bookmarks
Debugger Settings
Documentation
Editor Settings
Execution Settings
Form Objects
HTML Browser
HTTP Server
JSP & Servlets
Java Elements
Open File Server
Output Window
Print Settings
Property Sheet
System Settings
Update Center
Window management
Workspaces
Standard workspaces
Automatic workspace switching
Using workspaces
Multi-tab windows
Undocking and docking windows
Undocking
Docking
Cloning windows
Redisplaying windows obscured by windows from other applications
Modules in Forte for Java
Managing modules
Adding modules with the Update Center
Automatic Update Check dialog box
Adjusting proxy and firewall settings
Authenticating Update Center downloads
Updating modules manually
Uninstalling and reinstalling modules
Module help
Using templates
Creating new objects from templates
Other templates
Bookmark
Group of Files
HTML
Text
Creating your own templates
Modifying existing templates
Using macros in templates
Creating and editing macros
Advanced macro feature
Adding and modifying service types
Adding service types
Configuring service types
Process Descriptor property editor
Editing service types from the Filesystems tab in the Explorer
Removing service types
Customizing the environment
Changing the look and feel
Configuring the Editor
Changing assignments for Editor keyboard shortcuts
Customizing Editor abbreviations
Customizing Java code completion
Java Editor formatting options
Caret row highlighting
Setting fonts and text coloring in the Editor
Using an external editor
Additional Editor Settings
Customizing menus and toolbars
Changing commands in menus and toolbars
Creating new menus and toolbars
Dragging toolbars
Toolbar contextual menu and toolbar configurations
Changing commands in contextual menus
Customizing IDE shortcuts
Customizing the Component Palette
Customizing workspaces
Opening files from outside of the IDE
Using the remote launcher manually
Associating the launcher with a type of file
Customizing file opening
Open File Server properties

Appendix A: Default Keyboard Shortcuts

Global Shortcuts
Form Editor Shortcuts
Explorer Shortcuts
Window Shortcuts
Project Shortcuts
Build Shortcuts
Debugger Shortcuts
Editor Shortcuts
Navigation shortcuts
Edit shortcuts
Special Java Shortcuts

Appendix B: Default Editor Abbreviations

Appendix C: Main Window Menus and Toolbars

Menus
File Menu
Edit Menu
View Menu
Project Menu
Build Menu
Debug Menu
Tools Menu
Window Menu
Help Menu
Toolbars

Appendix D: Reference Guide to Project Settings and Global Options

Filesystems Settings reference
Workspaces reference
Compiler Types reference
Execution Types reference
Debugger Types reference
Search Types reference
Java Sources settings reference
Source synchronization
Object Browser settings reference
Project Options
Debugger Settings reference
Documentation settings reference
Editor Settings reference
Global Editor settings
Editor settings by type of editor
Execution Settings reference
Form Objects reference
HTML Browser reference
HTTP Server reference
JSP and Servlets reference
Java Elements reference
Open File Server reference
Output Window reference
Print Settings reference
Property Sheet reference
System Settings reference
Update Center reference

Appendix E: Actions

Appendix F: Custom Property Editors

Color Editor
Fonts Editor
Border Editor
Cursor Editor
String Editor
Icon Editor
Dimension Editor
Bounds Editor
Insets Editor
Modifiers Editor
Parameters Editor
Exceptions Editor
Error Expression Editor
Customizer dialog box

Contents Prev Next Index