KEEGAN NETBEANS IDE FIELD GUIDE _p2

Foreword to the First Edition

xiii

James Gosling

Foreword to the First Edition

Bill Shannon

Preface

xvii

About the Authors

xxv

Acknowledgments for the Second Edition

xxvii

Acknowledgments for the First Edition

xxix

Download, Installation, and First Project

(8)

Downloading the IDE

(1)

Installing the IDE

(1)

Setting a Proxy

(1)

First NetBeans IDE Project

(5)

NetBeans IDE Fundamentals

(16)

Creating a Project

(2)

Configuring the Classpath

(1)

Creating a Subproject

(2)

Creating and Editing Files

(2)

Setting Up and Modifying Java Packages

(1)

Compiling and Building

(1)

Viewing Project Metadata and Build Results

(1)

Navigating to the Source of Compilation Errors

(1)

Running

(1)

Creating and Running Tests

(1)

Debugging the Application

(1)

Integrating Version Control Commands

(1)

Managing IDE Windows

(2)

IDE Project Fundamentals

(44)

Introduction to IDE Projects

(2)

Choosing the Right Project Template

(1)

Creating a Project from Scratch

(4)

Importing a Project Developed in a Different Environment

(4)

Navigating Your Projects

(4)

Working with Files Not in the Project

(1)

Creating Packages and Files in the Project

(2)

Configuring the Project's Classpath

(1)

Changing the Version of the JDK Your Project Is Based On

(1)

Changing the Target JDK for a Standard Project

(1)

Referencing JDK Documentation (Javadoc) from the Project

(1)

Adding Folders and JAR Files to the Classpath

(1)

Making External Sources and Javadoc Available in the IDE

(1)

Structuring Your Projects

(2)

Displaying and Hiding Projects

(1)

Compiling a Project

(5)

Running a Project in the IDE

(2)

Deploying a Java Project Outside of the IDE

(2)

Building a Project from Outside of the IDE

(1)

Customizing the IDE-Generated Build Script

(4)

Running a Specific Ant Target from the IDE

(1)

Completing Ant Expressions

(1)

Making a Menu Item or Shortcut for a Specific Ant Target

(4)

Versioning Your Projects

(22)

Setting up CVS in NetBeans IDE

(1)

Checking Out Sources from a CVS Repository

(3)

Putting a Project into CVS

(2)

Keeping Track of Changes

(4)

Updating Files

(1)

Committing Changes

(1)

Ignoring Files in CVS Operations

(1)

Adding and Removing Files from a Repository

(1)

Working with Branches

(3)

Working with Patches

(2)

Working with Versioning Histories

(2)

Working with Other Version Control Systems

(2)

Editing and Refactoring Code

(62)

Opening the Source Editor

(1)

Managing Automatic Insertion of Closing Characters

(1)

Displaying Line Numbers

(1)

Generating Code Snippets without Leaving the Keyboard

(2)

Using Code Completion

(4)

Inserting Snippets from Code Templates

100

(8)

Using Editor Hints to Generate Missing Code

108

(1)

Matching Other Words in a File

109

(1)

Generating Methods to Implement and Override

110

(1)

Generating JavaBeans Component Code

111

(1)

Creating and Using Macros

112

(1)

Creating and Customizing File Templates

113

(2)

Handling Imports

115

(1)

Displaying Javadoc Documentation While Editing

116

(1)

Formatting Code

116

(4)

Text Selection Shortcuts

120

(1)

Navigating within the Current Java File

120

(4)

Navigating from the Source Editor

124

(2)

Searching and Replacing

126

(5)

Deleting Code Safely

131

(4)

Changing a Method's Signature

135

(1)

Encapsulating a Field

136

(2)

Moving a Class to a Different Package

138

(1)

Moving Class Members to Other Classes

139

(2)

Creating a Method from Existing Statements

141

(1)

Creating an Interface from Existing Methods

142

(1)

Extracting a Superclass to Consolidate Common Methods

143

(2)

Changing References to Use a Supertype

145

(1)

Unnesting Classes

146

(2)

Tracking Notes to Yourself in Your Code

148

(2)

Comparing Differences Between Two Files

150

(1)

Splitting the Source Editor

151

(1)

Maximizing Space for the Source Editor

151

(1)

Changing Source Editor Keyboard Shortcuts

152

(1)

Building Java Graphical User Interfaces

153

(16)

Using Different Layout Managers

156

(1)

Placing and Aligning a Component in a Form

157

(2)

Setting Component Size and Resizability

159

(1)

Setting Component Alignment

160

(1)

Specifying Component Behavior and Appearance

161

(1)

Generating Event Listening and Handling Methods

162

(3)

Customizing Generated Code

165

(1)

Previewing a Form

166

(1)

Using Custom Beans in the Form Editor

166

(1)

Deploying GUI Applications Developed with Matisse

167

(2)

Debugging Java Applications

169

(28)

Starting a Debugging Session

171

(4)

Attaching the Debugger to a Running Application

175

(2)

Starting the Debugger Outside of the Project's Main Class

