A relative positioning constant, that can be used instead of
north, south, east, west or center.
mixing the two types of constants can lead to unpredicable results. If
you use both types, the relative constants will take precedence.
For example, if you add components using both the NORTH
and BEFORE_FIRST_LINE constants in a container whose
orientation is LEFT_TO_RIGHT, only the
BEFORE_FIRST_LINE will be layed out.
This will be the same for lastLine, firstItem, lastItem.
Read the ObjectInputStream and if it isnt null
add a listener to receive item events fired
by the components.
Unrecognised keys or values will be Ignored.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListener(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
Read the ObjectInputStream and if it isnt null
add a listener to receive item events fired
by the components.
Unrecognised keys or values will be Ignored.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListner(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
Read the ObjectInputStream and if it isnt null
add a listener to receive item events fired
by the Menu Item.
Unrecognised keys or values will be Ignored.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListner(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
Read the ObjectInputStream and if it isnt null
add a listener to receive item events fired
by the components.
Unrecognised keys or values will be Ignored.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListner(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
The color value in the default sRGB ColorSpace as
float components (no alpha).
If null after object construction, this must be an
sRGB color constructed with 8-bit precision, so compute from the
int color value.
The color value in the native ColorSpace as
float components (no alpha).
If null after object construction, this must be an
sRGB color constructed with 8-bit precision, so compute from the
int color value.
Read the ObjectInputStream and if it isnt null
add a listener to receive item events fired
by the components.
Unrecognised keys or values will be Ignored.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListener(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
Internal, cached size information
(This field perhaps should have been transient).
newEventsOnly
boolean newEventsOnly
newEventsOnly will be true if the event is
one of the event types enabled for the component.
It will then allow for normal processing to
continue. If it is false the event is passed
to the components parent and up the ancestor
tree until the event has been consumed.
See Also:
dispatchEvent()
eventMask
long eventMask
The eventMask is ONLY set by subclasses via enableEvents.
The mask should NOT be set when listeners are registered
so that we can distinguish the difference between when
listeners request events and subclasses request them.
One bit is used to indicate whether input methods are
enabled; this bit is set by enableInputMethods and is
on by default.
Read the ObjectInputStream and if it isnt null
add a listener to receive item events fired
by the components.
Unrecognised keys or values will be Ignored.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListner(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
Event router for lightweight components. If this container
is native, this dispatcher takes care of forwarding and
retargeting the events to lightweight components contained
(if any).
The target component. This indicates the component over which the
event occurred or with which the event is associated.
This object has been replaced by AWTEvent.getSource()
For MOUSE_DOWN events, this field indicates the
number of consecutive clicks. For other events, its value is
0.
This field has been replaced by MouseEvent.getClickCount().
This field controls whether or not the event is sent back
down to the peer once the target has processed it -
false means it's sent to the peer, true means it's not.
Read the default ObjectInputStream, a possibly null listener to
receive item events fired by the Window, and a possibly null
list of child Windows.
Unrecognised keys or values will be Ignored.
Read this object out of a serialization stream, handling
objects written by older versions of the class that didn't contain all
of the fields we use now..
Serialized Fields
align
int align
align is the proprty that determines
how each row distributes empty space.
It can be one of the following three values :
LEFTRIGHTCENTER
newAlign is the property that determines
how each row distributes empty space for the Java 2 platform, v1.2 and greater.
It can be one of the following three values :
LEFTRIGHTCENTER
The flow layout manager allows a seperation of
components with gaps. The horizontal gap will
specify the space between components.
See Also:
getHgap,
setHgap
vgap
int vgap
The flow layout manager allows a seperation of
components with gaps. The vertical gap will
specify the space between rows.
See Also:
getVgap,
setVgap
serialVersionOnStream
int serialVersionOnStream
This represent the currentSerialVersion
which is bein used. It will be one of two values :
0 versions before Java 2 platform v1.2..
1 versions after Java 2 platform v1.2..
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListner(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListner(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
This field indicates whether the the frame is resizable
This property can be changed at any time.
resizable will be true if the frame is
resizable, otherwise it will be false.
Specifies the cell at the left of the component's display area,
where the leftmost cell has gridx=0. The value
RELATIVE specifies that the component be placed just
to the right of the component that was added to the container just
before this component was added.
The default value is RELATIVE.
gridx should be a non-negative value.
Specifies the cell at the top of the component's display area,
where the topmost cell has gridy=0. The value
RELATIVE specifies that the component be placed just
below the component that was added to the container just before
this component was added.
The default value is RELATIVE.
gridy should be a non-negative value.
Specifies the number of cells in a column for the component's
display area.
Use REMAINDER to specify that the component be the
last one in its column. Use RELATIVE to specify that
the component be the next-to-last one in its column.
gridheight should be a non-negative value and the default value is 1.
Specifies how to distribute extra horizontal space.
The grid bag layout manager calculates the weight of a column to
be the maximum weightx of all the components in a
column. If the resulting layout is smaller horizontally than the area
it needs to fill, the extra space is distributed to each column in
proportion to its weight. A column that has a weight of zero receives
no extra space.
If all the weights are zero, all the extra space appears between
the grids of the cell and the left and right edges.
The default value of this field is 0.
weightx should be a non-negative value.
The grid bag layout manager calculates the weight of a row to be
the maximum weighty of all the components in a row.
If the resulting layout is smaller vertically than the area it
needs to fill, the extra space is distributed to each row in
proportion to its weight. A row that has a weight of zero receives no
extra space.
If all the weights are zero, all the extra space appears between
the grids of the cell and the top and bottom edges.
The default value of this field is 0.
weighty should be a non-negative value.
This field is used when the component is smaller than its display
area. It determines where, within the display area, to place the
component. Possible values are CENTER,
NORTH, NORTHEAST, EAST,
SOUTHEAST, SOUTH, SOUTHWEST,
WEST, and NORTHWEST.
The default value is CENTER.
This field is used when the component's display area is larger
than the component's requested size. It determines whether to
resize the component, and if so, how.
The following values are valid for fill:
NONE: Do not resize the component.
HORIZONTAL: Make the component wide enough to fill
its display area horizontally, but do not change its height.
VERTICAL: Make the component tall enough to fill its
display area vertically, but do not change its width.
BOTH: Make the component fill its display area
entirely.
This field specifies the internal padding of the component, how much
space to add to the minimum width of the component. The width of
the component is at least its minimum width plus
(ipadx * 2) pixels.
This field specifies the internal padding, that is, how much
space to add to the minimum height of the component. The height of
the component is at least its minimum height plus
(ipady * 2) pixels.
This hashtable maintains the association between
a component and its gridbag constraints.
The Keys in comptable are the components and the
values are the instances of GridBagConstraints.
This field holds a gridbag constraints instance
containing the default values, so if a component
does not have gridbag constraints associated with
it, then the component will be assigned a
copy of the defaultConstraints.
This field holds tha layout information
for the gridbag. The information in this field
is based on the most recent validation of the
gridbag.
If layoutInfo is null
this indicates that there are no components in
the gridbag or if there are components, they have
not yet been validated.
This field holds the overrides to the column minimum
width. If this field is non-null the values are
applied to the gridbag after all of the minimum columns
widths have been calculated.
If columnWidths has more elements than the number of
columns, columns are added to the gridbag to match
the number of elements in columnWidth.
This field holds the overrides to the row minimum
heights. If this field is non-null the values are
applied to the gridbag after all of the minimum row
heights have been calculated.
If rowHeights has more elements than the number of
rows, rowa are added to the gridbag to match
the number of elements in rowHeights.
This field holds the overrides to the column weights.
If this field is non-null the values are
applied to the gridbag after all of the columns
weights have been calculated.
If columnWeights[i] > weight for column i, then
column i is assigned the weight in columnWeights[i].
If columnWeights has more elements than the number
of columns, the excess elements are ignored - they do
not cause more columns to be created.
rowWeights
double[] rowWeights
This field holds the overrides to the row weights.
If this field is non-null the values are
applied to the gridbag after all of the rows
weights have been calculated.
If rowWeights[i] > weight for row i, then
row i is assigned the weight in rowWeights[i].
If rowWeights has more elements than the number
of rows, the excess elements are ignored - they do
not cause more rows to be created.
This is the horizontal gap (in pixels) which specifies the space
between columns. They can be changed at any time.
This should be a non negative integer.
This is the number of rows specified for the grid. The number
of rows can be changed at any time.
This should be a non negative integer, where '0' means
'any number' meaning that the number of Rows in that
dimension depends on the other dimension.
This is the number of columns specified for the grid. The number
of columns can be changed at any time.
This should be a non negative integer, where '0' means
'any number' meaning that the number of Columns in that
dimension depends on the other dimension.
The current lightweight component that has focus that is being
hosted by this container. If this is a null reference then
there is currently no focus on a lightweight component being
hosted by this container
dragging
boolean dragging
Indicates if the mouse pointer is currently being dragged...
this is needed because we may receive exit events while dragging
and need to keep the current mouse target in this case.
This variable is not used, but kept for serialization compatibility
eventMask
long eventMask
The event mask for contained lightweight components. Lightweight
components need a windowed container to host window-related
events. This seperate mask indicates events that have been
requested by contained lightweight components without effecting
the mask of the windowed component itself.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListner(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
A vector created to contain items which will become
part of the List Component.
See Also:
addItem(),
getItem()
rows
int rows
This field will represent the number of rows in the
List Component. It is specified only once, and
that is when the list component is actually
created. It will never change.
multipleMode is a variable that will
be set to true if a list component is to be set to
multiple selection mode, that is where the user can
select more than one item in a list at one time.
multipleMode will be set to false if the
list component is set to single selection, that is where
the user can only select one item on the list at any
one time.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListner(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
This field indicates whether the menu has the
tear of property or not. It will be set to
true if the menu has the tear off
property and it will be set to false>
if it does not.
A torn off menu can be deleted by a user when
it is no longer needed.
Read the ObjectInputStream and if it isnt null
add a listener to receive item events fired
by the MenuBar.
Unrecognised keys or values will be Ignored.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListner(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
This menu is a special menu dedicated to
help. The one thing to note about this menu
is that on some platforms it appears at the
right edge of the menubar.
Read the ObjectInputStream and if it isnt null
add a listener to receive item events fired
by the Menu Item.
Unrecognised keys or values will be Ignored.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListner(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
This field indicates the command tha has been issued
by a particular menu item.
By default the actionCommand
is the label of the menu item, unless it has been
set using setActionCommand.
The eventMask is ONLY set by subclasses via enableEvents.
The mask should NOT be set when listeners are registered
so that we can distinguish the difference between when
listeners request events and subclasses request them.
A sequence of key stokes that ia associated with
a menu item.
Note :in 1.1.2 you must use setActionCommand()
on a menu item in order for its shortcut to
work.
This is indicates the virtual keycode for the menu shortcut.
It is the key code with which the menu short cut will be created.
In 1.1.2 you must use setActionCommand() on a menu item
in order for its shortcut to work, otherwise it will fire a null
action command.
Must use KeyEvent virtual keys - eg : VK_A.
Read the ObjectInputStream and if it isnt null
add a listener to receive item events fired
by the Scrollbar.
Unrecognised keys or values will be Ignored.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListner(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating and ItemListener object.
The maximum value of the Scrollbar.
This value must be greater than the minimum
value.
This integer can be either positive or negative, and
it's range can be altered at any time.
The Scrollbar's orientation--being either horizontal or vertical.
This value should be specified when the scrollbar is being
created.
orientation can be either : VERTICAL or
HORIZONTAL only.
There are 3 ways in which a scroll bar can be displayed.
This integer will represent one of these 3 displays -
(SCROLLBARS_ALWAYS, SCROLLBARS_AS_NEEDED, SCROLLBARS_NEVER)
An adjustable Vertical Scrollbar.
It is important to not that you must NOT call 3 Adjustable methods
ie : setMinimum(), setMaximum(), setVisibleAmount().
An adjustable Horizontal Scrollbar.
It is important to not that you must NOT call 3 Adjustable method
ie : setMinimum(), setMaximum(), setVisibleAmount().
The number of columns in the TextArea.
A column is an approximate average character
width that is platform-dependent.
This parameter will determine the text area's width.
Guaranteed to be non-negative.
Determines which scrollbars are created for the
text area. It can be one of four values :
SCROLLBARS_BOTH = both scrollbars. SCROLLBARS_HORIZONTAL_ONLY = Horizontal bar only. SCROLLBARS_VERTICAL_ONLY = Vertical bar only. SCROLLBARS_NONE = No scrollbars.
Read the ObjectInputStream, and if it isn't null,
add a listener to receive text events fired by the
TextComponent. Unrecognized keys or values will be
ignored.
Writes default serializable fields to stream. Writes
a list of serializable TextListener(s) as optional data.
The non-serializable TextListener(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of zero or more pairs.
A pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
textListenerK indicating and TextListener object.
Read the ObjectInputStream and if it isn't null,
add a listener to receive action events fired by the
TextField. Unrecognized keys or values will be
ignored.
Writes default serializable fields to stream. Writes
a list of serializable ActionListener(s) as optional data.
The non-serializable ActionListener(s) are detected and
no attempt is made to serialize them.
Serial Data:
Null terminated sequence of zero or more pairs.
A pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
ActionListenerK indicating and ActionListener object.
The echo character, which is used when
the user wishes to disguise the characters
typed into the text field.
The disguises are removed if echoChar = 0.
Read the default ObjectInputStream, a possibly null listener to
receive item events fired by the Window, and a possibly null
list of child Windows.
Unrecognised keys or values will be Ignored.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListener(s) are detected and
no attempt is made to serialize them. Write a list of
child Windows as optional data.
Serial Data:
Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
itemListenerK indicating an ItemListener object.Null terminated sequence of 0 or more pairs.
The pair consists of a String and Object.
The String indicates the type of object and
is one of the following :
ownedWindowK indicating a child Window object.
This represents the warning message that is
to be displayed in a non secure window. ie :
a window that has a security manager installed for
which calling SecurityManager.checkTopLevelWindow()
is false. This message can be displayed anywhere in
the window.
Reads default serializable fields from the stream. Reads from
the stream a string and an array of bytes as additional data.
Serial Data:
The String is the name of one of
CS_* constants defined in the
ColorSpace class if the profile object is a profile
for a predefined color space (for example
"CS_sRGB"). The string is null
otherwise.
The byte[] array is the profile data for the
profile. It will usually be null for the
predefined profiles.
If the string is recognized as a constant name for
predefined color space the object will be resolved into
profile obtained with
getInstance(int cspace) and the profile
data are ignored. Otherwise the object will be resolved
into profile obtained with
getInstance(byte[] data).
Writes default serializable fields to the stream. Writes a
string and an array of bytes to the stream as additional data.
Serial Data:
The String is the name of one of
CS_* constants defined in the
ColorSpace class if the profile object is a profile
for a predefined color space (for example
"CS_sRGB"). The string is null
otherwise.
The byte[] array is the profile data for the
profile. For predefined color spaces null is
written instead of the profile data. If in the future
versions of Java API new predefined color spaces will be
added, future versions of this class may choose to write
for new predefined color spaces not only the color space
name, but the profile data as well so that older versions
could still deserialize the object.
Serialized Fields
iccProfileSerializedDataVersion
int iccProfileSerializedDataVersion
Version of the format of additional serialized data in the
stream. Version 1 corresponds to Java 2
Platform, v1.3.
The object implements the readExternal method to restore its
contents by calling the methods of DataInput for primitive
types and readObject for objects, strings and arrays. The
readExternal method must read the values in the same sequence
and with the same types as were written by writeExternal.
The object implements the writeExternal method to save its contents
by calling the methods of DataOutput for its primitive values or
calling the writeObject method of ObjectOutput for objects, strings
and arrays.
This represents the key modifier that was selected,
and is used to determine the state of the selected key.
If no modifier has been selected it will default to
zero.
The adjustmentType describes how the adjustable
object value has changed.
This value can be increased/decreased by a block or unit amount
where the block is associated with page increments/decrements,
and a unit is associated with line increments/decrements.
A focus event can have two different levels,
permanent and temporary. It will be set to true if some
operation takes away the focus temporarily and
intends on getting it back once the event is completed.
Otherwise it will be set to false.
The (potentially null) Object whose notifyAll() method will be called
immediately after the Runnable.run() method returns.
catchExceptions
boolean catchExceptions
Set to true if dispatch() catches Exception and stores it in the
exception instance variable. If false, Exceptions are propagated up
to the EventDispatchThread's dispatch loop.
The (potentially null) Exception thrown during execution of the
Runnable.run() method. This variable will also be null if a particular
instance does not catch exceptions.
The unique value assigned to each of the keys on the
keyboard. There is a common set of key codes that
can be fired by most keyboards.
The symbolic name for a key code should be used rather
than the code value itself.
Indicates the number of quick consecutive clicks of
a mouse button.
clickCount will be valid for only three mouse events : MOUSE_CLICKED,
MOUSE_PRESSED and
MOUSE_RELEASED.
For the above, the clickCount will be at least 1. For all
other events the count will be 0.
A property used to indicate whether a Popup Menu
should appear with a certain gestures.
If popupTrigger = false no popup menu
should appear. If it is true then a popup menu should appear
.
deserialize contents ... if this instance has a distinct peer the
children are *not* serialized here, the peer's readObject() must call
readChildren() after deserializing this instance.
Serialize the BeanContextSupport, if this instance has a distinct
peer (that is this object is acting as a delegate for another) then
the children of this instance are not serialized here due to a
'chicken and egg' problem that occurs on deserialization of the
children at the same time as this instance.
Therefore in situations where there is a distinct peer to this instance
it should always call writeObject() followed by writeChildren() and
readObject() followed by readChildren().
readObject is called to restore this filename.
The original separator character is read. If it is different
than the separator character on this system, then the old seperator
is replaced by the local separator.
WriteObject is called to save this filename.
The separator character is saved also so it can be replaced
in case the path is reconstituted on a different host type.
This abstract pathname's normalized pathname string. A normalized
pathname string uses the default name-separator character and does not
contain any duplicate or redundant separators.
Class ObjectStreamClass is special cased within the
Serialization Stream Protocol.
An ObjectStreamClass is written intially into an ObjectOutputStream
in the following format:
TC_CLASSDESC className, serialVersionUID, flags,
length, list of field descriptions.
FIELDNAME TYPES
DESCRIPTION
--------------------------------------
className primitive data String
Fully qualified class name.
serialVersionUID long
Stream Unique Identifier for compatible classes
with same base class name.
flags byte
Attribute bit fields defined in
java.io.ObjectStreamConstants.SC_*.
length short
The number of field descriptions to follow.
fieldDescription (byte, primitive data String, String Object)
A pseudo-externalized format of class
java.io.ObjectStreamField.
Consists of typeCode, fieldName, and,
if a nonPrimitive typecode, a fully qualified
class name. See Class.getName method
for the typecode byte encodings.
The first time the class descriptor
is written into the stream, a new handle is generated.
Future references to the class descriptor are
written as references to the initial class descriptor instance.
Class Class is special cased within the Serialization Stream Protocol.
A Class instance is written intially into an ObjectOutputStream in the
following format:
TC_CLASS ClassDescriptor
A ClassDescriptor is a special cased serialization of
a java.io.ObjectStreamClass instance.
A new handle is generated for the initial time the class descriptor
is written into the stream. Future references to the class descriptor
are written as references to the initial class descriptor instance.
Class String is special cased within the Serialization Stream Protocol.
A String instance is written intially into an ObjectOutputStream in the
following format:
TC_STRING (utf String)
The String is written by method DataOutput.writeUTF.
A new handle is generated to refer to all future references to the
string instance within the stream.
Reconstitute the BigInteger instance from a stream (that is,
deserialize it). The magnitude is read in as an array of bytes
for historical reasons, but it is converted to an array of ints
and the byte array is discarded.
Serialized Fields
signum
int signum
The signum of this BigInteger: -1 for negative, 0 for zero, or
1 for positive. Note that the BigInteger zero must have
a signum of 0. This is necessary to ensures that there is exactly one
representation for each BigInteger value.
magnitude
byte[] magnitude
This field is required for historical reasons. The magnitude of a
BigInteger used to be in a byte representation, and is still serialized
that way. The mag field is used in all real computations but the
magnitude field is required for storage.
bitCount
int bitCount
The bitCount of this BigInteger, as returned by bitCount(), or -1
(either value is acceptable).
The index of the lowest-order byte in the magnitude of this BigInteger
that contains a nonzero byte, or -2 (either value is acceptable). The
least significant byte has int-number 0, the next byte in order of
increasing significance has byte-number 1, and so forth.
WriteObject is called to save the state of the URL to an
ObjectOutputStream. The handler is not saved since it is
specific to this system.
Serial Data:
the default write object value. When read back in,
the reader must ensure that calling getURLStreamHandler with
the protocol variable returns a valid URLStreamHandler and
throw an IOException if it does not.
readObject for object serialization. Reads in a
java.rmi.server.UID and a remote reference. The
remote reference is read via a direct call to
readExternal(ObjectInputStream in). Default
serialization is not used. The reference is used to create the
activator field in this object. That is, the
activator field is set to the stub returned from
RemoteProxy.getStub(activatorClassName, ref).
writeObject for object serialization. Writes out a
java.rmi.server.UID and the reference to the
activator responsible for activating the object associated with
this id, the remote reference contained in the
activator field.
Serial Data:
Writes out a java.rmi.server.UID, and
the unqualified class name, in UTF-8, of the
remote reference contained in the activator
field. Delegates to the activator's remote
reference to write itself to out. Directly calls
writeExternal(ObjectStream out) on the return
value of activator.getRef(). Default serialization
is not used.
readObject for object serialization. Reads in the unqualified
class name of the remote reference field, ref, in
UTF-8 and delegates to the ref field
to read in its representation. The ref field is
read via a direct call to
ref.readExternal(ObjectInputStream in). Default
serialization is not used.
writeObject for object serialization. Writes out the class
name of the remote reference contained in this class and
delegates to the reference to write out its representation.
Serial Data:
Writes out the unqualified class name of the remote
reference field, ref, in UTF-8 and
delegates to the ref field to write out its
representation. Different information will be written to
out depending upon the ref field's
type. Default serialization is not used.
Writes this object out to a stream (i.e., serializes it).
Serial Data:
An initial URL is followed by an
int indicating the number of certificates to follow
(a value of "zero" denotes that there are no certificates associated
with this object).
Each certificate is written out starting with a String
denoting the certificate type, followed by an
int specifying the length of the certificate encoding,
followed by the certificate encoding itself which is written out as an
array of bytes.
We know that the MessageDigest class does not implement
java.io.Serializable. However, since this field is no longer
used, it will always be NULL and won't affect the serialization
of the SecureRandom class itself.
Writes this object out to a stream (i.e., serializes it).
Serial Data:
An initial String denoting the
type is followed by a String denoting the
name is followed by a String denoting the
actions is followed by an int indicating the
number of certificates to follow
(a value of "zero" denotes that there are no certificates associated
with this object).
Each certificate is written out starting with a String
denoting the certificate type, followed by an
int specifying the length of the certificate encoding,
followed by the certificate encoding itself which is written out as an
array of bytes.
After reading an object from the input stream, do a simple verification
to maintain class invariants.
Serialized Fields
choiceLimits
double[] choiceLimits
A list of lower bounds for the choices. The formatter will return
choiceFormats[i] if the number being formatted is greater than or equal to
choiceLimits[i] and less than choiceLimits[i+1].
A list of choice strings. The formatter will return
choiceFormats[i] if the number being formatted is greater than or equal to
choiceLimits[i] and less than choiceLimits[i+1].
The calendar that DateFormat uses to produce the time field
values needed to implement date and time formatting. Subclasses should
initialize this to a calendar appropriate for the locale associated with
this DateFormat.
The number formatter that DateFormat uses to format numbers
in dates and times. Subclasses should initialize this to a number format
appropriate for the locale associated with this DateFormat.
Month strings. For example: "January", "February", etc. An array
of 13 strings (some calendars have 13 months), indexed by
Calendar.JANUARY, Calendar.FEBRUARY, etc.
Short month strings. For example: "Jan", "Feb", etc. An array of
13 strings (some calendars have 13 months), indexed by
Calendar.JANUARY, Calendar.FEBRUARY, etc.
Weekday strings. For example: "Sunday", "Monday", etc. An array
of 8 strings, indexed by Calendar.SUNDAY,
Calendar.MONDAY, etc.
The element weekdays[0] is ignored.
Short weekday strings. For example: "Sun", "Mon", etc. An array
of 8 strings, indexed by Calendar.SUNDAY,
Calendar.MONDAY, etc.
The element shortWeekdays[0] is ignored.
Localized names of time zones in this locale. This is a
two-dimensional array of strings of size n by m,
where m is at least 5. Each of the n rows is an
entry containing the localized names for a single TimeZone.
Each such row contains (with i ranging from
0..n-1):
zoneStrings[i][0] - time zone ID
zoneStrings[i][1] - long name of zone in standard
time
zoneStrings[i][2] - short name of zone in
standard time
zoneStrings[i][3] - long name of zone in daylight
savings time
zoneStrings[i][4] - short name of zone in daylight
savings time
The zone ID is not localized; it corresponds to the ID
value associated with a system time zone object. All other entries
are localized names. If a zone does not implement daylight savings
time, the daylight savings time names are ignored.
Localized date-time pattern characters. For example, a locale may
wish to use 'u' rather than 'y' to represent years in its date format
pattern strings.
This string must be exactly 18 characters long, with the index of
the characters described by DateFormat.ERA_FIELD,
DateFormat.YEAR_FIELD, etc. Thus, if the string were
"Xz...", then localized patterns would use 'X' for era and 'z' for year.
First, read the default serializable fields from the stream. Then
if serialVersionOnStream is less than 1, indicating that
the stream was written by JDK 1.1, initialize useExponentialNotation
to false, since it was not present in JDK 1.1.
Finally, set serialVersionOnStream back to the maximum allowed value so that
default serialization will work properly if this object is streamed out again.
If the minimum or maximum integer digit count is larger than
DOUBLE_INTEGER_DIGITS or if the minimum or maximum fraction
digit count is larger than DOUBLE_FRACTION_DIGITS, then the
stream data is invalid and this method throws an
InvalidObjectException.
Stream versions older than 2 will not have the affix pattern variables
posPrefixPattern etc. As a result, they will be initialized
to null, which means the affix strings will be taken as
literal values. This is exactly what we want, since that corresponds to
the pre-version-2 behavior.
The prefix pattern for non-negative numbers. This variable corresponds
to positivePrefix.
This pattern is expanded by the method expandAffix() to
positivePrefix to update the latter to reflect changes in
symbols. If this variable is null then
positivePrefix is taken as a literal value that does not
change when symbols changes. This variable is always
null for DecimalFormat objects older than
stream version 2 restored from stream.
The suffix pattern for non-negative numbers. This variable corresponds
to positiveSuffix. This variable is analogous to
posPrefixPattern; see that variable for further
documentation.
The prefix pattern for negative numbers. This variable corresponds
to negativePrefix. This variable is analogous to
posPrefixPattern; see that variable for further
documentation.
The suffix pattern for negative numbers. This variable corresponds
to negativeSuffix. This variable is analogous to
posPrefixPattern; see that variable for further
documentation.
The DecimalFormatSymbols object used by this format.
It contains the symbols used to format numbers, e.g. the grouping separator,
decimal separator, and so on.
True to force the use of exponential (i.e. scientific) notation when formatting
numbers.
Since:
1.2
minExponentDigits
byte minExponentDigits
The minimum number of digits used to display the exponent when a number is
formatted in exponential notation. This field is ignored if
useExponentialNotation is not true.
Since:
1.2
serialVersionOnStream
int serialVersionOnStream
The internal serial version which says which version was written
Possible values are:
0 (default): versions before the Java 2 platform v1.2
1: version for 1.2, which includes the two new fields
useExponentialNotation and minExponentDigits.
2: version for 1.3 and later, which adds four new fields:
posPrefixPattern, posSuffixPattern,
negPrefixPattern, and negSuffixPattern.
Read the default serializable fields, then if serialVersionOnStream
is less than 1, initialize monetarySeparator to be
the same as decimalSeparator and exponential
to be 'E'.
Finally, set serialVersionOnStream back to the maximum allowed value so that
default serialization will work properly if this object is streamed out again.
The character used to distinguish the exponent in a number formatted
in exponential notation, e.g. 'E' for a number such as "1.23E45".
Note that the public API provides no way to set this field,
even though it is supported by the implementation and the stream format.
The intent is that this will be added to the API in the future.
Since:
JDK 1.1.6
serialVersionOnStream
int serialVersionOnStream
Describes the version of DecimalFormatSymbols present on the stream.
Possible values are:
0 (or uninitialized): versions prior to JDK 1.1.6.
1: Versions written by JDK 1.1.6 or later, which includes
two new fields: monetarySeparator and exponential.
When streaming out a DecimalFormatSymbols, the most recent format
(corresponding to the highest allowable serialVersionOnStream)
is always written.
The string that the formatted values are to be plugged into. In other words, this
is the pattern supplied on construction with all of the {} expressions taken out.
An array of ten formatters, which are used to format the first ten arguments.
offsets
int[] offsets
The positions where the results of formatting each argument are to be inserted
into the pattern.
argumentNumbers
int[] argumentNumbers
The argument numbers corresponding to each formatter. (The formatters are stored
in the order they occur in the pattern, not in the order in which the arguments
are specified.)
maxOffset
int maxOffset
One less than the number of entries in offsets. Can also be thought of
as the index of the highest-numbered element in offsets that is being used.
All of these arrays should have the same number of elements being used as offsets
does, and so this variable suffices to tell us how many entries are in all of them.
First, read in the default serializable data.
Then, if serialVersionOnStream is less than 1, indicating that
the stream was written by JDK 1.1,
set the int fields such as maximumIntegerDigits
to be equal to the byte fields such as maxIntegerDigits,
since the int fields were not present in JDK 1.1.
Finally, set serialVersionOnStream back to the maximum allowed value so that
default serialization will work properly if this object is streamed out again.
If minimumIntegerDigits is greater than
maximumIntegerDigits or minimumFractionDigits
is greater than maximumFractionDigits, then the stream data
is invalid and this method throws an InvalidObjectException.
In addition, if any of these values is negative, then this method throws
an InvalidObjectException.
Write out the default serializable data, after first setting
the byte fields such as maxIntegerDigits to be
equal to the int fields such as maximumIntegerDigits
(or to Byte.MAX_VALUE, whichever is smaller), for compatibility
with the JDK 1.1 version of the stream format.
Since:
1.2
Serialized Fields
groupingUsed
boolean groupingUsed
True if the the grouping (i.e. thousands) separator is used when
formatting and parsing numbers.
The maximum number of digits allowed in the integer portion of a
number. maxIntegerDigits must be greater than or equal to
minIntegerDigits.
Note: This field exists only for serialization
compatibility with JDK 1.1. In Java platform 2 v1.2 and higher, the new
int field maximumIntegerDigits is used instead.
When writing to a stream, maxIntegerDigits is set to
maximumIntegerDigits or Byte.MAX_VALUE,
whichever is smaller. When reading from a stream, this field is used
only if serialVersionOnStream is less than 1.
The minimum number of digits allowed in the integer portion of a
number. minimumIntegerDigits must be less than or equal to
maximumIntegerDigits.
Note: This field exists only for serialization
compatibility with JDK 1.1. In Java platform 2 v1.2 and higher, the new
int field minimumIntegerDigits is used instead.
When writing to a stream, minIntegerDigits is set to
minimumIntegerDigits or Byte.MAX_VALUE,
whichever is smaller. When reading from a stream, this field is used
only if serialVersionOnStream is less than 1.
The maximum number of digits allowed in the fractional portion of a
number. maximumFractionDigits must be greater than or equal to
minimumFractionDigits.
Note: This field exists only for serialization
compatibility with JDK 1.1. In Java platform 2 v1.2 and higher, the new
int field maximumFractionDigits is used instead.
When writing to a stream, maxFractionDigits is set to
maximumFractionDigits or Byte.MAX_VALUE,
whichever is smaller. When reading from a stream, this field is used
only if serialVersionOnStream is less than 1.
The minimum number of digits allowed in the fractional portion of a
number. minimumFractionDigits must be less than or equal to
maximumFractionDigits.
Note: This field exists only for serialization
compatibility with JDK 1.1. In Java platform 2 v1.2 and higher, the new
int field minimumFractionDigits is used instead.
When writing to a stream, minFractionDigits is set to
minimumFractionDigits or Byte.MAX_VALUE,
whichever is smaller. When reading from a stream, this field is used
only if serialVersionOnStream is less than 1.
The maximum number of digits allowed in the fractional portion of a
number. maximumFractionDigits must be greater than or equal to
minimumFractionDigits.
Describes the version of NumberFormat present on the stream.
Possible values are:
0 (or uninitialized): the JDK 1.1 version of the stream format.
In this version, the int fields such as
maximumIntegerDigits were not present, and the byte
fields such as maxIntegerDigits are used instead.
1: the 1.2 version of the stream format. The values of the
byte fields such as maxIntegerDigits are ignored,
and the int fields such as maximumIntegerDigits
are used instead.
When streaming out a NumberFormat, the most recent format
(corresponding to the highest allowable serialVersionOnStream)
is always written.
This override of readObject makes sure unitsInUse is set properly
when deserializing a bitset
Serialized Fields
bits
long[] bits
The bits in this BitSet. The ith bit is stored in bits[i/64] at
bit position i % 64 (where bit position 0 refers to the least
significant bit and 63 refers to the most significant bit).
INVARIANT: The words in bits[] above unitInUse-1 are zero.
Save the state of this object to a stream (i.e., serialize it).
Ideally, Calendar would only write out its state data and
the current time, and not write any field data out, such as
fields[], isTimeSet, areFieldsSet,
and isSet[]. nextStamp also should not be part
of the persistent state. Unfortunately, this didn't happen before JDK 1.1
shipped. To be compatible with JDK 1.1, we will always have to write out
the field values and state flags. However, nextStamp can be
removed from the serialization stream; this will probably happen in the
near future.
Serialized Fields
fields
int[] fields
The field values for the currently set time for this calendar.
This is an array of FIELD_COUNT integers, with index values
ERA through DST_OFFSET.
isSet
boolean[] isSet
The flags which tell if a specified time field for the calendar is set.
A new object has no fields set. After the first call to a method
which generates the fields, they all remain set after that.
This is an array of FIELD_COUNT booleans, with index values
ERA through DST_OFFSET.
time
long time
The currently set time for this calendar, expressed in milliseconds after
January 1, 1970, 0:00:00 GMT.
True if fields[] are in sync with the currently set time.
If false, then the next attempt to get the value of a field will
force a recomputation of all fields from the current value of
time.
lenient
boolean lenient
True if this calendar allows out-of-range field values during computation
of time from fields[].
The TimeZone used by this calendar. Calendar
uses the time zone data to translate between locale and GMT time.
firstDayOfWeek
int firstDayOfWeek
The first day of the week, with possible values SUNDAY,
MONDAY, etc. This is a locale-dependent value.
minimalDaysInFirstWeek
int minimalDaysInFirstWeek
The number of days required for the first week in a month or year,
with possible values from 1 to 7. This is a locale-dependent value.
nextStamp
int nextStamp
The next available value for stamp[], an internal array.
This actually should not be written out to the stream, and will probably
be removed from the stream in the near future. In the meantime,
a value of MINIMUM_USER_STAMP should be used.
serialVersionOnStream
int serialVersionOnStream
The version of the serialized data on the stream. Possible values:
0 or not present on stream
JDK 1.1.5 or earlier.
1
JDK 1.1.6 or later. Writes a correct 'time' value
as well as compatible values for other fields. This is a
transitional format.
When streaming out this class, the most recent format
and the highest allowable serialVersionOnStream
is written.
The point at which the Gregorian calendar rules are used, measured in
milliseconds from the standard epoch. Default is October 15, 1582
(Gregorian) 00:00:00 UTC or -12219292800000L. For this value, October 4,
1582 (Julian) is followed by October 15, 1582 (Gregorian). This
corresponds to Julian day number 2299161.
Save the state of the HashMap instance to a stream (i.e.,
serialize it).
Serial Data:
The capacity of the HashMap (the length of the
bucket array) is emitted (int), followed by the
size of the HashMap (the number of key-value
mappings), followed by the key (Object) and value (Object)
for each key-value mapping represented by the HashMap
The key-value mappings are emitted in no particular order.
Serialized Fields
threshold
int threshold
The table is rehashed when its size exceeds this threshold. (The
value of this field is (int)(capacity * loadFactor).)
Save the state of this HashSet instance to a stream (that is,
serialize this set).
Serial Data:
The capacity of the backing HashMap instance
(int), and its load factor (float) are emitted, followed by
the size of the set (the number of elements it contains)
(int), followed by all of its elements (each an Object) in
no particular order.
Save the state of the Hashtable to a stream (i.e., serialize it).
Serial Data:
The capacity of the Hashtable (the length of the
bucket array) is emitted (int), followed by the
size of the Hashtable (the number of key-value
mappings), followed by the key (Object) and value (Object)
for each key-value mapping represented by the Hashtable
The key-value mappings are emitted in no particular order.
Serialized Fields
threshold
int threshold
The table is rehashed when its size exceeds this threshold. (The
value of this field is (int)(capacity * loadFactor).)
The first three fields are three String objects:
the first is a 2-letter ISO 639 code representing the locale's language,
the second is a 2-letter ISO 3166 code representing the locale's region or
country, and the third is an optional chain of variant codes defined by this
library. Any of the fields may be the empty string. The fourth field is an
intrepresenting the locale's hash code, but is ignored by
readObject(). Whatever this field's value, the hash code is
initialized to -1, a sentinel value that indicates the hash code must be
recomputed.
The first three fields are three String objects:
the first is a 2-letter ISO 639 code representing the locale's language,
the second is a 2-letter ISO 3166 code representing the locale's region or
country, and the third is an optional chain of variant codes defined by this
library. Any of the fields may be the empty string. The fourth field is an
int whose value is always -1. This is a sentinel value indicating
the Locale's hash code must be recomputed.
The internal state associated with this pseudorandom number generator.
(The specs for the methods in this class describe the ongoing
computation of this value.)
Save the state of this object to a stream (i.e., serialize it).
Serial Data:
We write out two formats, a JDK 1.1 compatible format, using
DOW_IN_MONTH_MODE rules, in the required section, followed
by the full rules, in packed format, in the optional section. The
optional section will be ignored by JDK 1.1 code upon stream in.
Contents of the optional section: The length of a byte array is
emitted (int); this is 4 as of this release. The byte array of the given
length is emitted. The contents of the byte array are the true values of
the fields startDay, startDayOfWeek,
endDay, and endDayOfWeek. The values of these
fields in the required section are approximate values suited to the rule
mode DOW_IN_MONTH_MODE, which is the only mode recognized by
JDK 1.1.
Serialized Fields
startMonth
int startMonth
The month in which daylight savings time starts. This value must be
between Calendar.JANUARY and
Calendar.DECEMBER inclusive. This value must not equal
endMonth.
If useDaylight is false, this value is ignored.
startDay
int startDay
This field has two possible interpretations:
startMode == DOW_IN_MONTH
startDay indicates the day of the month of
startMonth on which daylight
savings time starts, from 1 to 28, 30, or 31, depending on the
startMonth.
startMode != DOW_IN_MONTH
startDay indicates which startDayOfWeek in th
month startMonth daylight
savings time starts on. For example, a value of +1 and a
startDayOfWeek of Calendar.SUNDAY indicates the
first Sunday of startMonth. Likewise, +2 would indicate the
second Sunday, and -1 the last Sunday. A value of 0 is illegal.
If useDaylight is false, this value is ignored.
startDayOfWeek
int startDayOfWeek
The day of the week on which daylight savings time starts. This value
must be between Calendar.SUNDAY and
Calendar.SATURDAY inclusive.
If useDaylight is false or
startMode == DAY_OF_MONTH, this value is ignored.
startTime
int startTime
The time in milliseconds after midnight at which daylight savings
time starts. This value is expressed as wall time, standard time,
or UTC time, depending on the setting of startTimeMode.
If useDaylight is false, this value is ignored.
startTimeMode
int startTimeMode
The format of startTime, either WALL_TIME, STANDARD_TIME, or UTC_TIME.
Since:
JDK 1.3
endMonth
int endMonth
The month in which daylight savings time ends. This value must be
between Calendar.JANUARY and
Calendar.UNDECIMBER. This value must not equal
startMonth.
If useDaylight is false, this value is ignored.
endDay
int endDay
This field has two possible interpretations:
endMode == DOW_IN_MONTH
endDay indicates the day of the month of
endMonth on which daylight
savings time ends, from 1 to 28, 30, or 31, depending on the
endMonth.
endMode != DOW_IN_MONTH
endDay indicates which endDayOfWeek in th
month endMonth daylight
savings time ends on. For example, a value of +1 and a
endDayOfWeek of Calendar.SUNDAY indicates the
first Sunday of endMonth. Likewise, +2 would indicate the
second Sunday, and -1 the last Sunday. A value of 0 is illegal.
If useDaylight is false, this value is ignored.
endDayOfWeek
int endDayOfWeek
The day of the week on which daylight savings time ends. This value
must be between Calendar.SUNDAY and
Calendar.SATURDAY inclusive.
If useDaylight is false or
endMode == DAY_OF_MONTH, this value is ignored.
endTime
int endTime
The time in milliseconds after midnight at which daylight savings
time ends. This value is expressed as wall time, standard time,
or UTC time, depending on the setting of endTimeMode.
If useDaylight is false, this value is ignored.
endTimeMode
int endTimeMode
The format of endTime, either WALL_TIME, STANDARD_TIME, or UTC_TIME.
Since:
JDK 1.3
startYear
int startYear
The year in which daylight savings time is first observed. This is an AD
value. If this value is less than 1 then daylight savings is observed
for all AD years.
If useDaylight is false, this value is ignored.
rawOffset
int rawOffset
The offset in milliseconds between this zone and GMT. Negative offsets
are to the west of Greenwich. To obtain local standard time,
add the offset to GMT time. To obtain local wall time it may also be
necessary to add dstSavings.
useDaylight
boolean useDaylight
A boolean value which is true if and only if this zone uses daylight
savings time. If this value is false, several other fields are ignored.
monthLength
byte[] monthLength
This field was serialized in JDK 1.1, so we have to keep it that way
to maintain serialization compatibility. However, there's no need to
recreate the array each time we create a new time zone.
An array of bytes containing the values {31, 28, 31, 30, 31, 30,
31, 31, 30, 31, 30, 31}. This is ignored as of the Java 2 platform v1.2, however, it must
be streamed out for compatibility with JDK 1.1.
startMode
int startMode
Variables specifying the mode of the start rule. Takes the following
values:
DOM_MODE
Exact day of week; e.g., March 1.
DOW_IN_MONTH_MODE
Day of week in month; e.g., last Sunday in March.
DOW_GE_DOM_MODE
Day of week after day of month; e.g., Sunday on or after March 15.
DOW_LE_DOM_MODE
Day of week before day of month; e.g., Sunday on or before March 15.
The setting of this field affects the interpretation of the
startDay field.
If useDaylight is false, this value is ignored.
Since:
JDK1.1.4
endMode
int endMode
Variables specifying the mode of the end rule. Takes the following
values:
DOM_MODE
Exact day of week; e.g., March 1.
DOW_IN_MONTH_MODE
Day of week in month; e.g., last Sunday in March.
DOW_GE_DOM_MODE
Day of week after day of month; e.g., Sunday on or after March 15.
DOW_LE_DOM_MODE
Day of week before day of month; e.g., Sunday on or before March 15.
The setting of this field affects the interpretation of the
endDay field.
If useDaylight is false, this value is ignored.
Since:
JDK1.1.4
dstSavings
int dstSavings
A positive value indicating the amount of time saved during DST in
milliseconds.
Typically one hour (3600000); sometimes 30 minutes (1800000).
If useDaylight is false, this value is ignored.
Since:
JDK1.1.4
serialVersionOnStream
int serialVersionOnStream
The version of the serialized data on the stream. Possible values:
0 or not present on stream
JDK 1.1.3 or earlier.
1
JDK 1.1.4 or later. Includes three new fields: startMode,
endMode, and dstSavings.
2
JDK 1.3 or later. Includes two new fields: startTimeMode
and endTimeMode.
When streaming out this class, the most recent format
and the highest allowable serialVersionOnStream
is written.
The string identifier of this TimeZone. This is a
programmatic identifier used internally to look up TimeZone
objects from the system table and also to map them to their localized
display names. ID values are unique in the system
table but may not be for dynamically created zones.
Save the state of the TreeMap instance to a stream (i.e.,
serialize it).
Serial Data:
The size of the TreeMap (the number of key-value
mappings) is emitted (int), followed by the key (Object)
and value (Object) for each key-value mapping represented
by the TreeMap. The key-value mappings are emitted in
key-order (as determined by the TreeMap's Comparator,
or by the keys' natural ordering if the TreeMap has no
Comparator).
Save the state of the TreeSet instance to a stream (that is,
serialize it).
Serial Data:
Emits the comparator used to order this set, or
null if it obeys its elements' natural ordering
(Object), followed by the size of the set (the number of
elements it contains) (int), followed by all of its
elements (each an Object) in order (as determined by the
set's Comparator, or by the elements' natural ordering if
the set has no Comparator).
The array buffer into which the components of the vector are
stored. The capacity of the vector is the length of this array buffer,
and is at least large enough to contain all the vector's elements.
Any array elements following the last element in the Vector are null.
elementCount
int elementCount
The number of valid components in this Vector object.
Components elementData[0] through
elementData[elementCount-1] are the actual items.
capacityIncrement
int capacityIncrement
The amount by which the capacity of the vector is automatically
incremented when its size becomes greater than its capacity. If
the capacity increment is less than or equal to zero, the capacity
of the vector is doubled each time it needs to grow.
Contains the remaining unresolved part of the second
"name" argument to Context.rename().
This information necessary for
continuing the Context.rename() operation.
This field is initialized to null.
It should not be manipulated directly: it should
be accessed and updated using getRemainingName() and setRemainingName().
Contains the environment
relevant for the Context or DirContext method that cannot proceed.
This field is initialized to null.
It should not be manipulated directly: it should be accessed
and updated using getEnvironment() and setEnvironment().
Contains the name of the resolved object, relative
to the context altNameCtx. It is a composite name.
If null, then no name is specified.
See the javax.naming.spi.ObjectFactory.getObjectInstance
method for details on how this is used.
This field is initialized to null.
It should not be manipulated directly: it should
be accessed and updated using getAltName() and setAltName().
Contains the context relative to which
altName is specified. If null, then the default initial
context is implied.
See the javax.naming.spi.ObjectFactory.getObjectInstance
method for details on how this is used.
This field is initialized to null.
It should not be manipulated directly: it should
be accessed and updated using getAltNameCtx() and setAltNameCtx().
Contains the part of the link that has been successfully resolved.
It is a composite name and can be null.
This field is initialized by the constructors.
You should access and manipulate this field
through its get and set methods.
Contains the object to which resolution of the part of the link was successful.
Can be null. This field is initialized by the constructors.
You should access and manipulate this field
through its get and set methods.
Contains the remaining link name that has not been resolved yet.
It is a composite name and can be null.
This field is initialized by the constructors.
You should access and manipulate this field
through its get and set methods.
Contains the exception of why resolution of the link failed.
Can be null. This field is initialized by the constructors.
You should access and manipulate this field
through its get and set methods.
Records whether the name of this NameClassPair
is relative to the target context.
It is initialized by the constructor and can be updated using
setRelative().
Contains the part of the name that has been successfully resolved.
It is a composite name and can be null.
This field is initialized by the constructors.
You should access and manipulate this field
through its get and set methods.
Contains the object to which resolution of the part of the name was
successful. Can be null.
This field is initialized by the constructors.
You should access and manipulate this field
through its get and set methods.
Contains the remaining name that has not been resolved yet.
It is a composite name and can be null.
This field is initialized by the constructors.
You should access and manipulate this field
through its get, set, "append" methods.
Contains the original exception that caused this NamingException to
be thrown. This field is set if there is additional
information that could be obtained from the original
exception, or if there original exception could not be
mapped to a subclass of NamingException.
Can be null. This field is initialized by the constructors.
You should access and manipulate this field
through its get and set methods.
Holds the attribute's id. It is initialized by the public constructor and
cannot be null unless methods in BasicAttribute that use attrID
have been overridden.
ordered
boolean ordered
A flag for recording whether this attribute's values are ordered.
Contains the list of attributes to be returned in
SearchResult for each matching entry of search. null
indicates that all attributes are to be returned.
Field containing the Object that was resolved to successfully.
It can be null only when constructed using a subclass.
Constructors should always initialize this.
Field containing the remaining name yet to be resolved.
It can be null only when constructed using a subclass.
Constructors should always initialize this.
The length of the IOR type ID (int), followed by the IOR type ID
(byte array encoded using ISO8859-1), followed by the number of IOR profiles
(int), followed by the IOR profiles. Each IOR profile is written as a
profile tag (int), followed by the length of the profile data (int), followed
by the profile data (byte array).
The media position when the event occurred, expressed in sample frames.
Note that this field is only relevant to certain events generated by
data lines, such as START and STOP. For
events generated by lines that do not count sample frames, and for any
other events for which this value is not known, the position value
should be AudioSystem.NOT_SPECIFIED.
Writes default serializable fields to stream. Writes
a list of serializable ItemListener(s) as optional data.
The non-serializable ItemListner(s) are detected and
no attempt is made to serialize them.
Before writing a JComponent to an ObjectOutputStream we temporarily
uninstall its UI. This is tricky to do because we want to uninstall
the UI before any of the JComponent's children (or its LayoutManager etc.)
are written, and we don't want to restore the UI until the most derived
JComponent subclass has been been stored.
Before writing a JComponent to an ObjectOutputStream we temporarily
uninstall its UI. This is tricky to do because we want to uninstall
the UI before any of the JComponent's children (or its LayoutManager etc.)
are written, and we don't want to restore the UI until the most derived
JComponent subclass has been been stored.
Set to true when a KEY_PRESSED event is received and the menu is
selected, and false when a KEY_RELEASED (or focus lost) is received.
If processKeyEvent is invoked with a KEY_TYPED or KEY_RELEASED event,
and this is false, a MenuKeyEvent is NOT created. This is needed to
avoid activating a menuitem when the menu and menuitem share the
same mnemonic.
Before writing a JComponent to an ObjectOutputStream we temporarily
uninstall its UI. This is tricky to do because we want to uninstall
the UI before any of the JComponent's children (or its LayoutManager etc.)
are written, and we don't want to restore the UI until the most derived
JComponent subclass has been been stored.
Before writing a JComponent to an ObjectOutputStream we temporarily
uninstall its UI. This is tricky to do because we want to uninstall
the UI before any of the JComponent's children (or its LayoutManager etc.)
are written, and we don't want to restore the UI until the most derived
JComponent subclass has been been stored.
Before writing a JComponent to an ObjectOutputStream we temporarily
uninstall its UI. This is tricky to do because we want to uninstall
the UI before any of the JComponent's children (or its LayoutManager etc.)
are written, and we don't want to restore the UI until the most derived
JComponent subclass has been been stored.
Serialized Fields
messageType
int messageType
Message type.
optionType
int optionType
Option type, one of DEFAULT_OPTION, YES_NO_OPTION,
YES_NO_CANCEL_OPTION or OK_CANCEL_OPTION.
wantsInput
boolean wantsInput
If true, a UI widget will be provided to the user to get input.
Before writing a JComponent to an ObjectOutputStream we temporarily
uninstall its UI. This is tricky to do because we want to uninstall
the UI before any of the JComponent's children (or its LayoutManager etc.)
are written, and we don't want to restore the UI until the most derived
JComponent subclass has been been stored.
A optional String that can be displayed on the progress bar.
The default is null. Setting this to a non-null value does not
imply that the String will be displayed.
paintString
boolean paintString
Whether to textually display a String on the progress bar.
The default is false. Setting this to true will cause a textual
display of the progress to de rendered on the progress bar. If
the progressString is null, the percentage done to be displayed
on the progress bar. If the progressString is non-null, it is
rendered on the progress bar.
As of Java 2 platform v1.3 this unusable field is no longer used.
To override the default button you should replace the Action
in the JRootPane's ActionMap. Please refer to
the key bindings specification for further details.
As of Java 2 platform v1.3 this unusable field is no longer used.
To override the default button you should replace the Action
in the JRootPane's ActionMap. Please refer to
the key bindings specification for further details.
Set to true when the unit increment has been explicitly set.
If this is false the viewport's view is obtained and if it
is an instance of Scrollable the unit increment
from it is used.
blockIncrementSet
boolean blockIncrementSet
Set to true when the block increment has been explicitly set.
If this is false the viewport's view is obtained and if it
is an instance of Scrollable the block increment
from it is used.
If true, the knob (and the data value it represents)
resolve to the closest tick mark next to where the user
positioned the knob. The default is false.
The changeListener (no suffix) is the listener we add to the
Sliders model. By default this listener just forwards events
to ChangeListeners (if any) added directly to the slider.
Used by the Scrollable interface to determine the initial visible area.
rowSelectionAllowed
boolean rowSelectionAllowed
True if row selection is allowed in this table.
cellSelectionEnabled
boolean cellSelectionEnabled
Obsolete as of Java 2 platform v1.3. Please use the
rowSelectionAllowed property and the
columnSelectionAllowed property of the
columnModel instead. Or use the
method getCellSelectionEnabled.
Before writing a JComponent to an ObjectOutputStream we temporarily
uninstall its UI. This is tricky to do because we want to uninstall
the UI before any of the JComponent's children (or its LayoutManager etc.)
are written, and we don't want to restore the UI until the most derived
JComponent subclass has been been stored.
Serialized Fields
rootVisible
boolean rootVisible
True if the root node is displayed, false if its children are
the highest visible nodes.
rowHeight
int rowHeight
Height to use for each display row. If this is <= 0 the renderer
determines the height for each row.
showsRootHandles
boolean showsRootHandles
True if handles are displayed at the topmost level of the tree.
A handle is a small icon that displays adjacent to the node which
allows the user to click once to expand or collapse the node. A
common interface shows a plus sign (+) for a node which can be
expanded and a minus sign (-) for a node which can be collapsed.
Handles are always shown for nodes below the topmost level.
If the rootVisible setting specifies that the root
node is to be displayed, then that is the only node at the topmost
level. If the root node is not displayed, then all of its
children are at the topmost level of the tree. Handles are
always displayed for nodes other than the topmost.
If the root node isn't visible, it is generally a good to make
this value true. Otherwise, the tree looks exactly like a list,
and users may not know that the "list entries" are actually
tree nodes.
Is this tree a large model? This is a code-optimization setting.
A large model can be used when the cell height is the same for all
nodes. The UI will then cache very little information and instead
continually message the model. Without a large model the UI caches
most of the information, resulting in fewer method calls to the model.
This value is only a suggestion to the UI. Not all UIs will
take advantage of it. Default value is false.
visibleRowCount
int visibleRowCount
Number of rows to make visible at one time. This value is used for
the Scrollable interface. It determines the preferred
size of the display area.
invokesStopCellEditing
boolean invokesStopCellEditing
If true, when editing is to be stopped by way of selection changing,
data in tree changing or other means stopCellEditing
is invoked, and changes are saved. If false,
cancelCellEditing is invoked, and changes
are discarded. Default is false.
scrollsOnExpand
boolean scrollsOnExpand
If true, when a node is expanded, as many of the descendants are
scrolled to be visible.
The last viewPosition that we've painted, so we know how
much of the backing store image is valid.
backingStore
boolean backingStore
Deprecated.As of Java 2 platform v1.3
True when this viewport is maintaining an offscreen image of its
contents, so that some scrolling can take place using fast "bit-blit"
operations instead of by accessing the view object to construct the
display. The default is false.
The scrollUnderway flag is used for components like
JList. When the downarrow key is pressed on a
JList and the selected
cell is the last in the list, the scrollpane autoscrolls.
Here, the old selected cell needs repainting and so we need
a flag to make the viewport do the optimized painting
only when there is an explicit call to
setViewPosition(Point).
When setBounds is called through other routes,
the flag is off and the view repaints normally. Another approach
would be to remove this from the JViewport
class and have the JList manage this case by using
setBackingStoreEnabled. The default is false.
Handles mouse events from both this class, and the split pane.
Mouse events are handled for the splitpane since you want to be able
to drag when clicking on the border of the divider, which is not
drawn by the divider.
The index of the column in the model which is to be displayed by
this TableColumn. As columns are moved around in the
view modelIndex remains constant.
This object is not used internally by the drawing machinery of
the JTable; identifiers may be set in the
TableColumn as as an
optional way to tag and locate table columns. The table package does
not modify or invoke any methods in these identifer objects other
than the equals method which is used in the
getColumnIndex() method in the
DefaultTableColumnModel.
Factory for the attributes. This is the strategy for
attribute compression and control of the lifetime of
a set of attributes as a collection. This may be shared
with other documents.
Number of immutable sets that are not currently
being used. This helps indicate when the sets need
to be cleaned out of the hashtable they are stored
in.
This listener will be attached to the caret of
the text component that the EditorKit gets installed
into. This should keep the input attributes updated
for use by the styled actions.
The location to resolve relative URLs against. By
default this will be the document's URL if the document
was loaded from a URL. If a base tag is found and
can be parsed, it will be used as the base location.
An inverted graph of the selectors. Each key will be a String tag,
and each value will be a Hashtable. Further the key RULE is used
for the styles attached to the particular location, and
SPECIFICITY is used to indicate the specificity.
Determines how the isLeaf method figures
out if a node is a leaf node. If true, a node is a leaf
node if it does not allow children. (If it allows
children, it is not a leaf node, even if no children
are present.) That lets you distinguish between folder
nodes and file nodes in a file system, for example.
If this value is false, then any node which has no
children is a leaf node, and any node may acquire
children.
Submit a bug or feature For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 1993-2001 Sun Microsystems, Inc. 901 San Antonio Road Palo Alto, California, 94303, U.S.A. All Rights Reserved.