|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference 11g Release 1 (11.1.1.4.0) E13403-05 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjava.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JPanel
oracle.ide.panels.DefaultTraversablePanel
oracle.ide.net.URLChooser
public class URLChooser
The URLChooser is a replacement file chooser for JFileChooser. The URLChooser is designed to
work in terms of URL rather than File instances.
In general, most client code should not call the
URLChooser constructors directly. Instead, use one of the
DialogUtil.newURLChooser() variants, as this ensures that the
chooser will be initialized consistently throughout the application.
When the URLChooser must be subclassed, however, the
constructors can be called directly but this should be followed by a
call to DialogUtil.initURLChooser(URLChooser,oracle.ide.Context).
| Nested Class Summary |
|---|
| Nested classes/interfaces inherited from class javax.swing.JPanel |
|---|
javax.swing.JPanel.AccessibleJPanel |
| Nested classes/interfaces inherited from class javax.swing.JComponent |
|---|
javax.swing.JComponent.AccessibleJComponent |
| Nested classes/interfaces inherited from class java.awt.Container |
|---|
java.awt.Container.AccessibleAWTContainer |
| Nested classes/interfaces inherited from class java.awt.Component |
|---|
java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy |
| Field Summary | |
|---|---|
static URLFilter |
ALL_FILES_FILTER
The standard "All Files (*.*)" URLFilter for accepting all
URLs. |
static int |
APPROVE_OPTION
Return value from showOpenDialog(...) and
showSaveDialog(...) methods if open/save is chosen. |
static int |
CANCEL_OPTION
Return value from showOpenDialog(...) and
showSaveDialog(...) methods if cancel is chosen. |
static int |
DIRECTORIES_ONLY
|
static int |
DIRECTORIES_OR_FILES
|
static int |
ERROR_OPTION
Return value from showOpenDialog(...) and
showSaveDialog(...) methods if an I/O error occurred. |
static int |
FILES_ONLY
|
protected static java.lang.String |
HELP_TOPIC_SELECT_DIRECTORIES
|
protected static java.lang.String |
HELP_TOPIC_SELECT_FILES
|
protected static java.lang.String |
HELP_TOPIC_SELECT_FILES_OR_DIRECTORIES
|
static int |
MULTIPLE_INTERVAL_SELECTION
A value for setSelectionMode(int) meaning that one or
more continuous ranges of files can be selected at a time. |
static int |
SINGLE_INTERVAL_SELECTION
A value for setSelectionMode(int) meaning that one
continuous range of files can be selected at a time. |
static int |
SINGLE_SELECTION
A value for setSelectionMode(int) meaning that one
file can be selected at a time. |
| Fields inherited from class javax.swing.JComponent |
|---|
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
| Fields inherited from class java.awt.Component |
|---|
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
| Fields inherited from interface oracle.ide.controls.GridBagConstants |
|---|
ANCHOR_C, ANCHOR_E, ANCHOR_N, ANCHOR_NE, ANCHOR_NW, ANCHOR_S, ANCHOR_SE, ANCHOR_SW, ANCHOR_W, FILL_NONE, FILL_X, FILL_XY, FILL_Y |
| Fields inherited from interface java.awt.image.ImageObserver |
|---|
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
| Constructor Summary | |
|---|---|
URLChooser()
Constructs a default URLChooser with all file system
roots as reported by URLFileSystem.listRoots(). |
|
URLChooser(java.net.URL defaultSelection)
Constructs a default URLChooser with all file system
roots as reported by URLFileSystem.listRoots(). |
|
URLChooser(java.net.URL[] roots,
java.net.URL defaultSelection)
Constructs a URLFilter to display the specified
array of URLs as its "root" file systems and the
specified URL as the default selection. |
|
URLChooser(java.net.URL[] roots,
java.net.URL defaultSelection,
boolean showJarsAsDirs)
Deprecated. Replace with URLChooser(URL[],URL) and setShowJarsAsDirs(boolean). |
|
URLChooser(java.net.URL defaultSelection,
boolean showJarsAsDirs)
Deprecated. Replace with URLChooser(URL) and setShowJarsAsDirs(boolean). |
|
| Method Summary | |
|---|---|
boolean |
accept(java.net.URL url)
Returns true if the specified URL should be
displayed in the URLChooser. |
void |
addChooseableURLFilter(URLFilter filter)
Adds the specified URLFilter to be one of the filters
that are shown in the "File type" combo box. |
void |
addNotify()
|
void |
addShortcutButton(javax.swing.Icon icon,
java.lang.String description,
java.net.URL url)
This method adds a shortcut button to the button panel on the left side of the URLChooser. |
void |
addURLChooserListener(oracle.ide.net.URLChooserListener ucl)
Add a URLChooserListener to this URLChooser |
boolean |
approveSelection()
|
void |
cancelSelection()
This method is called when the URLChooser is being
canceled. |
protected java.net.URL |
canonicalizeApprovalURL(java.net.URL url)
Template helper method for approveSelection() to
canonicalize the URL to be approved. |
void |
changeToParentDirectory()
|
protected boolean |
checkApprovalParentExists(java.net.URL url)
Template helper method for approveSelection() to check that
the parent directory for the approval URL exists. |
void |
clearChooseableURLFilters()
Clears the list of chooseable URLFilters. |
void |
flush()
Clears the results of all file system queries that have been cached by the URLChooser, so a single chooser instance can be
reused multiple times in a session. |
protected java.net.URL |
getApprovalFileListURL()
Template helper method for approveSelection() and
getSelectedURL() to get the URL of the selected
node in the file list. |
URLFilter[] |
getChooseableURLFilters()
Returns all of the URLFilters shown in the "File type" combo
box as an array. |
DialogRunnerCallback |
getDialogRunnerCallback()
|
java.net.URL[] |
getExtraURLs()
Returns an array containing all URLs that have been
registered as "extra" URLs; returns null if
no URLs have previously been registed via setExtraURLs(URL[]). |
java.lang.String |
getFileNameURL()
|
URLFilter |
getSelectedFilter()
Returns the URLFilter that is currently selected in the
file type combo box. |
java.net.URL |
getSelectedURL()
Returns the URL of the node (which may be a directory or
a file) that is currently selected in the URLChooser. |
java.net.URL[] |
getSelectedURLs()
Returns an array of URLs representing the current
selections in the URLChooser. |
boolean |
getShowJarsAsDirs()
Returns whether the URLChooser allows browsing into
archives. |
void |
removeNotify()
|
void |
removeShortcutButtons()
Removes all shortcut buttons from the button panel on the left side of the URLChooser, allowing the URLChooser
instance to be reused in a different context without retaining the
existing shortcut buttons. |
void |
removeURLChooserListener(oracle.ide.net.URLChooserListener ucl)
Remove a URLChooserListener from this URLChooser |
void |
setDialogRunnerCallback(DialogRunnerCallback callBack)
|
void |
setExtraURLs(java.net.URL[] extraURLs)
Registers a URL array that corresponds to resources that
exist only in memory and not in the file system (for example, unsaved
files). |
void |
setFileNameURL(java.lang.String text)
|
void |
setRoots(java.net.URL[] roots)
Sets the root URLs that will be traversed by the
URLChooser. |
void |
setSelectedURL(java.net.URL selection)
Sets the selected directory such that the specified URL
is shown in the file list. |
void |
setSelectionMode(int selectionMode)
Sets the selection mode for the URLChooser. |
void |
setSelectionScope(int selectionScope)
Valid values are FILES_ONLY and DIRECTORIES_ONLY. |
void |
setShowJarsAsDirs(boolean showJarsAsDirs)
Sets whether the URLChooser should allow browsing into
archives. |
void |
setURLFilter(URLFilter filter)
Sets the active URLFilter. |
int |
showOpenDialog(java.awt.Component parent)
|
int |
showOpenDialog(java.awt.Component parent,
java.lang.String title)
|
int |
showOpenDialog(java.awt.Component parent,
Traversable content,
java.lang.String title)
|
int |
showSaveDialog(java.awt.Component parent)
|
int |
showSaveDialog(java.awt.Component parent,
java.lang.String title)
|
int |
showSaveDialog(java.awt.Component parent,
Traversable content,
java.lang.String title)
|
| Methods inherited from class oracle.ide.panels.DefaultTraversablePanel |
|---|
gbc, gbc, getComponent, getDefaultTitle, getExitTransition, getHelpID, getText, onEntry, onExit, setDefaultTitle, setHelpID |
| Methods inherited from class javax.swing.JPanel |
|---|
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI |
| Methods inherited from class javax.swing.JComponent |
|---|
addAncestorListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update |
| Methods inherited from class java.awt.Container |
|---|
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree |
| Methods inherited from class java.awt.Component |
|---|
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Field Detail |
|---|
public static final URLFilter ALL_FILES_FILTER
URLFilter for accepting all
URLs.
public static final int CANCEL_OPTION
showOpenDialog(...) and
showSaveDialog(...) methods if cancel is chosen.
public static final int APPROVE_OPTION
showOpenDialog(...) and
showSaveDialog(...) methods if open/save is chosen.
public static final int ERROR_OPTION
showOpenDialog(...) and
showSaveDialog(...) methods if an I/O error occurred.
public static final int MULTIPLE_INTERVAL_SELECTION
setSelectionMode(int) meaning that one or
more continuous ranges of files can be selected at a time.
public static final int SINGLE_INTERVAL_SELECTION
setSelectionMode(int) meaning that one
continuous range of files can be selected at a time.
public static final int SINGLE_SELECTION
setSelectionMode(int) meaning that one
file can be selected at a time.
public static final int FILES_ONLY
public static final int DIRECTORIES_ONLY
public static final int DIRECTORIES_OR_FILES
protected static final java.lang.String HELP_TOPIC_SELECT_FILES
protected static final java.lang.String HELP_TOPIC_SELECT_DIRECTORIES
protected static final java.lang.String HELP_TOPIC_SELECT_FILES_OR_DIRECTORIES
| Constructor Detail |
|---|
public URLChooser()
URLChooser with all file system
roots as reported by URLFileSystem.listRoots(). No
default (directory or file) is set.
public URLChooser(java.net.URL defaultSelection)
URLChooser with all file system
roots as reported by URLFileSystem.listRoots(). The
specified URL is used as the default selection; if
null, there will be no default selection.
public URLChooser(java.net.URL[] roots,
java.net.URL defaultSelection)
URLFilter to display the specified
array of URLs as its "root" file systems and the
specified URL as the default selection. The "root"
file systems only need to be directories and don't necessarily
have to be actual file system roots.
public URLChooser(java.net.URL defaultSelection,
boolean showJarsAsDirs)
URLChooser(URL) and setShowJarsAsDirs(boolean).
public URLChooser(java.net.URL[] roots,
java.net.URL defaultSelection,
boolean showJarsAsDirs)
URLChooser(URL[],URL) and setShowJarsAsDirs(boolean).
| Method Detail |
|---|
public void setExtraURLs(java.net.URL[] extraURLs)
URL array that corresponds to resources that
exist only in memory and not in the file system (for example, unsaved
files). While it is allowable to register a URL for a
resource that physically does exist, it is not recommended for
performance reasons.
Nonexistent extra resources registered in this manner will appear in
the URLChooser file list in italic font. This allows
the user to distinguish between actual file system resources and
in-memory only resources.
Extra resources should be registered each time the
URLChooser becomes displayed, and they should be cleared
each time it becomes undisplayed. Displayability changes to the
URLChooser can be detected by adding a HierarchyListener to it with Component.addHierarchyListener(java.awt.event.HierarchyListener).
extraURLs - the URL array specifying all in-memory only
resources, or null to clear the previously registered
URLs.HierarchyEvent.SHOWING_CHANGEDpublic java.net.URL[] getExtraURLs()
URLs that have been
registered as "extra" URLs; returns null if
no URLs have previously been registed via setExtraURLs(URL[]).
public void setDialogRunnerCallback(DialogRunnerCallback callBack)
public DialogRunnerCallback getDialogRunnerCallback()
public void setShowJarsAsDirs(boolean showJarsAsDirs)
URLChooser should allow browsing into
archives.
public boolean getShowJarsAsDirs()
URLChooser allows browsing into
archives.
public boolean accept(java.net.URL url)
true if the specified URL should be
displayed in the URLChooser. Returns
false otherwise.
public void addChooseableURLFilter(URLFilter filter)
URLFilter to be one of the filters
that are shown in the "File type" combo box. If the specified
filter is null or if the specified filter has
already been added, this method does nothing.
public void clearChooseableURLFilters()
URLFilters.
public URLFilter[] getChooseableURLFilters()
URLFilters shown in the "File type" combo
box as an array. If there are no filters, then an empty array is
returned.
public void addShortcutButton(javax.swing.Icon icon,
java.lang.String description,
java.net.URL url)
URLChooser. When the user clicks
on the shortcut button, the current location of the
URLChooser will be changed to be the URL
URL.
If the specified URL is null, this method
does nothing. If no shortcut buttons are added, then the shortcut
panel is not drawn.
public void removeShortcutButtons()
URLChooser, allowing the URLChooser
instance to be reused in a different context without retaining the
existing shortcut buttons. The shortcut panel will no longer be
visible after calling this method.
public boolean approveSelection()
true if the URLChooser is ready
to be dismissed; false if the user's current
selection only indicates that a custom wildcard filter or
directory change should occur instead.public void cancelSelection()
URLChooser is being
canceled.
public void changeToParentDirectory()
public java.net.URL getSelectedURL()
URL of the node (which may be a directory or
a file) that is currently selected in the URLChooser.
public java.lang.String getFileNameURL()
public void setFileNameURL(java.lang.String text)
public java.net.URL[] getSelectedURLs()
URLs representing the current
selections in the URLChooser. This array will
contain only one element if there is only one selection or
if the user typed the name of the file into the text field.
public void setSelectionMode(int selectionMode)
URLChooser. By
default, the URLChooser allows multiple interval
selection.
selectionMode - The specified mode must be one of
MULTIPLE_INTERVAL_SELECTION,
SINGLE_INTERVAL_SELECTION, or SINGLE_SELECTION.
java.lang.IllegalArgumentException - if the specified
selection mode is not one of the legal vales.public void setRoots(java.net.URL[] roots)
URLs that will be traversed by the
URLChooser. The roots can be any URL
that represents a directory. Even directories within jar
files are allowed.
public void setSelectedURL(java.net.URL selection)
URL
is shown in the file list. If the URL itself is a
directory, then that directory is selected.
public void setSelectionScope(int selectionScope)
FILES_ONLY and DIRECTORIES_ONLY.
Note: This method must be called from the AWT event
thread.
public void setURLFilter(URLFilter filter)
URLFilter. If the filter isn't on
the list of filters used by the URLChooser it is
first added. If the specified URLFilter is
null, the default "all files" filter is set as the
current filter.
public void flush()
URLChooser, so a single chooser instance can be
reused multiple times in a session. It is not necessary to use this
method for a chooser instance that is used only once and then
released.
This method is generally called immediately after a call to
showOpenDialog() or showSaveDialog() has
completed. If it is called before showing the chooser dialog, then
it should be called before any other initialization of the chooser is
done.
public int showOpenDialog(java.awt.Component parent)
APPROVE_OPTION, CANCEL_OPTION, or
ERROR_OPTION.
public int showOpenDialog(java.awt.Component parent,
java.lang.String title)
APPROVE_OPTION, CANCEL_OPTION, or
ERROR_OPTION.
public int showOpenDialog(java.awt.Component parent,
Traversable content,
java.lang.String title)
APPROVE_OPTION, CANCEL_OPTION, or
ERROR_OPTION.public int showSaveDialog(java.awt.Component parent)
APPROVE_OPTION, CANCEL_OPTION, or
ERROR_OPTION.
public int showSaveDialog(java.awt.Component parent,
java.lang.String title)
APPROVE_OPTION, CANCEL_OPTION, or
ERROR_OPTION.
public int showSaveDialog(java.awt.Component parent,
Traversable content,
java.lang.String title)
APPROVE_OPTION, CANCEL_OPTION, or
ERROR_OPTION.protected java.net.URL canonicalizeApprovalURL(java.net.URL url)
approveSelection() to
canonicalize the URL to be approved.
The default implementation calls URLFileSystem.canonicalize(URL). Subclasses may override to
provide differing behavior.
protected java.net.URL getApprovalFileListURL()
approveSelection() and
getSelectedURL() to get the URL of the selected
node in the file list.
The default implementation gets the URL of the selected
node in the file list. Subclasses may wish to override to
return null in order to ignore the file list
selection.
protected boolean checkApprovalParentExists(java.net.URL url)
approveSelection() to check that
the parent directory for the approval URL exists.
The default implementation gets the parent of the specified URL via URLFileSystem.getParent(URL) and tests for that
directory's existence with URLFileSystem.exists(URL).
Subclasses may override to provide differing behavior (for example,
to always return true if the parent directory need not
exist).
public void addURLChooserListener(oracle.ide.net.URLChooserListener ucl)
URLChooserListener to this URLChooser
public void removeURLChooserListener(oracle.ide.net.URLChooserListener ucl)
URLChooserListener from this URLChooser
public void addNotify()
addNotify in class javax.swing.JComponentpublic void removeNotify()
removeNotify in class javax.swing.JComponentpublic final URLFilter getSelectedFilter()
URLFilter that is currently selected in the
file type combo box. The value returned by this method should
always be non-null.
|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK Reference 11g Release 1 (11.1.1.4.0) E13403-05 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||