177

(1)

Stepping through Code

177

(4)

Setting Breakpoints

181

(4)

Managing Breakpoints

185

(1)

Customizing Breakpoint Behavior

186

(3)

Monitoring Variables and Expressions

189

(3)

Backing up from a Method to Its Call

192

(1)

Monitoring and Controlling Execution of Threads

192

(2)

Fixing Code During a Debugging Session

194

(1)

Viewing Multiple Debugger Windows Simultaneously

195

(2)

Developing Web Applications

197

(36)

Representation of Web Applications in the IDE

199

(4)

Adding Files and Libraries to Your Web Application

203

(5)

Editing and Refactoring Web Application Files

208

(6)

Deploying a Web Application

214

(3)

Testing and Debugging Your Web Application

217

(2)

Creating and Deploying Applets

219

(4)

Changing the IDE's Default Web Browser

223

(1)

Monitoring HTTP Transactions

224

(9)

Creating Web Applications on the JSF and Struts Frameworks

233

(18)

JSF Overview

234

(6)

Struts Overview

240

(11)

Introduction to Java EE Development in NetBeans IDE

251

(16)

Configuring the IDE for Java EE Development

252

(3)

Java EE Server Support

255

(2)

Getting the Most from the Java BluePrints Solutions Catalog

257

(10)

Extending Web Applications with Business Logic: Introducing Enterprise Beans

267

(16)

EJB Project Template Wizards

269

(3)

Adding Enterprise Beans, Files, and Libraries to Your EJB Module

272

(3)

Adding Business Logic to an Enterprise Bean

275

(1)

Adding a Simple Business Method

276

(4)

Enterprise Bean Deployment Descriptors

280

(3)

Extending Java EE Applications with Web Services

283

(28)

Consuming Existing Web Services

284

(7)

IDE and Server Proxy Settings

291

(1)

Creating a WSDL File

292

(1)

Implementing a Web Service in a Web Application

292

(8)

Implementing Web Services within an EJB Module

300

(1)

Testing Web Services

301

(3)

Adding Message Handlers to a Web Service

304

(7)

Developing Full-Scale Java EE Applications

311

(52)

Creating Entity Beans with the Top-Down Approach

313

(8)

Creating Entity Beans with the Bottom-Up Approach

321

(3)

Assembling Enterprise Applications

324

(4)

Importing Existing Enterprise Applications

328

(5)

Consuming Java Enterprise Resources

333

(8)

Java EE Platform and Security Management

341

(6)

Understanding the Java EE Application Server Runtime Environment

347

(8)

Ensuring Java EE Compliance

355

(2)

Refactoring Enterprise Beans

357

(2)

Database Support and Derby Integration

359

(4)

Developing Java ME Mobile Applications

363

(64)

Downloading and Installing the Mobility Pack

364

(1)

Mobility Primer

364

(2)

Configuration vs. Configuration

366

(1)

Setting up Mobility Projects

366

(1)

Creating a Project from Scratch

366

(1)

Importing a Project

367

(2)

Physical Structure of Mobile Projects

369

(1)

Using Mobility File Templates

370

(2)

Configuring the Project's Classpath

372

(4)

Debugging Your Project

376

(1)

Configuring Your Project for Different Devices

377

(2)

Setting the Active Configuration for Your Project

379

(1)

Reusing Project Settings and Configurations

380

(2)

Structuring Project Dependencies

382

(1)

Managing the Distribution JAR File Content

383

(1)

Handling Project Resources for Different Configurations

384

(1)

Writing Code Specific to a List of Configurations

385

(2)

Using the Preprocessor

387

(10)

Using Configuration Abilities

397

(1)

Creating and Associating an Ability with a Configuration

398

(2)

Localizing Applications

400

(2)

Using the MIDP Visual Designer

402

(3)

Understanding the Flow Designer

405

(8)

Understanding the Screen Designer

413

(1)

Deploying Your Application Automatically

414

(3)

Incrementing the Application's MIDlet-Version Automatically

417

(1)

Using Ant in Mobility Projects

417

(4)

Using Headless Builds

421

(1)

Using the Wireless Connection Tools

422

(4)

Finding More Information

426

(1)

Profiling Java Applications

427

(22)

Supported Platforms

428

(1)

Downloading and Installing the NetBeans Profiler

429

(1)

Starting a Profiling Session

429

(3)

The Profiler Control Panel

432

(3)

Monitoring an Application

435

(2)

Analyzing Performance

437

(5)

Analyzing Code Fragment Performance

442

(1)

Analyzing Memory Usage

443

(4)

Attaching the Profiler to a JVM

447

(2)

Integrating Existing Ant Scripts with the IDE

449

(28)

Creating a Free-Form Project

451

(2)

Mapping a Target to an IDE Command

453

(2)

Setting up the Debug Project Command for a General Java Application

455

(2)

Setting up the Debug Project Command for a Web Application

457

(5)

Setting up Commands for Selected Files

462

(1)

Setting up the Compile File Command

463

(3)

