Thank you for purchasing or evaluating JClass DesktopViews. This document
contains installation instructions, JDK requirements, and release
notes for each JClass DesktopViews product.
JClass DesktopViews products are compatible with JDK 1.4. If you are using JDK 1.4 or later and experience drawing problems, you may want to upgrade to the latest drivers for your video card from your video card vendor.
The following tables list the supported platform/JDK/Java3D combinations,
Web browser requirements, and supported IDEs and IDE capabilities:
Supported IDEs: | Version | IDE Capability | |
Compiling & Javadoc | Using JavaBeans | ||
Borland JBuilder | 7 | ||
8 | |||
9 | |||
WebSphere Studio Application Developer | 5.0 | ||
5.1 | |||
Sun Java Studio | 5, Std. Ed. | ||
IDEA | 3.x | n/s | |
Eclipse | 2.1 | n/s | |
NetBeans | 3.5 |
JBuilder 8 and the JCPopupCalendar
The JClass Elements JCPopupCalendar generates a NumberFormatException
in JBuilder 8 when the maximum
, minimum
,
or value
properties are set. While this does not prevent
correct code generation or compilation and running, it does prevent
these properties from maintaining state between sessions.
Eclipse 2.1
JClass DesktopViews javabeans cannot be used in Eclipse 2.1,
as it only supports compilation. Also note that Eclipse 2.1 is not equipped
with a visual editor.
Requirement for PDF viewers
In order to diplay PDF files created with JClass correctly,
your PDF viewer must support the PDF 1.4 specification. Failing that,
JClass PDF files may display with incorrect formatting and some PDF
features may be disabled. We recommend using the latest version of Adobe
Acrobat.
Java 2 Appletviewer Usage
Some JClass examples and demos may not run using the appletviewer tool (particularly "common" demos using multiple JClass products). JDK 1.2 changed appletviewer so that it does not use the CLASSPATH, and by default runs using more security. To work around this issues, try to run the applet with no security enabled; for example: appletviewer -nosecurity index.htmlJava 2 Browser Support (Plug-In)
If your browser doesn't support Java 2, you can use the Java Plug-In to run this version of JClass. For some older browsers, a conversion must be run on all HTML files in order to use the Plug-In. The conversion is provided with the Plug-In, and does not interfere with the operation of the pages. Please refer to http://java.sun.com/products/plugin/ for more details on the Java Plug-In for Java 2.Please note that you will need a license to install and use JClass DesktopViews. Please see the JClass DesktopViews Installation Guide for further information.
JClass products do not add to the minimum system requirements for your Java development environment.Ensure that your Java development environment is set up correctly before installing JClass DesktopViews. You must be able to create and run simple Java applications or applets before attempting to use JClass products.
To install JClass DesktopViews:
JClass DesktopViews | JClass DesktopViews Evaluation | JClass Chart Evaluation only | ||
---|---|---|---|---|
Target Platform | JDK 1.3.1 and higher and Java3D 1.2.1_04 and higher | |||
Windows | NT | JCDesktopViews630.exe |
JCDesktopViews630-eval.exe |
JCChart630-eval.exe |
2000 | ||||
XP | ||||
RedHat Linux | AS 2.1 | jcdesktopviews630-lnx.bin |
jcdesktopviews630-eval-lnx.bin |
jcchart630-eval-lnx.bin |
AIX | 4.33 | jcdesktopviews630-aix.bin |
jcdesktopviews630-eval-aix.bin |
jcchart630-eval-aix.bin |
5.1 | ||||
5.2 | ||||
Solaris | 7 | jcdesktopviews630-sol.bin |
jcdesktopviews630-eval-sol.bin |
jcchart630-eval-sol.bin |
8 | ||||
9 | ||||
HPUX | 11 | jcdesktopviews630-hp.bin |
jcdesktopviews630-eval-hp.bin |
jcchart630-eval-hp.bin |
Mac | OS X v10.2 | jcdesktopviews630-mac.zip |
jcdesktopviews630-eval-mac.zip |
jcchart630-eval-mac.zip |
chmod +x jcdesktopviews630-*.bin
then, run the installer by simply executing it:
./<installerfilename>.bin
where <installerfilename> is the name of the particular distibution you have downloaded
JCLASS_HOME (Contains this readme)For a full explanation of the installed files and directories, see the JClass DesktopViews Installation Guide.
|
|--bin (Optional executables; License Wizard is found here)
|
|--com (Source code [if purchased])
| |--klg
| |--
|
|--demos (Product demos, each in its own subdirectory)
| |--
|
|--docs
| |--api (Javadoc API reference)
| |
| |--getstarted (Getting Started Guide in HTML and PDF formats)
| |
| |--licensewizard (License Wizard Help)
| |
| |--<product> (Programmer's Guides in HTML and PDF formats)
|
|--examples (Simple code examples, one directory per product)
| |--
|
|--lib (JAR files)
|
|--licenses (License files)
|
|--xml-dtd (XML DTD files)
|
|--demobuilder.xml (Sample Ant integration buildfile)
|
|--license.txt
|
|--readme.html
|
|--readme.txt
|
|--Uninstall (Product uninstaller)
UNIX (as well as Windows) users can run the Gallery via an executable file. You can run the launchers by entering the following at a command prompt:
cd JCLASS_HOME/bin
jcexamples
Windows users can also launch the Example & Demo Gallery from the Windows Start menu:
Start | Programs | JClass DesktopViews | Example & Demo Gallery
For full, step-by-step instructions on how to run the JClass demos and
examples, please see the JClass DesktopViews Installation Guide.
Any XML parser that is compliant with Sun's JAXP 1.1 specification and DOM Level 2 may be used instead of crimson.jar. See Sun's JAXP readme for more information.
JClass customers who wish to obtain either of these versions should contact their Quest Software sales representative.
JClass 5.0 "J"
JClass 5.0 "J" supports JDK 1.1.8 or greater with Swing 1.1.1 environments.
JClass "J" version is an excellent choice for developers who are adding
functionality to existing Java programs operating in a Java 1.1.x environment
or programmers developing in environments that do not yet support Java
2. Also, use the collections JAR that ships with JClass 5.0 "J" to ensure
compatibility.
JClass 3.6.3
JClass 3.6.3 supports JDKs (1.02,1.1.x) using AWT. JClass
3.6.3 is an excellent choice for programmers who are extending existing
systems running in environments that do not support Swing or who do
not wish to use Swing.
The JClass 4.0 (and later) API was redesigned for Java 2 and JFC/Swing, and is not compatible with JClass 3.6. A porting guide is available to help you migrate your JClass 3.6 application to use a later version of JClass. Please contact your Quest Software sales representative.
JClass Chart 3D 6.3.0 fixes several problems found with 6.3.0. There
are no changes affecting applications built with version 6.3.0; simply
recompile your application with the new JAR file to upgrade.
false
. JCChart3d.snapshot()
with Java3D generates an image
missing the PlotArea.
OutOfMemoryError
when we set custom contour level
with zero value. NullPointerException
thrown when zooming in Java3D.
JClass Chart 6.3.0 contains improvements to annotation, ticks, and
gridlines. It also contains a new property that controls when anti-aliasing
is done. Simply recompile your application with the new JAR file to
upgrade.
NullPointerException
thrown when attempting
to choose an Axis Direction in customizer.JCChartLabelManager
not behaving properly
- labels added but not displayed.SOLID
. BAR
to STACKING_AREA
.NullPointerException
is thrown when applying
rotation and zooming to onto Stacking Bar chart.JCLabelGenerator
doesn't rotate labels.JCInputStreamDataSource
doesn't treat umlauts
and other special characters correctly. JCChart
gives NotSerializable
Exception after a new style is applied on a particular data series within
the chart.recalc()
is in
progress leads to ArrayIndexOutofBoundsException
.DataBinding
Page is not implemented in
Customizer. JCChart
component fails to stretch accordingly
under dual screen environment. setNumSpacing
is
used with exponential numbers. JCChart
legend is displayed in the wrong
position if there is a large number of data series.JCChart
to postscript with JCSymbolStyle.DOT
does not show symbols.IsIncluded=false
on one series make that series invisible.drawArc()
method of the java.awt.Graphics
class may draw beyond the
specified angular extent. For example, if the start angle is 0 and the
arc angle is 90 degrees, the resulting arc will extend slightly beyond
90 degrees. A similar problem is observed when the start angle is 180 degrees
or 270 degrees.(See Sun bug 4673238)
10105 Repainting problems with fast updates to chart (SWING limitation).
11116 NumberFormat
class gives wrong annotation
value for zero values the second time around.
14532 Errors printing charts from IE5 using JDK 1.3 hotspot.
There are no changes affecting applications built with version 6.3.0; simply recompile your application with the new JAR file to upgrade.
(ResultSet.TYPE_SCROLL_SENSITIVE)
to JDBCDatasource
results in a NullPointerException
with Oracle. nodeProperties
editor of JCData
Bean in JBuilder on Windows 2000. JClass Elements includes the following new components:
JCSplitWizard
, a new wizard component which generates a standard two panel wizard layout.
If desired, it can automatically generate a steps list for the left hand pane.
JCPopupCalendar
, which allows you to edit the date and time using a dropdown calendar
and uses a JFormattedTextField
that is configured to edit dates as its text editor. This
component requires JDK 1.4 or greater.
You can now switch the horizontal orientation of JCTreeTable
to right-to-left instead of left-to-right.
If you have implemented your own custom renderer and editor in JCSortableTable or JCTreeTable, please make sure that your renderer/editor can handle a null value. Otherwise, it may throw a NullPointerException.
JCDateChooser
confuses weekends if using a European
locale.JCTreeTable
: sorting on any column other
than the tree column changes the tree column display order as well.
JCTreeTable
: contextual popup mouse click
on headers should not trigger sorting.JCMultiSelectList
throws an Exception when
you double click in an empty list.JCMDIFrame
disappears
when clicking on the title bar of the frame.NullPointerException
thrown when trying to sort columns. setRootVisible(false)
is not taken in account when JCTreeTable
view is changed from Tree to Table. JCWizardPage
does not stretch properly using a JCElastic
interface. JCMDIFrame
inside of a JCMDIPane
does not work correctly. To workaround this issues, use frame.getContentPane().add(&npsp )
instead of setContentPane(a JPanel)
. StackOverflowError
thrown when using JCSpinFieldCellEditor
in JCSortableTable
. JCCircularGauge
draws incorrectly.JCCircularRange
results in a band with irregular thickness. TreeColumn
of JCTreeTable
. CheckBoxEditor
in TreeTable
behaves differently in JDK 1.4. JCSpinNumberBox
does not notify listeners when invalid input. expandPath()
method of TreeTable
does not work correctly.JCDateChooser
not intuitive with specific day values.
JClass Field 6.3.0 now supports validation for Big Decimals.
JCBigDecimalValidator
degrades numerical precision.ValueChanged
event not fired when data
entered by keyboard. JCPopupField
labels truncate when using
different locales. PopupFieldEditor
.
JCPopupField.getValue()
method returns Date
or GregorianCalendar
object
depending on how the date is inserted. Timestamp
objects are stored in the JCTextField
using SqlTimestampValueModel
.
JCComboField
does not trigger action events.
JCPopupField
/JCDateValidator
with JCDateChooser
set to SPIN_POPDOWN
mode
does not function correctly.JCTextFields
with JCDateValidators
behave anomalously. JCSpinFieldCellEditor
integration with
JCTable
. JCPopupField
(and
JCComboField
) has no effect. JCTextField
with IntegerValidator
loses selection when a menu is activated. JCTextField
and JCSpinField
cursor is alway positioned at the end of text. setMatchPickList(true)
does not work.
JCPopupField
. setValue
or getValueModel().setValue()
is not changing the value of JCPopupField
when setEditable
is false
. JCPopupField
does not respect the date
format when using JCDateValidator
unless setMaskInput
method is set to true
. JCComboField
.
JCValueEvent
is called twice. BigDecimal
does not invalidate out of range
numbers like Infinite or NaN. JCComboFields
do not throw ActionEvents
when selected. JCTextField
with DoubleValidator
cuts characters. TextField
portion in JCPopupField
loses focus after selecting a date from the calendar popup in Windows look
and feel. SwingUtilities.updateComponentTreeUI()
forces JCPopupField
to use default format and locale.
JCTextFieldCellEditor
with JCDoubleValidator
does not always commit values. JCDateTimeValidator
using shift and arrow buttons. JCPopupField
with JCDataValidator
,
the returned data is converted to a different value. JCSpinField
does not like integers as
minimum or maximum values when using DoubleSpinValidator
.
JCSpinField
resets to 1970 after consecutive
changes to month and year using the keyboard. JCSpinField
does not allow null values
at runtime. DAY_OF_YEAR
is in range from 366 to 377
(leap year). JCComboBox
/JCPopupField
is not serializable due to Swing PLAF. DataProperties
are not reflected in code by SunOne/NetBeans.There are no changes to HiGrid affecting applications built with
version 6.3.0; simply recompile your application with the new JAR file
to upgrade.
JScrollPane
.
setEditorBorder
method does not work
properly. HiGridFormatNodeEvent
object's getRowNode()
method returns null
. The Jar wizard has a new, more intuitive look.
javax.swing.*
classes when
these are archived by JarMaster. JClass LiveTable 6.3.0 contains numerous bug fixes. To access these, simply replace the JAR and recompile.
JCMultilineCellEditor
behaves incorrectly
with a FocusListener
is added.NullPointerException
is thrown when view
is sorted and new row is added with row label. JCTable.setAutoEdit(true)
causes problems
when used with editor.selectAll()
.VARIABLE
.
TraverseCell
events are
fired twice by datasources implementing EditableTableModel
.
JCComboBoxCellEditor/Renderers(Object[], int[])
constructor does not appear to function properly. JCListTable
does not have the sort capabilities
of a JCTable
. setAutoEdit(true)
.
JCComboBoxCellEditor
unusable when extended
outside applet with Windows or Motif look and feel. JCTraverseCellEvent.setCancelled(boolean)
does not work. JCTable
does not support accessibility.
getTopRow()
method returns 0 unless
setTopRow()
has been called. isCellVisible
to report
inaccurately. JBdbTable
unable to delete record without
exception. AbstractDataSource.fireDataReset()
does
not update RowColumnSeriesModel
. SortLabel
class is limited in application.
JCTable.isEditable(...)
throws StackOverflowError
if performed on a spanned, hidden cell. JCPopupFieldCellEditor
is used to change date value. top_row
variable is not updated as
table is scrolled. JCKeyModifier
has no effectAutoEdit
enabled, the JCCheckBoxCellEditor
does not function correctly while traversing. FIXED in JDK1.4. JClass PageLayout 6.3.0 now includes support for unicode characters.
AWTPrinter
does not pick up on landscape template. JCAWTPreviewer
does not follow the page
format of the template. FlowEvents
thows IllegalArgumentException
- offset out of bounds.JCFlow.setCurrentPageNumber()
is not reflected
on page 1 using macro. JLabel
text. JTable
formatting
information. JCPageTable
.
JCAWTPrinter.cancel()
method outputs a blank page
to the AWT printer. embedComponent()
method does not preserve
dashed line styles in JCChart
. embedComponent()
method fails ungracefully
if no image path is given for HTML printer. floatImage()
method is malfunctioning when
there is not enough space on the same page. JCPDFPrinter
and JCPCLPrinter
problems
with JCPageTable
cells that are longer than the page length.
JC[AWT]Printer.setNumCopies(int)
is ignored. JCTable
causes error in JCPageTable
when using JCPageTableFromJCTable
. JCPageTableFromJCTable.createTable(document,table,true)
method throws java.lang.IllegalArgumentException
. JCTable
to JCPageTable
- TableDataModel
. JCTableStyle
in JCPageTable
,
some styles do not function properly. JCPageTable
truncating cells when table cell
is longer than the length of the page. getSize()
method of JCFrame
in
PageTable
always returns height of 1000 inches. NullPointerException
in JCAWTPreviewer.dispose()
.
JCPageTable
does not clip at column boundry. JCAWTPrinter.cancel()
throws NullPointerException
.
OUTPUT_POLICY_IMMEDIATE
.
This guide contains proprietary information, which is protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser's personal use without the written permission of Quest Software, Inc.
The information contained in this document is subject to change without notice. Quest Software makes no warranty of any kind with respect to this information. QUEST SOFTWARE SPECIFICALLY DISCLAIMS THE IMPLIED WARRANTY OF THE MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Quest Software shall not be liable for any direct, indirect, incidental, consequential, or other damage alleged in connection with the furnishing or use of this information.
JClass, JClass Chart, JClass Chart 3D, JClass DataSource, JClass Elements, JClass Field, JClass HiGrid, JClass JarMaster, JClass LiveTable, JClass PageLayout, JClass ServerChart, JClass ServerReport, JClass DesktopViews, and JClass ServerViews are trademarks of Quest Software, Inc. Other trademarks and registered trademarks used in this guide are property of their respective owners.
World Headquarters
8001 Irvine Center Drive
Irvine, CA 92618
www.quest.com
e-mail: info@quest.com
U.S. and Canada: 949.754.8000
Please refer to our Web site for regional and international office information.
This product includes software developed by the Apache Software Foundation http://www.apache.org/.
The JPEG Encoder and its associated classes are Copyright © 1998, James R. Weeks and BioElectroMech. This product is based in part on the work of the Independent JPEG Group.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This product includes software developed by the JDOM Project (http://www.jdom.org/). Copyright © 2000-2002 Brett McLaughlin & Jason Hunter, all rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.