This document helps in troubleshooting problems that might occur with applications that use the desktop technologies in the release of Java Platform, Standard Edition Development Kit 6 (JDK 7 release or Java SE 7 release).
Most of the information in this guide also applies to the Java SE 6 release.
For help in troubleshooting possible problems between the application and the Java HotSpot virtual machine, see the Troubleshooting Guide for Java SE 7 with HotSpot VM or the Java 2 SE 5.0 Troubleshooting and Diagnostic Guide.
The target audience for this document comprises developers who are working with the desktop technologies in Java SE 7.
This document is intended for readers with a detailed understanding of the desktop technologies, a high-level understanding of the components of the Java Virtual Machine, as well as some understanding of concepts such as garbage collection, threads, native libraries, and so on. In addition, it is assumed that the reader is reasonably proficient on the operating system where the Java SE application is installed.
The first chapter of this guide introduces the desktop technologies, presents some general troubleshooting information and guidelines, and introduces some troubleshooting tools.
Further chapters suggest procedures to try when you encounter problems with some of the desktop technologies, namely, AWT, Java 2D, Swing, Internationalization, Java Sound, and Java Plug-in. More desktop technologies will be gradually added to this guide.
The last chapter provides suggestions on what to try before submitting a bug report, guidance on how to submit a report, and suggestions on what data to collect for the report.
Finally, there is an appendix for each of the following reference areas: Java 2D properties, and details about the format of the fatal error report.
Troubleshooting is a very important topic. If you have feedback on this document or if you have suggestions for topics that could be covered in a future version, use the Feedback Form. Fill in the relevant fields and click Send.
Note - Do not use this feedback form for support requests; they will not be answered. Technical support is provided at the Services site for Sun Developer Network.
The following additional online troubleshooting resources are available:
Community support can often be obtained using the Java Technology Forums. The forums provide a way to share information and locate solutions to problems. The forums are located at http://forums.oracle.com/forums/category.jspa?categoryID=285.
The following table describes the typographic conventions that are used in this book.
The following table shows the default UNIX system prompt and superuser prompt for shells that are included in the Solaris OS. Note that the default system prompt that is displayed in command examples varies, depending on the Solaris release.
Third-party URLs are referenced in this document and provide additional, related information.
Note - Oracle is not responsible for the availability of third-party web sites mentioned in this document. Oracle does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Oracle will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.
Many people contributed input to this guide: Artem Ananiev, Kannan Balasubramanian, Tim Bell, Christopher Campbell, Dmitry Cherepanov, Uday Dhanikonda (responsible engineering manager), Andrei Dmitriev, Denis S. Fokin, Alexander Gerasimov, Jennifer Godinez, Jim Holmlund, Yuka Kamiya, Antonia Lewis (writer), Alexy Menkov, Igor Nekrestyanov, Yuri Nesterenko, Phil Race, Oleg Semenov, Oleg Sukhodolsky, Anton Tarasov, Dmitri Trembovetski (major contributor and coordinator of input and review from Java Client Group).
The following table tracks the changes in versions of this guide.