Documentation Contents

Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Introduction

• Java SE Desktop Overview
• Troubleshooting an Issue
• Identifying the Type of Issue
  • Crashes
  • Performance Problems
  • Behavior Problems
• Basic Tools
• Using JDWP

2 AWT

• Debugging Tips for AWT
• Layout Managers
• Key Events
• Modality
• Memory Leaks
• Crashes
  • How to Distinguish an AWT Crash
  • How to Troubleshoot an AWT Crash
• Focus Events
  • How to Trace Focus Events
  • Native Focus System
  • Focus System in the Java Plug-in
  • Focus Models Supported by X Window Managers
  • Miscellaneous Problems With Focus
• Data Transfer
  • Debugging Drag and Drop Applications
  • Frequent Issues With Data Transfer
• Other Issues
  • Splash Screen Issues
  • Tray Icon Issues
  • Popup Menu Issues
  • Background/Foreground Color Inheritance
  • AWT Panel Size Restriction
  • Hangs when debugging popup menus and similar components on X11
  • Window.toFront()/toBack() behavior on X11
• Heavyweight/Lightweight Components Mixing
  • The Requirement of Validating the Component Hierarchy
  • Validate Roots
  • Swing Painting Optimizations
  • Non-opaque LW Components
  • Disabling the Default HW/LW Mixing Feature Implementation

3 Java 2D

• Changing Rendering Pipelines and Their Properties
  • Solaris OS and Linux: Using Default X11 Pipeline
  • Solaris OS on SPARC: Changing Default Visual Used by Java 2D
  • Windows OS: Using Default DirectDraw/GDI Pipeline
  • Windows OS: Using Direct3D Pipeline (Full-Screen Mode)
  • Using OpenGL Pipeline (Solaris OS, Linux, and Windows)
• Generic Performance Issues
  • Hardware Accelerated Rendering Primitives
  • Using Java 2D Primitive Tracing to Detect and Avoid Non-accelerated Rendering
  • Causes of Poor Rendering Performance
  • Improving Performance of Software-only Rendering
• Text-Related Issues
  • Application Crash During Text Rendering
  • Differences in Text Appearance
  • Metrics
• Java 2D Printing

4 Swing

• General Debugging Tips for Swing
• Specific Debugging Tips for Swing
  • Incorrect Threading
  • Overlapping Children of a JComponent
  • Updating the Display
  • Changing the Model
  • Adding or Removing Components
  • Overriding Opaque
  • Permanent Changes to a Graphics
  • Custom Painting and Double Buffering
  • Opaque Content Pane
  • Performance: Call to Renderer for Each Cell
  • Possible Leaks
  • Mixing Heavyweight and Lightweight Components
  • Tips for Using Synth
  • Tracking Activity on Event Dispatch Thread
  • Differing Default Layout Managers
  • Listener Objects Dispatched to Deepest Component
  • Adding a Component to Content Pane
  • Drag and Drop Support in Swing
  • One Parent at a Time for a Component
  • Problem With JFileChooser and Shortcuts on Windows

5 Internationalization

• Introduction
• Troubleshooting

6 Java Sound

• System Sound Configuration
• Audio File Formats
• Audio Formats
• Overrun and Underrun Conditions

7 Time Zone Settings in the JRE

• Native Time Zone Information and the JRE
  • Determine the Time Zone Data Version in Use
  • Troubleshooting Problems with Tzupdater
• Determining the Default Time Zone on Windows
  • Check Which Time Zone the JRE Reports as Default
  • Determine the Setting in the Control Panel
  • Check Whether Automatic Daylight Saving Time Adjustment is Enabled
  • Set the Default Time Zone in the Control Panel
  • Check Whether You Can Use -Duser.timezone
  • Special Tools in Windows 7
  • JRE Internal Representation of Time Zone Mappings

8 Applets and Java Web Start Applications

• Configuration Problems
  • Validation
  • Common Configuration Problems
  • Managing Java Runtimes
  • Passing parameters to the JRE
  • Java Deployment Home
  • Deployment Tracing Information
  • Deployment Cache
  • Network Configuration
• Applet Troubleshooting
  • Applet Does Not Start - Plugin Cheat Sheet
  • Unresponsive Web Page
• Avoiding Security Dialogs
  • Signed Applications
  • Mixed Code Issues
• Development Tips
  • Debugging Applets and Web Start Applications
  • Profiling Applets and Java Web Start Applications
  • Debugging Memory Leaks

9 Submitting Bug Reports

• Checking for Existing Fixes in Update Releases
• Preparing to Submit a Bug Report
• Collecting Data for a Bug Report
  • Hardware Details
  • Operating System
  • Java SE Version
  • Command-Line Options
  • Environment Variables
  • Fatal Error Log
  • Core or Crash Dump
  • Detailed Description of the Problem
  • Logs and Traces
  • Results from Troubleshooting Steps
• Collecting Core Dumps
  • Collecting Core Dumps on Solaris OS
  • Collecting Core Dumps on Linux
  • Reasons for Not Getting a Core File
  • Collecting Crash Dumps on Windows

A Java 2D Properties

• Properties on Solaris OS and Linux
• Properties on Windows

B Fatal Error Log

• Location of Fatal Error Log
• Description of Fatal Error Log
• Header Format
• Thread Section Format
  • Thread Information
  • Signal Information
  • Register Context
  • Machine Instructions
  • Thread Stack
  • Further Details
• Process Section Format
  • Thread List
  • VM State
  • Mutexes and Monitors
  • Heap Summary
  • Memory Map
  • VM Arguments and Environment Variables
  • Signal Handlers
• System Section Format

---

Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Contact Us