This chapter is designed to get you up and running quickly on Oracle JDeveloper. Find information about working with the general development environment, source files, connections, using the online help, and common development tools.
This chapter includes the following sections:
JDeveloper is the main development platform for the Oracle Fusion Middleware suite of products. It is a cross-platform IDE that runs on Windows, Linux, Mac OS X, and other UNIX-based systems.
Roles enable you to tailor the JDeveloper environment. The modified environment removes items that you do not need from JDeveloper, including menus, preferences, New Gallery, and even individual fields on dialogs. The role you select determines which features and options are available to you as you work in JDeveloper.
The roles available are:
Default Role. This role allows you to access all JDeveloper features. The other roles provide subsets of these features.
Customization JDeveloper. This role allows you to create customizable applications, using the Oracle Metadata Services (MDS) framework.
Database Edition. This gives you access to just the core database development tools.
Java EE Edition. This includes only features for core Java EE development.
Java Edition. This includes only features for core Java development.
Note:
The full set of online help is always available regardless of the role you have chosen for JDeveloper.
JDeveloper prompts you to select a role the first time it is run. You can also change the role while JDeveloper is running.
To change the JDeveloper role:
From the main menu, select Tools > Switch Roles.
The current role contains a bullet next to it. In the Switch Roles menu, select the role you want to switch to.
To optimize performance and user experience, JDeveloper allows you to just load the features you need for your project. Managing features enables you to see only those components of the IDE that are most relevant to your work. Managing features has no affect on the data in a project itself.
For example, assume two projects used to create two different views into an application. The first project might have Java features loaded, which informs JDeveloper that the IDE should reflect the Java technology stack. Such filtering eliminates clutter from individual projects. The second project might have a features loaded for Swing/AWT, informing JDeveloper to reflect IDE components required for Swing/AWT development.
To add or remove features in JDeveloper:
From the main menu, select Tools > Features. The Manage Features for role dialog opens. This dialog displays the features available in the current JDeveloper role. These features are checked by default.
Search for the feature you want to add or remove by entering it in the Search field, or scroll in the list of Available Features. Click a feature or feature category and view its description on the right.
Check the features you want to add, and uncheck the features you want to remove. Click the Check for Updates icon to open the Check For Updates wizard which allows you to load features from an extension.
Optionally, to clear previously loaded features from the cache, click Clear Feature Loading Cache.
Click OK when you are done.
JDeveloper allows you to arrange the windows according to your convenience. JDeveloper uses two kinds of windows in the IDE:
Dockable windows that can be placed anywhere in the IDE.
Tabbed editor windows that are fixed in the center of the IDE.
Double-click the title bar of any JDeveloper window to quickly maximize to full screen view. Double-click the title bar again to return the window to its former position in the IDE.
You can minimize any dockable window in JDeveloper, or set it to remain open in place. The default state is set to remain open.
When a window is set to stay open, its position is static. It remains always visible, in whichever position you have docked it.
When a window is set to minimize, its behavior is more fluid. When you give it focus, it opens fully in the general area (top, bottom, left, right) where you last left it docked. When you move the focus elsewhere, the minimized window collapses into the margin. Whether open or closed, any minimized window's status set to minimize is identified by a named button in the margin.
To minimize any dockable window:
Click the Minimize icon in the far right-hand corner of the window set to be kept open.
If the window currently has focus, it now expands to full height and remains in place. If the window does not have focus, it collapses into the margin.
When you minimize a window, a button bearing that window's name appears in the margin. You can toggle the minimized window open and closed with this button.
Note:
When you minimize a window that exists in a docking zone that also contains other windows, all windows in the docking zone are minimized.
All of the tools available under the View menu—the Application Navigator, Structure window, Property Inspector, and so on—can be arranged however you like. You can dock them singly or in groups. You can also tab windows together in one location, either as docked or floating windows.
The following table provides information on how to move dockable windows.
Requirement | Action |
---|---|
Move a solitary docked window |
Grab its title bar and drag |
Decouple a docked window from a group |
Grab its title bar and drag |
Move a group of docked, tabbed, or docked and tabbed windows |
Grab the title bar for the group—the topmost horizontal title bar, empty but for the close box—and drag. |
To decouple one tabbed window from a group |
Grab the window's tab and drag. |
Note:
The title bars for docked windows sometimes appear vertically, on the side of the window.
The following table provides information on ways to reposition dock windows:
Requirement | Action |
---|---|
Dock a window (or window group) against another edge of the development area |
Drag the window (or window group) to the destination edge |
Dock a window (or window group) alongside another window |
Drag the window (or window group) to the top, bottom, or side edge of the docked window |
Tab one window with another |
Drag the window to be tabbed into the center of the destination window (or window group) and release |
You can float any window that's normally docked—the Application Navigator, any custom navigator, the Log window, the Property Inspector, the Component Palette. You can also resize and position it wherever you would like within JDeveloper.
Generally, floating windows are best suited for a large screen with enough room for displaying both the information windows and your source code. If you are using floating palettes on a smaller screen they can sometimes be hidden by other information windows as you work.
You can easily open and close the main elements of the JDeveloper IDE, which include the navigators, Structure window, Property Inspector, Component Palette, Resource Palette and Log window.
In the View menu, choose the name of the window.
You can close an open window in one of these ways:
Click the Close icon which appears on the tab window's name.
With the focus in the window, press Shift+Escape or Ctrl+Click.
You can accomplish any task in JDeveloper using the keyboard as you use the mouse.
JDeveloper comes with several predefined keyboard schemes. You can choose to use one of these, or customize an existing set to suit your own coding style by changing which keyboard shortcuts map to which actions.
To load preset keyboard schemes:
From the main menu, choose Tools > Preferences.
In the preferences dialog, select the Shortcut Keys node. For more information at any time, press F1 or click Help from within the Preferences dialog.
On the shortcut keys page, click More Actions and then select Load Keyboard Scheme. The Load Keyboard Scheme dialog appears, with the currently loaded keyboard scheme highlighted.
In the Load Keyboard Scheme dialog, select the scheme you wish to load and click Ok.
On the Shortcut Keys page, if you have finished, click Ok.
To view JDeveloper commands and their associated keyboard shortcuts (if assigned):
From the main menu, choose Tools > Preferences.
In the Preferences dialog, select the Shortcut Keys node.
On the Shortcut Keys page, under Available Commands, you can view the complete set of JDeveloper commands, and what keyboards shortcuts (if any) are assigned to each. If you are looking for a particular command or shortcut, or want to look at shortcuts for a particular category of commands only, enter a filtering expression in the Search field.
You can also define new shortcuts, or change existing ones.
To define a new keyboard shortcut for a command within a given keyboard scheme:
From the main menu, choose Tools > Preferences.
In the Preferences dialog, select the Shortcut Keys node. For more information at any time, press F1 or click Help from within the preferences dialog.
On the Shortcut Keys page, under Available Commands, select the command that you wish to define a new shortcut for.
To define a new shortcut for this action, place focus on the New Shortcut field, and then press the key combination on the keyboard.
If this proposed shortcut already has a command associated with it, that command will now appear in the Conflicts field. Any conflicting shortcuts are overwritten when a new shortcut is assigned.
To assign this shortcut to the action selected, click Assign. If you want to delete an already-assigned shortcut, click the Delete button in the toolbar.
If you want to assign more than one shortcut to a command, select the command and click the Duplicate button. Then, type the shortcut key in the New Shortcut field and click Assign.
When you are finished, click Ok.
To import or export keyboard schemes:
From the main menu, select Tools > Preferences to open the Preferences dialog.
Click More Actions > Export or Import. Keyboard schemes are stored as XML files.
For any action that can be accomplished with a mouse, including selection, there is a way to accomplish the action solely from the keyboard. You can accomplish any task in JDeveloper using the keyboard as you can using the mouse.
The shortcut keys defined in the Java Look and Feel guidelines provide the base set for JDeveloper. The various predefined keyboard schemes available in JDeveloper are then overlaid upon this base set. If the same shortcut key exists in both the look and feel guidelines and the JDeveloper keyboard scheme, the JDeveloper scheme prevails. If a shortcut key defined by the look and feel guidelines does not appear in a JDeveloper scheme, then it is the original look and feel definition that remains in effect when the scheme in question is enabled.
At any given time, then, the shortcut keys enabled in JDeveloper depend upon the interaction of the currently enabled scheme with the Java look and feel guidelines. When you first open JDeveloper, the default scheme is enabled. You can change this scheme whenever you wish, and within each scheme, you can customize any of the shortcut key assignments that you would like. Note that any customized shortcuts you create in a scheme are not retained when another predefined keyboard scheme is activated (or even if the same scheme is reloaded).
To load predefined keyboard schemes, view current shortcut assignments within a scheme, and customize those assignments, you will need to open the preferences dialog. To open the dialog, choose Tools > Preferences (or on the keyboard, press Alt+T+P) from the main menu and then, using the arrow keys in the left-hand pane, navigate to the Shortcut Keys node. For details on working with the dialog, with the page displayed, click Help (or on the keyboard press H).
The following table describes the common methods of moving the cursor in JDeveloper:
Table 3-1 Common Methods of Moving the Cursor
Key | Cursor Movement | Ctrl+cursor Movement |
---|---|---|
Left Arrow |
Left one unit (e.g., a single character) |
Left one proportionally larger unit (e.g., a whole word) |
Right Arrow |
Right one unit |
Right one proportionally larger unit |
Up Arrow |
Up one unit or line |
Up one proportionally larger unit |
Down Arrow |
Down one unit or line |
Down one proportionally larger unit |
Home |
Beginning of the line |
To the beginning of the data (top-most position) |
End |
End of the line |
To the end of the data (bottom-most position) |
Tab |
Next field or control, except when in a text area or field. In this case, press Ctrl+Tab to navigate out of the control. Where there are fields and controls ordered horizontally as well as vertically, pressing Tab moves the cursor first horizontally to the right, then at the end of the line, down to the left of the next line. |
To the next pane which may be a navigator, an editor, or a palette, except when in a text area or field. In this case, press Ctrl+Tab to navigate out of the control |
Shift+Tab |
Previous field |
To previous tab position. In property sheets, this moves the cursor to the next page |
Enter |
Selects and highlights the default button, except when in a combo box, shuttle button, or similar control. Note: The default button changes as you navigate through controls. |
n/a |
This section describes keyboard navigation in standard JDeveloper components.
The following table describes the keyboard actions to perform navigation tasks involving buttons.
Table 3-2 Keyboard Navigation for Buttons
Navigation | Keys |
---|---|
Navigate forward to or from button |
Tab |
Navigate backward to or from button |
Shift+Tab |
Activate the default button (when the focus is not on a button) |
Enter |
Activate any button while it has focus |
Enter, Spacebar, or keyboard shortcut (if one has been defined) |
Activate Cancel or Close buttons on a dialog |
Esc |
The following table describes the keyboard actions to perform navigation tasks involving checkboxes.
Table 3-3 Keyboard Navigation for Checkboxes
Navigation | Keys |
---|---|
Navigate forward to or from checkbox |
Tab |
Navigate backward to or from checkbox |
Shift+Tab |
Select or deselect (when the focus is on the checkbox) |
Spacebar or keyboard shortcut (if one has been defined) |
Navigate to checkbox and select or deselect (when the focus is not on the checkbox) |
Keyboard shortcut (if one has been defined) |
Dropdown Lists And Combo Boxes
The following table describes the keyboard actions to perform navigation tasks involving dropdown lists and combo boxes.
Table 3-4 Keyboard Navigation for Dropdown Lists and Combo Boxes
Navigation | Keys |
---|---|
Navigate forward to or from a combo box or dropdown list |
Tab or keyboard shortcut (if one has been defined) |
Navigate backward to or from a combo box or dropdown list |
Shift+Tab |
Toggle list open and closed |
Spacebar (the current selection receives the focus) |
Open a list |
Down Arrow to open (first item on list receives focus) |
Move up or down within list |
Up and Down Arrow keys (highlighted value has focus) |
Move right and left within the initial entry on a combo box |
Right and Left Arrow keys |
Select list item |
Enter Note: The first time you press Enter, the item in the list is selected. The second time you press Enter, the default button is activated. |
Close list (with the highlighted value selected) |
Esc |
The following table describes the keyboard actions to perform navigation tasks involving list boxes.
Table 3-5 Keyboard Navigation for List Boxes
Navigation | Keys |
---|---|
Navigate forward into or out of a list |
Tab |
Navigate backward into or out of list |
Shift+Tab |
Make a selection |
Up Arrow, Down Arrow, Spacebar, or Enter Note: The first time you press Enter, the highlighted item in the list is selected. The second time you press Enter, the default button is activated. |
Move within list |
Up Arrow or Down Arrow |
Move to beginning of list |
Home or Ctrl+Home |
Move to end of list |
End or Ctrl+End |
Select all entries |
Ctrl+A |
Toggle (select or deselect) an item |
Spacebar or Ctrl+Spacebar |
Select next item up in list without deselecting item with current focus |
Shift+Up Arrow Key |
Select next item down in list without deselecting item with current focus |
Shift+Down Arrow Key |
Select current item and all items up to the top of the list |
Shift+Home |
Select current item and all items up to the bottom of the list |
Shift+End |
Select current item and all items visible above that item |
Shift+Page Up |
Select current item and all items visible below that item |
Shift+Page Down |
Select item with current focus without deselecting other items (to select items that are not adjacent) |
Ctrl+Spacebar |
Navigate through list without deselecting item with current focus. |
Ctrl+Up Arrow or Ctrl+Down Arrow |
Table 3-6 Keyboard Navigation for Radio Buttons
Navigation | Keys |
---|---|
Navigate forward to or from radio button |
Tab |
Navigate backward to or from radio button |
Shift+Tab |
Navigate forward from radio button |
Arrow Keys |
Navigate backward from radio button |
Shift+Arrow Keys |
Select radio button |
Arrow key (navigating to a radio button via arrows selects it) or keyboard shortcut (if one has been defined) |
Deselect radio button |
Select a different radio button in the group using one of the commands above |
The following table describes the keyboard actions to perform navigation tasks involving shuttles.
Table 3-7 Keyboard Navigation for Shuttles
Navigation | Keys |
---|---|
Navigate forward into or out of a list |
Tab |
Navigate backward into or out of list |
Shift+Tab |
Make a selection |
Up Arrow or Down Arrow |
Move within list |
Up Arrow or Down Arrow |
Move to beginning of list |
Home or Ctrl+Home |
Move to end of list |
End or Ctrl+End |
Select all entries |
Ctrl+A |
Toggle (select or deselect) an item |
Spacebar or Ctrl+Spacebar |
Select next item up in list without deselecting item with current focus |
Select next item up in list without deselecting item with current focus |
Select next item down in list without deselecting item with focus |
Shift+Down Arrow Key |
Select current item and all items up to the top of the list |
Shift+Home |
Select current item and all items up to the bottom of the list |
Shift+End |
Select current item and all items visible above that item |
Shift+Page Up |
Select current item and all items visible below that item |
Shift+Page Down |
Select item with current focus without deselecting other items (to select items that are not adjacent) |
Ctrl+Spacebar |
Navigate through list without deselecting item with current focus. |
Ctrl+Up Arrow or Ctrl+Down Arrow |
The following table describes the keyboard actions to perform navigation tasks involving sliders.
Table 3-8 Keyboard Navigation for Sliders
Navigation | Keys |
---|---|
Navigate forward to or from slider |
Tab |
Navigate backward to or from slider |
Shift+Tab |
Increase value |
Up Arrow or Right Arrow |
Decrease value |
Left Arrow or Down Arrow |
Minimum value |
Home |
Maximum value |
End |
The following table describes the keyboard actions to perform navigation tasks involving spin controls.
Table 3-9 Keyboard Navigation for Spin Controls
Navigation | Keys |
---|---|
Navigate forward to or from spin control |
Tab |
Navigate backward to or from spin control |
Shift+Tab |
Increase value |
Up Arrow or Right Arrow, or type the value you want |
Decrease value |
Left Arrow or Down Arrow, or type the value you want |
Minimum value |
Home |
Maximum value |
End |
The following table describes the keyboard actions to perform navigation tasks involving text fields.
Table 3-10 Keyboard Navigation for Text Fields
Navigation | Keys |
---|---|
Navigate forward into or out of text box |
Tab or keyboard shortcut (if one has been defined) |
Navigate backward into or out of text box |
Shift+Tab |
Move to previous/next character within text box |
Left Arrow/Right Arrow |
Move to start/end of box |
Home/End |
Select all text |
Ctrl+A |
Deselect all text |
Left Arrow or Right Arrow |
Select current item and all items up to the Left/Right |
Shift+Left Arrow, Shift+Right Arrow |
Select current item and all items up to the Start/End |
Shift+Home, Shift+End |
Select current item and all items up to the previous/next word |
Ctrl+Shift+Left Arrow, Ctrl+Shift+Right Arrow |
Copy selection |
Ctrl+C |
Cut selection |
Ctrl+X |
Paste from clipboard |
Ctrl+V |
Delete next character |
Delete |
Delete previous character |
Backspace |
This section contains information about keyboard shortcuts for complex UI components.
The following table describes the keyboard actions to perform navigation tasks involving dockable windows.
Table 3-11 Keyboard Navigation for Dockable Windows
Navigation | Keys |
---|---|
Navigate forward in or out of dockable window |
Ctrl+Tab |
Navigate backward in or out of dockable window |
Ctrl+Shift+Tab |
Display context menu |
Shift+F10 |
Navigate between tabs within a dockable window |
Alt+Page Down, Alt+Page Up |
Move between elements including dropdown lists, search fields, panels, tree structure (but not individual elements in a tree), individual component buttons |
Tab |
Move up/down through dockable window contents (scrollbar) |
Up Arrow, Down ArrowThis scrolls the window contents if the focus moves beyond visible area of canvas. |
Move left/right (scrollbar) |
Up Arrow, Down ArrowThis scrolls the pane contents if focus moves beyond visible area of canvas. |
Move to start/end of data (component buttons) |
Ctrl+Home, Ctrl+End |
Select an element |
Enter or Spacebar |
Scroll left/right within the canvas area (without moving through the window contents) |
Ctrl+Left/Ctrl+Right |
Scroll Up/Down within the canvas area (without moving through the window contents) |
Ctrl+Up/Ctrl+Down |
Context menus are accessed using Shift+F10. Menus from the main menu bar are accessed using the keyboard shortcut for the menu.
The following table describes the keyboard actions to perform navigation tasks involving the menu bar.
Table 3-12 Keyboard Navigation for Menus
Navigation | Keys |
---|---|
Navigate to menu bar |
F10 |
Navigate out of menu bar |
Esc |
Navigate between menus in menu bar |
Right Arrow, Left Arrow |
Navigate to menu item |
Up Arrow, Down Arrow |
Navigate from menu item |
Up Arrow, Down Arrow |
Activate item |
Enter, Spacebar, or keyboard shortcut (if one has been defined) |
Open submenu |
Right Arrow |
Retract submenu |
Left Arrow or Esc |
The following table describes the keyboard actions to perform navigation tasks involving panels.
Table 3-13 Keyboard Navigation for Panels
Navigation | Keys |
---|---|
Navigate in/out forward |
Tab |
Navigate in/out backward |
Shift+Tab |
Expand panel (when focus on header) |
Right Arrow |
Collapse panel (when focus on header) |
Left Arrow |
Navigate within panel |
Up Arrow, Down Arrow |
Navigate to panel header from contents (when focus is on top item in list) |
Up Arrow |
Navigate to panel contents from header (when focus is on header) |
Down Arrow |
Arrow keys move focus in the direction of the arrow, except when a web widget has focus; in that case, the down arrow or enter key initiates the widget control action, such as opening a choice list. tab moves the focus right, shift+tab moves the focus left.
The following table describes the keyboard actions to perform navigation tasks involving tables.
Table 3-14 Keyboard Navigation for Tables
Navigation | Keys |
---|---|
Navigate forward in or out of table |
Ctrl+Tab |
Navigate backward in or out of table |
Shift+Ctrl+Tab |
Move to next cell (wrap to next row if in last cell) |
Tab Arrow or Right Arrow |
Move to previous cell (wrap to previous row if in first cell) |
Shift+Tab or Left Arrow |
Controls in cells open |
Down Arrow or Enter |
Block move left |
Ctrl+Page Up |
Block move right |
Ctrl+Page Down |
Block move up |
Page Up |
Block move down |
Page Down |
Move to first cell in row |
Home |
Move to last cell in row |
End |
Move to first cell in table |
Ctrl+Home |
Move to last cell in table |
Ctrl+End |
Select all cells |
Ctrl+A |
Deselect current selection (and select alternative) |
Any navigation key |
Extend selection on row |
Shift+Up Arrow |
Extend selection one column |
Shift+Down Arrow |
Extend selection to beginning of row |
Shift+Home |
Extend selection to end of row |
Shift+End |
Extend selection to beginning of column |
Ctrl+Shift+Home |
Extend selection to end of column |
Ctrl+Shift+End |
Edit cell without overriding current contents, or show dropdown list in combo box |
F2 |
Reset cell content prior to editing |
Esc |
This section refers to the tabs that appear within a dockable window, view or dialog. The following table describes the keyboard actions to perform navigation tasks involving tabs in dockable windows, views and dialogs.
Table 3-15 Keyboard Navigation for Tabs
Navigation | Keys |
---|---|
Navigate forward into or out of tab control |
Tab |
Navigate backward into or out of tab control |
Ctrl+Tab |
Move to tab (within control) left/right |
Left Arrow/Right Arrow |
Move to tab (within control) above/below |
Up Arrow/Down Arrow |
Move from tab to page |
Ctrl+Down |
Move from page to tab |
Ctrl+Up |
Move from page to previous page (while focus is within page) |
Ctrl+Page Up |
Move from page to next page (while focus is within page) |
Ctrl+Page Down |
The following table describes the keyboard actions to perform navigation tasks involving trees.
Table 3-16 Table Navigation for Trees
Navigation | Keys |
---|---|
Navigate forward into or out of tree control |
Tab |
Navigate backward into or out of tree control |
Shift+Tab |
Expand (if item contains children) |
Right Arrow |
Collapse (if item contains children) |
Left Arrow |
Move to parent from child (if expanded) |
Left Arrow |
Move to child from parent (if already expanded) |
Right Arrow |
Move up/down one item |
Up Arrow, Down Arrow |
Move to first item |
Home |
Move to last entry |
End |
Select all children of selected parent |
Ctrl+A |
Select next item down in list without deselecting that item that currently has focus |
Shift+Down Arrow |
Select next item up in list without deselecting that item that currently has focus |
Shift+Up Arrow |
Select current item and all items up to the top of the list |
Shift+Home |
Select current item and all items up to the bottom of the list |
Shift+End |
Select the item with current focus without deselecting other items (to select items that are not adjacent) |
Ctrl+Spacebar |
Navigate through list without deselecting item with current focus |
Ctrl+Up/Down Arrow |
The Following Table Describes The Keyboard Actions To Perform Navigation Tasks Involving Wizards.
Table 3-17 Keyboard Navigation for Wizards
Navigation | Keys |
---|---|
Navigate between stops on the roadmap or between pages |
Up Arrow, Down Arrow (these do not wrap) |
Navigate forward between components on wizard panel, wizard navigation bar buttons, and navigation panel |
Tab |
Navigate backward between components on wizard panel, wizard navigation bar buttons, and navigation panel |
Shift+Tab |
Navigate between buttons on Navigation Bar |
Right and Left Arrow Key (does not wrap) |
Navigate between stops on Roadmap/between wizard pages |
Ctrl Page Up and Ctrl Page Down |
This section contains information about keyboard shortcuts for JDeveloper-specific UI components.
The following table describes the keyboard actions to perform navigation tasks involving dialogs.
Table 3-18 Keyboard Navigation for Dialogs
Navigation | Keys |
---|---|
Close dialog without making any selections or changes |
Esc |
Activate the default button (if one is defined) |
Enter |
Overview Editor (Form + Mapping)
The following table describes the keyboard actions to perform navigation tasks involving overview editors.
Table 3-19 Keyboard Navigation for the Overview Editor
Navigation | Keys |
---|---|
Navigate into or out of overview editor from other pages in editor (for example Source or History) |
Alt+Tab |
Navigate from the tab group to next control in editor) |
Tab or Ctrl+Down Arrow |
Navigate forward or backwards between controls on overview editor |
Tab or Alt+Tab |
Move between tabs in the side tab control (when the focus in the tab group) |
Up Arrow, Down Arrow |
Move between tabs in side tab control (when focus on Page) |
Ctrl+Page Up/Ctrl+Page Down |
Move from page to tab group (from next control in editor) |
Ctrl+Tab |
Move from page to tab group (from any control in editor) |
Ctrl+Up Arrow |
Open and close Sections (when focus is on a section header) |
Enter, Spacebar, Right Arrow/Left Arrow |
Component and Resource Palettes
The following table describes the keyboard actions to perform navigation tasks involving palettes.
Table 3-20 Keyboard Navigation for Component and Resource Palettes
Navigation | Keys |
---|---|
Navigate forward in or out of palette |
Ctrl+Tab This moves you into first item within the pane. |
Navigate backward in or out of palette |
Ctrl+Shift+Tab |
Move between elements including dropdown lists, search fields, panels, tree structure (but not individual elements in a tree), individual component buttons |
Tab, Shift+Tab |
Move up/down elements in a list or tree |
Up Arrow/Down Arrow |
Move left/right elements in a list or tree |
Left Arrow/Right Arrow |
Move to start/end of data (component buttons) |
Ctrl+Home/Ctrl+End |
Select a component button |
Enter |
The following table describes the keyboard actions to perform navigation tasks involving navigators.
Table 3-21 Keyboard Navigation for Navigators
Navigation | Keys |
---|---|
Navigate forward in or out of navigator |
Ctrl+Tab This moves you into first item within the pane. |
Navigate backward in or out of navigator |
Ctrl+Shift+Tab |
Move between elements including dropdown lists, search fields, panels, tree structure (but not individual elements in a tree), individual component buttons |
Tab |
Move up/down elements in a list or tree |
Up Arrow/Down |
Move left/right elements in a list or tree |
Left Arrow/Right Arrow |
Move to start/end of data (component buttons) |
Ctrl+Home/Ctrl+End |
Select a component button |
Enter |
Select an element |
Enter |
The following table describes the keyboard actions to perform navigation tasks involving the Property Inspector.
Table 3-22 Keyboard Navigation for the Property Inspector
Navigation | Keys |
---|---|
Navigate forward into or out of Property Inspector |
Ctrl+Tab |
Navigate backward into or out of Property Inspector |
Ctrl+Shift+Tab |
Navigate from side tab group to page |
Tab |
Navigate backward and forwards between elements on page |
Tab, Shift+Tab |
Move to tab above/below (when focus is on the side tab) |
Up Arrow, Down Arrow |
Move to tab right or left, above or below (when focus is on the internal tab group) |
Up Arrow, Down Arrow, Right Arrow, Left Arrow |
Move from side tab group to page |
Ctrl+Down Arrow |
Move from page to side tab group |
Ctrl+Up Arrow |
Move to side tab above (previous) when focus on page |
Ctrl+Page Up |
Move to side tab below (next) when focus on page |
Move to side tab below (next) when focus on page |
Open and Close sections (when focus is on a section header) |
Enter |
The following table describes the keyboard actions to perform navigation tasks involving the pane elements of text editors.
Table 3-23 Keyboard Navigation for Text Editors
Navigation | Keys |
---|---|
Navigate forward in or out of editor |
Ctrl+Tab |
Navigate backward in or out of editor |
Ctrl+Shift+Tab |
Move from page to previous page |
Alt+Page Up |
Move from page to next page |
Alt+Page Down |
The following table describes the keyboard actions to perform navigation tasks involving the text or canvas areas of text editors.
Table 3-24 Keyboard Navigation for Canvas Areas of Text Editors
Navigation | Keys |
---|---|
Move up/down one line |
Up Arrow, Down Arrow |
Move left/right one character |
Left Arrow, Right Arrow |
Move to start/end of line |
Home, End |
Move to previous/next word |
Ctrl+Left Arrow, Ctrl+Right Arrow |
Move to start/end of text area |
Ctrl+Home/Ctrl+End |
Move to beginning/end of data |
Ctrl+Home/Ctrl+End |
Move up/down one vertical block |
Page Up/Page Down |
Block move left |
Ctrl+Page Up |
Block move right |
Ctrl+Page Down |
Block extend up |
Shift+Page Up |
Block extend down |
Shift+Page Down |
Block extend left |
Ctrl+Shift+Page Up |
Block extend right |
Ctrl+Shift+Page Down |
Select all |
Ctrl+A |
Deselect all |
Up Arrow, Down Arrow, Left Arrow, Right Arrow |
Extend selection up/down one line |
Shift+Up Arrow/Shift+Down Arrow |
Extend selection left/right one component or char |
Shift+Left Arrow/Shift+Right Arrow |
Extend selection to start/end of line |
Shift+Home/Shift+End |
Extend selection to start/end of data |
Ctrl+Shift+Home/Ctrl+Shift+End |
Extend selection up/down one vertical block |
Shift+Page Up/Shift+Page Down |
Extend selection to previous/next word |
Ctrl+Shift+Left Arrow /Ctrl+Shift+Right Arrow |
Extend selection left/right one block |
Ctrl+Shift+Page Up/Ctrl+Shift+Page Down |
Copy selection |
Ctrl-C |
Cut selection |
Ctrl-X |
Paste selected text |
Ctrl-V |
The following table describes the keyboard actions to perform navigation tasks involving graphical editors.
Table 3-25 Keyboard Navigation for Graphical Editors
Navigation | Keys |
---|---|
Navigate forward in or out of editor |
Ctrl-Tab |
Navigate backward in or out of editor |
Ctrl+Shift+Tab |
Move from page to previous page |
Alt+Page Up |
Move from page to next page |
Alt+Page Down |
The following table describes the keyboard actions to perform navigation tasks involving the canvas areas of graphical editors.
You can alter the appearance and functionality of a wide variety of JDeveloper features.
You can alter the appearance of JDeveloper using pre-defined settings.
To change the look and feel of the IDE:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within the Preferences dialog.
In the Preferences dialog, select the Environment node if it is not already selected.
On the Environment page, select a different look and feel from the Look and Feel dropdown list.
Click OK.
Restart JDeveloper.
Note:
The key bindings in Motif are different from key bindings in Windows. Under Motif, the arrow keys do not change the selection. Instead they change the lead focus cell. You must press Ctrl + Space to select an item. This is expected behavior.
You can customize the default display options (such as whether or not the splash screen is displayed at start up, or whether dockable windows are always on top), as well as other general behavior, such as whether JDeveloper will automatically reload externally modified files and whether output to the Log window is automatically saved to a file.
To change the general environment settings for the IDE:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within the Preferences dialog.
In the Preferences dialog, select the Environment node if it is not already selected.
On the Environment page, select the options and set the fields as appropriate.
Click OK.
Restart JDeveloper.
You can customize the layout for dockable windows in their docked position. You can also set dockable windows to remain on top of other GUI elements, or not, when those windows are moved.
To change the shape of one or more of the four docking areas:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within the Preferences dialog.
In the Preferences dialog, select the Environment node select Dockable Windows.
On the Dockable Windows page, click the corner arrows to lengthen or shorten each docking area's shape.
Click OK.
To change whether dockable windows remain on top or not when moved:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within the Preferences dialog.
In the Preferences dialog, select the Environment node select Dockable Windows.
On the Dockable Windows page, select or deselect Dockable Windows Always on Top as appropriate.
Click OK.
You can customize the display of the Compare window.
To customize the options for comparing files:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within the Preferences dialog.
In the Preferences dialog, select Compare and Merge.
On the Compare page, set the options available for the display of two files being compared.
Click OK.
The Component Palette offers you a quick method for inserting components into files open in the editor.
You can add pages to the Component Palette, within which to group additional components, or you can add components to existing pages.
From the main menu, choose Tools > Configure Palette to open the Configure Component Palette dialog. For more information at any time, press F1 or click Help from within the Configure Component Palette dialog.
Optionally, in the Configure Component Palette dialog, for Page Type select the appropriate type to limit the display in the Pages list.
In the Configure Component Palette dialog, underneath the Pages list box, click Add.
In the Create Palette Page dialog, enter the name of the new page and select a type from the dropdown list. If you selected a page type in Step 2, that type is reflected now in this dialog.
Click OK to return to the Configure Component Palette dialog.
If finished, click OK. The new page is now added to the dropdown list in the Component Palette. It also appears in the Pages list of the Configure Component Palette dialog.
Alternately, right-click in the Component Palette and choose Add Page.
You can add pages to the Component Palette to group your JavaBeans components, or you can add components to existing pages. Once you add JavaBeans to the Palette, you can insert these beans into any file you have open in the Java Visual Editor by selecting them from the Palette.
To add a JavaBeans component to the Palette:
If the bean is not already referenced by a library, create a user library (outside the project) for the bean.
In the Class Path field, set the location of the bean class. If the bean is in an archive, use the archive. If the bean is contained in a project, use the output directory of that project.
Note that when you are creating your own JavaBeans for later deployment, it can be useful to defer putting them into an archive until you have finished development.
From the main menu, choose Tools > Configure Palette to open the Configure Component Palette dialog. For more information at any time, press F1 or click Help from within the Configure Component Palette dialog.
Optionally, in the Configure Component Palette dialog, for Page Type select Java to view only those pages containing JavaBeans.
Skip to Step 6 if you do not want to add a new page.
Underneath the Pages list box, click Add.
In the Create Palette Page dialog, enter the name of the new page, ensure that Java is selected from the dropdown list, and click OK.
Your new page name is added to the bottom of the Pages list in the Configure Component Palette dialog.
In the Pages list, select the page to which you wish to add the JavaBeans component.
Underneath the Components list box, click Add.
In the Add JavaBeans dialog, fill in the appropriate details for the new component.
Click OK to return to the Configure Component Palette dialog.
If finished, click OK.
The new beans component now appears in the Component Palette when the appropriate page is selected. It also appears in the Components list of the Configure Component Palette dialog when the page it is associated with is selected in the Pages list.
Note that if you remove a page supplied by JDeveloper, the only way to recover it again is to restore the default setting for the Component Palette by moving the palette.xml
file from jdev_install
/system
to jdev_install
/system/release_and_build
_number, where jdev_install
is the root directory in which JDeveloper is installed.
To remove a page from the Palette:
From the main menu, choose Tools > Configure Palette to open the Configure Component Palette dialog. For more information at any time, press F1 or click Help from within the Configure Component Palette dialog.
Optionally, in the Configure Component Palette dialog, for Page Type select the appropriate type to limit the display in the Pages list.
In the Pages list, select the page to be removed.
Underneath the Pages list box, click Remove.
If the page cannot be removed, the Illegal Request dialog appears.
To confirm removal, in the Confirm Remove Page dialog, click Yes.
In the Configure Component Palette dialog, click OK.
The page no longer appears in the Component Palette dropdown list. It has also been removed from the Pages list of the Configure Component Palette dialog.
Alternately, with the page selected in the Component Palette, right-click in the Palette and choose Remove Page.
Note that if you remove a component supplied by JDeveloper, the only way to recover it again is to restore the default setting for the Component Palette by moving the palette.xml
file from jdev_install
/system
to jdev_install
/system/release_and_build
_number, where jdev_install
is the root directory in which JDeveloper is installed.
To remove a component from the Palette:
From the main menu, choose Tools > Configure Palette to open the Configure Component Palette dialog. For more information at any time, press F1 or click Help from within the Configure Component Palette dialog.
Optionally, in the Configure Component Palette dialog, for Page Type select the appropriate type to limit the display in the Pages list.
In the Pages list, select the page you want to remove the component from.
In the Components list box, click Remove.
If the component cannot be removed, the Illegal Request dialog appears.
To confirm removal, in the confirmation dialog, click Yes.
In the Configure Component Palette dialog, click OK.
The component no longer appears in the Component Palette dropdown list. It has also been removed from the Components list of the Configure Component Palette dialog.
You cannot remove a component using the Component Palette context menu. You must work through the Configure Component Palette dialog.
You can change the roles that are used to shape JDeveloper. Shaping tailors the JDeveloper environment based on the role of the user.
When you change to a new role, it is only available after you restart JDeveloper.
To change the role for JDeveloper:
From the main menu, choose Tools > Switch Roles and select the role of your choice.
You can associate commonly used file types with JDeveloper. Once a file type has been associated with JDeveloper, opening a file of that type automatically launches JDeveloper. (This feature is supported only in Windows systems.)
To associate a file type with JDeveloper:
From the main menu, choose Tools > Preferences and open the File Types pane. For more information at any time, press F1 or click Help from within the Preferences dialog.
In the list of file types, select a file type to be associated with JDeveloper.
In the Details for area, check Open with JDeveloper.
When designing and building applications, you may need to find and use many software assets. You may know what you want to find, but you may not certain where to find it or even what the artifact of interest is called. Even if you think you know where to find the artifact, and what it is called, you might not know how to establish a connection to the source repository. Consider the following:
An application developer needs to find and incorporate shared model, view and controller objects created by other members of her team, and by other product teams.
A UI designer needs access to a corporate catalog of images, style sheets, templates and sample designs to facilitate rapid creation of standards-compliant pages.
An application integrator needs easy access to a variety of web services of interest to a particular domain.
An end user needs to find relevant content (for example, portlets and UI components) for use while personalizing a page. In each of these cases, the user has a simple goal: find the resource(s) needed for the task at hand. The process of discovering and accessing the assets should be as effortless as possible.
The Resource Palette in JDeveloper addresses this. It lets you:
Locate resources stored in a wide variety of underlying repositories through IDE connections
Locate resources by browsing a hierarchical structure in catalogs
Search for resources and save searches
Filter resources to reduce the visible set when browsing
Use a resource you have found in an application you are building
Facilitate resource discovery and reuse by sharing catalog definitions
The resource palette allows you to create connections to a number of different resources, such as application servers, databases, WebDAV servers, from where you can use them in different applications and share them with other users.
In the main menu, choose View > Resource Palette.
By default, the Resource Palette is displayed to the right of the JDeveloper window.
The connections defined in the Resource Palette are listed in the IDE Connections panel of the Resource Palette.
When you create a connection in JDeveloper, you can create it in the context of the Resource Palette as an IDE connection that can be reused in different applications, or shared between users, or as application connections.
Some types of connections may appear in special connection-type navigators. For example, database connections display in the Database Navigator under the IDE Connection node (for IDE connections), or the application-name node (for application resource connections). The Database Navigator is where you edit objects through the database connection.
The different types of connection that can be made depends on the technologies and extensions available to you. To see what you can create a connection to, choose New Connection from the New button in the Resource Palette.
The file system location for the Resource Palette connection descriptor definition information is
system-dir/jdeveloper/system11.1.2.n.nn.nn.nn/o.jdeveloper.rescat2.model/connections/connections.xml
In JDeveloper 11g you have two ways of creating and managing connections. You can define a connection to be used in the context of an application (called an Application Resource connection), or for the IDE as a whole (called an IDE connection). You use the same dialog to define both of these, but their scope within JDeveloper is different.
When you first create a connection you choose the connection scope. You cannot subsequently change the connection scope.
These connections are locally scoped and just available within the application. Connections in application resources are artifacts of the application and are deployed within the application. These types of connection are listed in the Application Resources panel of the Application Navigator, under the Connections node.
The file system location for the connection descriptor definition information is application-folder/.adf/META-INF/connections.xml
, where application-folder
is the path for the selected application.
You can create connections in the Resource Palette to resources available to JDeveloper.
The specific types of connections you can make depend on the technologies and extensions available to you.
In the Resource Palette IDE Connections panel, choose New Connection from the New button.
Choose the type of connection you want to create, and enter the appropriate information in the Create Connection dialog. For more information at any time, press F1 or click Help from within the dialog.
Once you have created a connection in the Resource Palette, you can edit details of the connection, but you cannot change the connection name.
In the Resource Palette IDE Connections panel, choose Properties from the context menu of a connection.
The Edit connection dialog opens where you can change the connection details. For more information at any time, press F1 or click Help from within the Edit connection dialog.
You can use connections in the Resource Palette in an application.
The connection can be added to the application currently open in JDeveloper, and it is listed in the Application Resources panel of the Application Navigator, under the Connections node.
To add a connection to an application:
In the Resource Palette IDE Connections panel, choose Add to Application from the context menu of a connection.
Alternatively, drag the resource from the Resource Palette and drop it onto an application page.
Alternatively, drag the connection from IDE Connections in the Resource Palette and drop it onto the Application Resources pane in the Application Navigator.
There are two ways of searching in the Resource Palette:
Performing a simple search
Performing an advanced search, where you enter parameters in a dialog
In addition, you can define a dynamic folder in a catalog where the content of the folder is defined by a query expression that is executed when the folder is opened.
The time the search takes depends on how many resources there are in the Resource Palette, and how long it takes to connect to them, and the results are displayed in the Search Results panel.
You can stop a search before it has completed by clicking the Stop Search button.
In this case, the search is performed across all the contents of the Resource Palette, and it may take some time because JDeveloper connects to remote resources during the search.
In the Resource Palette, click the Search Options button to choose whether the search is performed against the Name, Type or Description of the resource. For more information at any time, press F1 or click Help from within the Resource Palette.
Enter a search string in the field. For example, if you want to find every resource that contains dep
in the name, choose Name in step 1, and enter dep
. Every resource that contains the string dep
will be listed in the search results.
Click the Start Search button to start the search.
You can specify a series of search criteria, and you can choose where to start the search from.
To perform an advanced search:
In the Resource Palette, choose Advanced Search from the context menu of an object in the My Catalogs panel or the IDE Connections panel. For more information at any time, press F1 or click Help from within the Advanced Search dialog.
Define where the search starts. Either select from Search in, or click Show Hierarchy which allows you choose within a hierarchical list of the Resource Palette contents.
Enter search criteria to return the resources you want, and click Search.
You can save a search and reuse it. There are two ways of saving a search in order to reuse it:
As a dynamic folder, where the contents of the folder are created dynamically based on the search criteria when the folder is opened.
As a static folder containing the results of the search.
Dynamic folders can also be created directly in a catalog.
In the Resource Palette Search Results panel, choose Save Search from the context menu.
In the Save Search dialog, choose:
Save Search Criteria, to create a dynamic folder.
Save Search Results, to create a static folder of results.
For more information at any time, press F1 or click Help from within the Resource Palette.
Enter a name for the folder.
Choose the catalog to contain the folder, either from the dropdown list, or from the hierarchical list displayed when you click Show Hierarchy.
Filters allow you fine-tune the contents of catalog folders.
To filter the contents of My Catalogs:
In the Resource Palette, choose Filter from the context menu of an object in the My Catalogs panel or the IDE Connections panel. For more information at any time, press F1 or click Help from within the Filter dialog.
Enter a string to define the filtering. Only entries in the folder that contain the string will be shown.
Catalogs and connections are shared by importing Resource Catalog archive (.rcx) files that have been exported by another user.
Note:
When you select a catalog to export, any connections in the catalog are also selected. If you deselect the catalog before exporting, you must be sure to also deselect the connections that are not wanted in the archive file.
In the Resource Palette, choose Export from the context menu of an object in the My Catalogs panel or the IDE Connections panel.
In the Export Catalog and Connections dialog, select the catalogs and connections to be exported, and decide how errors will be handled. For more information at any time, press F1 or click Help from within the Export Catalog and Connections dialog.
In the Resource Palette, choose Import from (New).
In the Import Catalog and Connections dialog, specify or browse to the path and name of the Resource Catalog archive file (.rcx). For more information at any time, press F1 or click Help from within the Import Catalog and Connections dialog.
Choose the catalogs and connections you want to import, and determine how to handle errors.
You can refresh the contents of the Resource Palette.
To refresh the Resource Palette:
In the Resource Palette, choose Refresh from the context menu of an object in the My Catalogs panel or the IDE Connections panel.
A catalog is a user-defined construct for organizing resources from multiple underlying repositories. The contents of a catalog and its associated folder structure can be designed to be used by an individual developer, or they can be targeted towards specific groups of users such as the UI designers for a development project.
Catalog folders organize resources in a catalog. You use catalog folders in the same way you would to organize files in a file system or bookmarks in a Web browser. Each catalog folder can contain any combination of:
Folders.
Dynamic folders, which are populated using a query.
Filters, which are used to fine-tune the content of a folder or subtree.
You can organize the information in the resource palette in catalogs.
In the Resource Palette, choose New Catalog from the New button.
In the Create Catalog dialog, specify a name for the catalog. For more information at any time, press F1 or click Help from within the Create Catalog dialog.
(Optional) Provide a description for the catalog, and the email of the catalog administrator.
You can create folders to organize the contents of catalogs.
You can organize the information within catalogs in folders.
In the Resource Palette, choose New Folder from the context menu of a catalog in the My Catalogs panel or the IDE Connections panel. For more information at any time, press F1 or click Help from within the Create Folder dialog.
Enter a name for the folder.
Dynamic Folders provide a powerful way to dynamically populate a catalog folder with resources. The content of the folder is defined by a query expression that is executed when the folder is opened. The results of the query appear as the contents of the folder.
In the Resource Palette, choose New Dynamic Folder from the context menu of a catalog in the My Catalogs panel or the IDE Connections panel. For more information at any time, press F1 or click Help from within the Create Dynamic Folder dialog.
Define the search criteria that will be used to populate this folder when it is opened.
You can add a connection from the IDE Connections panel or a resource from the Search panel in the Resource Palette to a catalog in My Catalogs.
To add a resource to a catalog:
In the Resource Palette, right click a connection in the IDE Connections panel, or the result of a search in the Search panel and choose Add to Catalog from the context menu.
The Add to Catalog dialog opens for you to specify the name for the resource in the catalog, and the catalog to add it to. For more information at any time, press F1 or click Help from within the Create Connection dialog.
Alternatively, you can drag an item from under IDE Connections and drop it on a catalog or catalog folder.
You can reorganize a catalog by selecting an item or folder in the catalog and dragging it to another folder in the same catalog, or to another catalog.
JDeveloper includes an editor for editing source files across several technologies, including Java and XML, among others.
JDeveloper includes an editor for editing source files across several technologies, including Java and XML, among others.
Depending on the type of source file you are editing, the source editor will be available in one of the following forms:
Java Source Editor
XML Editor
HTML/JSP Source Editor
JavaScript Editor
In addition to technology-specific features, the source editor also has a set of common features across all technologies that enhance the coding experience. These features include bookmarking, code insight, code templates, and several other features that enable you to code faster and better.
Use the Code Editor page in the Preferences dialog to customize the source editor to suit your coding style.
The source editor offers a set of common features across all technologies that provide intuitive support for a variety of coding tasks. Available across all forms of the editor, these features enhance your coding experience through quicker execution of coding tasks and better navigation through code.
The breadcrumb bar, located at the bottom of the editor window, shows the hierarchy of code entities from the current caret position up to the top of the file. Hovering the mouse cursor over a node pops up some information about the node, and clicking on the node navigates the caret to the node location.
A breadcrumb can be clicked to display a popup list of child breadcrumbs can be displayed (where appropriate). For example, for a Java class, you can click the breadcrumb to display the class' methods and inner classes in a list. Choosing an item on this list will navigate the editor to its location.
If block coloring has been activated and colors have been assigned, breadcrumbs are highlighted in the same color as their corresponding code blocks.
The right margin of the editor provides colored overview marks that are indicators for a location in the source file. Hovering the mouse over an overview mark makes a popup appear which displays information about the item in that location of the source file, and a snippet of the relevant code.
The following overview indicators are provided:
A square mark at the top right corner of the editor window indicates the overall health of your source file, as per its color. White indicated that the health is currently being calculated. Green indicates that there are no errors or warnings in the file. Red indicates errors, and yellow indicates warnings
Rectangles, depending on their color, signify the occurrence of the following source editing artifacts:
Red: Java code error
Pale blue: bookmark
Medium blue: current execution breakpoint
Yellow: occurrence of searched text
Pale orange: Java warning
Bright orange: Profile Point
You can also press Ctrl anywhere in the right margin to view a popup window that displays a portion of the source code that is not currently in view. By adjusting the position of the mouse while pressing Ctrl, you can view the entire code without scrolling in the editor itself
Hovers enable you to position the mouse cursor over certain areas of the IDE and get some information on them in a popup window that appears floating in front.
Tools menu > Preferences > Code Editor > Display > Show Whitespace Characters
This feature optionally renders spaces, new lines, carriage returns, non-breaking spaces, and tab characters as visible characters in the editor. Turned off by default, this can be enabled and disabled using the Preferences Dialog.
Edit menu > Duplicate Selection
Duplicates the currently selected block of code, and places the copied code beside the original code. After duplication, the newly inserted code is selected. The clipboard is not affected by this operation.
Edit menu > Block Selection
This feature enables you to select code vertically. when you do not want to select text that wraps around the end of lines. This is useful for selecting tabular data, or vertically aligned code blocks.
Join the current line to the next, or join all lines in a selection. Any comment delimiters or extra whitespace are intelligently removed to join the lines.
Default keyboard shortcut: Ctrl+J
When the source editor is in use, the status bar at the bottom displays the line and column coordinates of the current position of the cursor.
Hold down the Ctrl key and use the mouse scroller to zoom in to or zoom out of the code editor.
The generic source editor also provides a set of features through the context menu. To use these features, in the context menu, select Source. Depending on the type of source file in use, items other than the ones mentioned below may be present in the context menu. For example, the Java Source Editor contributes Java-specific options to the source editor context menu.
Note:
These features are also available through the Source menu.
Completion insight provides you with a list of possible completions, such as method names, and parameter types if they are applicable, at the insertion point, which you may use to auto-complete Java code you are editing. This list is generated based on the code context found at the insertion point. The contexts supported by completion insight are:
Within package and import statements
Within extends, implements, and throws clauses
Within continue and break statements
Within general code expressions
Default keyboard shortcut: Ctrl+Space
Parameter insight provides you with the types and names of the parameters of the method call you are typing. If the method is overloaded, multiple sets of parameter types and names are listed.
Default keyboard shortcut: Ctrl+Shift+Space
Note:
If errors for the file appear in the Structure window, Code (Completion or Parameter) Insight may not work. If the class(es) you are using are not in your project (that is, not on your classpath), Code Insight will not appear. Please note that you may need to compile your src files in order for Code Insight to have access to them.
Use to auto-complete code statements where such a completion is obvious to JDeveloper; for example, semi-colon insertions at the end of a statement.
Default keyboard shortcut: Ctrl+Shift+Enter
Insert a code template from a list of JDeveloper's predefined code templates. The code templates offered are context sensitive. For example, templates to declare class variables are only offered when the cursor is in the appropriate place in the class file.
Default keyboard shortcut: Ctrl+Enter
Code Assist examines your code in the editor and provides assistance to fix common problems. A Code Assist icon appears in the editor margin when JDeveloper has a suggestion for a code change. To invoke Code Assist manually, press Ctrl+Alt+Enter. To select an action listed in Code Assist, press Alt+ the underlined key.
Default keyboard shortcut: Ctrl+Alt+Enter
Select to view the Javadoc or Jsdoc (depending on whether you are using the Java or JavaScript editor) for the element in focus.
Default Keyboard Shortcut: Ctrl+D
Comments out the line currently in focus in the source editor. Running this command on a commented line uncomments the line.
Default Keyboard Shortcut: Ctrl+Slash
Indents the line of code currently in focus. If a block of code is selected, the entire block is indented.
Unindents a line or block of code, based on code has focus in the editor.
You can change the default settings of many of the features of the source editor by changing the preferences.
You can also view or change shortcut keys for the source editor, by modifying the predefined keyboard schemes.
To set indentation size for the source editor:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within the Preferences dialog.
In the Preferences dialog, select the Code Editor node, then the Code Style page.
On the Code Style page, select the Edit button.
On the Format tab, open the Indentation node and select Indentation Size.
Change the indentation value as required.
Note:
While editing code, if you press the Tab key when the Use Tab Character option is unchecked, JDeveloper indents by the indentation size you specify (4 by default). If you select Use Tab Character, JDeveloper will use tab characters for indenting, based on values specified in both the Indentation Size and Tab Size fields. For example, if you use an indent size of 4, and a tab size of 8, then it takes two indent levels (4 spaces each) to reach the tab size (8). So if you press Tab twice to indent twice, JDeveloper will insert a tab character in the source file. That tab character will expand to 8 spaces.
Click OK to close the dialogs.
To set fonts for the Source Editor
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within the Preferences dialog.
In the Preferences dialog, select the Code Editor node, then the Fonts node.
On the Fonts page, select a font type and size. Alter the sample text, if you wish. The sample text display reflects your font changes.
By default, all your system fonts are loaded. To limit the fonts available on this page to fixed-width fonts, select Display Only Fixed-Width Fonts.
Click OK.
To set caret behavior for the source editor:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within Preferences dialog.
In the Preferences dialog, expand the Code Editor node.
Select the Caret Behavior node.
On the Caret Behavior page, set the different attributes that determine how the caret will look and behave.
For more information, press F1 or click Help from within the dialog page.
Click OK.
To set the options for width and the right margin in the source editor:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within the Preferences dialog.
In the Preferences dialog, expand the Code Editor node.
Select the Display node.
On the Display page, enter the settings you wish for the right margin.
Enter a width for the source editor, expressed in numbers of columns.
Click OK.
To set line gutter behavior for the source editor:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within the Preferences dialog.
In the Preferences dialog, expand the Code Editor node.
Select the Line Gutter node.
On the Line Gutter page, decide whether or not line numbers will appear.
Set the other attributes to create the line gutter behavior that you want.
Click OK.
To set the options for syntax highlighting in the source editor:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within the Preferences dialog
In the Preferences dialog, expand the Code Editor node.
Select the Syntax Colors node.
On the Syntax Colors page, begin by selecting the appropriate category for the syntax you wish to work with.
The display on the page changes to reflect the current settings for the first style listed in this category, which is highlighted.
With the category displayed above, select any individual style in the Available Styles list to view its current settings.
Select a font style and set the background and foreground color as desired. The sample text changes accordingly.
Click OK.
To set bookmark options for the source editor:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within Preferences dialog.
In the Preferences dialog, expand the Code Editor node.
Select the Bookmarks node.
On the Bookmarks page, decide how you wish to handle bookmarks once you've exited the editor or Oracle JDeveloper, how you wish to traverse bookmarks, and how you wish to handle bookmarks at the end of files for lines that may no longer exist.
Click OK.
To set the options for Code Insight in the source editor:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within Preferences dialog.
In the Preferences dialog, expand the Code Editor node.
Select the Code Insight node.
On the Code Insight page, select the appropriate checkboxes to enable completion insight or parameter insight and use the sliding bar to set the delay time before the popup window appears.
Click OK.
Code templates assist you in writing code more quickly and efficiently while you are in the source editor. You can edit the existing templates or create your own.
To view existing code templates:
From the main menu, choose Tools > Preferences, expand the Code Editor node, and select Code Templates. For more information at any time, press F1 or click Help from within Preferences dialog.
On the Code Templates page, scroll through the shortcuts, which represent the letters you must type to evoke each template.
Click on any shortcut to view the associated template code on the Code tab. If there are any imports associated with this template, they will be shown on the Imports tab.
To edit an existing code template:
From the main menu, choose Tools > Preferences, expand the Code Editor node, and select Code Templates.
On the Code Templates page, make changes to the shortcut, the description, the code (including the variables used in it), and the imports, as required.
When you are finished, click OK.
To define a new code template:
From the main menu, choose Tools > Preferences, expand the Code Editor node, and select Code Templates.
On the Code Templates page, click Add. The cursor jumps to the bottom of the Shortcut list and a new row is added.
Type in the name for the new shortcut and add a description in the list next to it.
Select the Code tab and enter the code for this template. Note that cursor position is a part of the template, representing the logical insertion point for new code to be entered when the template is used. Select the Imports tab and enter any imports associated with this template.
Click OK.
To customize the HTML and JSP options for the source editor:
Choose Tools > Preferences. For more information at any time, press F1 or click Help from within Preferences dialog.
Expand the Code Editor node.
Select the XML and JSP/HTML node.
On the XML and JSP/HTML page, select End Tag Completion to enable that option.
Click OK.
To set undo behavior for the source editor:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within the Preferences dialog.
In the Preferences dialog, expand the Code Editor node.
Select the Undo Behavior node.
On the Undo Behavior page, use the slider bar to set the number of actions of the same type to be combined into one undo.
Select or deselect the options for combining insert-mode and overwrite-mode edits and for combining the deletion of next and previous characters.
If you wish to be able to undo navigation-only changes, select the appropriate checkbox. If you enable this setting, use the slide bar to set the number of navigation changes to be combined into one undo.
Click OK.
To set printing options for the source editor:
From the main menu, choose Tools > Preferences. For more information at any time, press F1 or click Help from within the Preferences dialog.
In the Preferences dialog, expand the Code Editor node.
Select the Printing node.
On the Printing page, set the various print options.
Click OK.
Oracle JDeveloper possesses several capabilities for easier handling of files in the editor window.
You can open a file to fill the maximum view available in JDeveloper. This is done by maximizing the source editor to fill JDeveloper
The same technique of double-clicking a tab can be used for any of the other windows in JDeveloper, for example, the Help Center, or the Application Navigator.
To maximize the view of a file:
In the source editor, double-click the tab of the file. The source editor becomes the only window visible in JDeveloper, with the file you have chosen currently displayed in it.
To reduce the view of a file to its former size
Double-click the tab of the file again. The windows within Oracle JDeveloper return to their former layout.
You can navigate through files visually (cycling through by tab), historically (cycling through by order of access), or numerically (cycling through based on file shortcut key assignment).
To navigate through open files by tab:
Press Alt+Left Arrow or Alt+Right Arrow. Use Alt+Left Arrow to navigate to the left, and Alt+Right Arrow to navigate to the right.
To navigate through open files based on history:
Press Ctrl+Tab or Ctrl+Shift+Tab
Use Ctrl+Tab to open the last active file. Note that opening a file renders it the currently active file, such that the previously active file now becomes the last file to have been active.
For example, given files A, B, and C (opened in the order C, B, A), where file A currently has focus, pressing Ctrl+Tab brings B to the foreground. Now B is the file with focus and A is the last active file. Pressing Ctrl+Tab again thus brings A back to the foreground.
Press Ctrl+Tab+Tab+Tab to cycle through files by order of access without stopping. Only when you stop on a file is that file given focus. Stopping on a file is equivalent to using Ctrl+Tab on that file.
You can display all the files currently open in the editor window, or all the files currently open in a particular tab group.
To display the alphabetical list of all the files currently open in a given tab group:
Click the File List button in the upper right-hand corner of the editor window. Alternately, with the focus in the editor window, press (in the default keyboard scheme) Alt+0.
If the editor window is not subdivided, the list will contain all open files. If the editor window is subdivided, the list will contain all the open files in that tab group.
To display the alphabetical list of all the files currently open in the editor window, regardless of split or detached files:
From the main menu, choose Window > Windows.
Oracle JDeveloper remembers the last files you have edited.
To access a recently-edited file, irrespective of whether it is currently open or not:
From the main menu, choose Navigate > Go to Recent Files or (in the default keyboard scheme) press Ctrl+ =.
In the Recent Files dialog, select the file from the list or begin typing the first letters of the filename.
Click OK.
By default, only those files opened directly (through the navigator, for instance) appear in the list. Those opened indirectly (for example, as you debug code) do not automatically appear. To view files opened both directly and indirectly, select Show All.
You can split the editor window horizontally or vertically, opening a single file in multiple views. In each view, you've the choice of changing which editor the file is opened in.
You can split a file into as many views as you like. The split views are automatically synchronized with each other.
To open a single file in multiple views:
From the main menu, choose Window > Split Document.
The editor window is now split in two, with two identical and independent windows opened on the same file. Each window has its own set of editor tabs at the bottom.
In each window, select the editor tab to view the file in that editor.
Note that some editors (such as the Java Visual Editor) permit only one view at a time on a file.
Alternately, you can split the file using the mouse, either horizontally or vertically.
To split the file horizontally, grab the splitter just above the vertical scroll bar (on the upper right-hand side of the window) and drag it downward.
To split the file vertically, grab the splitter just to the right of the horizontal scroll bar (on the lower right-hand side of the window) and drag it left.
To navigate quickly between split views:
Press F6 to cycle forward.
Press Shift+F6 to cycle backward.
To collapse those multiple views back into one:
From the main menu, choose Window > Unsplit Document.
Alternately, you can drag the splitter past the end of the editor window.
You can split the editor window horizontally or vertically, opening views on more than one file at a time. Each view is independent of the others
You can split the editor window into as many different independent views as you would like.
To view more than one file at a time, in independent windows:
From the main menu, choose Window > New Tab Group.
The editor window is now split in two, with different files in each window. Each window has a set of document tabs at the top and a set of editor tabs at the bottom. Each window is known as a tab group.
You can create as many tab groups as you like.
Alternately, you can detach a file using the mouse, by grabbing the document tab for the file and dragging it towards the area of the window where you want the file displayed.
As you drag the tab, the icon that follows the cursor changes. A split window with an arrow to the left, right, top, or bottom indicates that if you release the mouse now, the new window will be placed in that relationship to the current window.
To move a file to a different tab group:
Drag the document tab for the file to the center of the area occupied by the tab group you wish to attach it to.
When the icon that follows the cursor changes to show a miniature window with tabs, release the mouse.
To collapse those multiple views back into one:
From the dropdown menu, choose Window > Collapse Tab Groups.
Alternately, you can simply grab the document tab for a detached file and drop it onto an existing tab or tab group. When the icon changes to show a miniature window with tabs, release the mouse.
You can close any file open in the editor window with a single click.
To close the current file, choose one of the following ways:
From the main menu, choose File > Close.
Press Ctrl+F4.
In the editor, right-click the tab for the current file and choose Close.
Hover the mouse over the tab for the current file and click the Close button.
To close all files, choose one of the following ways:
From the main menu, choose File > Close All.
Press Ctrl+Shift+F4.
In the editor, right-click the tab for any file and choose Close All.
To close all files except one:
In the editor, right-click the tab for the file you want to stay open and choose Close Others.
To close multiple files at once:
From the main menu, choose Window > Windows.
In the Windows dialog, select the files to be closed and click OK.
In the editor, select the corresponding tab for the file to be closed.
Ctrl+click the tab, or hover the mouse over the tab and click the Close button.
Mouseover Popups enable you to position the mouse cursor over certain areas of the IDE and get some information on them in a popup window that appears floating in front. Information is available on the following:
Javadoc
Source code
Data values while debugging
Breakpoints
The popup window appears when you move the mouse over and optionally press the key that you assign for the feature. The following are some of the areas of the IDE that mouseover popups are available for:
Structure window
Text in an editor
The Smart-Popup feature shows the most appropriate popup for a given situation, depending on the order of popups specified in the Mouseover Popups page of the Preferences dialog. Smart-Popup is activated by a keystroke which you can specify on the Mouseover Popups page of the Preferences Dialog.
For example, you may have the following popup configuration (set using the Mouseover Popups page of the Preferences dialog)
Smart-Popup is enabled and configured on the Control key.
The Data Values, Documentation, and Source popups all have Smart-Popup enabled and are ordered in the following way: Data Values, Documentation, Source Code in the Mouseover Popups table.
With this configuration, if you hover the mouse over a variable in the source editor and press Control, then:
The Data Values popup is considered first. If you are debugging and the mouse hovers over a variable with a value, the Data Value popup is displayed.
If no popup is displayed for the previous step, then the Documentation popup is considered next. If the variable has any documentation, it is displayed in a popup window.
If no popup is displayed for the previous step, then the Source popup is considered next, and the source code for the variable (if available) is displayed in a popup window.
With Smart-Popup, you only need to use the Smart-Popup activation keystroke for the IDE to display the most appropriate popup
Note:
Even with Smart-Popup enabled, the individual popups for Data Values, Documentation, and Source Code can still be activated by their respective activation keys.
You can quickly locate the source node in the Application Navigator for any file opened for editing, whether or not that node is in the current project.
To locate the node for any file opened in the editor:
Make sure that the focus in the editor is on the file you wish to locate.
From the context menu, choose Select in Navigator.
You can use bookmarks in your source files to help you quickly locate relevant code. You can use the Bookmarks Window to navigate to bookmarked material.
To set or remove a bookmark in a source file:
Within the file, place the cursor in the gutter of the line you would like bookmarked.
Right-click and choose Toggle Bookmark.
Oracle JDeveloper provides several features for editing source files.
JDeveloper provides a powerful source editor that will help you write different kinds of code quickly and efficiently.
You can set preferences for the specific editor for each file type.
To open your source code in its default editor:
In the Application Navigator, double-click the file or right-click and choose Open.
The default editor associated with that file type appears in the content area. If the editor is already open on that file, the editor comes to the foreground.
To open your source code in a specific editor or viewer:
In the Application Navigator, double-click the file or right-click and choose Open.
In the editor window, select the appropriate editor tab.
Changes made in the source will be immediately reflected in other views of that file.
You can also generate Java source code from modeled Java classes.
It is possible to edit source code that you have opened in JDeveloper with an outside editor, should you wish to do so. When you return to the JDeveloper IDE, it will detect the changes you have made.
Before you edit a file externally, you should first save any changes made in JDeveloper. If you do not, when you return to JDeveloper, you will be asked whether to reload those files or not. If you reload the externally modified files, you will lose the unsaved changes made in JDeveloper. If you do not reload them, you will lose the changes made outside JDeveloper once you save the file in JDeveloper.
To edit source code with an external editor, with the file open in JDeveloper:
Save any changes made to the file open in JDeveloper.
Edit your file externally and save your changes to the disk.
Return to JDeveloper and to the file open in the source editor.
By default, the file is reloaded in JDeveloper without a confirmation beforehand. To receive a confirmation dialog, deselect the Silently Reload When Buffer Is Unmodified option on the Environment page of the Preferences dialog.
Once you have added code snippets to the Component Palette, you can add them to files open in the editor.
Alternatively, you can use code templates to assist you in writing code more quickly and efficiently while you are in the source editor.
To insert a code snippet from the Palette into a source file:
Open the file in the source editor.
If the Component Palette is not visible, open it by choosing View > Component Palette.
In the Palette dropdown list, select Code Snippets or the snippets page you have defined.
The snippets defined for that page appear listed to the right. Toggle between list and icon views by right-clicking and choosing the view you want from the context menu.
Position your cursor in the file at the point where the snippet is to be inserted.
In the Palette, click the snippet name or icon.
The code snippet appears in the file.
You can record, and play back, keystroke sequences in files open in the source editor.
To define shortcut keys for recording and playing back:
From the main menu, choose Tools > Preferences.
In the Preferences dialog, select the Shortcut Keys node.
On the Shortcut Keys page, in the Search field, enter Macro Toggle Recording
.
You will see the Macro Toggle Recording action selected under Available Commands.
To assign a shortcut, place focus in the New Shortcut field, and enter a shortcut by pressing the key combination on the keyboard.
If this proposed shortcut already has an command associated with it, that command will appear in the Conflicts field.
To assign the shortcut you have specified, click Assign.
Now, in the Search field, enter Macro Playback
.
Repeat steps 5 and 6 to assign a shortcut for playing back the macro.
Click OK.
Open the source file in an editor.
To begin recording, press the key combination you have defined for recording macros.
Now enter the keystroke sequence you wish to record.
To end recording, again press the key combination you have defined for recording macros.
Open the source file in an editor.
Position your cursor in the open file.
Press the key combination you have defined for playing back macros.
You can create tasks that are directly related to lines in files of source code, or tasks that are associated with applications, projects or general files. Oracle JDeveloper comes with the tags TODO
, TASK
, and FIXME
and the priorities HIGH
, MEDIUM
, LOW
and NONE
preconfigured, and you can add your own task tags and priorities in the Tasks page of the Preferences dialog.
To add your own task priorities and task tags:
From the main menu, choose Tools > Preferences.
In the Preferences dialog, select the Tasks node.
On the Tasks page, alter the priorities and source tags to suit your requirements.
For more information, press F1 or click Help from within the dialog page.
Click OK.
To create a task associated with a comment line in source code:
Open the tasks window by choosing View > Tasks Window.
Within the source code file, create a comment line starting with // and one of the task tags, for example //TODO
.
Continue to type the comment, which will at the same time appear as the description of the task in the tasks window.
Set the other options in the task window as required. For help while using the tasks window, press F1.
To create a task associated with an application, project or file:
In the navigator, select the object for which you wish to create a task.
Open the tasks window by choosing View > Tasks Window.
Select the Add Tasks button, which will open the Add Task dialog.
Complete the dialog for the task that you want to create. For help while using the Add Task dialog, press F1.
You can compare source files either belonging to the same project, or outside.
To compare a file currently being edited with its saved version:
Place the focus on the current version open in the editor.
Select the History tab in the editor window.
The saved file opens side by side with the file in the editor buffer.
To compare one file with another file outside the project:
Place the focus on the file in the editor to be compared.
From the main menu, choose File > Compare With Other File.
In the Select File to Compare With dialog, navigate to the file and click Open.
The two files open side by side, under a tab labeled Compare.
To compare any two files within the same project:
In the navigator, select the two files to be compared.
From the main menu, choose File > Compare With > Each Other.
The two files open side by side, under a tab labeled Compare.
While you are in the process of making changes to a file, at any time you can revert to the last saved version of the file.
To revert to the last saved version of a file:
While the changed file has focus in the editor, from the main menu choose File > Replace With > File On Disk.
In the Confirm Replace dialog, click Yes.
Any changes you have made since the last save are now undone.
Oracle JDeveloper provides a powerful source editor that will help you write different kinds of code quickly and efficiently.
To search a source file currently open in the source editor, with the option to replace text:
With the file open in the editor, ensure that the editor has focus.
Optionally, if an instance of the text you want to search for is easily found, you can highlight it now.
From the main menu, choose Search > Find. Alternatively, press Ctrl+F.
In the Find Text Dialog, enter or select the text to locate.
Text previously searched for in this session of JDeveloper appears in the Text to Search For dropdown list.
Select other search parameters accordingly.
For more information, press F1 or click Help from within the dialog.
Click OK.
To do a simple search in the open source file for a single text string:
With the file open in the editor, ensure that the editor has focus.
Place the cursor in the file at the point you wish to search from.
From the main menu, choose Search > Incremental Find Forward or Search > Incremental Find Backwards.
In the dialog, enter the search text.
As you type, the cursor jumps to the next instance of the group of letters displayed.
Alternatively, enter the text string in the search box. As you type, the cursor jumps to the next instance of the group of letters displayed. Use the Previous or Next buttons to search up and down the file. Click in the search box to set Match Case, Whole Word, or Highlight Occurrences.
To search all files in a project or an application:
From the main menu, choose Search > Find in Files.
In the Find in Files dialog, enter or select the text to locate.
Text previously searched for in this session of Oracle JDeveloper appears in the Search Text dropdown list. By default, if you opened this dialog with text selected in the source editor, that text appears as the first entry.
If you want to choose the file types that are included in the search, click the File Types button to open the File Types To Include dialog. By default, all file types will be searched.
Select other search parameters as required.
For more information, press F1 or click Help from within the dialog.
Click OK.
Oracle JDeveloper enables you to print source files.
Display the file to be printed in an editor, or select its filename in the navigator.
From the main menu, choose File > Print.
In the Print dialog, select your print options.
Click OK.
Regular expressions are characters that customize a search string through pattern matching. You can match a string against a pattern or extract parts of the match.
JDeveloper uses the standard Sun regular expressions package, java.util.regex. For more information, see "Regular Expressions and the Java Programming Language" at http://docs.oracle.com/javase/tutorial/essential/regex/
.
Extensions are components that are loaded and integrated with JDeveloper after it is started. Extensions can access the IDE and perform many useful tasks. In fact, much of JDeveloper itself is composed of extensions. Most of the basic functionality in JDeveloper is implemented as extensions—software packages which add features and capabilities to the basic JDeveloper IDE. You can add existing extensions into JDeveloper, or create your own.
This section contains information on finding, installing, and enabling or disabling JDeveloper extensions. The simplest way to find and download JDeveloper extensions is through the Check for Updates wizard.
If you need additional capabilities from the IDE (such as integration with a version control system or a special editor or debugger), you can add external tools to JDeveloper. See Section 3.12, "Adding External Tools to JDeveloper" for more information. In addition, you can obtain additional extension development tools and functionality in the Extension Software Development Kit (SDK). You can download the Extension SDK via the Check for Updates wizard.
You can also download the Extension SDK from the Oracle Technology Network Web page.
Note:
Any time an extension is added or upgraded, the migration dialog appears at startup in case you need to migrate any previous settings related to that extension.
The easiest way to find and install extensions is to use the Check for Updates wizard.
To install extensions using the Check for Updates wizard:
From the Help menu, select Check for Updates.
Follow the steps in the wizard to browse, download, and install patches and extensions.
You can also access the Check for Updates wizard from the Tools > Features page.
Some extension providers prefer to have you install directly from their Web site, so that among other things they can contact you when there are updates to the extension. In this case, the Check for Updates wizard will inform you of the provider's preference, and will then open your default Web browser so that you can conduct the download and installation from the provider's Web site.
To download and install from the provider's Web site:
Follow the instructions on the provider's Web site for downloading and installing the extension. Be sure to note any comments or instructions on registration, configuration, or other setup requirements.
You can find and download extensions from the JDeveloper Extensions Exchange website on OTN. The page is located here:
http://www.oracle.com/technetwork/developer-tools/jdev/index-099997.html
The available extensions include:
JUnit Extension, an extension you can use to create and run test cases, test suites, and test fixtures, using JUnit.
iSQL*Plus Extension, an extension that enables you to load or execute SQL*Plus scripts from within JDeveloper.
Oracle Business Intelligence Beans, a set of standards-based JavaBeans™ that enables developers to build business intelligence applications.
Other extensions to JDeveloper contributed by the JDeveloper community.
To install extensions after you have downloaded them from OTN:
For extensions created for the current release, see the Oracle Fusion Middleware Developer's Guide for Oracle JDeveloper Extensions.
For extensions created for earlier releases, see: "Extension Packaging and Deployment For Previous Versions of JDeveloper" in the Extension SDK. Extensions were packaged differently and placed in a different location in earlier releases.
JDeveloper supports the concept of a "watched directory". A watched directory is a location where a user or script can drop files and have them discovered by JDeveloper automatically the next time it starts.
To install an extension using the dropins directory:
Drop your extension jar in the JDeveloper dropins directory, which is located in the jdeveloper/dropins
folder.
Additional dropins directories can be specified via the ide.bundle.search.path property
, either at the command line or by adding an entry in the jdev.conf file.
You can access the JDeveloper online help through the Help Center. This section describes how you can effectively use the features of the Help Center.
The JDeveloper Help Center comprises two windows: the help navigator and the help topic viewer.
The following types of content are available:
Conceptual and procedural information, which is available in this guide.
Context sensitive online help topics, which open when you press F1 or click Help in a dialog or wizard, or click the help icon in a wizard.
Developer guides, which provide end-to-end information for developing applications with specific technologies.
Tutorials, which provide introductions to many JDeveloper application scenarios.
From the Help Center, you can also access additional documentation on Oracle Technology Network (OTN).
The Help Center search feature lets you search the installed documentation, the documentation available from OTN, and the Fusion Middleware Documentation Library.
You can also customize the way you view content.
The Help Center enables you to browse the table of contents, locate relevant topics in the dynamic help links lists, and do a full text search of installed and online content. It also provides a Favorites navigator for saving links to frequently referenced topics. The Help Center comprises two windows: the help navigator and the help topic viewer. You can customize some aspects of these windows.
The following table describes the features available in the Help Center toolbar.
Table 3-27 Help Center Toolbar Icons
Icon | Name | Description |
---|---|---|
Keep Help Center on Top (Alt+K) |
Keeps the Help Center on top of all other open windows. |
|
Navigators |
Opens Help Center navigators you have previously closed. |
|
JDeveloper Forum |
Launches an external browser window and visit the JDeveloper Forum on Oracle Technology Network (OTN). |
|
Search |
Searches all the documentation installed as online help, Oracle Technology Network (OTN) and the Fusion Middleware and Database Libraries. |
The Help Center includes tabs for navigating content on the left:
Contents - Displays the table of contents for all installed content in the help system, including traditional online help, tutorials, developer guides, and the user guide.
Favorites - Displays folders of user defined help topics and external links you have saved for quick retrieval.
The Help Center includes the following tabs for viewing content and search results on the right:
Help content viewers - Display the selected online help and developer guide contents. Multiple tabbed pages open for selected content.
Tutorial viewer - Displays a selected tutorial. Only one tutorial viewer opens.
Search results - Displays the results of the full text search.
The JDeveloper Help Center comprises two windows: the help navigator and the help topic viewer.
To open the online help, use any of these methods:
Press F1, click Help, or click the Help icon at any time to display context-sensitive help.
From the main menu, choose Help > Search.
From the main menu, choose Help > Table of Contents.
From the main menu, choose Help > Help Favorites.
From the Start page, choose any link with a tutorial, book or help topic icon.
To see a help page that is already open:
Select a tab at the top of the help topic window.
Click the scroll buttons at the top of the help topic window to scroll through all available tabs and select a tab.
Click the Tab List button at the top of the help topic window to display the list of all available pages and select a page.
You can search all the documentation installed as online help by doing a full-text search, and you can also search Oracle Technology Network (OTN) and the Fusion Middleware and Database Online Documentation Libraries. You can search an individual help topic that is open by using the Find icon in the topic viewer toolbar.
To do a full-text search from the Help Center:
If the Help Center is not open, from the main menu, choose Help > Search.
In the Search field, enter the word or phrase you are searching for.
Optionally, open the Search Options menu and select the locations you want to search. By default, Local Documentation and the Fusion Middleware library are selected.
Set the other search options as needed; these apply only to the online help search.
Click the Go icon or press Enter.
The Search Results page opens in the help viewer area, with the titles and sources of each matching document, as well as the beginning text.
To select a topic, double-click its title.
Each help topic opens in a separate tabbed page. The Search Results page remains available. Each OTN and Documentation Library page opens in your default browser.
Using the Boolean Expressions option:
BooleanExpression is a recursive tree structure for expressing search criteria involving boolean expressions. The BooleanExpression is based on the following grammar:
BooleanExpression :: BooleanExpression AND BooleanExpression BooleanExpression OR BooleanExpression BooleanExpression NOT BooleanExpression BooleanExpression + BooleanExpression BooleanExpression - BooleanExpression + BooleanExpression - BooleanExpression NOT BooleanExpression StringExpression (base case)
To begin a documentation search from the main toolbar Search field:
In the Search field, enter the word or phrase you are searching for.
Open the Search Options menu and select only the documentation: Help: Local, Help: OTN, Help: iLibrary. Deselect other locations.
By default, all locations are selected.
Click the Go icon or press Enter.
The Help Center opens with the Search Results page on the right, showing the titles and sources of each matching document, as well as the beginning text.
You can save links to frequently referenced help topics, stored in folders you create and name, on the Favorites page in the Help Center. The help topic must be open in the help topic viewer, in order to bookmark it. You can also add links to external sites.
To add links to help topics to the Favorites page:
Click the Add to Favorites icon in the help topic viewer toolbar.
The Add to Favorites dialog is displayed.
Select the folder to which you want to add the link and click OK.
To add links to external sites to the Favorites page:
Click the Add External Favorites icon in the Favorites page toolbar, or right-click a node on the Favorites page and choose Add External Favorites from the context menu.
The Add External Favorites dialog is displayed.
Enter a title for the page or document in the Name field.
Enter the fully qualified path in the URL field.
Select the folder to which you want to add the link and click OK.
To create a new Favorites folder:
Click the New Folder icon in the Favorites page toolbar, or right-click a node on the Favorites page and choose New Folder from the context menu.
Enter the new folder name and click OK.
You can also create a new folder when the Add to Favorites dialog is open, by clicking New Folder.
Right-click a folder on the Favorites page and choose Rename from the context menu.
Enter the new folder name and click OK.
You can also rename a folder when the Add to Favorites dialog is open, by clicking Rename.
To delete a Favorites folder or link:
Click the Delete icon in the Favorites page toolbar, or right-click a node on the Favorites page and choose Delete from the context menu.
You can also delete a folder when the Add to Favorites dialog is open, by selecting the node and clicking Delete.
You can customize some features of the Help Center window, as well as the navigators and topic viewers through the toolbars and context menu.
Use the Keep on Top icon to keep the Help Center in front of all open windows, including JDeveloper.
You can select the following types of help that you want to display from the Navigators drop down in the Help Center toolbar:
Contents - Displays the table of contents for all installed online help topics and books.
Favorites - Displays folders of user defined links for quick access to installed and external documentation.
Alternatively, you can right-click in the Help Center and choose a navigator from the Configure Tabs option on the context menu, to open navigators you previously closed.
You can also choose to view all help topics in the Contents navigator, or reduce what is displayed by selecting a single content type from the Contents drop down, as shown in the following figure.
Use the Change Font Size options in help topic viewer toolbar to increase or decrease the font size incrementally.
When you navigate through topics in the help system, the topics open in new tabbed pages.
To see a help page that is already open, use one of the following ways:
Select a tab at the top of the help topic window.
Click the scroll buttons above the help topic viewer to scroll through all available tabs and select a tab.
Click the Tab List button above the help topic viewer to display the list of all available pages and select a page.
When you open topics by clicking links within topics, the topics open within the same viewer. To cycle through those topics, click the Forward or Back icons in the help topic viewer toolbar. Note that you cannot navigate forward or back between different types of help viewer tabs; for example, the search results and help topic tabs. Use the scroll buttons instead.
To close one or more pages open in the help topic viewer:
Right-click in the help topic viewer tab and choose from options on the context menu.
You can close the page in front, all the pages, or all the pages except the page in front.
You can print help topics individually or by section.
To print an individual help topic:
Open a help topic in the help topic viewer.
In the help topic viewer toolbar, click the Print icon.
Click the Contents tab in the Help Center.
In the table of contents tree, select a topic folder.
Right-click and choose Print Topic Subtree.
The container topic and its children are printed. Topics listed as links are not printed.
This section provides an introduction to fundamental JDeveloper IDE functionality and concepts.
Use the Application Overview pages to guide you as you build a Fusion Web application, and to create files and objects and view the status of them.
The Application Overview Checklist steps you through the building of a Fusion Web application, according to Oracle recommended best practices. The Checklist is displayed by default when a Fusion Web application is created, as part of the Application Overview pages.
The checklist optionally walks you through the entire process of configuring and building your application, with links to specific dialogs and wizards. Each step is also designed to teach you about the architecture, tools and resulting files using a combination of links to step-by-step instructions, relevant sections of the Developer's Guides, and descriptions of what happens in the IDE as a consequence of doing the work in a step.
Unlike a wizard, the Checklist itself is intended to provide a linear, but ultimately flexible and lightweight guide. You can follow the prescribed path in exact sequence, or explore tasks in a different preferred order. When using the Checklist, it suggests a best way to accomplish your goals, but you are not restricted by it. You can also close the Application Overview and work directly in the IDE, or work in both the IDE and Checklist interchangeably.
Expand a step and read the prerequisites and assumptions.
Optionally click any of the documentation links.
Click the button that takes you to the relevant area of the IDE.
Use the status indicator dropdown to change the status as you work through tasks.
All files and artifacts that you create within JDeveloper appear in the Application Overview file summary pages, organized by object type. You can create new files and artifacts, and view them filtered by status and project. The following table describes the types of file summary pages.
Page | Function |
---|---|
Status |
Displays information about the object types available, using these status icons:
|
File |
Displays the names of the objects. You can sort the objects in ascending or descending order by clicking the Sort icon in any of the column headings. |
Project |
Displays the project in which the file or object is located. |
The following table describes the icons in the File Summary Pages toolbar and their functions.
Table 3-29 Icons in the File Summary Pages Toolbar
Icon | Name | Function |
---|---|---|
New |
Creates new objects of the types listed, in the selected project. The context menu lists the files and objects associated with the technology that can be created in each project. |
|
Edit |
Opens the selected file or object in its default edito.r |
|
Delete |
Removes the selected file or object. |
|
Filter Status or Project |
Displays the list of all files of a particular status by selecting the status, as described above. By default, Show All is selected. If there is more than one project within the current application, use this list to select which project or projects you wish to be included in the file summary pages. You can choose:
|
Use the File List to search for and work on objects that you have created within an application. The rules, code assists, and metrics that are used to analyze Java code are specified by the Code Assist profile.
The following table describes the options available in the file list tab header.
Table 3-30 File List Tab Header Options
Option | Function |
---|---|
Look in |
If you have more than one project within the current application, use this list to select which project or projects will be searched for objects. The list includes all projects in the current application, plus options to show all projects and a selection of projects (multiple projects). You can choose:
|
Saved Searches |
Initially contains <New Search>. After you have saved at least one search, also lists all saved searches. Selecting a saved search will display the search criteria for that search. The search results will show the results of the most recent search, even as you change between saved searches. To obtain new search results, click the Search button. Saving a search is one of the actions available from the More Actions button. |
Show History |
Opens the Recent Searches dialog, through which you can return to a recent search. The search criteria of the selected search is shown, while the search results remain as they were for the most recent search. To obtain new search results, click the Search button. |
The following table describes the features available in the search criteria area.
Table 3-31 Features in the Search Criteria Area
Option | Function |
---|---|
Search criteria input line(s) |
Initially contains a single input line for search criteria. You can add further lines by clicking the Add icon at the end of the line. You can remove lines by clicking the Delete icon at the end of the line that you want to remove. By default, the first field in the line contains File Name: you can change this to File Extension, Date Modified, Status, or Category. The second field contains the options available for extending the entry in the first field. The third field contains a list of all object types that can be searched for. |
Match options |
Choose between Match All and Match Any to determine the scope of the search. |
Search |
Click to begin a search based on the search criteria currently shown. |
More Actions |
Click to reveal the following menu of options for use with named searches:
|
The following table describes the options available in the Search Results table.
Table 3-32 Options Available in the Search Results Table
Option | Function |
---|---|
Results summary |
Shows the number of files that match the search criteria, and the date and time that the search was completed. |
Refresh |
Reruns the search with the current search criteria. |
Customize table |
Opens a menu from which you can choose the columns that will be displayed in the results table. Also contains a Select Columns option, which opens the Customize Table dialog, through which you can choose which columns to display and the order in which they are displayed in the results table. The columns that are shown by default are Status, File, Project, and Date Modified, in that order. Other columns that you can choose to show are Application and Category. |
Table headings |
You can change the order of the columns by grabbing a table heading and moving it horizontally. You can change whether objects are shown in ascending or descending order within the columns by clicking a heading to give it focus, then clicking again to change the sort order. The sort icon (or) in the table heading will change as appropriate. |
Objects list |
Lists all the objects returned by the search. You can initiate actions for an object by selecting the name, right-clicking, and selecting from the context menu. |
The Compare Window allows you to view the differences between two files or two directories.
You might want to do this when deciding whether to check in a particular file to a source control system, especially if doing so will overwrite a file whose contents you are unfamiliar with. The Compare Window is integrated with the Application Overview and the Application Navigator, and with the Subversion source control system.
The following table describes the icons in the Compare Window toolbar and their functions.
Table 3-33 Compare Window Toolbar Icons
Icon | Name | Function |
---|---|---|
Go to First Difference |
Click to move the cursor to the first difference. |
|
Go to Previous Difference |
Click to move the cursor to the previous difference. |
|
Go to Next Difference |
Click to move the cursor to the next difference. |
|
Go to Last Difference |
Click to move the cursor to the last difference. |
|
Generate Patch |
Click to open the Generate Patch dialog, where you can generate a patch containing changes that have been made to the files. |
The Application Navigator allows you to manage the contents and associated resources of an application.
This section describes the features available from the Application Navigator toolbar.
Use the main dropdown list, displayed in the figure below, to create a new application, open an existing application, or choose from the list of open applications. Use the context menu to choose from the list of application level actions available.
Use the application menu, displayed in the figure below, to choose from a list of actions available.
The following table describes the options available from the Application Menu.
Table 3-34 Application Menu Options
Menu Option | Function |
---|---|
New Project |
Opens the New Gallery ready for you to select the type of project to create. |
New (Ctrl+N) |
Opens the New Gallery. Only those items available to be created from an application are available |
Open Project |
Opens the Open Project dialog, where you navigate to a project that you want to open in this application. |
Close Application |
Closes the current application. |
Delete Application |
Deletes the application control file (.jws) from disk. |
Rename Application |
Opens the Rename dialog where you can change the name of the current application. |
Find Application Files |
Opens the File List, where you can search for specific files. |
Show Overview |
Opens the Application Overview which is the home for all files you can create in this application. |
Filter Application |
Opens the Manage Working Sets dialog where you can specify the files to include or exclude from being listed in the Application Navigator. |
Secure |
Secures your application resources. |
Deploy |
Allows you to choose from the deployment profiles defined for the application. |
Application Properties |
Opens the Application Properties dialog where you can set various properties for the application. |
You can several application operations from the Application Navigator. These include:
In the initial view, before any application content is shown, select the New Application link to create a new application or select the Open Application link to open an existing application.
Open any currently closed navigator, or bring a currently open navigator to the foreground, using View > navigator-name.
Move, size, float, minimize, maximize, restore or close the Application Navigator using the context menu available by right-clicking its tab or by pressing Alt+Minus.
Change the application shown in the navigator by choosing one from the main dropdown list or, if the one you want is not shown, by choosing Open Application.
Create a new application by choosing New Application from the dropdown list.
Open the context menu for the application by right-clicking the application, or by clicking the Application Menu icon (to the right of the application name).
You can perform the following operations from the projects panel of the Application Navigator:
View the project properties by clicking the Project Properties icon.
Refresh the project contents by clicking the Refresh icon.
Filter the project content that you work with by selecting options from the Working Sets dropdown menu.
Change what is shown in the navigator by selecting options from the Navigator Display Options dropdown menu.
Obtain a context-sensitive menu of commands for any node by right-clicking it.
Display the structure of an object in the Structure window by clicking the object's name.
Open an object in its default editor, or bring the default editor into focus, by double-clicking the object's name.
Rename a file using File > Rename.
Relocate a file using File > Save As.
Search for items visible in the panel by putting the focus anywhere inside it and typing a search string for the object you are looking for. (Precede with an asterisk to search for instances of names containing the search string.)
Close or open the panel by clicking its bar.
Remove the panel from view by opening its dropdown menu (panel bar, far right) and choosing Minimize. Restore it by clicking the three dots at the very bottom of the navigator and then clicking Projects.
You can perform the following operations in the Application Resources panel:
Close or open the panel by clicking its bar.
Change the area used by the panel by grabbing its bar and moving it up or down.
Remove the panel from view by opening its dropdown menu (panel bar, far right) and choosing Minimize. Restore it by clicking the three dots at the very bottom of the Application Navigator and then clicking Application Resources.
Obtain a context-sensitive menu of commands for any node by right-clicking it.
Display the structure of an object in the Structure window by clicking its name.
Open an object in its default editor, or bring the default editor into focus, by double-clicking the object's name.
Search for items visible in the panel by putting the focus anywhere inside it and typing a search string for the object you are looking for. (Precede with an asterisk to search for instances of names containing the search string.)
You can perform the following operations in the Data Controls panel:
Close or open the panel by clicking its bar.
Change the area used by the panel by grabbing its bar and moving it up or down.
Remove the panel from view by opening its dropdown menu (panel bar, far right) and choosing Minimize. Restore it by clicking the three dots at the very bottom of the Application Navigator and then clicking Data Controls.
Obtain a context-sensitive menu of commands for any node by right-clicking it.
Edit the definition of a data control by opening its context menu and choosing Edit Definition.
Search for items visible in the panel by putting the focus anywhere inside it and typing a search string for the object you are looking for. (Precede with an asterisk to search for instances of names containing the search string.)
You can perform the following operations in the Recently Opened Files panel:
Close or open the panel by clicking its bar.
Change the area used by the panel by grabbing its bar and moving it up or down.
Remove the panel from view by opening its dropdown menu (panel bar, far right) and choosing Minimize. Restore it by clicking the three dots at the very bottom of the Application Navigator and then clicking Recently Opened Files.
Open an object in its default editor, or bring the default editor into focus, by double-clicking the object's name.
Search for items visible in the panel by putting the focus anywhere inside it and typing a search string for the object you are looking for. (Precede with an asterisk to search for instances of names containing the search string.)
The Application Server Navigator allows you to manage connections to application servers. It is integrated with the Resource Palette.
When you create an application server connection in the Application Server Navigator it is available in the Resource Palette. Similarly, when you create an application server connection in the Resource Palette, it is available in the Application Server Navigator.
From the context menu of the Application Server Navigator, you can:
Create a new connection to an application server by choosing New Application Server from the context menu of the Application Servers node.
Import connections by clicking Import from the context menu of the Application Servers node.
Export connections by clicking Export from the context menu of the Application Servers node.
Edit the properties of an existing application server connection by choosing Properties from the context menu of the connection.
From the context menu of IntegratedWebLogicServer, you can:
Start the Integrated WebLogic Server.
Start the Integrated WebLogic Server in debug mode.
Create the Default Domain. When you first start the Application Server Navigator, the only node is IntegratedWebLogicServer (domain unconfigured). Before you can work with Integrated WebLogic Server, you must create a default domain. If you are creating the default domain for the first time, you must enter an administrator password for the new domain.
Update the Default Domain.
Configure a log to help diagnose problems.
Launch the Admin Console for:
Integrated WebLogic Server.
Oracle WebLogic Server.
The following table describes the icons in the Application Server Navigator toolbar:
The Structure window offers a structural view of the data in the document currently selected in the active window of those windows that participate in providing structure: the diagrams, the navigators, the editors and viewers, and the Property Inspector.
Depending on the document currently open, the Structure Window enables you to view data in two modes:
Source - displays the code structure of the file currently open in the editor. Applicable to technologies that allow code editing. For example, this tab will not be available when a diagram is open for editing.
Design - displays the UI structure of the file currently open in the editor.
In the Structure window, you can view the document or diagram data in a variety of ways. The structures available for display are based upon document or diagram type. For a Java file, you can view code structure, UI structure, or UI model data. For an XML file, you can view XML structure, design structure, or UI model data.
The Structure window is dynamic, tracking always the current selection of the active window (unless you freeze the window's contents on a particular view), as is pertinent to the currently active editor. When the current selection is a node in the navigator, the default editor is assumed. To change the view on the structure for the current selection, select a different structure tab.
The windows that participate in providing structure also follow selections made in the Structure window. Double-clicking the node for a method in the Structure window, for instance, makes the source editor the active view and takes you directly to the definition for that method.
You can open multiple instances of the Structure window, freezing the contents of any number of them, in order to compare the structures of different files. You can also switch structure views without changing editors.
Diagram objects (such as UML elements) listed in the Structure window can be dragged from the window and dropped directly onto diagrams.
The following table describes the icons in the Structure Window toolbar and their functions:
Table 3-36 Structure Window Toolbar Icons
Icon | Name | Function |
---|---|---|
Freeze |
Click to freeze the Structure window on the current view. A window that has been frozen does not track the active selection in the active window. |
|
New View |
Click to open a new instance of the Structure window. The new view appears as a tabbed page in the same window. |
The Structure window view depends upon the document type of the current selection in the active window. Each view offers different options for viewing and sorting the structure of your files based on file type.
The following table describes the Structure Window views.
Table 3-37 Structure Window Views
View | Description |
---|---|
ADF Business Components View |
When you select any ADF business component in one of the navigators, the Structure window offers a structured view of the component's files, attributes, and other properties. |
Cascading Style Sheet View |
This view allows you to select and group CSS elements for easy editing. When a CSS file is open for editing, CSS selectors in the file are displayed in the Structure window as one of three types: Element, Class, and ID. |
Java View |
This view displays the code as well as design structure of the Java file currently being edited. Additionally, you can specify several display preferences to view structural data. |
JSP/HTML View |
This view displays the code structure and UI bindings for the JSP/HTML file that is currently selected. |
Struts View |
The Struts view shows the hierarchy of elements and attributes for the Struts configuration file currently selected in the active navigator or editor. |
TopLink View |
The TopLink view displays detailed information about the TopLink element selected in Application Navigator or TopLink editor, including descriptors, sessions, and mappings. |
UML View |
The UML view displays the behavior, interaction, and code structure in UML-based diagrams such as Activity Diagrams, Class Diagrams, and Use Case Diagrams. |
Diagram View |
When a diagram is open for editing, the Diagram view displays the components that have been added to the diagram. You can select an element in the Structure Window's diagram view and locate it in the diagram |
Use to view the data controls created to represent an application's business services and to create databound UI components by dragging and dropping the control panel objects onto an open web page or ADF Swing panel.
Note:
The Data Controls panel may appear empty if no data controls have been created for or imported into the application.
The panel displays objects to which your UI components can be bound, including data collections, attributes, and methods that the business services developer exposed through the Oracle ADF data control, as well as specific, built-in operations that are generic to all data collections.
When you drag an object from the Data Controls panel onto a page, the context menu displays the UI components you can create for that specific object. Creating components this way means that they will automatically be databound to the dropped object.
After inserting a databound UI component into the displayed web page or Java panel, you can view the Oracle ADF data binding:
In the code view of a web page, where data binding objects appear in expressions that get evaluated at runtime using the expression language features of the JSTL tag library.
In the code view of an ADF Swing panel or form, where the setModel()
method call on the UI component initializes the data binding object and accesses the Oracle ADF binding context (specified by the setBindingContext()
method call on the panel).
In the associated page definition file. The page definition file defines the bindings created for the page, panel, or form.
The following table describes the icons in the Data Controls panel toolbar and their functions:
The Log window displays tabbed windows for specific feedback from various components of the IDE.
The Log window displays information on:
Compiler. The compiler reports error messages that you can double-click to navigate directly to the correct line in the source file referenced.
Apache Ant. When you build your project using Apache Ant, the Log Window displays relevant build information.
Debugger
Audit
Profiler
To bring up the context menu for the contents of the Log window, right-click within the window. To bring up the context menu for the Log window as window, right-click on the tab.
From the context menu for the general Log window, you can:
Copy the contents of the window
Select all data within the window
Wrap the text in the window
Clear the contents of the window
Save the contents of the window to another format
Close the window
Other actions may be available within the tabbed sections generated by specific processes.
From the context menu for the window itself, you can:
Close the window
Close all other tabs but for the currently selected tab
Close all tabs within the window
The Status Window is one of the JDeveloper features that helps you to audit your code. It displays audit violations in the document selected in the File List and provides information to help you resolve the issues.
The Code Assist audit profile determines the audit violations that are reported.
You can choose the items you want to view using the icons in the Status window toolbar.
The following table describes the icons in the toolbar and their functions:
Table 3-39 Status Window Toolbar Icons
Icon | Name | Function |
---|---|---|
Show Error Issues |
Toggle to show just the number of errors in the selected file, or to list the errors in the file. |
|
Show Warning Issues |
Toggle to show just the number of warnings in the selected file, or to list the warnings in the file. |
|
Show Incomplete Issues |
Toggle to show just the number of incomplete issues in the selected file, or to list the incomplete issues in the file. |
|
Show Advisory Issues |
Toggle to show just the number of advisory issues in the selected file, or to list the advisory issues in the file. |
|
Fixes |
Select one of the issues in the list, and click Fixes. A suggested fix is displayed, for example: Add missing Javadoc tags. |
Use this dockable window to record tasks associated with applications, projects and files.
If you are working in a Java Class source file, a task will automatically be created whenever you type // TODO
(in other words, when you create a comment and use the source tag recognized by JDeveloper).
While you are using the Tasks window, these features are available:
Sort the information by clicking the column headings.
Show or hide columns by opening the context menu for any heading and choosing from the list. Alternatively, you can choose Show/Hide Columns from the context menu of any task.
Add a task by choosing Add Task from the context menu of any task.
Edit an existing task by choosing Edit Task from the context menu of the task.
Delete a task by choosing Remove Task from the context menu of the task.
Delete completed tasks by choosing Remove Completed Tasks from the context menu of any task.
Open the file that the task refers to by choosing Go to Source from the context menu of the task.
The toolbar enables you to manage the tasks displayed in the Tasks window. The following table describes the icons in the Tasks Window toolbar and their functions.
Table 3-40 Tasks Window Toolbar Icons
Icon | Name | Function |
---|---|---|
Current Application |
Choose to define the current application as the scope of the tasks displayed. |
|
Current Project |
Choose to define the current project as the scope of the tasks displayed. |
|
Current File |
Choose to define the current file as the scope of the tasks displayed. |
|
Add task |
Click to create a new task (independent of source file comments). |
|
Edit task |
Click to edit the highlighted task. |
|
Delete task |
Click to remove highlighted task. |
|
Filter |
Click to open the Filter Tasks dialog, where you can set up filters to determine which tasks are and are not shown. |
External tools are custom JDeveloper menu items and toolbar buttons that launch applications installed on your system, applications that are not packaged as part of JDeveloper.
To find all external programs that JDeveloper is preconfigured to support:
From the main menu, choose Tools > External Tools.
In the External Tools dialog, click Find Tools.
To add access to an external program from JDeveloper:
From the main menu, choose Tools > External Tools.
In the External Tools dialog, click New. Follow the instructions in the wizard.
To change how an external program appears, or remove access to an external program from JDeveloper:
From the main menu, choose Tools > External Tools.
In the External Tools dialog, click Edit or Delete. If you are editing the options, display, integration or availability of an external tool from JDeveloper, select the corresponding tab and change the values. Click Help for help choosing valid values.
Click OK. Your changes are reflected immediately.