Setting up the Run File Command

466

(2)

Setting up the Debug File Command

468

(2)

Setting up the Debugger's Apply Code Changes Command

470

(1)

Setting up the Profile Project Command for a General Java Application

471

(1)

Changing the Target JDK for a Free-Form Project

472

(1)

Making a Custom Menu Item for a Target

473

(1)

Debugging Ant Scripts

473

(4)

Developing NetBeans Plug-in Modules

477

(30)

Plug-in Modules

478

(1)

Rich-Client Applications

478

(2)

Extending NetBeans IDE with Plug-in Modules

480

(1)

Setting up a Plug-in Module

481

(5)

Using the NetBeans APIs

486

(10)

Registering the Plug-in Module

496

(1)

Adding a License to a Plug-in Module

497

(2)

Building and Trying Out a Plug-in Module

499

(1)

Packaging and Distributing a Plug-in Module

500

(2)

Packaging and Distributing a Rich-Client Application

502

(2)

Finding Additional Information

504

(3)

Using NetBeans Developer Collaboration Tools

507

(20)

Getting the NetBeans Developer Collaboration Tools

508

(1)

Configuring NetBeans IDE for Developer Collaboration

509

(1)

Creating a Collaboration Account

510

(4)

Managing Collaboration Accounts

514

(4)

Logging into a Collaboration Server

518

(1)

Collaborating and Interacting with Developers

519

(8)

Appendix A Importing an Eclipse Project into NetBeans IDE

527

(10)

Getting the Eclipse Project Importer

528

(1)

Choosing Between Importing with and Importing without Project Dependencies

529

(1)

Importing an Eclipse Project and Preserving Project Dependencies

529

(3)

Importing an Eclipse Project and Ignoring Project Dependencies

532

(2)

Handling Eclipse Project Discrepancies

534

(1)

Handling Eclipse Project Reference Problems

534

(3)

Appendix B Importing a JBuilder Project into NetBeans IDE

537

(4)

Getting the JBuilder Project Importer

538

(1)

Importing a JBuilder 2005 Project

538

(1)

Project Import Warnings

539

(1)

Running the Imported Project

540

(1)

Index

541

Welcome to the second edition of theNetBeans IDE Field Guide!This book is designed both as an introduction to NetBeans IDE and as a task reference, something that you can pick up from time to time to get an answer to a question or to find new ways to take advantage of the IDE's possibilities. Whether NetBeans is your first IDE or your fifth, this book can help you make the most of the IDE.This edition is updated and expanded to cover the following features, some of which are brand new in NetBeans IDE 5.0: Matisse GUI builder The IDE's new and improved CVS support New editing and refactoring features Support for developing on the JSF and Struts web frameworks Support for creating plug-in modules for NetBeans IDE and standalone applications based on the NetBeans platform Support for profiling applications for performance problems What Is NetBeans IDE?NetBeans IDE is a free-of-charge integrated development environment (IDE) primarily focused on making it easier to develop Java applications. It provides support for all types of Java applications, from rich desktop clients to multi-tier enterprise applications to applications for Java-enabled handheld devices.NetBeans IDE has a modular architecture that allows for plug-ins. However, the range of features in the basic installation is so rich that you can probably can start using the IDE for your work without worrying about plug-ins at all.The IDE itself is written in Java, so you can run it on any operating system for which there is a Java 2 Standard Edition JDK (version 1.4.2, version 5.0, or later) available. Click-through installers are available for Microsoft Windows, Solaris, Linux, Mac OS, and other systems. You can also download the IDE as a ZIP or TAR file if you want to install it on an operating system other than the ones listed here.The IDE's basic job is to make the edit-compile-debug cycle much smoother by integrating the tools for these activities. For example, the IDE: Identifies coding errors almost immediately and marks them in the Source Editor. Helps you code faster with code completion, code template, word matching, and fix import features. Provides visual navigation aids, such as the Navigator window and "code folding," as well as numerous keyboard navigation shortcuts designed especially for Java programmers. Can display documentation for a class as you are typing in the Source Editor. Hot-links compilation errors in the Output window, so you can jump straight to the source by double-clicking the line or pressing F12. Manages package names and references to other classes. When you rename or move classes around, the IDE identifies places in the code that are affected by these changes and enables you to have the IDE generate the appropriate changes to those files. Has many debugging features that provide a comprehensive view of the way your code is working as it runs. You can set breakpoints (which persist from session to session) and keep your code free of clutter (such as println statements). Helps you integrate other parts of your workflow, such as checking sources in to and out from a version control system.You can also download the NetBeans Profiler to augment the traditional edit-compile-debug cycle with performance profiling. What Makes NetBeans IDE SpecialWhen you use NetBeans IDE, you get the benefits of a top-shelf IDE without the negatives that you might associate with moving your development to a single environment.Like other integrated development environments, NetBeans IDE provides a graphical user interface for command-line tools that handle the compiling, debugging, and packaging of applications.Unlike other IDEs, NetBeans IDE does not force a build structure on you with project metadata that you need to reverse engineer