Home

Productivity! User Manual

Contents

1. Figure 116 Assistant Issue Highlight Style options eet i The Assistants Displaying Delay option allows specifying delay should be used to display ie i a Assistant popup Delay Assistant Displaying Delay Delay FE Figure 117 Assistant Displaying Delay Auto Fix The Auto Fix Errors options allow enabling disabling auto fix functionality for all or particular types of errors Auto Fix Errors 1 Enable auto fix errors 4 Enable auto type cast Y Enable auto Import Figure 118 Auto Fix Options Productivity User Manual 108 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Options Rename Assistant The Rename Assistant options allows enabling disabling rename functionality for all or particular types of entities It s also possible to specify shortcut to start refactoring using these options If the Enter key is chosen to start refactoring the Ctrl Enter key allows simple renaming and vice versa Rename Assistant fa Enable Rename Assistant pe Enable class rename assistant fa Enable field rename assistant Enable method rename assistant Fa Enable local variable assistant Use ENTER key to Refactor LO Use CTRL ENTER key to Refactor Figure 119 Rename Assistant Options Smart JavaDoc Page Pro The Smart JavaDoc page of the Productivity Editor Options page is used for customizing of the Smart JavaDoc tool and provides the following options 1 Issue Highl
2. Change Figure 129 Edit Template Definition Dialog Shortcuts Page Shortcuts The Shortcuts table shows the list of key maps along with shortcuts assigned to the template for the each particular key map Change The Change button allows assigning or changing the shortcut for the selected key map On pressing this button the Assign Key Stroke dialog is showing that allows defining the shortcuts attributes Remove The Remove button allows removal of shortcut for the selected key map Productivity User Manual 117 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Options Edit Template Field Dialog Pro General This dialog allows maintenance of template field properties Edit Template Field Definition war Marne war Default Value On Calculate getLocalariableNamelgetFieldyaluel varT ype ield Traversal m Nest Field Co When has value CO Next Default Field DO When has no Value a CO Always Figure 130 Edit Template Field Definition Dialog The following options are available Default Value Productivity User Manual Copyright 2000 2004 Productivity L L C http www jproductivity com The Name field allows specifying the name of the template field Please note that this name should be unique within particular template The Default Value field allows specifying the initial value should be assigned to the fi
3. 24 42 sec Figure 111 Hyperlinks options Productivity User Manual 105 Copyright 2000 2004 jProductivity L L C http www jproductivity com Help I nsight Delay Context Discovering Productivity Options With this option you may specify the Help Insight delay for J Builder built in Member Insight as well as for Productivity insights Help Insight Invocation Delay Figure 112 Help I nsight options You may also indicate whether Help Insight will be integrated with the J Builder built in insights using the Enable Help for built in J Builder insights checkbox From the Enable Help for Productivity Insights option you can specify whether or not Help I nsight will be integrated with the insights included into Productivity Invocation delay With this slider you may define the timeout between the time when a member in Member Insight or Productivity Insights is selected and when the Help I nsight popup window is displayed In certain cases particularly for the classes with a large number of inner classes Context Insight may display only the upper class information Contest Discovering Timeout t Include inner classes Figure 113 Context Discovering options The reason for this is the limitation of J Builder JOT subsystem that requires significant amount of time up to tens of seconds to retrieve information about the inner classes To avoid hang up of J Builder the time required for
4. Figure 81 J Builder Member Insight with Help I nsight Invoked If such integration is enabled the popup window of Help Insight will be automatically Shown for a currently selected item in Member Insight or Productivity Insight popup You can also force showing Help Insight for a selected item using Shift F1 shortcut CUA Productivity User Manual 84 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Information Tools Options Dependency You may enable integration of Help Insight with other Insights using Help Insight options on the Editor Options Productivity Usage property page To specify delays of Help Insight invocation you can use the Editor Options Productivity Delays property page Hyperlink Help Hyperlink Help is a tool that allows easy and convenient viewing help topics for particular symbols t getDlefaultToolkit get creenfizel ry Poon getacreena ref ze height public abstract Dimension getScreensizet ize width e width Gets the size of the creen Returns the size of this toolkit s screen in pixels Figure 82 Hyperlink Help Popup Window with Help for Method To invoke Hyperlink Help press and hold the Alt key and point the mouse over the identifier which you need help with The identifier becomes a hyperlink and if you press the left mouse button the built in J Builder help is shown for it If you place the mouse over the identifi
5. Figure 92 JavaDoc Auto Generation Options If you enable this checkbox together with the automatic generation of JavaDoc during methods generation Project Properties Productivity Code Style General then the GetSet Creator tool will insert default description for the method default description for the method return value getter and default description for the method parameters setter Cache Page The Cache page of the Productivity Project Properties pages provides the following options 1 Autorefresh option 2 Refresh groups 3 Refresh Now To set these options for all the new projects select Project Default from the Project Properties The main goal of Productivity is to increase the developers productivity to its maximum Since presumably the application will be frequently used it should work as quickly as possible The project may contain several thousands of classes including the Classes directly included into the project JDKs and required libraries classes and constant search through them would be highly inconvenient Thus Productivity builds classes cache right after the first invocation and then stores it to hard drive providing for future re use After cache build or load Productivity uses it for quick access to the classes according to the specified criteria Options grouped on this page allow you to control the process of class cache building and refreshing Autorefresh Options This option allow
6. Power Tools ar PA CODE YAR lt PRE gt public void setDefaultRenderer Class columntlass TableCellRenderer renderer OQ io les it can be a that mode is mot visi a C Check classes and Sarna for ai allowed Sets a default cell renderer to be used if no renderer has been setin a TableColumn If renderLeis null removes the default renderer for this column class list itemi 4 Source HTML p gt lt img src file F sal gif aliqon middl lt p gt lt p gt Sets a lt u default lt fu cell lt 1 gt renderer lt color 0000ff gt renderer has hee lt ffontsn lt code gt TableColumn focode gt If renderer is Figure 39 Smart JavaDoc View with JavaDoc Comment Preview The JavaDoc editor panel includes set of editors one editor per one JavaDoc tag Each editor or editors group is labeled with the name of the tag it belongs to To navigate to the next previous tag editor the Tab or Ctrl Down Shift Tab or Ctri Up Shortcuts are provided respectively JavaDoc Editing Using Smart JavaDoc The Smart avaDoc tool offers rich functionality for WYSIWYG editing of the JavaDoc comment in form close to one will be generated by standard JavaDoc doclet and in turn rendered by Help Viewer Editing of JavaDoc is started by activation of Smart avaDoc using appropriate tab at the bottom of the editor Smart J avaDoc first tries to discover member in the current caret position and offers editing of JavaDoc co
7. Productivity Options If a non standard J Builder keymap is used such as Vi VIM the Smart Braces may conflict with the keymap settings Apparently for keymap VI the and symbols may be overridden by Smart Braces It is justified by the features of the vi implementation improper implementation of the Keymap default action However the part of Smart Braces functionality that causes the conflict can be disabled To do this you should add the following lines into your J Builder config file placed in J Builder bin directory vmparam DProductivity Smart Braces CompleteCharacters no vmparam DProductivity Smart Braces CompleteStrings no General Page The General page of the Productivity Editor Options page provides the following options e Import statement generation e Search options e Sort classes by e Autocomplete Productivity contains a number of tools designed for imports modification Class Insight Implement nsight Override I nsight Constructor nsight Imports Beautify and Smart nstantiate All these tools share common settings for the import statements modification so modification of these options will affect all tools mentioned above Cinport statements generation Import particular class Co Import all classes from package 18 Import particular class and consolidate packages Import maximum E classes from the same package Figure 102 Import statements generation option
8. e There is a break statement e There is a continue statement e There is a return statement e There is a throw statement elcomeFrame java E ay Wielcomer Seine Design Beg gt smart Gutter Marks a e E A O Figure 54 Smart Gutter Marks Show Hide Button There is ability to turn Smart Gutter marks on off using the button in the View Toolbar Thumbnail Gutter Pro The Thumbnail Gutter is an additional gutter at the right side of the view It s intended to quickly provide information about state of the currently edited J ava source file Unlike to the built in J Builder gutter Thumbnail Gutter always shows gutter marks for the whole source file Supported gutter marks are errors warnings and To Dos Figure 55 Thumbnail Gutter In addition the gutter allows quick navigation to a corresponding code issue by single mouse button click Productivity User Manual 65 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Editor Enhancements Reference to a class List is ambiguous toa class List is A Figure 56 Thumbnail Gutter with Hint for Error This gutter shows distribution of code issues along the whole file Also it allows quickly get information about particular mark using hint that appears if mouse cursor is placed over appropriate gutter mark There are several additional features provided by Thumbnail Gutter e Ability to navigate to any
9. Productivity Power Tools 2 Hyperlink A A Horizontal Line BE Line Break mage Border Insert symbol Figure 45 Inserting Special Objects The following objects are supported a Link corresponds to the JavaDoc link tag The user is able to specify properties of a new link or change them for existing one by using Link Properties Dialog CD Link Properties Ed Link Text pO Link Location ee l URL is relative to page location owes ee Figure 46 Link Properties Dialog b Hyperlink corresponds to HTML lt a href gt tag c Horizontal line corresponds to HTML lt hr gt tag d Line Break corresponds to HTML lt br gt tag e Border applies appropriate HTML style to the current paragraph f Image corresponds to HTML lt img gt tag The user is able to specify properties of a newly created image or change them for existing one using the Image Properties Dialog Productivity User Manual 57 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools D Insert a New Image Appearance Align Text to Image mice bal Spacing Left and Right D Top and Bottorn D Border go how t can be pi Ls Check classes Figure 47 Image Properties Dialog g Insert Symbol allows to insert special symbol to JavaDoc comment using the Insert Special Symbol dialog C Insert Spec
10. 1 If particular bookmark contains reference to a project this project will be opened if it still not opened yet and activated 2 The file which bookmark refers to will be opened if it still not and activated 3 If bookmark location within file has a valid value the editor will be scrolled to the bookmark location Persistent bookmarks can be toggled and navigated using usual J Builder shortcuts Numbered bookmarks are supported too The only way to navigate unnumbered bookmark is using the Persistent Bookmarks Navigate tool Productivity User Manual 78 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Navigation Tools if franesize height gt screen ize height framesize height screensize height Creensice width eensize width ensSize width fra Toggle Breakpoint Set Bookmark Ctrlt ShiftO Toggle Bookmark Ctri ShiftB Ctrl 3 hift 1 Ctri Shitt2 Manage Bookmarks Cte Shiths Ctri Shita La UlManager setLook nd 1 Ctrl Shitt S ea 1 to Catch Exception el Ctri Shit e print tackETracel I new WelcomedAppt 1 m T Lo Ft FF Ctrl Shift my Ctrl Shitt 3 1 om my Ha Cti Shittd La cn Figure 73 Setting a Bookmark Using the Gutter Context Menu Another way of working with persistent bookmarks is using context menu on the editor gutter Also if bookmark has description associated with it it may
11. Complete curly brace Complete curly brace and indent Complete brace Complete square brace Complete Strings Complete characters Use ALT key to override current options Ge al Smart key options Figure 101 Smart Braces Options Expanded The following options are available Complete curly brace Allows you to specify whether Smart Braces should complete the curly brace Complete curly brace and indent Allows you to specify whether Smart Braces should complete the curly brace and make the indent in accordance with the currently set size Complete brace Allows you to specify whether Smart Braces should complete the brace Complete square brace Allows you to specify whether Smart Braces should complete the brace Complete Strings Allows you to specify whether Smart Braces should complete the string constants Complete characters Allows you to specify whether Smart Braces should complete the character constants Use ALT key to override the current options With this option enabled the current options can be overridden provided the ALT key is pressed when typing For example if Complete curly brace option is enabled pressing with the ALT key will only insert the opening curly brace without the corresponding closing one Productivity User Manual 99 Copyright 2000 2004 Productivity L L C http www jproductivity com NOTE Import statements generation Productivity User Manual
12. Help Insight is an Alternative way of getting help on a selected member To allow Help Insight invocation when using the Insight you should turn on the Editor Options Productivity Usage Integrate Help Insight with Productivity Insights checkbox With this option turned on just select a member and wait until Help Insight popup will show the appropriate JavaDoc help page if any You can also force Help Insight invocation using the shortcut Shift F1 CUA You can specify Help Insight invocation delay using the Editor Options Productivity Delays Help Insight Invocation Delay slider Productivity User Manual 16 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Power Tools Code Generation Tools Productivity offers powerful set of code generation tools intended to simplify routing but very common operations like e Inserting appropriate import statements for class using short class name the Class nsight tool e Implementing interface or extending class the mplement nsight tool e Overriding methods the Override nsight tool e Creation of constructor with the same signature as one defined in super class the Constructor nsight tool e Instantiation of variable the Smart Instantiate tool e Creating of getter setter methods the GetSet Creator tool e Creating of constructor used to initialize set of class fields the Introduce Constructor tool e Creating
13. Members edit box blank to view all the members for navigation purposes Browse Members highlights the members with names exactly matching the typed word using bold font and abstract methods using italic font You can select a member by navigating through the list with the help of the usual keyboard An Alternative way to do it is to continue typing the word the list selection will be changed to produce the closest match possible Press Enter when selecting a member and Browse Members will browse it Productivity User Manual 76 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Navigation Tools Hyperlink Navigate Hyperlink Navigate is a tool allowing easy and convenient navigation with a method similar to that of the J Builder built in Symbol Insight tool public int lastindexDf fint ch return lastIndexO0fich count Li Class java lang String Member int lastindex Ot Parameters int int Returns the index within this string of the last occurrence of the specified character searching backward starting at the specified Figure 71 Hyperlink Navigate with Hint that Describes Identifier Under Cursor To invoke Hyperlink Navigate press and hold the Ctrl key pointing the mouse over the identifier you are going to navigate to A hyperlink will appear and if you press the left mouse button J Builder will navigate to it in the same manner as Symbol Insight does If you
14. User Manual Copyright 2000 2004 jProductivity L L C http www jproductivity com 62 Productivity Editor Enhancements Pop Paste Action This action allows consecutive popping and pasting of code fragments from the local clipboard history in the LIFO order It can be invoked using the Ctri Alt I nsert CUA shortcut Clipboard Insight This tool allows viewing of local clipboard queue and pasting one or several selected fragments in the editor When editing a file press Alt Shift V CUA to invoke Clipboard Insight The Clipboard Insight popup will be shown with the list of code fragments copied cut to clipboard during the J Builder session static public void main String args Chipboard insight super processWindowEvent e Super n pro cessWMindomEment e E z if E qe tid WindowEvent WIND OW CLOSING super processlindowEvent e System ex1t 0 protected void processlindoEvent W static public void main String args Dimension screensize Toolkit getD Dimension screensize Toolkit get System out printlni Figure 52 Smart Clipboard nsight Window Along with Clipboard Content Popup You can select a code fragment navigating through the list with the help of the usual keyboard Clipboard nsight list supports multiselection feature thus it s possible to paste several items at once To do this select the code fragments should be pasted using the Ctrl key and mouse and
15. case to upper one and vice versa Parameters aString string need to be converted Return converted string String toConst String aLiteralValue Composes name for string literal based on passed literal value It is composed as C style constant where locations of underscores are match to locations of characters in upper case in the literal value Parameters aLiteralValue string literal value Return name for string literal based on literal value String fromConst String aLiteralName Composes value for string literal based on passed literal name using the same rules as for composing name for literal based on its value Parameters aLiteralName string literal name Return value for string literal based on literal name String capitalize String aString Productivity User Manual 45 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools Capitalizes the first letter of passed string Parameters aString string to capitalize Return capitalized string value String deCapitalize String aString Decapitalizes the first letter of passed string Parameters aString string to capitalize Return decapitalized string value String subString String aString String aStringToFind Obtains a new string by trimming the right part of passed one starting from occurrence of another string Parameters aString string to be trimmed aStringToFind st
16. collection of context information was limited to 2 seconds Thus if JOT fails to provide the data within this interval only the upper class information is selected Relatively slow performance of Context I nsight when cursor is placed on the white space between class methods can also be justified by these reasons The same limitations may affect other tools that use the same functionality Override Insight mplement nsight From this option you can specify the maximum time required to discover the context Tools Page Pro The Tools page of the Productivity Editor Options page provides the following options 1 Smart Clipboard Productivity User Manual 106 Copyright 2000 2004 Productivity L L C http www jproductivity com Smart Clipboard Smart Braces Productivity User Manual Productivity Options 2 Smart Braces The Smart Clipboard group allows performing tuning of Smart Clipboard Tools mart Clipboard eneral Options naer Import Statements on Paste Clipboard history size 20 Ch Always e Indent block on paste i Show prompt Never Figure 114 Smart Clipboard options General Options This options group provides ability to specify size of clipboard history clipboard buffer and enable disable automatic indentation of the inserted block according to current indent level this option is applicable to pasting Java code into J ava files Insert Import Statements On Paste This set
17. dialog which shows packages structure and allows choosing a class by specifying its full path You can use the appropriate button in the top left corner of the popup to invoke it Options Dependency Please note that the set of classes shown in Browse Insight depends on Packages Exclusion settings on the Project Properties Productivity General property page You can adjust the way of classes sorting as well as the algorithm used for classes search using the Editor Options Productivity General property page There using the Productivity Insights Usage option you can specify whether Productivity Browse nsight tool or J Builder built in Browse classes should be invoked Browse Members Browse Members allows quick finding members belonging to the current discovered context and browsing them COR nora eed Sa Fr ale Se ie ohne gt ple OE de VWelcomne pyp i maini trify T pack Frame g MWelcome4pp old maini Stringi Figure 70 Browse Members Popup Window Press Alt Minus CUA when editing a file to invoke Browse Members Insight The Browse Members popup will be shown with the list of members either classes methods or fields matching the word at the cursor position The list may be empty if there are no matching methods though To find matches type the word in the Browse Member edit box and Browse Members will dynamically rearrange the members list to show the matching ones You can also leave the Browse
18. does not support nesting of container tags like lt p gt lt pre gt lt ul gt lt ol gt lt div gt lt dt gt lt table gt If JavaDoc comment to be edited contains such nested structures they will be translated to linear ones if possible 5 If the color attributes are not set for the following tags Smart JavaDoc artificially adds them to allow visual recognition of the tags content These artificial colors are temporary ones and will not appear in the resulting JavaDoc Productivity User Manual 54 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools lt var gt Maroon lt anchor gt Blue lt code gt Navy 6 Smart JavaDoc doesn t support paragraph align attributes for the following tags lt pre gt lt ul gt lt ol gt lt table gt Also please note that Smart JavaDoc considers all words starting from as JavaDoc tags Smart JavaDoc Toolbar Most of the actions accessible for JavaDoc editing are provided by Smart avaDoc toolbar F GX al Biz u x P E la eb A A Eo 0 H CODE WAR lt PRE gt Figure 40 Smart J avaDoc Toolbar The following groups of actions can be found in the Smart JavaDoc toolbar Tags actions group provides ability to manipulate the JavaDoc structure by adding editing or removing particular JavaDoc tags u aX l2ptoe sans B Z U todo ToDo since Since c serialData Serial data msee See Also d
19. e Quick obtaining information about read only status of file and changing it Change ReadOnly Project View Synchronizer Pro The Project View Synchronizer provides ability to synchronize file is currently being editing with the corresponding node in the J Builder Project View There is possibility to have continuous synchronization that automatically tracks the changing of the current file and finds corresponding node in the Project View o a dy Interfacelmple loz SN yachronize source with project art Figure 64 Force Project View Synchronizer Button acelmplement Rite ee B Interfacelmplementationilt Design Always synchronize source with project Figure 65 Project View Synchronizer Buttons If continuous synchronization is disabled there is an ability to force synchronization manually Project View Synchronizer behavior can be controlled using and I View Toolbar buttons placed at the left bottom of the editor near horizontal scrollbar left corner Productivity User Manual Copyright 2000 2004 jProductivity L L C http www jproductivity com 72 Productivity IDE improvements Options Dependency The Project View Synchronizer behavior can be controlled using the IDE Options Productivity property page which may be used to specify if all nodes except the current one should be collapsed after Project View Synchronizer invocation Structure View Synchronizer Pro This tool allows synchronizing of Jav
20. following controls which allow viewing and maintaining the bookmarks list Bookmarks Table The Bookmarks Table shows the list of bookmarks Each bookmark occupies one row in the table while each table s column represents particular attribute of bookmark The Description and Persistent columns are editable This allows specifying values of them using in place editing capabilities If Description attribute is specified it will be displayed in the Persistent Bookmarks Navigate tool and will be shown as tool tip when mouse is placed over bookmark in the gutter If bookmark s Persistent attribute is turned off such a bookmark will not be stored on J Builder exit Productivity User Manual 80 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Navigation Tools Go To The Go To button provides navigation to the currently selected bookmark without closing the dialog Remove The Remove button allows removing of the bookmark is currently selected Remove All The Remove All button removes all bookmarks Move Up The Move Up button allows moving currently selected bookmark up in the bookmarks list Move Down The Move Down button allows moving currently selected bookmark down in the bookmarks list Note The Manage Bookmarks Dialog allows actual maintenance of bookmarks list so no changes can be discarded or undone by closing this dialog View Navigator and Navigator Insight Pro The Vi
21. if Java Structure View Is not visible Productivity User Manual 51 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Power Tools The JavaDoc View contains toolbar with set of actions used for JavaDoc editing the JavaDoc editor and optionally the preview panel pul pt y Sans y B J U x oy i IA CODE WAR lt PRE gt r public void setDefaultRenderer Class columnClass TableCellRenderer renderer OQ ew it can be o that aosi is not visi iS m _j Check Eee elena Sets a default cell tencererto be used if no renderer has been setin a TableColumn If renderer is null rermoves the default renderer for this ham class e list item e Source 4 HTML public void setlefaultRenderer Clas s columillas 1f renderer null defaultRenderersbyColumnllass puticolumnel else defaultRenderersbyClolumnClass remove col Figure 38 Smart avaDoc View with Source Code View There is ability to showing hiding of the preview panel using the button on the Smart JavaDoc toolbar The preview panel consists of two tabs The Source one allows you quickly view source code for the currently edited member as well as for the whole file The HTML tab contains live preview of the JavaDoc comment that will be generated for current member Productivity User Manual 52 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity
22. in the Choose Methods edit box and Delegate Insight will dynamically rearrange the list of methods to show the matching ones The Choose Method edit box can be blank that allows viewing all methods Jbialog abialog null public synchronized void addComponentListener ComponentListener 1 f abialog addComponentListener 1li Figure 15 Code Generated by Delegate I nsight Delegate Insight correctly recognizes delegate modifiers and generates static methods if required preserving other modifiers as well It utilizes all major delegate patterns and allows using the following entities as delegates e Field declared either in currently edited class or in any of its parents e Execution result of method without parameters e Execution result of method with parameters In this case Delegate nsight generates methods which have merged list of parameters one part is needed to obtain a delegate and another one to be passed to delegates methods call Options Dependency The Project Properties Productivity Code Style property page allows customizing code style and placement for the generated methods Settings for Java Doc comments those can be optionally generated during methods generation can be customized using the Project Properties Productivity Java Doc property page Easy JavaDoc and Easy JavaDoc Insight Easy JavaDoc is a tool that allows easy and convenient generating of templates for JavaDoc comments on particu
23. o Code block o Enclosing statements and code blocks o Method o Class o Whole file Smart Gutter Pro The Smart Gutter is a gutter placed at the left side of the editor and right from J Builder editor gutter and it is intended to show miscellaneous hints concerning corresponding Java code by arranging appropriate gutter marks The Smart Gutter allows viewing tool tips those show description of a Smart Gutter mark when mouse cursor is moving over it Optionally any Smart Gutter mark can provide operations applicable to the corresponding code If there is at least one operation available the sign is shown at the left of a gutter mark In this case mouse cursor is changed to the hand one and the operations can be executed by mouse button click The most typical operation is navigation to some piece of code related someway to the code corresponding to the mark Ot protected void processWindowF rent Win super processWindovEvent e Object componen e cet Ir WEEN TD OT Variable compan nt hides field defined in the class retura Figure 53 Smart Gutter The Smart Gutter marks are currently supported for the following cases e There is method overriding Productivity User Manual 64 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Editor Enhancements e There is declaration of constructor with the same signature as the one defined in the super class
24. of proxy delegate methods those actually calls methods of class member the Delegate I nsight tool e Creation of default JavaDoc comment the Easy JavaDoc tool e Import statements optimization the mports Beautify tool All these tools provide very simple and intuitive interface and allow you to get required task complete using minimal amount of actions needed Class Insight Class Insight Forget about typing your import statements Class Insight allows quick finding Java classes with short names matching the word at the cursor position and inserting there the class name found and its import statement To choose a class from several possible variants it employs a popup window similar to other Javalnsight popups Memberlnsight Parameterlnsight etc You don t need to type import statements manually just use Class I nsight to find and insert the required class and let it make all other job for you The Class Insight backend caches all the required information about classes containing in project JDK and project required libraries to speedup usage The cache build is Initiated only on the first Class Insight invocation so it doesn t affect J Builder startup and a project opening time The Class Insight saves the cache in the project directory while project closing and loads the cache from disk when the project is opened next time The cache file is named lt Project Name gt cache and it can be easily removed when unneeded us Prod
25. of radio buttons provides ability to specify policy for import statements generation that should be used during pasting of Java code block this option is applicable to pasting Java code into J ava files If this option is not disabled Smart Clipboard will optionally insert appropriate import statements for all classes found in the copied code fragment The Smart Braces options group provides ability to customize behavior of Smart Braces and Matching Code Highlight tools man Braces races Highlight le Highlight delay Delay O75 sec races Highlight Expiration Allows highlight expiration Delay atching Brace Code Show matching code popup Figure 115 Smart Braces options 107 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options Using this options group the user is able to specify delays used for highlight expiration and matching code popup displaying Assistant Page Pro The Assistant page of the Productivity Editor Options page is used for customizing of Productivity Assistant and provides the following options 1 2 Issue Highlight Style Assistant Popup Delay Auto Fix Errors Rename Assistant Issue Highlight The Issue Highlight Style options group provides ability to specify line style and color for Style visual marks those are used to highlight issue in editor lz ue Highlight Style Priority Low 7 Style E Dotes Line dl Color
26. or search results Pro Navigator nsight The Navigator Insight is specialized insight used for quick controlling of View Navigator Browse nsight The Browse Insight tool allows quick finding Java classes with short names matching the word at the cursor position and browsing them or the appropriate help topics Browse Members The Browse Members tool allows quick finding members belonging to the current discovered context and browsing them Hyperlink Navigate Hyperlink Navigate Is a tool that allows easy and convenient navigation through symbols definitions basing on the concept of hyperlinks Pro Search Results and This tool is intended to highlight in the editor various things References Highlight found during search or find references operations Pro Local References Highlight This tool allows finding local references of the symbol under caret and highlighting them Information Tools Help Insight Help Insight allows easy viewing help topics if any for the identifier at the cursor position Also it provides quick help for items shown in J Builder built in Member Insight and Productivity insights Hyperlink Help Hyperlink Help allows easy and convenient viewing help topics for particular symbols Context I nsight Context Insight is a tool that allows you to check context of the current cursor position Context Insight collects information about all classes and methods and shows it using the insight popup wind
27. place the mouse over the identifier with the Ctrl key pressed after some delay the Hyperlink Navigate popup appears that contains information about the symbol under the cursor Options Dependency You can customize delays used for invocation and closing of the Hyperlink Navigate popup window using the Hyperlink Navigate Delays options on the Editor Option Productivity Delays property page Also you can specify whether Hyperlink Navigate Should be invoked during a debug session using the Invoke insights during debugging option on the Editor Option Productivity Usage property page Search Results and References Highlight Pro This tool is intended to highlight in the editor various things found during search or find references operations those things should be listed in the message pane as well To place highlights the special button on the view toolbar should be used If nothing selected in the message pane this tool uses the most recent search results related to the current file But it s possible to exactly specify result set to highlight by selecting root node in the search tree e g Direct usages or Declarations To navigate through the highlights usual Navigator keys Ctrl Page Up Page Down CUA are used Productivity User Manual 77 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Navigation Tools St public VelcomeApp WelcomeFrame new Welcomerrame fPack fr
28. popup windows if there is an active debugging session Help I nsight You may specify whether Help Insight should be integrated with another insights Help Insight 4 Integrate Help Insight with JBuilder Member Insight Integrate Help Insight with Productivity Insights Figure 108 Help I nsight options Integrate Help Insight with J Builder Member Insight If this checkbox is selected Help Insight will be integrated with J Builder Member Insight In such mode as soon as you change the selection within the Member Insight popup window list Help Insight with the help for a selected item will appear near the Member Insight popup window Integrate Help Insight with Productivity Insights If this checkbox is selected Help Insight is integrated with all the insights included into Productivity Please note that even if you disable this integration you will still be able to invoke Help Insight for a selected item in the insight popup list To do this you just need to press the shortcut key normally used for Help Insight invocation the default Shortcut is CTRL F1 under CUA when Productivity insight is being used Hyperlink ee hiding This option allows you to hide the Hyperlink Navigate popup window mode Highlight Mavigate _ lose popup window on Hyperlink hiding Figure 109 Highlight Navigate options If selected the popup window will be hidden together with the hyperlink If not the popup window will be closed in accordance with
29. position within file using mouse button double click in the desired location on the gutter e Status icon at the top of the gutter which shows the status of the file There are following statuses O a OK no errors or warnings found O C Errors any errors found o Y Warnings any warnings found o Y Running Code is being analyzed e Assistant icon at the bottom of the gutter which providers access to Assistants menu that allows controlling of Code Assistant and Info Assistant status e Ability to display bounds of the class which caret position belongs to This feature allows instantly understand whether errors and warnings exist those are related to that class Classes Highlight Pro Classes Highlight is a tool intended to highlight classes used in the code It uses Extra keyword style so to see it in action please customize this style to make it different from Identifier style using the Editor Preferences Editor Color Java property page Productivity User Manual 66 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Editor Enhancements public class WelcomeApp boolean packFrame false irs Construct the application T St public Welcomeappi WelcomeFrame frame new WelcomeFrame fPack frames that have useful preferred si Figure 57 Classes Highlight By default all classes are highlighted but it s possible to specify which classes should
30. the Editor Options Productivity Smart Templates property page Productivity User Manual Copyright 2000 2004 jProductivity L L C http www jproductivity com 49 Productivity Power Tools Smart JavaDoc Pro Creation and editing of source code documentation is an important part of the development process Unfortunately J Builder provides very basic support for this so developer is forced to create the entire JavaDoc comments markup manually To significantly increase productivity of source code documentation creation to reduce amount of possible JavaDoc errors those can occur during this process and to insure that documentation is still valid after performed refactoring Productivity offers very powerful tool intended to provide visual JavaDoc editing The Smart JavaDoc tool offers rich JavaDoc creation navigation and editing functionality It represents additional viewer for Java files and is accessible via appropriate tab at the bottom of the editor E qe A BF U of By ile Welcome html Pe My WelcomeApp java CODE ua A y ics v 2 Le WelcomeFrame java public void setSize Dimension di Set the size of this Dimension objectto the specified size This method is included for completeness to parallel the setSize method we by Component Parameters d the new size for this Dimension object Since JDE1 1 See Also Dimension W Dimension2D on java awLDimension getsize El Seri
31. then press the Enter key Clipboard nsight will insert all selected items It s possible to control the order of inserted items Holding Chift while pressing Enter will lead to inserting selected items in reverse order Options Dependency You can control the behavior of Smart Clipboard using the Editor Options Productivity Tools property page Smart Selection Pro The Smart Selection tool represents set of several selection enhancement actions those allow to simplify selection operations while editing Java files The following actions are provided e Selection of the whole code block statement method or class These actions are available in the editor context popup menu as well as in the J Builder menu bar There are no default key bindings for these actions but you are able to easy assign them using the Key Map editor Productivity User Manual 63 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Editor Enhancements e Expanding Selection Ctrl W CUA and Narrowing Selection Ctrl Shift W CUA These actions are also available in editor context popup menu and in the JBuilder menu bar as well They allow to expand narrow current selection incrementally to outer inner source element respectively The approximate order of selections is as follows the exact one depends on current structure of the Java code and current caret position o Word under cursor o Expression o Statement
32. traversal forlo List traversal using cached list size Figure 123 Templates list RIS RSI New The New button allows creation of a new template After pressing of this button the Edit Template Dialog is showing which allows specifying miscellaneous attributes of newly created template Edit The Edit button allows maintenance of currently selected template After pressing of this button the Edit Template Dialog is showing which allows specifying miscellaneous attributes of selected template Copy The Copy button allows creation of a new template using currently selected template as a prototype After pressing of this button the Edit Template Dialog is showing which allows specifying miscellaneous attributes of newly created template Remove The Remove button allows removal of currently selected template Code The Code editor pane provides preview of currently selected template int size list sizeli for int index OU index lt size index varTypes var varTypes 1138 get indexs gt s5elBlock Productivity User Manual 111 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Options Figure 124 Template Code preview Quick Expand This options group allows selection of key can be used to quickly expand a template Key which name is match to the word at caret mauick Expand Key Tab Enter Figure 125 Quick Expand Key options Ed
33. 10 The Help button in the Insight popups may remain highlighted after invocation of J Builder help viewer ae Productivity User Manual 132 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Feedback Productivity Feedback As part of continuing efforts to improve our product we welcome your comments suggestions and general feedback on the project If you have questions about Productivity please feel free to contact us for further information at productivity jproductivity com or visit our site using the following URL http www jproductivity com If you discover any issues or defects in Productivity please send the description of them to productivity jproductivity com We d appreciate if you could provide us additional information that may definitely help us to fix these problems dls Zi Productivity User Manual J Builder version Operational system version and vendor List of third party open tools installed in your J Builder Exceptions stack trace and any error output You can see it if you run J Builder along with console Running threads dump it makes sense if J Builder is not responding You can see it if you run J Builder along with console and press Ctrl Break shortcut in the focused console 133 Copyright 2000 2004 jProductivity L L C http www jproductivity com
34. 23 Ambiguous Names ssue Code Assistant rr Construct the frame public Ws LeoueFeametis choad Ga Let rt be void shift Enter Let ft return Object Ctri 2 1t 1 Productivity User Manual 32 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools Figure 24 Invalid method declaration issue Code Assistant public class WelcomeFrame extends JFrame List children null J Class List is unknown LA Borderlayout 1 java util List shitt Enter com sun tools javac O utilList Ctri Ait 1 Figure 25 Unknown Class Issue Code Assistant Options Dependency You can control Assistants behavior using the Editor Options Productivity Assistant property page The Project Properties Productivity Assistant property page can be used to specify project dependent Assistant options Advanced To Do s Pro The Advanced To Do tool expands the concept of To Do comments by treating them as tasks rather then simple entities those can hold only textual information The following attributes can be assigned to To Do task Priority e Completion Status e Owner e Start Date e Due Date e Reminder e URL All these attributes are encoded in the body of To Do so concept of Advanced To Do s doesn t require using of any additional storage Tools those work with To Do s e g Advanced Java Structure View are aware
35. 51 JavaDoc Editing USING Smart ava DOC Sian 53 Smart avabOc Tool Dahir enaa sarin sale a aan ened nao eRe GS 55 JavaDoc Errors HIGMIONUM Tia a 59 Smart liavaDoc gt NOR CUESTAS 60 Edito Enhancements A AA 62 Smart ElIpDOara Prot des 62 Paste ACI Aa 62 CODY CUE ACUON Siria 62 MO OB AUG a 6 g rere oor Reem comeet a a rn Rn Seon Deere mn ae ene a ey Tee 62 ROD PASC ACOM ae ee ae ep ar ene are ae Re er em an a ee eT ene ne ae en ee 63 ENDDO STA ANSIA rn ey ee wre gee a en roa accom ey ene 63 ODUONS Dependencia 63 Smart election SP lO es cerca vaniide tensa atine AS 63 Smart GUS Prol A A SAS 64 WAUMON Gutter Pro taa 65 Elasses FI nante Proa dE 66 Advanced Text View Status Pro ssssssssssrssrerrererrrerrsrrsrrrrerrerrrrrrrsrrrrerrerrrrerrerrrrrrrerrerre 67 SMAEB PACS A sede ae Madea setae mii emt chau suman Cx ucdeiee 2s tev acedaivedean lewd E S N 68 Options DEDCAGEMGY madison da 68 Marching lt COOEHAIGNIGMG PrO aia A IA AAA adds 68 OPTIONS DEDENOENCY iii AAA RAA 69 Slate Braces HIGMUIGNE PRO A is 69 ODLIONS DEDENAENEY ses vests aba taave te txeu AA A 70 GHanGes HIGMNONE PrO arar A A RE Ai 70 current Lime FIG PFO osa NA avd 70 Classes and Methods Separator Pro ococccccccnnnnccccncnnannnnncnnnnnn rra rr rr 71 IDE MAID FOVEMACIIUS a e es 72 Project View Synchronizer POLO NI ARA beeen eae n 72 ODtIONS DEDENOENCY cepa ao nadaa 73 Structure View Synchronizer Pro sarria RRA AA URANO ARENA 73 Change Re da OAIY
36. Brian Sayatovic Synchronize ProjectView and Broser selection by Torsten Welches Where Am By David Pierron JbPropStructure by Angus Chan Clipboard Manager by Jacob Roberson Productivity User Manual Copyright 2000 2004 Productivity L L C http www jproductivity com 11 Productivity Tools Productivity Tools NOTE Productivity Offers a powerful set of tools intended to reduce routine coding tasks These tools are carefully designed to allow solving such tasks with minimum efforts and in minimal time The following tools are available after installing Productivity The exact set of tools included depends on edition the Pro mark highlights tools available in Productivity Professional Edition only All tools offered by Productivity belong to the following groups e Code Generation Tools e Power Tools e Editor Enhancements e IDE improvements e Navigation Tools e Information Tools Please refer the table below to find more about content of these groups Also there you can find short description of every tool included into Productivity Table 1 Productivity Pro Tools Code Generation Tools Pro Delegate nsight Delegate Insight provides an easy way to generate methods which implementations are delegated to another object delegate Pro Introduce Constructor Introduce Constructor allows easy generation of constructors intended to initialize appropriate fields of the class Class I nsi
37. Class current anInnerClasses i 1480 1451 1f current getName equalsfallassName 1482 i 1483 result current 1484 break Figure 59 Matching Code Highlight It introduces the following features e Ability to highlight the break target statements for return break labeled break break lt label gt continue and labeled continue continue lt label gt statements e Ability to highlight matching code using dotted path with arrow on the Gutter e Ability to view matching brace code when It s has been scrolled out of view The Special popup window shows the matching code in the top of the editor e Ability to navigate to matching code using Ctri Shift CUA shortcut Options Dependency You can control the behavior of Matching Code Highlight using the Editor Options Productivity Tools property page Using this page you are able to specify whether the code popup window should be displayed as well as to set the popup window invocation delay Smart Braces Highlight Pro The Smart Braces Highlight tool offers matching braces highlight and navigation operations HEI 7 amp amp result null i result current break i allaseName etartsWith current getName result obtainllass JotUtils obtainInnerllasses Jotllas3iqurc Productivity User Manual 69 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Editor Enhancements Figu
38. Enter Class Insight switches between importing a particular class and the whole package Shift Enter Class Insight produces a code for instantiation of the selected class variable If there are no matches found Java lnsight Select Class dialog is shown Select a class in this dialog and press OK The Class nsight will replace or just insert the word at the cursor position with a selected class name adding the appropriate import statement Showing Navigation Pane You can switch Class nsight popup to show the Navigation Pane by turning off the Editor Options Productivity Usage Show Class Insight popup as list checkbox With this option turned off Class Insight popup will be shown with the Navigation Pane that allows using Class Insight popup even if there is no word at the cursor position or if there are no matching classes found To find matches type a word in the Use Class edit box and Class Insight will dynamically rearrange the classes list to show the matching ones Productivity User Manual 18 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools Options Dependency Please note that the set of classes shown in the Class I nsight list depends on Packages Exclusion settings on the Project Properties Productivity General property page Import statements are generated basing on Imports Generation settings on the Editor Options Productivity General pro
39. GetSet Creator will dynamically rearrange the list of fields to show the matching ones You can also leave the Fields edit box blank to view all fields Productivity User Manual 23 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools UJMenu JMenuFile new JMenul UJMenultem jJMenuFileExit new JMenulten JMenuw JMenudelp new JMenul UJMenultem jMenuHelp About new JMenultemii Se Se eee i IG f f Construd E Y X 18 i public We Md JMenuBar enahleFye Ye JMenuFile try Te iMenuFileExit jbInit 44 iMenuHelp i Ty MermHe lpabout catch Exception e f Figure 8 GetSet Creator Popup Window GetSet Creator highlights the fields with names exactly matching the typed word using bold font GetSet Creator analyses all the fields and all the methods those may be considered as accessor or mutator ones and removes certain fields from the list if appropriate methods are already exist You can select a field either one or any navigating through the list with the help of the usual keyboard An Alternative way to do it is to continue typing the word the list selection will be changed to produce the closest match possible Press the Enter key when you select the required fields s and GetSet Creator will generate applicable accessors and or mutators to it you can select all items in the list using the CtrIi A shortcut When generating a method GetSet Cr
40. Go to start of document Ctri Home Productivity User Manual 60 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Power Tools Go to end of document Ctri End femieena Select to line start Shift Home Select to document start Shift Ctrl Home Select to line end Select to document end Go to line above Up Go to line below Down Select to line above Select to line below Increase paragraph indent Decrease paragraph indent Go to the next tag Go to the previous tag Go to the next member Go to the next member Ctrl Page Down On link or image activate property Mouse double click action Otherwise select paragraph Set selected text BOLD DEFAULT Set selected text I TALIC DEFAULT Set selected text UNDERLINE DEFAULT Insert Horizontal ruler lt hr gt Insert line break lt BR gt Format painter Mouse click to copy format mouse click to paste format Esc or click on button to clear Productivity User Manual 61 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Editor Enhancements Editor Enhancements The overall productivity of developer greatly depends on source code editor That s why Productivity includes several tools those enhances built in J Builder editor and allows to gain Productivity users even higher level of productivity These tools may be separated on several categories e Code editing improvements Smart C
41. Implement Insight will also write all the methods defined in the interface or all the abstract methods defined in the class if you have selected an interface and a class respectively If you have selected a class not an interface and the target one already has a super class you will be prompted to confirm modifications Also there is a possibility of invoking the built in Implement Interface Wizard You can use the appropriate button in the top left corner of the popup Productivity User Manual 19 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools public class Untitledl implements Runnable public Untitled1l public void runt f Atodo Implement this run method throw new Unsupported0perationException Method runi not yet implemented Figure 3 Code Generated by I mplement nsight The figure above illustrates code generated by mplement Insight Code Changes Synchronization Implement Insight analyses changes in all dependant source files and correctly reflects them during generation of abstract methods implementations But for most of the cases you need to compile all dependant classes before invocation of Implement Insight If the required class is not compiled yet or the required methods are not found in the compiled class these errors will be shown in the Status View Options Dependency Please note that the set of classes shown in Im
42. O ISR E 97 EdItor ODUONS DIAO O iia ARA AA a a 98 Smart Braces Options Editor OPONE AAA AAAAN 98 Genera POGO maraca a ARA TA A E AETA 100 Jade Page on AR 103 DEEN EE cic E E Tere T T OIGA E TA AATE E E STE 105 TOOIS Page PrO nrn S A a OA E OARRA 106 ASSANE ea eo PO peda E ewes 108 Smart Tavapoc Page Proust a ltda dida boda 109 S mare Templates Pade A PrO sitiada deals 110 EOI Template aloe Pronto latir dt idas 112 Generali ae i era ke een gE ores lee ae aii ea Fae tents 112 CEO Se Ae etre ogo cil tg ara 114 ALEE SA Pie 1E 1 arn caea T I coi E E aiawiy anil cer ean E E E ono CUR cn Aue 115 SMOPECUS Radeon aa 117 Edit Template Fie Dialog PEO a a aos 118 IDE ODTHONS Diada AAA A a a A 121 PRODUCTI VI TY KEY BINDINGS sisciisictiintiniccatenss ri sidshstnueearastessesserbanrernenueaabenneineie 123 Key Bindings for CUA Brief and Visual Studio keymaps ccc cece cece cece cece eee eeeeeeeeeeeeananas 124 Key Bindings for Emacs Macintosh and Macintosh Code Warrior keymapS cccccccccccccccccccooo 126 PRODUCTIVITY TOOLS CONS divisar arai 129 KNOWN ISSUES AND LI MI TATIONS nnssnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 131 PRODUCTIVITY FEEDBACK siii 133 Productivity User Manual Copyright 2000 2004 jProductivity L L C http www jproductivity com Tables Table L PROQUENVI yl TOO Sid eNe ici 12 Table 2 Productivity Key Bindings for CUA Brief and Visual Studio keyMapS ccooccc
43. ONIZALCIO Ves soii Aia 21 OPtONS DEPENAENAC Mit ANA SAA ais 22 SMAA aI atinada ico a 22 SHOWING NAVIO ON PAWS aene eea iia 23 OPUONS DEpENdENC Y rai SA lit is 23 Gel Cl Creat OR o tc sd Es 23 Ntrogquce Constructor PrO nac Ea ea 25 options DEDENGeNCY artista 26 DEJEAN ONE PrO enn AA AA er riarn 26 OPtiOns DEDENGeNCY ainia id 27 Easy JavaDoc and Easy JavaDoc INSIQDT occccccccccccccccncncnnonnnnnnn cece cnn rn nn rr 27 EAS Vi AV AW OC oenen e a a a eta A bod ate a eee eae A 28 EASY VADO CANSO Oia AAA AAA SAA eee ees 28 Options Depende as 29 POWE TOOS it A AS eat A ed gaan ee 29 REN aIMeASSISCAME P O A A ona Ria narrow E eda ee sao 29 Options DependenE Vd A A wan an IAN 30 ASISTAN PRO A A ds 30 OptIONS DEDENGENGY in dis 33 Advanced TO DO S PEO A A A ae es 33 ODEOWNS Dependencia aid A AR AS 34 Task SES POL AA is 34 Introduction to LaSKS CONCEDE ia A A 35 Task List USer MCC a Ce aria AA e 35 Maintaining Tasks USING Tas Listar 37 REINAS eS a aa E 38 ODUONS Dependencia A inteidataieeanea inhi 38 Productivity User Manual Copyright 2000 2004 jProductivity L L C http www jproductivity com 3 S Mare Templates PhO porcina e O marenecunrsinatanetees 39 Predefined Pesa aii rs eawrieds 41 EX ORCS SIO Sarria od ii 42 Smart Templates ASIA asa aaa 47 OMNE RSS Mart Templates unicidad ri 48 ODUONS DEDENOSNEY ii DAA RAN VAS AID AAA AN tin ee te thatilae 49 S Mart aYaDOC PROV aa a licor 50 Smarti avabDoc User Internacio oia
44. Productivity The name speaks for itself Productivity 2 0 for Borland J Builder User Manual http www jproductivity com Copyright c 2000 2004 Productivity L L C All rights reserved J Builder is registered trademark of Borland Software Corporation Java and all Java based marks are trademarks or registered trademarks of Sun Microsystems Inc in the United States and other countries Other brand and product names are trademarks or registered trademarks of their respective owners Productivity User Manual Copyright 2000 2004 Productivity L L C http www jproductivity com 2 Contents PRODUCTIVITY OVERVIEW lt a 7 INSTALLATION INSTRUCTUON Siria ideas 9 PFOGUETIVIEY KeyvIAstalatON ati A A SA A 9 HOW to Ota ev Ple cada 9 FO W to IMStall Key FIC atada adria 9 PFOGUCHIVICY EO AS SAO lr SA AE LEA AAA A AIN 9 License Agreement AcCOD latin sin AS 9 GANSA PrOGUCHIVIDY idad ARA 10 COMPATIBILITY rara 11 PRODUCTIVITY E TOOLS am AA A A 12 COMMON AsIignts Features aura ida IA AAA da IRA IAS 16 COntexE SWIECI Dia ida 16 He SUDOR a E AEA A desadneneas 16 Code Generation TOOLS sonetai ae eE a a EA AEEA AG 17 Class INSI Es AA N eee 17 Glass MSI NE ACTIONS ici Ii 18 SHOWING Navigation Rara iaa iria 18 Options Dependent asada taa cria 19 FPADIe Meninas caida 19 Code Changes SINCOAFONIZACIO Naiara aaa 20 ODtONS Dependencia darian cia 20 Override INsSiGnt and Constructor ASI lancia das 20 Code Ena ges gt y NE F
45. S PLO aaa ANA 73 Navigation FOOLS urna OEI NEIRA 75 BRO WSCUASIO iran toria NN ia 75 BROWSS ASIN ACUSAN UN A ES AUN naa 75 ODUONS DEPpendentY amariada tias 76 BOW st MEMO CS anta o ala aia Deberia 76 AA PPP A a 77 ODIOS DS PENdene aaa criada dcad 77 Search Results and References Highlight Pro c cece cece cece cece cece eeeeeeeeeeeeeeeeeeeeeenennneees 77 Persi tent BOOKMaArKS PrO ienr aE E niet abe cau ren A wiser urs tae NT on rnnes 78 Persistent Bookmarks Navigate ssssssessrrerrsrrrrsrrsrrrrrrrerrrrrrrsrrsrrrrrrrerrrrrnrsrrsrrrrerrrrrrn 79 Manage Bookmarks Dial0d ii A A ATE TA 80 View Navigator and Navigator Insight PrOl ooocccccccccccncncncnnnnnnnn cn cece cnn nn 81 IOMA TOONS ya dio 83 SIDA raras dao 83 Navigation Pal Sai AAA SS 83 FLY PEI A SID NA A AA AAA AS 84 Productivity User Manual Copyright 2000 2004 Productivity L L C http www jproductivity com integration With Other EASIONES divi ii 84 ODUIONS D GDENOCN EY add ais 85 FLY DOIG ICID innit to eanenpet incerneeaetese AS CR O 85 options Depr ndan y atari Sia 85 CONTEXT ASIN ira A E O E E A 85 OPON DEPECNACNC Y rision r a a a a le decane 86 PRODUCTIVITY OPTIONS aiiin is 87 PFO ECE Properties DIGIOG ni EER E AS EA IAE 88 General Oe unica IS ans cias 88 COS SIMS Pal AAA MEL Ias vacua etna daeNe tbat eeaiuaaeee as 89 FAVADOC AAA de eo acters 91 Cache Pad Site AS A A as 93 ASSISTAME PRATS ii A A AA ENE ANA 95 TOOS PAE morata E OR
46. Steel and Plain Steel W2K Look amp Feel Improvements Metal theme Plain Steel Figure 131 Metal theme options Below you can see the samples of Ul under different themes Window Help IDE Options Editor Options 4 Configure Libraries fae Configure JDKs Configure Palette 8 Editor Options Fo Configure Libraries Es Configure JOKE Confiqure Palette Figure 133 Plain Steel Theme sample If you are using Metal LF you may select one of the themes provided Plain themes are similar to the standard one as they are derived from it however the bold attributes of fonts were removed and the font size was slightly decreased Plain Steel W2K in Productivity User Manual 121 Copyright 2000 2004 Productivity L L C http www jproductivity com Task List Reminders Pro Productivity Options addition sets fonts to the mimic ones used in Windows 2000 Tahoma and therefore requires this font to be installed The Task List Reminders groups allows you to tune how Productivity should handle reminders defined in the Task List Task List Reminders show reminders la hours bu before due date Maximum reminders to show E r Play Sound D WINNT iMediatding way AR Figure 134 Task List Reminders Group This group includes the following options Show reminders before due date Allows to specify time interval should be used to show reminder before rem
47. a ant rene E F n a ETE Javax suing event public void keyReleased KeyEvent el I Figure 5 Smart I nstantiate Popup Window When an interface is selected to be instantiated Smart nstantiate automatically inserts implementation of the interface as an anonymous inner class You can control this behavior using the Project Properties Class Insight General property page An Alternative way to get Smart Instantiate executed is using the shortcut Alt I CUA that invokes a particular Smart Instantiate popup This popup is similar to the Class Insight one but it doesn t require holding the Shift key to activate Smart I nstantiate you just need to select a class and press the Enter key to instantiate it A couple of samples of illustrating what Smart nstantiate can do for you Productivity User Manual 22 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools Runnak Figure 6 Code Before Invocation of Smart I nstantiate Runnable runnable new Runnable public void runt fttittodo Implement this rung method throw new Unsupported0perationException Method runt not yet implemented I Figure 7 Code After Invocation of Smart I nstantiate Showing Navigation Pane You can switch the Smart Instantiate popup to show the Navigation Pane by turning off the Editor Options Productivity Usage Show Class Insight popup as list checkbox With thi
48. a structure element at the caret position in the editor with the corresponding element in the Java Structure View There is possibility to have continuous synchronization that automatically tracks caret position changes and finds corresponding element in the Structure View If continuous synchronization is disabled there is an ability to force synchronization manually 14 po dede oral Source a source with structure Smart JawaD Figure 66 Java Structure Synchronizer Buttons as CE nee wee Synchronize Source a Structure n Figure 67 Java Structure Synchronizer Buttons Structure View Synchronizer behavior can be controlled using the and View Toolbar buttons placed at the left bottom of the editor near horizontal scrollbar left corner Change ReadOnly Pro This tool allows easy viewing and managing read only status for file nodes The main features are e Ability to change read only status if file is stored in file system for one or any files using popup menu on viewer tab file node in the Project View or by mouse double click on appropriate panel in status bar the last approach is applicable to Java files only e Ability to highlight read only status using red dot in the top right corner of the node icon for Java files e Ability to highlight modified status using blue dot in the top right corner of the node icon for Java files e Ability to track outer chan
49. ages added by Productivity e General where you can specify options for Import Statements Generation Search Options Sorting options Autocomplete Insight Usage and Invocation insights during debugging e Usage where you can specify how to use or not use the appropriate tools e Delays where you can specify options for Hyperlink Help and Hyperlink Navigate invocation and closing delays Help Insight delay used for integration with J Builder Member Insight and Context Discovering timeout e Tools Pro e Assistant Pro e Smart Templates Pro e Smart JavaDoc Pro In addition with the help of Editor Options Dialog you are able to customize options for the Smart Braces tool These options can be found on the Editor property page in the Editor Options tree view Smart Braces Options Editor Options The Smart Braces tool can be customized via the Editor Options dialog box As soon as Productivity is installed additional node appears in the Editor Options tree view Editor Options Editor property page Editor options 1 Smart Braces options G a Smart key options Productivity User Manual 98 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Options Figure 100 Smart Braces Options This node contains the Smart Braces customization options You may fully customize all the features of Smart Braces to satisfy your needs and goals Editor options Smart Braces options
50. alizable S java awtComponentisetSize Dimension Dimension Dimension d E Dimensiontint width int height E a Source HTML equals Object obj a getHeight getSizel gerwidtht hashCode setSize Dimension d setsize double width double ae a width int height Dimension java setSizelDimension d ooo ostring lt 2 Smart JavaDoc public void setSize Dimension dj Bsetsize d width d height Figure 36 Smart J avaDoc Overview The major features of Smart avaDoc are e Close to WYSIWYG mode of JavaDoc comment editor according to HTML output provided by standard J avaDoc doclet e Rich HTML editing capabilities Smart JavaDoc does not support whole set of HTML tags However the supported set is quite enough for creation of professional quality documentation e Ability to discover and visually highlight JavaDoc conflicts and errors such as unsupported tags parameters and throws conflicts missing tags etc e Ability to easily correct found JavaDoc conflicts and errors Productivity User Manual 50 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools Rich functionality of JavaDoc comment structure management adding specific tags adding all required tags removing all invalid and unused tags tags renaming may be performed in couple of clicks Convenient functionality for navigation and instant accessing members for which JavaDoc com
51. allows you to easily override methods ca Context Insight allows you to check the current context and navigate from there Help Insight allows easy viewing of help topics if any for an identifier within the current context in the cursor position Help Insight OnMembers allows easy viewing of help topics for a member within the current context in the cursor position Pe arenas sanana nenames Refresh cache for classes included into project only oe Productivity User Manual 129 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Tools Icons Professional Edition Tools Icons Delegate nsight provides an easy way to generate methods which implementations are delegated to another object delegate Introduce Constructor allows easy generation of constructors intended to initialize appropriate fields of the class Expands Smart Template with the name corresponding the word at caret or invokes Smart Templates nsight Invokes Persistent Bookmarks Navigate that allows navigation to desired bookmark This tool allows viewing of local clipboard queue and pasting one or several selected fragments in the editor This action allows swapping the content of the clipboard with currently selected block of code This action allows consecutive popping and pasting of code fragments from the local clipboard history in the LIFO order Invokes the Navigator Insight window that allows choosing an o
52. ame li result obtainllass JotUtils ohtainInnerllaszes Figure 61 Changes Highlight and Current Line Highlight Current Line Highlight Pro The Current Line Highlight increases usability of the J Builder editor As it follows from it name this tool simply highlights the line of code at the caret position using specified background color Productivity User Manual 70 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Editor Enhancements ntertacemplementationiUti 46 la sho Source Design Bean Cn Figure 62 Current line highlighting switch Line highlighting can be turned on off using the button from the View Toolbar one that is placed at the left bottom of the editor near horizontal scrollbar left corner Classes and Methods Separator Pro This is another tool included into Productivity intended to increase readability of the Java source code It visually separates classes and methods from each other by painting horizontal line at the top of corresponding classes and methods declarations Please note that this feature depends on the errors in Java source file If there are some severe syntax errors the Java source code parser is unable to parse code correctly In such a case some of the dividers may be displayed incorrectly JMenuFileExit setlexti Exit JMenuFileExit add ctionlistener new ActionListener public void actionPerformed ActionEvent ej JMenuFileE
53. ames that have useful preferred 3 fNalidate frames that have preset sizes if packFrane frane pack else frame validate Figure 72 Search Results and References Highlight Persistent Bookmarks Pro J Builder provides bookmark functionality that allows to set bookmark associated with particular line of the file and the return to it However J Builder built in implementation of the editor bookmarks has some drawback all bookmarks are actually associated with editors not with files thus bookmarks are not persistent between JBuilder sessions The Persistent Bookmarks tool included into Productivity is free from drawbacks mentioned above and introduces advanced bookmarks concept as well as offers lots of new possibilities Each bookmark is linked to a project if any and to a file and is hold its own location as line number in the file as well Every bookmark can optionally contain the Description attribute those can be specified to allow easy identifying of particular bookmark There are two types of bookmarks are currently supported persistent ones and temporary ones All bookmarks with Persistent attribute enabled are stored to the IDE properties on J Builder exit and correspondently all such bookmarks are loaded during the following J Builder run This behavior allows pointing to the most used files and easy navigating them anytime The following actions can be executed during navigating to a persistent bookmark
54. asses stated in the template and adding appropriate import statements to the source file e Ability to use preprocessor instructions those allow dynamic building of template code using conditional and iteration statements e Ability to format template code according to the current project code style and current indent level e Ability to specify supported file types Java HML etc for any template e Ability to specify supported context e g symbol comment or string for any template e Ability to assign keyboard shortcut for any template Shortcut assignments for different key maps are supported too Predefined Fields The following table outlines predefined template fields which always available to any template definition Productivity User Manual Al Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Power Tools Table 4 Predefined Template Fields Field Name Description Specifies the location should be used for caret after template completion selBlock Inserts content of the code block has been selected before the template expansion selBlock asComment Inserts a code block has been selected before the template expansion and transforms it into a Java block comment selBlock asString Inserts a code block has been selected before the template expansion and correctly transforms it to a Java string Inserts current date string currentDateTime Insert current date and ti
55. ation value It will be 1 for numeric types false for boolean and null for any other Java type Template Functions are included into this group allow gaining access to any field within running Functions template String getFieldValue String aName Returns current value of the template field Parameters aName name of the field Return value of the field null if field with passed name is not found void saveFieldValue String aName Saves field value as string to allow it future use Parameters aName name of the field void saveFieldValueAsl nteger String aName Saves field value as integer to allow it future use Parameters aName name of the field Object loadFieldValue String aName Object aDefaultValue Obtains previously saved field value Parameters Productivity User Manual 43 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools aName name of the field aDefaultValue optional default value Return previously saved field value if field value was not saved before it returns aDefaultValue or null if default value is not specified System Functions l l Functions from this group provide access to some of system properties and resources String getSystemProperty String aName Obtains the value of system property Parameters aName name of system property to get Return value of system property null if property with such name is not fou
56. be displayed as hint if mouse IS placed over bookmark icon Code should be revised later Output is used for debugging only irmediActionEvent e bh out println action performed Figure 74 Hint with Description of Bookmark Persistent Bookmarks Navigate This tool allows easy navigation to any bookmark from the bookmark list Persistent Bookmarks Navigate can be invoked using the Alt Shift B CUA shortcut Productivity User Manual 79 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Navigation Tools gt Persistent Bookmarks Mavigate Navigate to e selected boos mark Hutput 15 use Figure 75 Persistent Bookmarks Navigate Manage Bookmarks Dialog Productivity provides rich functionality that allows bookmarks managing The Manage Bookmarks Dialog allows maintaining the bookmarks list T Hanage Bookmarks EJ Bookmarks Description Go To QE Sample numbered bookmark vw a 2E Numbered non persistent bookmark 135 CE Code to be revised fa 141 Helv Remove Al Bookmark Details Mowe Down Project file WES Dey Tools JBuilderSPersonalfsamples Velcomesvelcoame File file WES Dey Tools JBuildersSPersonalfsamples velcomessrcicome Line Mumber 47 Figure 76 Manage Bookmarks Dialog The Manage Bookmarks dialog can be invoked using the Edit Manage Bookmarks menu item or using the editor gutter context menu This dialog provides the
57. be highlighted e g java javax for each project using the Project Properties Productivity Tools property page Advanced Text View Status Pro Productivity includes enhanced editor status bar intended to provide more information about the current status of file in the editor as well as to simplify navigation operations e show current class d void addComponentListener ComponentListener 1 thi li e Show current method faa istener a Show lines count iw Show cursor location m3 Show cursor position Figure 58 Advanced Text View Status Bar The Advanced Text View Status provides all functionality of built in J Builder status bar and offers the following additional features e Displaying name of class corresponds to caret position J ava files only e Name of method corresponds to caret position J ava files only e Caret position offset of caret location within editor document e Number of lines in editor document e Ability to instantly change read only status if file is not modified and is stored in file system using mouse double click on file status label e Ability to change insert override status using mouse double click on insert status label e Ability to invoke J Builder Go to line number dialog using mouse double click on caret position or caret location label e Ability to invoke Browse Insight popup using mouse double click on the class name label if one i
58. bject to navigate This action allows to expand current selection incrementally to outer source element This action allow to narrow current selection incrementally to inner source element Shows the Task List which allows viewing and managing tasks re Productivity User Manual 130 Copyright 2000 2004 jProductivity L L C http www jproductivity com Known ssues and Limitations Known Issues and Limitations 1 Productivity Classes Cache e Since only public classes may be cached the tools that depend on the cache allow working with the public classes only e Cache may not be automatically refreshed during adding and or removing classes packages and libraries as well as upon changes to the project class and source paths In such cases you should refresh the class cache manually or schedule the refresh at the project make or build e To avoid using the already cached classes that belong to the previously removed packages you should refresh the cache for all classes 2 The tools that operate with the words under cursor may sometimes improperly handle the words with underscores 3 Productivity shortcuts are designed and tested to eliminate any possible conflicts with the J Builder shortcuts in any standard J Builder keymap However there remains a possibility of conflicts with some of J Builder plug ins other applications and those functionality of the operational system that use the same shortcuts for other pur
59. c Mac CW Mac Safe Class Insight Ctrl Alt Ctrl Alt Ctrl Alt Ctrl Alt Space Space Space Space oe Productivity User Manual 126 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Tools Icons Table 9 Productivity Pro Key Bindings for Emacs Macintosh and Macintosh Code Warrior keymaps Alt Enter Alt Enter Alt Enter Alt Enter Delegate I nsight Alt Shift M Alt Shift M Alt Shift M Alt Shift M Find Matching Brace Ctri Ctri Ctri Ctri Find Matching Code Ctri Shift Ctrl Shift Ctril Shift Ctrl Shift Introduce Constructors Alt Shift C Alt Shift C Alt Shift C Alt Shift C Navigator Insight Alt Shift N Alt Shift N Alt Shift N Alt Shift N Navigator Next Ctrl Page Alt Page Ctrl Page Down Ctrl Page Down Down Down Navigator Previous Ctrl Page Up Alt Page Up Ctri Page Up Ctrl Page Up Persistent Bookmarks Navigate Alt Shift B Alt Shift B Alt Shift B Alt Shift B Select Class Not Assigned Not Assigned Not Assigned Not Assigned Select CodeBlock Not Assigned Not Assigned Not Assigned Not Assigned Select Method Not Assigned Not Assigned Not Assigned Not Assigned Select Statement Not Assigned Not Assigned Not Assigned Not Assigned Selection Narrow Ctril Shift W Ctrl Shift Ctril Shift W Ctrl Shift W Ctril W Alt Shift W Ctrl W Ctri W Smart Clipboard Insight ALt Shift V ALt Shift V ALt Shift V ALt Shift V Smart Clipboard PopPaste Ctrl Alt Ctrl Alt Ct
60. ccccncccnnn noo 124 Table 3 Productivity Key Key Bindings for Emacs Macintosh and Macintosh Code Warrior keymaps lr E EE cia 126 Table 4 Productivity ECONO Sii AS A AAA AAA AAA 129 Productivity User Manual 6 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Overview Productivity Overview pr pal pa aa era a Oh a o a 315 fi D T zireh HE PEA Productivity is a genuine and rich set of tools intended to greatly simplify routine coding and navigation operations As a result it allows significantly greater development productivity All Productivity tools are carefully designed and tuned to minimize efforts to invoke and use them so you can enjoy the friendly environment Productivity offers With Productivity tools e Be aware of any errors in your code and get assistance to fix them e Be always on schedule with help of Task List e Write bulletproof documentation for your code e Easily reuse your favorite code fragments e Write well composed and easy maintainable code e Forget about typing your imports e Forget about annoying dialogs and Wizards while you are coding e Discover context and navigate through it e Use hyperlinks to surf and to get informed e Navigate freely through your classes methods fields and even editing points e Obtain quick help on classes and methods exactly where and when you need e Add super interfaces change super classes in several sim
61. clicking to desired column header Outlined View consists of Tasks Folder Tree View at the left and Plain View at the right of Task List Tasks Folder Tree View allows selection of tasks grouping and filtering criteria and it acts as Master while Plain View acts as Details is their relationship The following folders are available Productivity User Manual 35 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools EH Project Folder the root for all other folders 5 Overdue Tasks contains all overdue tasks e Le Code Issues contains code issues ll Tasks contains General Tasks e To Do s contains all To Do s outlined by packages of classes those To Do s are belonging to It is possible to specify filters sorting order columns set columns placement and sizes Individually for each view and folder All these settings are persistent between J Builder sessions The Task List provides ability to synchronize selected task with file it is related to if any To open file associated with the task use double click on the task in task list table The following table outlines actions available on the toolbar Table 2 Task List Toobar Actions CI i eseripttom OOO ie Toggles Plain Outlined Views e Specifies if tasks details view will include tasks from descendants of the currently selected package pa Expands all nodes in tree Collapses all nodes i
62. cut This is useful if template is defined as one that may store and utilize user input collected during previous invocation The purpose of this tool is ability to maintain easy find and paste frequently used code Snippets templates hereafter to the currently editing document J Builder built in templates represents usual code fragment which pastes as is and may be optionally formatted according to project code style built in templates only Such a templates concept suits well for simple needs while leaving lots of manual modifications of pasted code for most of complicate cases Smart Templates provides all functionality offered by build in J Builder templates and correctly indents the code fragment and optionally formats it according to current indent level and braces style To minimaze efforts needed to fit templates to the developers needs the concept of advanced templates is used The main difference of this concept is ability to specify template fields inside the code snippet Each field is represented by its own name enclosued by sign written right in the code Snippet In this case template acts as live running form rather then simple code fragment On template expansion all the code outside fields is pasted exactly as it is defined while fields are represented by a set of editors those allows entering values using usual way Each field editor has each own border and the focused one has the Special border w
63. der dialog is displayed when the time gap between current date and due date for particular task is less then specified value In addition there is an optional ability to play sound when reminder is occurring Productivity at Reminder Thu Jul 18 00 38 57 GMT 02 00 2002 Check classes and method for not allowed mod Dismiss fiers transient and volatile Goto Task Snooze and remind again 1 min Figure 30 Reminder Dialog The following actions are available from this dialog e Navigate to the particular task using the Go to Task button e Dismiss reminder using the Dismiss button e Snooze reminder for the certain period of time using the Snooze button and appropriate combobox The Task List hides all the shown Reminder dialogs for project dependent tasks when the user closes particular project or selects another one Options Dependency You can tune reminders behavior using the IDE Options Productivity property page Productivity User Manual 38 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools Smart Templates Pro This tool introduces advanced templates concept and offers a lot of new possibilities and usability features Smart Templates may be invoked using usual Ctri J CUA shortcut or by typing template name and pressing Tab by default key There is also possibility to expand last used template by pressing Ctri Shift J CUA short
64. e e Reminder Status specifies whether reminder should be shown to the user about the task near to the due date The following task types are currently supported e Code Issues errors and warnings collected from the file currently opened in the editor They are interpreted as tasks because all errors and most of warnings should be fixed in order to successfully build source file e To Do s all todo comments collected from the file currently opened in the editor and optionally collected for the whole project All tasks collected for the whole project are cached in the file with todos extension stored in the project folder Task List tries to keep this cache up to date as soon as file is opened though there is ability to rebuild all of them manually e General Tasks simple persistent tasks intended to general use They are not related to any file but rather are related to the whole project All those tasks are stored in the file with tasks extension stored in the project folder Task List User Interface The Task List consists of toolbar which provides controls those allow maintaining and controlling Task List and Task List View which shows tasks Task List View can be either Plain or Outlined one The Plain View shows the table in which each task occupies one row and each column represents appropriate single attribute of task There is ability to resize move or hide columns as well as to specify sorting order by
65. e Alt button t getDefaultToolkitt qgetScreensSizel T T TODA gelocreensize public abstract Dimension getscreenSize ize width e width Gets the size of the creen Returns the size of this toolkit s screen in pixels Figure 80 Help I nsight Popup Invoked via Hyperlink Help In this case for space saving purposes the Help Insight popup doesn t show the Navigation Panel It will only be shown after activating any hyperlink within the popup window Integration with Other Insights Another feature of Help Insight is integration with J Builder built in Memberlnsight and other Productivity Insights Kit qetbefaultToolkiti getScreensizelt public static Toolkit getDefaultToolkit Gets the default toolkit If there is a system property named ant toolkit that property is treated as the name of a class that is a subclass of Toolkit ze width framesize width 2 screensi lf the system property does not exist then the default toolkit used is the class named sun awt motif MToolkit which is a motif implementation of the Abstract Window Toolkit Also loads additional classes into the VM using the property assistive technologies specified in the Sun reference implementation by a line in the accessibilty properties file The form is assistive _technologies where the iz a comma separated list af assistive technology classes to load Each class is loaded in the order
66. e is successfully completed not just some of its files and that there were no compiler errors during the build process You may tune the cache refresh process by using the refresh groups Refresh group is a set of packages that may be refreshed independently Thus you may specify a set of refresh groups that would include the most frequently changing classes and refresh their cache individually Refresh groups packages starts from specified root 1 Packages Add new java javax swing Edit javax Remove Refresh Figure 94 Refresh Groups Options You may specify your refresh groups using the table shown above Use Add new button to create a new group Edit button to edit the existing group and Remove button to delete a group Refresh button allows you to refresh the selected group Please note that double clicking a group row brings you up to group editing similar to pressing the Edit button Creating new groups as well as editing the existing ones is performed via the New Edit Refresh Group Dialog 94 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options New Refresh Group Group Marne Packages to refresh dp select Package aL Figure 95 New Edit Refresh Group Dialog Please use the Group Name field to specify the name of the group to be refreshed and the Packages to refresh field to specify the packages to be inc
67. e see Productivity Tools Table 6 Productivity Key Bindings for CUA Brief and Visual Studio keymaps wo EC Class Insight Ctri Alt Space Ctri Alt Space Ctri Alt Space Class Insight Ctril Alt H Ctril Alt H Ctrl Alt H Browse Insight Ctrl Minus CtrI Shift Minus Ctrl Minus Browse Members Alt Minus Ctri Alt Minus Alt Minus Context I nsight Ctrl Q Ctrl Q Ctrl Q Imports Beautify Ctrl Alt B Ctri Alt B CtrI Alt B Smart I nstantiate Ctrl Shift 1 Set Creator Alt Shift S Ctrl Shift S oe Productivity User Manual 124 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Key Bindings Table 7 Productivity Pro Key Bindings for CUA Brief and Visual Studio keymaps w O w Not Assigned Not Assigned Not Assigned Smart Templates ExpandLast CtrI Shift Ctrl Shift Ctrl Shift Smart Templates ExpandOntTheFly Alt Shift Alt Shift Alt Shift Highlight Local References Ctri Alt Enter Ctri Alt Enter Ctri Alt Enter oe Productivity User Manual 125 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Key Bindings Key Bindings for Emacs Macintosh and Macintosh Code Warrior keymaps The following table outlines the shortcuts to Productivity features For a detailed description of these features please see Productivity Tools Table 8 Productivity Key Key Bindings for Emacs Macintosh and Macintosh Code Warrior keymaps Tool Emacs Ma
68. eator analyses the current class as well as all its Super classes and super interfaces so it can call the appropriate method of the super class or skip particular method generation in case of any contradictions There is an ability to invoke GetSet Creator in the mode that allow generating either accessors or mutators methods only using the Alt Shift G or Alt Shift S CUA shortcuts respectively public JMenuBar getJMenuBarl i return jMenubarl public void setJMenubarl JMenubar jMenubarl Value JMenmibarl JMenubarlYalue Figure 9 Code Generated by GetSet Creator In general GetSet Creator uses Java Beans convention for naming the accessor and mutator methods But if your code style assumes using prefixes or and suffixes for fields naming GetSet Creator allows you to use them without distortion of method Productivity User Manual 24 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools names you just need to specify correct prefixes and suffixes in the Project Properties Productivity Code Style Fields Naming options group For example if you specify prefix m_ and name your field as m_count GetSet Creator generates methods as getCount and setCount GetSet Creator can generate JavaDoc comments during methods generation To control this please use the options on the Project Properties Productivity JavaDoc property page Introduce Constructo
69. ed near this method If this option is disabled all the methods will be inserted in the end of a class definition and the constructors will be inserted after the last defined constructor The only exception is the generation of get set methods if this option is disabled a get set method will be inserted after the appropriate set get method Generate JavaDoc during methods generation 90 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options This checkbox is used to specify whether the JavaDoc comment templates will be generated during the methods generation If you enable it all the methods generated by the Productivity tools will include the JavaDoc comment templates the same as those produced by Easy J avaDoc The only exception is the generation of anonymous inner classes JavaDoc will never be generated during the anonymous inner class generation JavaDoc Page The Easy JavaDoc page of the Productivity Project Properties pages provides the following options 1 Policy for handling the existing JavaDoc comments 2 Methods JavaDoc Generation 3 Classes JavaDoc Generation 4 Auto Generation To set these options for all the new projects select Project Default from the Project Properties All the options on this page are applicable to JavaDoc generation by both manual invocation of Easy JavaDoc default shortcut is CTRL D and by invoking Easy avaDoc during method generatio
70. ed on this field can be the first focused field only if it has value after initialization When has no Value If this option is turned on this field can be the first focused field only if it has no value after initialization Always If this option is turned on this field can be the first focused field without any conditions oe Productivity User Manual 119 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options Fields This group defines which field should be focused when the user presses the Enter key Traversal within this field The following options are available Next Field If this option is turned on the next field with the different name will be focused Next Default Field If this option is turned on the field to be focused will be determined using the Default Policy of the rest of fields Productivity User Manual 120 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options IDE Options Dialog The IDE Options dialog includes a property page added by Productivity which allows user to select the Metal theme to be used by JBuilder and customize Task List Reminders options Look amp Fill Improvements The Look amp Fill Improvements group provides the themes to select from for the Metal look and feel Productivity allows you to customize the current theme of Swing Metal LF There are two additional themes added Plain
71. eld on template execution 118 Productivity Options Complete on Init The Complete on Init checkbox specifies whether the field should be completed if it gets a value after initialization Completed fields are represented in the running template as simple fragments of code rather then editors Expressions This group allows specifying the expressions applicable to different stages of template field lifecycle The Check button allows checking entered expressions to avoid syntax errors On Init The On Init editor pane allows specifying the expression will be evaluated to assign initial value for the template field On Calculate The On Calculate editor pane allows specifying the expression will be evaluated to assign value for the template field to reflect changes in this one or in other fields On Change The On Change editor pane allows specifying the expression will be executed to make some actions to reflect value changes of this field Please note that if this expression returns some value this value will be ignored so execution of this expression can t change any fields anyway Te DENAU This group allows defining the policy and conditions used to determine whether this field should be first focused one on template expand The following options are available None If this option is turned on this field can be the first focused field only if there are no other candidate fields When has Value If this option is turn
72. election tool offers sophisticated code selection functionality that is based on n structure of Java program It allows expanding narrowing selection incrementally using appropriate code elements as well as quickly selection of whole statement code block method or class The Advanced Text View Status Bar represents a replacement of standard component that allows viewing of class and method for current caret position caret offset and lines count IDE Improvements Pro Project View Synchronizer Pro Java Structure Synchronizer Pro Change ReadOnly This tool provides functionality for synchronizing of currently active file with the corresponding node in the J Builder Project View The Java Structure Synchronizer allows synchronizing the J ava Structure View with current caret position in the editor The Change ReadOnly allows easy viewing and managing the read only status for file nodes Navigation Tools Pro Persistent Bookmarks Productivity User Manual ThePersistent Bookmarks tool offers advanced bookmarks functionality These bookmarks are persistent between sessions of J Builder are associated not only with editor but also with file and J Builder project 14 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Tools Pro View Navigator The View Navigator tool allows quick navigation by source elements classes methods fields issues errors editing points
73. emplate Definition Dialog Options Page Options This group provides options those control general template behavior Format Expanded String The Format Expanded String option specifies whether template code should be formatted and indented according to the current indent level and code style ivi I Productivity User Manual 114 Copyright 2000 2004 Productivity L L C http www jproductivity com Expand in Context Expand in Document Productivity User Manual Productivity Options Complete on Fill The Complete on Fill option allows specifying whether the running template should be completed when all template fields are filled Complete on Change The Complete on Change option allows whether the running template should be completed when there is any change occurred in the document outside of template This group provides options those allow specifying the context applicable to expand this template Code This option specifies whether this template can be expanded in Java code reserved words identifiers expressions etc Shorten Full Class Names This option specifies whether all known classes references from the template code should be shorten as well as appropriate import statements should be added This group provides options those allow specifying the document type applicable to expand this template Fields Page The Fields page allows maintaining the fields are belonging to the template is bei
74. enable generation of the corresponding tag Please note that if you select the Generate author check box Easy J avaDoc will use the name of the Author as specified on the Project Properties General property page Classes JavaDoc Generation This option allows specifying the tags that will be included into the generated JavaDoc template for the method Classes JavaDoc Generation Generate author Generate see _ Generate isince Generate version Figure 91 Classes J avaDoc Generation Options By default Easy JavaDoc always generates a description only However you may expand the content of generated template via the Methods JavaDoc Generation option You may select the appropriate checkbox to enable generation of the corresponding tag Please note that if you select the Generate author checkbox the Easy avaDoc will use the name of the Author as specified on the Project Properties General property page The same happens with the Generate version checkbox Auto Generation You may specify whether default comments should be generated for the get set methods using Automatically generate text of comments for get set methods Please note that this option is applicable only to GetSet Creator tool Auto Generation _ Automatically generate text of comments for get set methods Productivity User Manual 92 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options
75. eprecated Deprecated or this column ault cell render Figure 41 Adding Required Tags Font actions group provides ability to apply appropriate font size and family to the currently selected block of text Productivity User Manual 55 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools Font Style actions group provides ability to apply appropriate font style bold italic underline and subscript Superscript ones to the currently selected block of text Subscript ve Superscript Figure 42 Applying Subscript Style Format Painter a tool is similar to one can be found in Microsoft Word Allows performing of quick copying of formatting style from one text fragment to another one Paragraph Alignment actions group provides ability to set alignment of paragraph Bullets and Numbering actions group provides ability to convert currently selected code fragment to a list either numbered or unnumbered Marked List Numbed List Figure 43 List Style Selection Indents actions group that provides ability to increase or decrease the indent level of the current paragraph r i aaa r CODE HR lt PRE gt Figure 44 Controlling ndent Level a Insert Objects actions group that provides ability to insert various HTML objects Productivity User Manual 56 Copyright 2000 2004 Productivity L L C http www jproductivity com
76. er with the Alt key pressed after some delay the Help Insight popup appears that contains exact help about the symbol under the cursor Options Dependency You can customize delays on invocation and closing of the Hyperlink Help popup window using the Help Insight options on the Editor Option Productivity Delays property page Also you can specify whether Hyperlink Help should be invoked during a debug session using the Invoke insights during debugging option on the Editor Option Productivity Usage property page Context Insight Context Insight is a tool that allows you to check context of the current cursor position Context Insight collects information about all classes and methods and shows it using the Insight popup window To invoke Context Insight please use the Ctri Q CUA shortcut Productivity User Manual 85 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Information Tools Runnable rumable new Runnable i public void rumi public class ContextUtils public static class ContextUtils PathDeclaration void whe content aPatrh T 3 ContextUtils l extends Runnable public void runi Figure 83 Context I nsight Popup Window Another feature supported by Context Insight is navigation If you place the mouse cursor over an identifier within the Context Insight popup window the hyperlink appears and activation of hyperlink leads to navigation to the identif
77. ere ls one otherwise the name of the default cross platform LookAandFeel class See Also seiLook4ndPFeelfavax swing Look2ndFeel ager getsystemLookAndFeelClassName ii Figure 79 Help I nsight Popup Window To invoke Help Insight for a symbol at the cursor position place the cursor over the identifier for which you need help and press Shift F1 CUA To invoke Help Insight for a member within the current context place the cursor in the bounds of a method or class for which you need help and press the Alt F1 CUA Shortcut Help Insight shows the appropriate JavaDoc help topic if any or tries to find and show the appropriate one for a super class or method in other case Navigation Pane The Navigation Pane atthe top of the popup shows different gadgets intended to control the popup You can use the Back and Forward buttons or Alt Left and Alt Right keys respectively to navigate through the help topics history or you can use the Open the Productivity User Manual Copyright 2000 2004 Productivity L L C http www jproductivity com 33 Productivity Information Tools Whole Topic button to open the complete help topic in the Help Viewer window The Context label shows the context or an HTML file name depending on the ability to resolve any Hyperlink Help An Alternative way to invoke Help I nsight is to use Hyperlink Help by placing the mouse cursor over an identifier for which you need help while holding th
78. ew Navigator tool provides ability to control set of source code related navigation operations using the same way and uniform manner The main idea of this tool is utilizing of pair of shortcuts and a pair of appropriate buttons to execute previous and next navigation operations against specified Navigate Object Following Navigate Objects are currently Supported for J ava files e Warning or Error e Low Priority Issue e Any Issue e Editing Point e Method e Class e Class or Method e Search Result e Local Reference Following Navigate Objects are available for other types of text files Productivity User Manual 81 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Navigation Tools e Editing Point e Search Result ra Warning or Error Low Priority lesue Any lesue Method Class search Resulh As Insert _ 166 Modified Insert Figure 77 View Navigator and View Navigator menu The Navigator control is placed at the bottom right of the editor view right under the vertical scrollbar and includes the Previous Next and Select Object To Navigate buttons The Previous and Next buttons allows navigating through the objects you can use Ctrl Page Up and Ctrl Page Down shortcuts CUA too The Select Object To Navigate button allows choosing an object to navigate by using appropriate menu items form popup menu shown on button release Another way choose object type
79. ges of read only status as well as file modifications Productivity User Manual 73 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity I DE Improvements Le 3 Som 7 u Welcome jp EH Welcome jp E Welcome Fittmil eet j 24 Welcome pp java el WielcomeFrame java Oper 2 Add Files Packages 3 Remove from Project YYelcomeFrame java Rename Welcome Frame jawa New Folder Close Project Welcome jpx S AE O Make lol SY Rebuild lol ad Productivity Cache Refresh Properties lst allethotterate Cd Figure 68 J ava Structure Synchronizer Buttons Productivity User Manual Copyright 2000 2004 jProductivity L L C http www jproductivity com 74 Productivity Navigation Tools Navigation Tools Productivity offers rich set of powerful tools intended to simplify navigation and allow quick finding of required information There are several types of navigation are supported e Navigation to appropriate class using short class name Browse nsight e Quick navigation to appropriate member of Java Class Browse Members e Navigation to particular symbol definition Hyperlink Navigate e Navigation to appropriate bookmark in editor Persistent Bookmarks e Navigation and iteration to source code element class method fields code issue to do comment of search result View Navigator and Navigator Browse Insight Browse ns
80. ght Class Insight allows quick finding Java classes with short names matching the word at the cursor position and inserting the class name found into the cursor position as well as inserting import statement Implement Insight Implement Insight allows quick finding Java classes with short names matching the word at the cursor position and using them either as a super interface or as a super class Override Insight Override Insight allows quick finding methods to override with names matching the word at the cursor position or a typed word and overriding them into the class at the cursor Productivity User Manual Copyright 2000 2004 jProductivity L L C http www jproductivity com 12 Productivity Tools reson Constructor nsight Constructor nsight allows quick overriding class constructors Easy avaDoc Easy JavaDoc allows easy and convenient generating templates for JavaDoc comments for a particular method or class Smart Instantiate Smart Instantiate is an additional Class nsight functionality that allows adding instantiation of a particular class or interface GetSet Creator GetSet Creator is a tool that allows easy creation of accessors and or mutators for selected fields of a class Power Tools Pro Rename Assistant This tool simplifies identifiers renaming by introducing in place rename approach Pro Assistants The set of assistants those show information about the particular issue and or
81. gure 103 Search options The following options are available for search control Use startsWith method If this option is turned on all the search operations will be performed for the string with the value of the word at cursor Otherwise the search will include the strings that contain the required substring usually a word at cursor Case sensitive If this option is turned on the case sensitive search algorithm will be used Stop on exact match If this option is turned on only classes with the names that exactly match the word at cursor will be shown Show additional classes ee Productivity User Manual 101 Copyright 2000 2004 jProductivity L L C http www jproductivity com NOTE Sort classes by Autocomplete Productivity User Manual Productivity Options If the Stop on exact match option is disabled you may specify the amount of classes you would like to see in the popup list Since the overall amount of classes may be quite important you may make the list of classes less extended This option is common for the following Insights Class Insight Browse Insight Implement Insight and Smart nstantiate These options allow controlling the sorting of classes for the following Insights Class Insight Browse Insight Implement nsight and Smart Instantiate Sort classes by E Class name then by package name 8 Full qualitied class name Figure 104 Sort Classes By options The following option
82. h entry in that panel should be ended by symbol The sequence order of classes being specified is inessential The Add button allows adding a class using the Select Class dialog Tools Page The Tools page allows specifying the following options 1 Classes Highlight To set these options for all the new projects select Project Default from the Project Properties Classes Highlight Productivity allows highlighting of certain classes using Java Extra keyword style and these options allows fine tuning this functionality Highlight Classes Y Enable Classes Highlight Classes To Highlight Figure 99 Classes Highlight Enable Classes Highlight Select this checkbox if you wish to turn highlight classes on Classes to Highlight Productivity User Manual 97 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Options Using this panel you can specify list of classes to be highlighted Each entry in that panel should be ended by symbol The sequence order of packages and classes being specified is inessential It s possible to use the following entries e to highlight all classes e package to highlight all classes belonging to specified package e package class to highlight exactly specified class The Add button allows adding a package or class using the Select Package or Class dialog Editor Options Dialog The Editor Options dialog includes the following property p
83. he method or class at the cursor position This approach allows easy generation of JavaDoc comments for the method or class at the cursor position pur TODO Insert description of the method here paran e ai public void jMenuFileExit actionPerformed ActionkEvent ej Syatem exiti j Figure 17 Code Generated by Easy JavaDoc You can select a member navigating through the list with the help of the usual keyboard An Alternative way to do it is to continue typing the word the list selection will be changed to produce the closest match possible Productivity User Manual 28 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools On selecting the members press Enter to generate JavaDoc covering all of them Options Dependency You may adjust content of JavaDoc generated by Easy JavaDoc using Project Options Productivity Easy JavaDoc By default Easy JavaDoc generates return param and throws tags You may also specify that it should generate author see and since tags To enable or disable their generation please open the Project Options Productivity Easy JavaDoc property page and select the appropriate check boxes Please note that if you select generation of the author tag the Easy JavaDoc inserts the tag s value as it is specified on the Project Properties General property page In addition on the same page you can specify the policy to be used by Ea
84. hich highlights it There is ability to navigate through all the fields using the Tab and Shift Tab Shortcuts The Enter and Shift Enter shortcuts allow navigating through the fields Skipping ones with the same type q public void processList List alistTolterate i int size alistT size j for int i 0 i lt size i f Object object Object alistT get 1 Figure 31 Smart Template with Fields It s possible to invoke another tools like Member Insight for selecting values of template fields Productivity User Manual 39 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Power Tools i public void processList List alistTolterate E Iterator iter aListTol iterator j while iter H cam boriand samples welcome WWelcome Frame Ubject obje Adjustable D djustnentEvent D AdjustmentListener 2d aListToIterate D Alphalomposite D AlphaCompositeContext D ncestorNotifier D AnimatingClontrolssurface D dnimatingSurface D drithmetickxception Figure 32 Entering Field Value Using J Builder Member Insight The following major features are applicable to template fields e All the template fields of same name are automatically synchronized that allow entering field value only once e Ability to specify default value or initialization expression for a template field The default value or result of expression execution is automatically assigned to the field on te
85. ial Character Ed elect Character Figure 48 Insert Special Character Dialog Colors actions group which provides ability to specify foreground and background color for the selected fragment of code Options provides ability to enable disable displaying of the preview panel Navigation includes two actions those allow navigation to the next previous member of Java file These actions may be invoked using Ctrl Page Down and Ctrl Page Up shortcuts respectively Block Style actions group which provides ability to specify style of the text block paragraph lt p gt preformatted block lt pre gt code lt code gt or variable width lt var gt Productivity User Manual 58 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools CODE WAR lt PRE gt Paragrpah Header 1 Header 2 Header 3 Header 4 Header 5 Header 6 Figure 49 Text Block Style Selection There is ability to specify which actions group should be visible on the Smart JavaDoc toolbar using the toolbar context menu le Font le Font Style ra Format Painter m3 Paragraph Alignment ra Bullets and Numbering ra Indents lw Insert Objects i Block Style m Colors K e Options ra Navigation Hide All Figure 50 Controlling Smart avaDoc Toolbar JavaDoc Errors Highlighting The Smart JavaDoc tool provides rich functionality that allows detecting whether errors or conflic
86. ier In some cases particularly within classes with significant amount of inner classes the Context Insight may display only upper class information Such behavior is explained by definite limitations of the J Builder J OT subsystem that requires significant amount of time up to tens of seconds to retrieve information about the inner classes To avoid hang up of J Builder the time required for context information gathering may be limited in Editor Options Productivity Delays page So if JOT provides no data within this interval only upper class information is provided The same reason may cause relatively slow performance of Context Insight if the cursor is on the white space between class methods The same limitations may affect other tools using the same functionality Override Insight mplement nsight Options Dependency You can specify Context Discovering Timeout using the Editor Options Productivity Delays property page Productivity User Manual 36 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Options Productivity Options Productivity Pro offers rich abilities for customizing its functionality and tuning it exactly for your own unique code style and your particular needs You can manage Productivity settings in convenient and customary ways using standard J Builder approaches for configuration Most of Productivity settings are concentrated in two JBuilde
87. ifying the description for the template Group The Group combobox allows specifying the group this template belongs to The group defines the name of the file in which this template will be stored after saving of the template list Allocation of templates across scopes and groups allows better controlling them and provides easy way to share them between team members Active The Active checkbox allows specifying whether this template is available for use ivi I Productivity User Manual 113 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Options Code The Code editor pane allows typing the code of the template The code of the template consists of code fragments and optionally template fields within them Each field is represented by its name enclosed by sign In general it s enough just to state fields in the template code and they will be automatically added to the template To specify properties for the desired template fields the Fields page is used Options Page The Options page allows specifying miscellaneous properties of template Edit Template Definition forlc General ions Fields Shortcuts ptions Format Expanded String e Complete on Fil t Complete on Change xpand in context xpand in Document Code je Java Other Shorten Full Class Names JSP Comment _ XML _ String HTML _ Plain Text _ Text Figure 127 Edit T
88. ight Style 2 Java Doc Generation Style Issue A at waist 4 fae 0 00 0 ee eee Sn ee ee Highlight The Issue Highlight Style options group provides ability to customize style and color of Style marks should be used to visually highlight errors in JavaDoc comments such as missing or redundant parameters missing throws unknown tags etc lesue Highlight Style Priority Low Style Dotted Line Y Color Figure 120 Smart JavaDoc Issue Highlight options JavaDoc le i Generation The JavaDoc Generation style options group provides ability to customize style of Style JavaDoc comment generated by Smart JavaDoc JavaDoc Generation Style Separate HTML tage Insert empty line after JavaDoc tag Indent JavaDoc tag text Productivity User Manual 109 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options Figure 121 JavaDoc Generation Style options There are the following options e Separate HTML tags if enabled all tags such as lt p gt will be placed on different lines e Insert empty line after JavaDoc tag if enabled the empty line will be Inserted between J avaDoc tags e Indent JavaDoc tag text if enabled the multi line tag description will be indented from left by the tag itself Smart Templates Page Pro This page allows customizing of Smart Templates behavior and maintaining the templates list It provides the following
89. ight allows quick finding Java classes with short names corresponding to the word at the cursor position browsing them or opening the appropriate help topic for them java swing J TabbedPane prion Browse dass EJE JTabbedPane oe awing D JTabhedPaneBeaniInfo l Javax Swing D JTable l Javan swing GQ JTableBeaniInto Ee Javax swing SY JTableHeader Javak swing table Figure 69 Browse I nsight Popup Window To invoke Browse Insight press Ctrl Minus CUA The Browse Insight popup will be Shown with the list of classes matching the word at the cursor position The list may be empty if there are no matching classes though To find matches type a word in the Browse Class edit box and Browse nsight will dynamically rearrange the classes list to show the matching ones You can select a class navigating through the list with the help of the usual keyboard An Alternative to do it is to continue typing the word the list selection will be changed to produce the closest match possible Browse Insight Actions Press Enter when you find the required class and Browse nsight will open this class in the browser Productivity User Manual Copyright 2000 2004 Productivity L L C http www jproductivity com 75 Productivity Navigation Tools Press Ctrl Enter when you find the required class and Browse lnsight will open the appropriate help topic for it Also there is a possibility of employing the Browse Classes
90. inder s task due date As units of time interval measurement minutes hours or days may be selected Maximum reminders to show Allows specifying the maximal amount of reminders those may be simultaneously visible Play Sound Provides ability to specify that some sound should be played on reminder displaying and assign appropriate sound file should be used by reminder Productivity User Manual 122 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Key Bindings Productivity Key Bindings Productivity supports all J Builder built in keymaps such as 1 Brief 2 CUA 3 Emacs 4 Macintosh Mac 5 Macintosh Code Warrior Mac CW 6 Visual Studio VS Also an additional keymap is provided Mac Safe intended to improve Productivity usability on the Macintosh platform If you use Professional or Enterprise edition of J Builder you are able to customize these NOTE shortcuts by using either Editor Options Editor Keymap Customize or IDE Options Browser Keymap Customize dialogs All the Productivity shortcuts are placed in the Productivity group ae Productivity User Manual 123 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Key Bindings Key Bindings for CUA Brief and Visual Studio keymaps The following table outlines the shortcuts to Productivity features For a detailed description of these features pleas
91. ions These tools Productivity User Manual 13 Copyright 2000 2004 jProductivity L L C http www jproductivity com Pro Smart Gutter Pro Smart Braces Highlight Pro Matching Code Highlight Pro Changes Highlight Pro Methods and Classes Separator Pro Current Line Highlight Pro Smart Selection Pro Advanced Text View Status Bar Productivity Tools include clipboard management swapping context of clipboard with current selection inserting pasted Java code with correct indent along with required import statements etc The Smart Gutter is additional gutter placed near standard J Builder editor gutter and is used for showing various hints concerning corresponding code in editor by arranging appropriate gutter marks The Smart Braces Highlight tool providers matching braces highlight and navigation operations as well as showing code fragment that corresponds to appropriate brace The Matching Code Highlight tool performs highlighting of code matching to one at caret position as well as displaying appropriate code fragment in the popup window The Changes Highlight Highlights changed lines if Java source on the gutter The Methods and Classes Separator tool visually separates classes and methods from each other by painting horizontal line at the top of declaration The Current Line Highlight tool highlights the line under cursor in the current editor with appropriate background color The Smart S
92. is being edited and this file is not read only one Changing of Completed attribute for To Do s and General Tasks doesn t lead to any other actions rather then simple assigning of appropriate value to the task This behavior is completely different for Code Issues as the nature of Code Issues is Productivity User Manual 37 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools different To make Code Issue completed the reason of it should be removed or the problem should be fixed someway Thus Code Issue can be completed if there are actions those can fix it and to complete it one of them should executed as well For example if code issue is unknown class or ambiguous one it s possible to select correct class from list of options fix the issue and thus complete the task Reference to a class List is ambiguous ul o javawutillist P t H l l ession a java ayt List A H unclosed character literal Figure 29 Fixing Code Issues Using Task List Reminders There is ability to setup reminders for tasks which are not completed yet and have due date assigned To setup reminder the appropriate attribute of required task should be checked The 2 button should be pressed to enable reminders tracking It is possible to instruct Task List to show reminders for tasks which owned by current user only To turn this mode on the Ya button should be pressed The Remin
93. it Template Dialog Pro The Edit Template Dialog allows maintenance of a template and specifying its structure and properties It contains the following pages e General one that allows maintaining general properties of template e Options one that allows specifying miscellaneous properties of template e Fields one that allows maintaining the fields belonging to template e Shortcuts one allows specifying of shortcuts for each supported keymap General Page The General page allows maintenance of template general properties ae Productivity User Manual 112 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options Edit Template Definition forlc Options Fields Shortcuts Mame Horie Description List traversal using cached list size Sh OUp default ba e Is Active General Code int size FlistA sizel for iint index U index lt size index gyvarTyped var varTypesi 1list qet index selBRlocks EA a N Figure 126 Edit Template Definition Dialog General Page It provides the following options Name The Name edit box allows specifying the name for the template This name would be short as possible though it should be meaningful enough to recognize the template Please note that template name should be unique within current scope Description The Description edit box allows spec
94. ith the list of members fields and methods matching a word at the cursor position The list may be empty if there are no matching or suitable members though To find matches type a word in the Choose Delegate edit box and Delegate nsight will dynamically rearrange the list of members to show the matching ones The Choose Delegate edit box can be blank that allows viewing of all members JMenultem jJMenuHelp bout new JMenultem WPialog abiald s com borand samples welcome Welomesame Choose Delegate bd KI 4 ff Construct ES public Welcome add Lompone ampare r enahleFrentea add String A Hlic Component add Component comp try add i Component int Component Jblnit 1 Figure 13 Delegate I nsight Popup Window Selecting a Delegate As soon as a member to become the delegate is selected multiple selection is not supported by this tool and press the Enter key the Delegate nsight popup shows the Productivity User Manual 26 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Power Tools list of methods belonging to the delegate and suitable to be introduced in the target class UMenultem jMenuHelp bout new JMenultenm JDialog abialoia n A choose ets gawd X ff Comstruct ii public Welcome enableEventa AUTEvent WINDOW EVENT MASE try Figure 14 Delegate I nsight Popup Window Selecting Methods To find matches please type a word
95. lar methods or classes except for the anonymous ones Productivity User Manual 27 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools Easy JavaDoc To invoke Easy JavaDoc place the cursor within a method or class for which you want to generate JavaDoc and press Ctrl D CUA JavaDoc comment will be automatically inserted just before the method Since the method comments contain tags for all declared fields exceptions can be thrown by the method That s really easy Easy JavaDoc Insight Easy JavaDoc Insight allows choosing of several methods or classes for JavaDoc generation ffFile Exit action performed public void jMenuFileExit actionPerformed ActionEvent e System ex1t 0 2 i i void Figure 16 Easy J avaDoc I nsight Popup Window Press Ctrl Shift D CUA to invoke Easy J avaDoc Insight The Easy avaDoc nsight popup will be shown with the list of members methods and or classes matching the word typed in the Members edit box The list may be empty if there are no matching members though To find matches type a word in the Members edit box and Easy JavaDoc Insight will dynamically rearrange the members list to show the matching ones If you leave the Members edit box blank all members within the current context are shown NOTE Unlike other Insights Easy JavaDoc Insight doesn t merely employ the word at the cursor position it rather uses the name for t
96. lipboard Auto Indent Smart Selection Smart Braces tools e Matching elements highlights Smart Braces Highlight Matching Code Highlight tools e Usability improvements Thumbnail Gutter Smart Gutter Advanced Text View Status Bar Line Numbers tools e Editor look and feel improvements Methods and Classes Separator Changes Highlight Classes Highlight tools Smart Clipboard Pro This tool introduces the replacement for standard clipboard actions and offers a number of improvements and new features Paste Action In general this action acts as usual Paste action but in addition also allows making the following actions e Auto indentation of Java code during paste operation according to the indent level at the point of pasting e Automatically insertion of appropriate import statements on paste for classes used in the copied fragment if clipboard content was copies from J Builder editor with Java code Copy Cut Actions In general those actions acts as usual Copy Cut actions but they allows making the following additional actions e Collecting information about classes used in the copied cut code fragment e Storing the copied cut code fragment in the local clipboard queue that allows future use of several code fragments Swap Action This action allows swapping the content of the clipboard with currently selected block of code It can be invoked using the Ctrl Shift I nsert CUA shortcut Productivity
97. list of possible actions to complete Pro Task List The Task List is a tool that allows viewing and managing the list of tasks code issues and to do s Pro Advanced To Do s The Advanced To Do s tool is further expansion of the To Do comments concept by treating them as tasks with set of attributes like priority status owner etc Pro Smart Templates The Smart Templates is advanced template engine that provides set of sophisticated features like linked fields calculated fields expression and functions supports It introduces advanced code templates those can be easily adapted to particular coding style coding style Pro Smart avaDoc The Smart JavaDoc tool is additional viewer for Java file node that offers JavaDoc authoring in mode that is very close to WYSIWYG one Editor Enhancements Smart Braces The Smart Braces is a tool that allows easy creation of closing braces while you are typing Pro Code Folding Ability to fold Java Doc comments and collapse all of them Enhancements by using special button on the view toolbar Pro Classes Highlight Allows highlighting classes used in the code Pro Thumbnail Gutter The Thumbnail Gutter represents additional gutter placed near the vertical scrollbar of editor pane and allows showing gutter marks for the whole source file as well as navigate to them Pro Smart Clipboard The Smart Clipboard represents several tools used for provide more efficient clipboard operat
98. luded into the group You may specify the packages for inclusion by either manual typing only valid J ava symbols are allowed separator for packages is or by adding them via the Select Package dialog invoked by the Add button The order of specified packages is not essential Refresh Now These options enable immediate start of the refresh operation for the Productivity classes cache Refresh Project Refresh Libraries Refresh All Figure 96 Refresh Now Options You may choose from the following refresh types of the classes included into the project only of the project libraries which is crucial to do after adding or removing libraries or of the whole cache including the classes from J DK Assistant Page The Assistant page allows specifying the following options 1 Auto Import Policy 2 Frequently Used Classes To set these options for all the new projects select Project Default from the Project Properties Auto Import Policy This option panel allows maintaining the list of Auto Import Policy entries Such list is used to determine which action should be executed for each particular short class name during auto import process Productivity User Manual 95 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options Auto Import Policy Full Class Name Particular com sun tools javac wi tree Tree Figure 97 Auto I mport Policy Each entry occupies o
99. ly fixed 1 Type cast errors by adding required type cast Productivity User Manual 31 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools 2 Unknown class errors by adding appropriate import statement It s possible to specify policy for each short class name that exactly defines what action should be done to make this name known in the code It is usual thing when several classes with the same short names are be defined in different packages java util List and java awt List is the good example To simplify working with such classes it s possible to specify a list of most frequently used classes using the Project Properties Productivity Assistant property page Such list is used to determine particular class to import or to show in the top of the list in case of existence of several different candidates It s possible to disable assistants either globally for all types of issues using menu in the bottom right corner of Thumbnail Gutter or disable assistant for only specific group of issues le Info Assistant ls Code Assistant Figure 22 Disabling Enabling Assistants Menu Below are several examples of Code Assistant import Java awt import java util public class WelcomeFrame extends JFrame List children null J Reference to a class List is ambiguous borderLayoutli a java util List shitt Enter a java awt List Ctrl 2 1t 1 Figure
100. mart Braces The reason of such behavior lies in the features of the vi implementation not absolutely correct implementation of the Keymap default action However you can disable the part of the Smart Braces functionality which leads to the conflict To do this please add the following lines to your J Builder config file located in the J Builder bin directory vmparam DProductivity Smart Braces CompleteCharacters no vmparam DProductivity Smart Braces CompleteStrings no Matching Code Highlight Pro Productivity User Manual Java is well structured language but several statements exists that greatly decrease readability of the program those ones which breaks normal code flow execution In some cases especially if source code is written by another developer it can be hard to understand to which statement for example break one points too The situation become even worse if these break statement has label and labeled statement is far from break one The Matching Code Highlight become really invaluable in such situations Matching Code Highlight tool provides help in source code investigation and helps to understand which code is matching to one at the caret position In addition this tool provides easy navigation to it 68 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Editor Enhancements for int i 0 i lt anlrmertlasses length ss result null i 1479 Jot
101. me string Expressions The most powerful feature of Smart Templates is ability to specify expressions needed to be evaluated during template execution This allows developing truly smart and dynamic templates those can be easy adapted to developers needs In general any expression should conform to expressions definition rules in Java language and can contains only the following lexemes e String character and numeric literals e operators e Variables e Functions calls e Open and close parenthesis The Smart Templates provides automatic types conversion during evaluation of expressions so expression can contains literals variables and functions with different types and or return types If possible all these different types will be correctly cased The following functions are available Utility Functions Functions are included into this group are intended to suit miscellaneous utility purposes String getLocalVariableName String aType Productivity User Manual Copyright 2000 2004 Productivity L L C http www jproductivity com 42 Productivity Power Tools Composes variable name based on passed variable type Parameters aType string that represents variable type Return name for variable based on variable type String getVariablel nitValue String aType Composes variable initialization value based on passed variable type Parameters aType variable type Return variable initializ
102. ments should be created Ability to filter members used for documentation creation via advanced Java Structure Component Ability to perform two way editing of JavaDoc comment using both Smart JavaDoc and usual Java source editor Ability to browse source code while editing JavaDoc Ability to instantly get preview of JavaDoc comment will be generated Sophisticated multilevel undo redo support Smart JavaDoc User Interface The Smart JavaDoc tool is an additional viewer available for J ava files It consists of two major parts Java Structure View which allows you easily navigate between members for which JavaDoc comment should be generated JavaDoc View intended to provide JavaDoc comment editing and previewing setColumnselection A lloyred boolean Sie Some indexi int index setDefauttEditoritass columntlazs E setDeftautRenderer Class columntia setEdting olumncint acolumn setEditingRow1int aRow public method Figure 37 Smart JavaDoc Java Structure View The Java Structure View offered by Smart JavaDoc is similar to one provided for Java files The main difference is that all unimportant and not suitable members are filtered out from its view There are two additional actions those allows to navigate to the next previous member of Java Structure View These actions may be invoked using Ctri Page Down and Ctri Page Up shortcuts respectively Please note that these Shortcuts are operational even
103. mment for it If there are no JavaDoc comment exists for the current source code member the default JavaDoc template for all suitable tags is offered If JavaDoc comment exists Smart avaDoc will show editors only for tags defined in it Changes made by user while editing the JavaDoc comment are written to the source file on closing the Smart JavaDoc tab on selection of another member class field or method or by saving the document Productivity User Manual 53 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools Please note that Smart JavaDoc may perform conversion of some unsupported tags found in JavaDoc comment The following are limitations of Smart JavaDoc regarding support of HTML tags 1 Smart JavaDoc doesn t support the following HTML tags so it skips and ignores them lt base gt lt basefont gt lt body gt lt html gt lt title gt lt meta gt lt script gt lt style gt lt head gt lt applet gt lt object gt lt frame gt lt noframes gt 2 The following tags are partially supported by Smart JavaDoc they will be displayed but in some cases they may be edited incorrectly lt form gt lt input gt lt option gt lt textarea gt lt table gt lt td gt lt tr gt lt th gt 3 There is set of tags those will be replaced by equivalent ones Original tag Replacing Tag lt p gt lt p gt cave ep le es 4 Smart JavaDoc
104. mplate expansion e Ability to specify calculated expression for a template field This allows dynamically calculate field value to reflect changes made by the user in this field or in the other ones e Ability to specify change expression for a template field This allows making some actions after the field is changed and or calculated e Ability to store values entered in the template fields and load previously stored values on the next template invocation This allows to fill fields automatically during the consecutive template calls e Ability to utilize selected block of code as field value Expanded tamplate enters the running state after invocation and user is able to fill template fiels A running template can be completed by pressing Esc key changing code outside of any template fields if appropriate option is turned on or by filling all fields and using Enter key to navigate between them After the completion of running template all the code written in the field editor is pasted directly to the document and the editor caret is optionally placed to the position specified by location of predefined field if one is included into template definition In addition the Smart Templates tool introduces the following features Productivity User Manual 40 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools e Ability to shorten full qualified names for cl
105. n in Override nsight Constructor nsight Implement Insight and Smart nstantiate tools Please note that all these options are not applicable to the code generated for anonymous classes since JavaDoc is never generated for them If JavaDoc Already This option allows you to specify the processing policy for the existing JavaDoc Exists comments Of JavaDoc already exists Skip generation C Override existing Figure 89 If JavaDoc exists Options You may define how Easy JavaDoc will handle the existing JavaDoc comments If JavaDoc already exists for a method or class Easy JavaDoc may either skip the generation of JavaDoc template and override the existing block by its own one or prompt your confirmation for overriding of the existing comment pear ie These options allow you to specify the tags that will be included into the generated Generation JavaDoc template for the method Productivity User Manual 91 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Options Methods JavaDoc Generation Generate author Generate msee _ Generate since Figure 90 Methods J avaDoc Generation Options By default Easy avaDoc always generates param throw and return except void methods and constructors tags based on the method definition However you may expand the content of generated template using Methods J avaDoc Generation option You may select the appropriate checkbox to
106. n in the Status View Productivity User Manual 31 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools Options Dependency Using the Project Properties Productivity General property page you can customize Code Generation Options which allow you to adjust the code style for the generated methods code Import statements are generated basing on Imports Generation settings on the Editor Options Productivity General property page There you also can customize other Override Insight options such as Search Options and Sort Classes By Smart Instantiate Smart Instantiate is an additional functionality of Class Insight that allows adding instantiation of a particular class by invoking Class I nsight selecting the class and pressing Shift Enter Smart Instantiate recognizes the need to define a variable or just to create a new object For example when you type List fList new List 100 and use Smart Instantiate to create an ArrayList instance Class Insight replaces only the appropriate class name and preserves the variable definition and constructor parameters You will get the following List fList new ArrayList 100 The same behavior is exhibited when using Smart nstantiate to create a new instance and as a parameter to a method call In other cases Smart nstantiate inserts definition and initialization of the variable with a new instance of the selected class fal
107. n tree Allows creation of new tasks Removes currently selected task s Refreshes current view and optionally refreshes To Do s for the whole project rr Allows applying filters for the current view Allows choosing visible columns for the current view E El z Specifies whether todo comments should be shown for the whole project or for active file only Specifies whether completed tasks should be visible Enables Disables reminders tracking Productivity User Manual 36 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools Specifies whether reminders should be shown only for tasks assigned to the current user Maintaining Tasks Using Task List The Task List allows creation of new tasks removal of existing ones and changing attributes of them To change task attributes Task List offers in place editing capabilities and provides appropriate cell editor for the each attribute r Helphlanaca Jate of rcCla ate of rcCla Figure 28 Changing Priority of the Task The following table shows operations applicable to each task type Table 3 Task Operations Operation Task Type Code Issue Completed attribute General Task e A E a This operation is applicable if there is at least one Complete action available for the particular Code Issue These operations are applicable if J ava file this To Do is belonging to
108. nd String getDate String aFormat Obtains string representation of current date according to optional format Parameters aFormat optional parameter that defines the form of date output The valid values are SHORT MEDIUM LONG FULL Return string representation of current date String getDateTime String aDateFormat String aTimeFormat Obtains string representation of current date and time according to optional format Parameters aDateFormat optional parameter that defines the form of date output The valid values are SHORT MEDIUM LONG FULL alTimeFormat optional parameter that defines the form of time output The valid values are SHORT MEDIUM LONG FULL Return string representation of current date String E Functions Functions from this group provide different string manipulation routines String toUpper String aString Converts passed string to upper case Productivity User Manual 44 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools Parameters aString string need to be converted Return string converted to upper case String toLower String aString Converts passed string to lower case Parameters aString string need to be converted Return string converted to lower case String toggleCase String aString Converts passed string so each character of it became toggled from lower
109. ne row in the list and it s properties are shown in the appropriate columns All those properties cane be edited right in the list using in place editing approach Auto Import Policy entry properties are e Name specifies short name of the class Predefined entry with name allows specifying default behavior for all names not stated in the list e Import specifies action to be done Possible actions are o Never no class will be imported o Any first suitable class will be imported o Particular class with exactly specified name will be imported o Unique unique suitable class will be imported e Full Class Name specifies full class name to import This property can be applied to Particular action only The Add and Remove buttons allow adding new and removing existing entries Note predefined entry can t be removed Frequently Used Classes This option panel allows maintaining the list of frequently used classes Such list is used to determine particular class to import or prompt in case of existence of several different candidates Productivity User Manual 96 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options Frequently Used Classes com Borland primetime node Mode com borland primetime wta Url java awt Component java util Date java util Enumeration javax swing text Element lavax swing text Position Figure 98 Frequently Used Classes Eac
110. ng editing 115 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Options Edit Template Definition forlc Expression MIC detLocalariableblamelqgetField Yaluel rarType Figure 128 Edit Template Definition Dialog Fields Page Fields The Fields table shows the list of fields defined in the template and it allows selection of particular field to maintain In this table each field occupies one row and each table column represents particular fields attribute The Name and Expression columns show the name and calculate expression for the field The In Use column shows whether this field is used somewhere in the template code New The New button allows creation of a new field Edit The Edit button allows maintenance of currently selected field Copy The Copy button allows creation of a new field using currently selected field as a prototype ivi I Productivity User Manual 116 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Options Remove The Remove button allows removal of currently selected field Shortcuts Page The Shortcuts page allows assigning keyboard shortcuts to the template for the each key maps installed in the J Builder Edit Template Definition forlc Shortcuts Keymap Keystroke Brief C A Emaos SS lt S sSs sSSSSSOSOSOSC S Macintash Macintosh Codewarrior o Macintosh Safe S O visus OO o O
111. ng this option Productivity Insights Usage Use Class Insight _ Show Class Insight and Smart Instantiate popup as list Use Browse Insight Figure 106 Productivity Insights Usage options Use Class Insight If this checkbox is not selected the original J Builder tools will be invoked instead of Productivity Class nsight by pressing the appropriate shortcut Show Class Insight and Smart nstantiate popup as list If this checkbox is selected the popup window used by Class Insight and Smart Instantiate will not include the Navigation Pane and will be similar to J Builder built in Member Insight Use Browse Insight If this checkbox is not selected the original J Builder tool will be invoked instead of Productivity Browse nsight by pressing the appropriate shortcut Productivity User Manual 103 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options Invoke During debugging J Builder provides ability to inspect the symbol under cursor using the Ae appropriate popup window Since both JBuilder and Productivity Hyperlink Navigate BUE OIM windows are invoked by placing mouse over the symbol with the CTRL key pressed down in some cases these windows may overlap Anvoke popups during debugging fer Hyperlink Help et Hyperlink Navigate Figure 107 Invoke popups during debugging options To eliminate this you may disable Hyperlink Help and Hyperlink Navigate
112. no matching templates though To find matches type a word in the Template edit box and Smart Templates Insight will dynamically rearrange the list of templates to show the matching ones You can also leave the Template edit box blank to view all templates You can select a template navigating through the list with the help of the usual keyboard An alternative way to do it is to continue typing the word the list selection will be changed to produce the closest match possible Productivity User Manual 47 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools public void processList List alistTolterate Java Cade remit Fd KO Integer const declaration Insert if statement Expand JBuilder Built in Templates Insert if felse statement Insert if var null statement Insert if var nulli else statement Throw IllegalArqumentException Throw IllegalStateException 1f instanceof Public interface definition Irmoke code later Figure 33 Smart Templates I nsight Popup Window Press the Enter key when you select the template and Smart Templates Insight will expand selected one On the Fly Smart Templates The main idea of such templates is ability to quickly generate and use template definition based on the block of text All the repetitive tokens from the block those are not predefined ones will be replaced by the template fields definitions This approach allo
113. nt behavior using the Editor Options Productivity Assistant property page Assistant Pro The Assistant tool provides visual feedback in the editor about any code issue by highlighting corresponding symbols using styled and colored line By default errors warnings and To Do s are highlighted using red green and gray wavy line respectively Each issue has description associated with it and description text for every issue can be shown in the hint window that appears if mouse cursor is placed under the code issue Assistant provides special Insight window which can automatically pop up in the location of code issue nearest to the caret position and shows information about the particular issue or list of possible actions to complete resolve it There are two kinds of Assistants Info Assistant and Code Assistant The Info Assistant shows description for the issue if there are no actions that may be performed to resolve the issue It is useful as it can provide more convenient feedback about the code issue than Structure View as it always visible and placed near caret and probably near the point of the user view Productivity User Manual 30 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools f Uverridden so We can exit when window is closed protected void processiWindowEvent WindowEvent ej f super processWlindowEventlel if fe getID WindowEvent WINDOW CLOSING Sy
114. o allow running any Productivity Tools You can reject the Productivity License Agreement and can accept it later using the Help About Productivity Dialog Productivity User Manual Copyright 2000 2004 jProductivity L L C http www jproductivity com 9 Uninstalling Productivity To uninstall Productivity please close J Builder and remove copied jars and the key file Productivity User Manual 10 Copyright 2000 2004 Productivity L L C http www jproductivity com Compatibility Compatibility Productivity 2 0 supports J Builder version X only while Productivity 1 x supports any J Builder version from 4 up to 9 It doesn t impose big limitations related to J Builder edition or host platform Please note to run Productivity Pro 1 X under JBuilder4 the xerces jar should be installed in the system and path to it should be stated in the classpath Productivity Pro edition is known to be not compatible or providing functionality that overlaps with the following J Builder Open Tools Syntax Checker by Steven Lee Extended Highlighting by Volker Malzahn Selection Margin 2 01 by Karl Tauber Number Line by Gillmer Derge Highlight Matching Parenthesis Brace or Bracket by Gillmer Derge Java Node Icon Tip by Keith Wood Refactorlt by Agris Software AS Text Drag Drop by Karl Tauber ChangeReadOnly by Luke Hutterman Tag Read Only by Fabrizio Giustina Structure Synchronizer by
115. of having such attributes and are able to correctly show only description of To Do comment Productivity User Manual 33 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Power Tools b r todo Remove debug output i s0 Andrew SazonoreP 39 rows Exception this getContentfane l Figure 26 Advanced To Do and Assistant Any custom attributes can be directly added or changed manually in the source code according to the supported syntax The most convenient way of working with To Do s is using Task List The Task List allows navigation to a selected To Do changing of any To Do s attributes certainly excluding file URL and removing the To Do from the source file The To Do Assistant allows execution of the most helpful actions for the To Do at the caret position Those actions include Complete Edit and Remove the current To Do task Options Dependency You can control the behavior of Assistants using the Editor Options Productivity Assistant property page Task List Pro The Task List tool allows viewing and managing the list of tasks Task List is embedded into J Builder Message Pane To show or hide Task List please use View Task List menu item or appropriate menu item in editor context menu AA MORA gl Productivity joo Description URL Owner Start Date la Overdue Tasks E Code Issues TA Tasks O E To Do s O a dev ep doceditor O da edi
116. options 1 Scope 2 Template 3 Code 4 Quick Expand Key Scope The Scope combobox allows selection of template list to maintain scope JBuilder Home T Figure 122 Templates List Scope options The following scopes are currently supported e User Home specifies the template list that belongs to the currently logged in user All the templates belonging to this scope are stored in the files lt Group gt templates located in the lt User Home gt jbuilder lt N gt folder e JBuilder Home specifies the template list that is J Builder wide so it is available for all users those use this installation of J Builder All the templates belonging to this scope are stored in the files lt Group gt templates located in the lt j Builder Install Folder gt Productivity folder All the templates from all available scopes are merged allowing transparent usage of templates defined in any scope Templates defined in the User Home scope have priority over ones defined in J Builder Home one Templates The Templates table shows the list of templates available in currently selected scope ee Productivity User Manual 110 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options and it allows selection of particular template to maintain Template Mame Description Active Shortcut do Insert dosyhile statement for Generic for statement tora Array traversal torb Bean traversal forl List
117. ow Productivity User Manual 15 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Tools Common Insights Features Most of Productivity Insights share the following approaches Context Switching During invocation any context dependent Insight analyses context structure and selects the target for modification the deepest class or method found for the cursor position The Context label shows the full qualified name of this class or method If there are several classes or methods found in the context path you can choose a different class as a target Use Switch Context up to and Switch Context down to buttons or keyboard Shortcuts Alt Up or Alt Down respectively to select a class or methods as the target the Context label will reflect the changes This functionality is useful when cursor is placed within an inner class while you need to execute appropriate actions to the outer one Help Support To view help press the appropriate key mapped to the help action in the current keymap typically this is F1 If an Insight shows the list of members and there is a member either class method or field selected in the list the Help Viewer will show the appropriate documentation page for this member if any If the members list is empty or there is no member selected the help on the Insight will be shown You can use the Help button in the Navigation Pane to invoke help on the Insight directly
118. perty page There you can also customize other Class Insight options such as Search Options Sort Classes By Autocomplete and Productivity Insights Usage Implement Insight Implement Insight allows quick finding of Java classes with short names matching the word at the cursor position and using them either as a super interface or super class for the class at the cursor position class Untitledl public hee males welcome Lndtiect aaa InterFace 7 Y Runnable Fal java lang Figure 2 I mplement I nsight Popup Window When editing a file place the cursor within the bounds of the class you want to add a Super interface or set a super class to and press Ctri Alt I CUA to invoke Implement Insight The I mplement nsight popup will be shown with the list of classes matching the word at the cursor position The list may be empty if there are no matching classes though To find matches type the word in the Implement Interface edit box and Implement nsight will dynamically rearrange the classes list to show the matching ones You can select a class navigating through the list with the help of the usual keyboard An Alternative way to do it is to continue typing the word the list selection will be changed to produce the closest match possible Press the Enter key when you find the required class and Implement Insight will add this class to the list of super interfaces or set it as the super class for the target one
119. ple steps e Override methods and constructors in a couple of clicks e Add access methods for you fields instantly e Use your own unique naming standards Productivity User Manual Copyright 2000 2004 jProductivity L L C http www jproductivity com 7 e And finally forget that you are using Productivity just enjoy your favorite DE interesting work and your superior performance Use Productivity to add unleashed power to your JBuilder environment Productivity User Manual Copyright 2000 2004 Productivity L L C http www jproductivity com Installation instructions Installation instructions NOTE Productivity To install Productivity you should unpack the archive you ve downloaded and copy productivity jar productivityPro jar for Professional Edition to the lib ext directory under your J Builder installation If you already have Productivity installed in your system and you are going to install Productivity Pro please remove it since all functionality of Productivity is included to Productivity Pro Also you should remove previous versions of Productivity Productivity Pro if any Key Installation Productivity requires a key file which enables the Productivity functionality In standard edition this file is named productivity key while in Professional Edition file name is productivityPro key How to Obtain Key File In some cases the evaluation key file can be found in the do
120. plement Insight list depends on Packages Exclusion settings on the Project Properties Productivity General property page Also there you can customize Code Generation Options which allow you to adjust the code style for the generated methods code Import statements will be generated basing on Imports Generation settings on the Editor Options Productivity General property page There you can also customize other mplement Insight options such as Search Options and Sort Classes By Override Insight and Constructor Insight Override Insight allows quick finding of methods and constructors to override with names matching a word at the cursor position or a typed word and overriding them in the class at the cursor position Productivity User Manual 20 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools class Untitledl implements EeyListener maes dekone Unbtect E essed KeyEvent Figure 4 Override l nsight Popup Window When editing a file place the cursor within the bounds of the class you want to override methods for and press Ctrl M CUA to invoke Override Insight The Override I nsight popup will be shown with the list of methods those match the word at the cursor position The list may be empty if there are no matching methods though To find matches type a word in the Override Methods edit box and Override Insight will dynamically rearrange the methods lis
121. poses 4 Several different Insights may be shown simultaneously 5 Smart Instantiate always allows instantiation of classes that have constructors with the package access only without checking the actual package 6 Working with Inner Classes e Override Insight and GetSet Creator are unable to place caret at the methods generated for anonymous inner classes or for inner classes defined in the methods The caret position in this case will be unchanged e Override Insight and GetSet Creator are unable to resolve the inner classes stated as super classes or super interfaces for any other inner class Thus it is not possible to override methods or to generate access methods for the fields defined in such inner classes 7 Help Insight e Shortcuts to non local HTML pages may not work for external browsers under Microsoft Windows 2000 e JjTextPane used in Help Insight may hang J Builder when displaying huge HTML pages and or jumping to non existing anchors e Help Insight may find classes members if the documentation was generated in compliance with standard JavaDoc doclet only e Help Insight may show improper documentation page for java io package 8 External browser invocation works under Win32 platform only oe Productivity User Manual 131 Copyright 2000 2004 jProductivity L L C http www jproductivity com Known Issues and Limitations 9 Resizing of the Insight popups may not work properly in some cases
122. ptions for all new projects choose Project Default Project Properties This property page allows customizing the code generated with Productivity tools and adjust it to your personal coding style This option allows customizing names of parameters used in methods generated by Productivity tools Any parameter name has a customizable prefix and suffix With the appropriate checkbox enabled you ll be able to specify the respective part of a parameter name in the edit box In other words you can specify the value to be used when naming parameters fethods Prameters Maming Use prefix la Use suttix Parameter Figure 85 Methods Parameters Naming Options Productivity tools generate names of parameters if their actual names are unknown when source code of a class is unavailable By default it utilizes usual Java convention for parameters naming but you can force it to use prefixes and or suffixes according to your own requirements Naming This option allows customizing names of fields according to the coding style you prefer Fields Maminad Use prefix k Use suffix 89 Copyright 2000 2004 jProductivity L L C http www jproductivity com Generate Throwing General Productivity User Manual Productivity Options Figure 86 Fields Naming Options You can customize a prefix and suffix of a field name With appropriate checkbox enabled you ll be able to specify the respective pa
123. r Pro NOTE Productivity User Manual Introduce Constructor is a tool that allows easy generation of constructors those are intended to initialize selected class fields It can be invoked using Alt Shift C CUA Shortcut The Introduce Constructor popup will be shown with the list of fields matching a word at the cursor position The list may be empty if there are no matching fields though To find matches type a word in the Fields edit box and I ntroduce Constructor will dynamically rearrange the list of fields to show the matching ones The Fields edit box can be blank that allows viewing all fields JMenultem jMenuHelpibout new JMenultenfi cam borland samples welcome MWetconecane piatou aD choose Fields fren Lo K 91 public syno ikspi EEn JMeruE ar y 2 jMenuFile oul To jMenuFileExit aan Tp jMenuHelp TMenu public We id Y jMenuHe lpAhout JMenul ten enableEvents ANTEvent WINDOW EVENT MASE Figure 10 I ntroduce Constructor Popup Window JMenultem JMenuHelp bout new JMenultem com dorang NN watone Wetonactane Jiialog abi 3 DY Choose Feds meme JW X public sync JMenubar l JMenubar li jMenuFile jMenuFileExit JMenuirl mena 3MenuHel j p public Welg e jMenuie panog enableEvents AWTEvent WINDOW EVENT MASE gt Figure 11 Selection of Fields Should be I nitialized One or more fields can be selected using the fields list The order of fields selection exac
124. r dialogs the Project Properties and Editor Options dialogs The Project Properties dialog contains the following property pages added by Productivity e General where you can specify options for Imports Beautify and Packages Exclusion e Code Style where you can specify options for Code Generation e JavaDoc where you can specify options for JavaDoc generation e Cache where you can specify options for managing Productivity classes cache e Assistant where you can specify options for managing Assistant behavior e Tools where you can specify options for various Productivity tools The Editor Options dialog includes the following property pages added by Productivity e General where you can specify options for Import Statements Generation Search Options Sorting options Autocomplete Insight Usage and Invocation Insights during debugging e Usage where you can specify how to use or not use the appropriate tools e Delays where you can specify options for Hyperlink Help and Hyperlink Navigate Invocation and closing delays Help Insight delay used for integration with J Builder Member Insight and Context Discovering timeout e Smart Templates where you can customize the Smart Templates behavior and maintain the templates list e Assistant where you can customize the Assistant behavior e Tools where you can customize miscellaneous tools behavior e Smart JavaDoc where you can customize the Smart avaDoc behavior In addi
125. re 60 Smart Braces Highlight with hint window The major features of Smart Braces Highlight are e Ability to find and highlight matching brace when the caret is placed at any side of a brace e Ability to navigate to the matching brace using only one shortcut Ctri Backslash CUA for opening and closing ones e Ability to view matching brace code when it s has been scrolled out of view The Special popup window shows the open brace code in the top and close brace code in the bottom of the editor correspondingly Please note that the close brace code can be shown for try catch final and do while statements only e Ability to show matching braces scope on the Gutter Options Dependency The Smart Braces Highlight behavior can be controlled using the Editor Options Productivity Tools property page Changes Highlight Pro The Changes Highlight tool highlights changed lines of code using the special marks in the gutter The main features are e Change marks can track amount of changes in the particular line of code and reflect the number of them using different colors Thus more times line was edited more bright color will be used to highlight changes e Full support of undo redo functionality as well as re reading of document e Full support of MVC architecture that allow tracking and showing changes in the document across different views and browsers resul tl CUErent break if jallassName startsWithicurrent getN
126. ring to find Return trimmed string value String getConstPrefix String aName Obtains the prefix from the passed literal name Parameters aName name of literal Return obtained prefix or passed literal name if prefix can t be obtained ie bag and Functions included into this group provide access to some properties of the active Dependant Project and to information about context available for the caret position of the editor Functions String getProjectProperty String aName Obtains the value of property of active project Parameters aName name of project property to get Return value of project property null if property with such name is not found Productivity User Manual 46 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools String getFullClassName Obtains the name of Java class at caret position Return full qualified name of class String getClassName Obtains the short name of Java class at caret position Return short name of class String getPackageName Obtains the package name of Java class at caret position Return package name Smart Templates Insight This tool allows choosing a template to expand When editing a file press Ctrl J CUA to invoke Smart Templates Insight The Smart Templates I nsight popup will be shown with the list of template matching a word at the cursor position The list may be empty if there are
127. rl Alt Ctrl Alt Insert Insert Insert Insert Selection Expand Smart Clipboard Swap Ctrl Shift Ctrl Shift Ctrl Shift Ctrl Shift Insert Insert Insert Insert Smart Templates Expand Ctrl Ctrl Ctrl Ctrl Productivity User Manual 127 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Tools Icons Smart Templates ExpandLast Ctrl Shift J Ctrl Shift Ctrl Shift Ctrl Shift J Smart Templates ExpandOnThe Alt Shift Alt Shift Alt Shift Alt Shift Fly Highlight Local References CtrI Alt Ente Ctri Alt Ent Ctri Alt Enter CtrI Alt E r er nter Productivity User Manual 128 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Tools Icons Productivity Tools Icons The following table shows icons used by tools included into Productivity Table 10 Productivity Tools Icons a Cra o Easy JavaDoc provides easy generation of JavaDoc for selected members Easy JavaDoc nsight provides easy generation of JavaDoc for selected members Get Creator easy creation of getters GetSet Creator easy creation of getters and setters for selected fields Set Creator easy creation of setter methods EN Implement Insight used for fast interface implementing Smart Instantiate allows you to instantiate a class variable or even implement an anonymous class in seconds Constructor Insight allows you to quickly create constructors Override Insight
128. rojects the amount of such classes may achieve several thousands The Productivity popup windows allow reducing the excessive amount of classes by eliminating those not used Such as sun and sunw which are included into JDK but hardly used in your project directly with the help of this option you can exclude unnecessary packages Packages Exclusion _ Enable packages exclusion Exclude packages Figure 84 Package Exclusion Options Enable packages exclusion Select this checkbox if you wish to exclude classes belonging to particular packages from showing them in the Productivity insights With this checkbox disabled all classes from Productivity cache are shown 88 Copyright 2000 2004 jProductivity L L C http www jproductivity com Methods Parameters Naming Fields Productivity User Manual Productivity Options Exclude packages Using this panel you can specify packages to be excluded Either type the package name to exclude it manually only valid Java symbols are allowed separates packages or add the package using the Select Package dialog invoked by the Add button The sequence order of packages being specified is inessential Code Style Page The Options page of the Productivity Project Properties allows user to specify the following options 1 Methods Parameters Naming 2 Fields Naming 3 Generate Throwing java lang UnsupportedOperation Exception 4 General Options To set these o
129. rt of a field name in the edit box The current version of Productivity uses this option in GetSet Creator Depending on values specified GetSet Creator can define the appropriate name of the get set method by removing a prefix and suffix and the appropriate parameter names Using these radiobuttons you can exactly specify the rules of code generating in the method body If you enable Generate always radiobutton Productivity always generates method body with TODO comment and the code that throws java lang UnsupportedOperation exception Generate throwing of java lang UnsupportedOperation exception Generate always C Generate only when needed Figure 87 Generate throwing of UnsupportedOperationException Options If you enable Generate only when needed radiobutton Productivity generates the code that throws exception only for the method with non void return type These options provide more opportunities for you to fine tune the code generated by Productivity General _ Generate method body near current cursor position Generate JavaDoc during methods generation Figure 88 General Code Style Options Generate method body near the current cursor position This option allows you to specify the anchor position where the generated code will be inserted If the appropriate checkbox is selected the whole code will be generated in the position close to cursor if the cursor is within a method the code will be generat
130. s The following options are available for management of import statement modifications Import particular class If this option is turned on the import statement for the required class will be inserted however imports consolidation will not be applied 100 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Options Import all classes from package If this option is turned on all classes from all the packages will be imported and particular imports from the same package will be removed This option is useful when a large amount of classes from the same package are used Import particular class and consolidate packages If this option is turned on a particular class will be imported if the number of imports from the same package does not exceed the maximum allowed The maximum amount of classes to be imported without import statements consolidation is controlled by the Import maximum N classes from the same package field If the number of imports from the same packages exceeds the specified limit all the imports of a particular class from the required package will be removed and import statement for the whole package will be inserted instead as These options allow you to tune the algorithm used for search of items within the Productivity popup lists Search optians e Use startsith method _ Case sensitive _ Stop on exact match Show additional 200 classes Fi
131. s are available for classes sorting control Class name then by package name If you select this option the classes will be sorted according to the class name and then class package Full qualified class name If you select this option the classes will be sorted according to their full qualified names Productivity allows automatic execution of the Insight primary action when there is only one possible variant found In this case the action will be performed without the Insight popup window being shown Autocomplete Use autocomplete Figure 105 Autocomplete options Use autocomplete If this checkbox is enabled the autocomplete option will be turned on and Productivity will automatically complete the actions if possible 102 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Insights Usage Productivity Options Usage Page The General page of the Productivity Editor Options page provides the following options 1 Productivity Insights usage 2 Invoke insights during debugging 3 Help Insight 4 Highlight Navigate popup hiding mode 5 Superclass Changing Policy Two tools included into Productivity Class Insight and Browse nsight use the same default shortcuts Ctrl Alt Space and Ctrl Minus respectively CUA as J Builder built in tools If you want to continue using the J Builder built in tools you may disable the Productivity insights startup usi
132. s option turned off Smart nstantiate popup will be shown with the Navigation Pane that allow to use Smart nstantiate even if there is no word at the cursor position or if there are no classes matching it To find matches type a word in the Instantiate Class edit box and Smart nstantiate will dynamically rearrange the classes list to show the matching ones Options Dependency Please note that the set of classes shown in the Smart Instantiate list depends on Packages Exclusion settings on the Project Properties Productivity General property page Import statements are generated basing on Imports Generation settings on the Editor Options Productivity General property page There you can also customize other options of Smart nstantiate such as Search Options Sort Classes By Autocomplete and Productivity Insights Usage Using the Project Properties Productivity General property page you can customize Code Generation Options which allow you to adjust the code style for the generated methods code GetSet Creator GetSet Creator is a tool that allows easy creation of accessors and or mutators for selected fields of a class When editing a file press Alt Shift A CUA to invoke GetSet Creator Insight The GetSet Creator popup will be shown with the list of fields matching a word at the cursor position The list may be empty if there are no matching fields though To find matches type a word in the Fields edit box and
133. s visible Productivity User Manual 67 Copyright 2000 2004 Productivity L L C http www jproductivity com Smart Braces NOTE Productivity Editor Enhancements e Ability to invoke Browse Members popup using mouse double click on the method name label if one is visible e Ability to customize set of labels should be visible within Advanced Text View Status using popup menu which can be invoked using right mouse click on any status label Smart Braces is a tool that allows easy creation of matching braces right while you are typing Just type an opening brace and Smart Braces will automatically add the closing one In addition to braces completion Smart Braces supports completion of string and character enclosing symbols and respectively Smart Braces adds closing characters after the opening ones for all characters except curly braces the closing curly brace is inserted into the next line and may require an additional line for the cursor with the appropriate indent to be placed according to the Complete curly brace and indent option Options Dependency You can control the behavior of Smart Braces using the Editor Options Editor Editor Options tree view expand the Smart Braces options node and turn on or off options you need With a non standard J Builder keymap used such as Vi VIM Smart Braces may conflict with keymap settings Apparently for the VI keymap and symbols may be overridden by S
134. s you to specify whether cache will be refreshed automatically The most frequently changed classes from all the classes used by the project are those included into the project itself in other words the classes developed by you within a project Whereas changing JDK and adding or removing libraries are very rare operations new classes within a project appear change their location or become renamed every day Auto refresh options e Refresh project classes after project rebuid finishing e Refresh project classes after project make finishing Figure 93 Cache Auto Refresh Options The Auto refresh options are designed to make the cache content as up to date as possible offering convenient usage of such Productivity tools as Class Insight and Productivity User Manual 93 Copyright 2000 2004 Productivity L L C http www jproductivity com Refresh groups Productivity User Manual Productivity Options Browse lnsight with your classes and also to reduce the necessity of manual refresh of Productivity classes cache This option enables your class cache to be refreshed after every successful project build or make Refresh of classes included in the project is normally a short operation that requires much less time compared to project build so we recommend that these options be always enabled Please note that the class cache refresh will be performed only under the condition that the whole project build or mak
135. stem exit l Oi illegal start of expression CI Figure 19 I nfo Assistant The Code Assistant shows description for the issue along with the list of actions those can help to resolve it Code Assistant provides most convenient way to resolve issues as it allows fixing of issue without having to leave current cursor position It allows fixing of the issue manually or by invoking of appropriate tool As soon as issue is resolved it restores original caret position The user is able to fix the issue quickly using prompted shortcut or just using mouse There is also ability to popup and focus Code Assistant using Alt Enter CUA keystroke and use usual keys to navigate through the fix actions and the Enter key to choose invoke required one Mrerridden so we can exit when window is closed protected void processtlindovEvent WindowEvent e super processlindomEvent e if fe getID WindowE vex JENTE i Svatem exit D0 J y expected a Add missing Shift Enter Figure 20 Code Assistant Another way to fix issue is using context popup menu and this way is useful when Code Assistant is disabled zo ee UE ee pi a b java awt List Font Mit 4 Select All ERES OSOS EES ESNS S KANAE AAR A EEE ANN A EAA Figure 21 Code Assistant I ntegrated I nto Context Menu Assistant can be configured to automatically fix certain types of errors without prompting to the user The following errors currently can be automatical
136. sy JavaDoc if JavaDoc comment already exists for a method or class Based on your selection Easy avaDoc can overwrite old comments skip generation or ask your confirmation on comments rewriting Note that these options may affect the members list content in Easy JavaDoc Insight popup if the option to skip members with existing JavaDoc is specified all such members will be excluded from the members list Power Tools Productivity includes set of advanced tools those make Productivity really unique As all other Productivity tools these ones are intended to dramatically increase productivity of Java developer These tools include e Rename Assistant unique tool that simplifies identifiers renaming by Introducing in place rename approach e Assistants rich set of code and information assistants those provide quick information about code issues and if possible set of choices those allow problem resolving e Task List the tool that allows viewing and managing list containing tasks code issues and to dos e Smart Templates the advanced code templates engine with ability to live update of related fields while typing e Smart JavaDoc the tool that allows JavaDoc authoring in mode is very close to WYSIWYG one It is available as an additional viewer for Java file node Rename Assistant Pro Rename Assistant is a tool intended to simplify identifiers renaming It introduces in place editing approach and let
137. t to show the matching ones You can also leave the Override Methods edit box blank to view all the methods to override Override Insight highlights the methods with names exactly matching the typed word with bold font and the abstract methods with italic font In addition to the methods inherited from the super class Override nsight shows the methods defined in the interfaces but not implemented directly by the target class You can select a method either one or any navigating through the list with the help of the usual keyboard An Alternative way to do it is to continue typing the word the list selection will be changed to produce the closest match possible Press the Enter key when you select the required methods and Override Insight will override them and add calls to the appropriate methods of the super class if needed You can call Override nsight with constructors only using the shortcut Ctrl Shift M CUA Also there is a possibility of invoking the built in Override Methods Wizard You can use the appropriate button in the left top corner of the popup to invoke it Code Changes Synchronization Override Insight analyses changes in all dependant source files and correctly reflects them in the methods list But in most cases you need to compile all dependant classes before invocating Override Insight If the required class is not compiled yet or the required methods are not found in the compiled class these errors will be show
138. the delay specified on the Delays page Productivity User Manual 104 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Options S Cl Chang This option allows you to specify how the Productivity Implement Insight tool will Policy handle the situation when an extra super class is assigned to a class superclass Changing Policy o Never change 0 Always change Show prompt Figure 110 Superclass Changing Policy options In such case Implement Insight will perform the following actions depending on the currently selected value Never change Implement Insight will not change the super class and will not implement methods from the proposed super class Always change Implement Insight will change the super class to the selected one and will override all abstract methods Show prompt Implement Insight will show a prompt dialog allowing you to specify what should be done Delays Page The Delays page of the Productivity Editor Options page provides the following options 1 Hyperlink Help Delays 2 Hyperlink Navigate Delays 3 Help Insight Delay 4 Context Discovering Timeout Hyperlinks With these options you may specify the delays used for invocation and closing of popup Delays windows displayed by the Hyperlink Help and Hyperlink Navigate tools woerlink Help Invocation delay Closing delay 275 seo EY Hyperlink Navigation Invocation delay Closing delay 252 sec C
139. the user to enter a new name and then choose whether hi she likes to refactor simply rename or skip changes of identifier name To see Rename Assistant in action just place the caret to an identifier you wish to rename and start renaming it simply by typing new name Rename Assistant pops up right in the place of your identifier you can recognize it by the lines shown on the top and bottom of identifier being renamed and Rename Assistant icon placed on gutter When new name is entered it s possible to Productivity User Manual 29 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools e Press the Enter key to rename identifier using refactoring procedures e Press the Ctrl Enter key to simply rename identifier e Press the Esc key or mouse click outside Rename Assistant to skip any changes import java awt import javax swing ULWanager import com sun tools Javac vO tree Tree public class NewWelcomeapp boolean packFrame false i E Y Construct the application Figure 18 Rename Assistant It s possible to tune Rename Assistant behavior using the Editor Preferences Productivity Assistant property page There is ability to quickly turn assistant on off using the Enable Rename Assistant button on the view toolbar Please note that Rename Assistant works only if there are no syntax errors in the source code Options Dependency You can control Rename Assista
140. tion with the help of Editor Options Dialog you are able to customize options for the Smart Braces tool These options can be found on the Editor property page in the Editor Options tree view Also the IDE Options dialog includes a property page added by Productivity which allows user to select the Metal theme to be used by J Builder Productivity User Manual Copyright 2000 2004 jProductivity L L C http www jproductivity com 87 Productivity Options Project Properties Dialog Packages Exclusion Productivity User Manual The Project Properties dialog contains the following property pages added by Productivity e General where you can specify options for Imports Beautify and Packages Exclusion e Code Style where you can specify options for Code Generation e JavaDoc where you can specify options for JavaDoc generation e Cache where you can specify options for managing Productivity classes cache General Page The Options page of the Productivity Project Properties pages allows to specify the following options 1 Packages Exclusion To set these options for all new projects choose Project Default Project Properties Productivity uses cache of classes included into particular project By default this cache includes all classes found according to JBuilder paths settings In general this includes classes from J DK classes in project libraries and project classes themselves It is obvious that in large p
141. tly defines the definition order of constructor parameters and in turn the order of fields initialization 25 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Power Tools As soon as fields to initialize are selected pressing the Enter key closes Introduce Constructor popup and introduces constructor that initializes all selected fields public WelcomeFrame TMenuBar JMenubarl JMenu JMenuFile JMenultem jMenuFileExit this jMenuBarl JMenubarl this jMenuFile jMenuFile this MenuFileExit 7JMenuFileExit Figure 12 Code Generated by I ntroduce Constructor Please note that if constructor with the same signature is already exists Introduce Constructor popup will not be closed and appropriate error message will be displayed in the Status Bar Options Dependency The Project Properties Productivity Code Style property page allows customizing code style and placement for the generated constructors Settings for Java Doc comments those can be optionally generated during constructors introducing can be customized using the Project Properties Productivity Java Doc property page Delegate Insight Pro The Delegate Insight tool provides an easy way to generate methods those actual implementations are delegated to another object delegate To invoke Delegate nsight please use Alt Shift M CUA shortcut After invocation the Delegate nsight popup is shown w
142. to navigate is using Navigator Insight which can be invoked using the AIt Shift N CUA Shortcut Warning or Error Low Priority Issue Any Issue Editing Point Method Class search Result Figure 78 Navigator nsight Productivity User Manual 82 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Information Tools Information Tools Help Insight Productivity includes several advanced tools those allows you instantly get information about required Java source code element With Productivity Information tools you can e Easily view help topic if one exist for the identifier in the caret position Help Insight and Hyperlink Help e Get instant help selected item in J Builder Code Insight Help nsight e Get full information about context of source code in the current caret position Context nsight Help Insight is a tool allowing you to easily view help topics if any for an identifier or a member within the current context in the cursor position Help is shown in a convenient popup window Help Insight extracts and displays information relating to a particular code only for example for a particular method not for all classes framesize Crame getsizeli a Y Be UiManager geioysiemlookd nd eela ssAamet public static String getSystemLook ndFeelClassHamet Returns the name of the LookAndFeel class that implements the native systems look and feel if th
143. tor b state for line numbers file MES Loc SHOULD THIS CALL BE CALLED file MES Loc SHOULD WE PROCESS THIS file MMESS Loc check if we need to visit node with another typ file AVE Loc hows it can be possible that node is not visited a file MESs Loc atole all pres eerie eth Andrew Sazonow 5 20 02 5 39 Check classes and method for not allowed modi Andrew Sazonov 52002 5 39 320 Check GutterEx repainting on the end of file Andrew Sazonov 522102 1 28 Check that LineMumber expires az S00n az ers Andrew Sazonov S232 4 37 Add expiration for Advanced Javastructure and Andrew Sazonov 5 23 02 4 38 A Andrew Sazonov 527102 1 40 OOOO E E E 1 m El are otal Task Count 333 Productivity User Manual 34 Copyright 2000 2004 jProductivity L L C http www jproductivity com Productivity Power Tools Figure 27 Task List Panel Introduction to Tasks Concept Each task is an entity that represents some work to be done The following attributes are belong to each task e Priority can be one of the following Low Medium High Highest e Completion Status specifies whether the task is completed or not e Description specifies the description of the task e Owner specifies the user name which owns the task e Start Date specifies the date the task was should be started e Due Date specifies the date when the task should be don
144. ts between Java code definition and corresponding JavaDoc exist If some error or conflict is detected Smart JavaDoc highlights appropriate element using the underline with style and color corresponding to the issue priority The reason Productivity User Manual 59 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools of the highlighted issue can be found in the hint that appears when mouse cursor is placed over the highlighted element public void columRemoved TableColumnModeleyvent el Invoked when a column is removed from th ia o Missing definition of parameter e Application code will notuse these method JTable See Also TabletcolumnilodelListener Figure 51 JavaDoc Comments Errors Detection The style of the issue highlight is defined by settings can be found on the Editor Options Productivity Smart JavaDoc property page You can easily fix found errors utilizing appropriate commands available from the popup menu or from toolbar Using them you can add remove or edit required JavaDoc tags There are a lot of actions provided by Smart JavaDoc those are accessible using keyboard shortcuts The following table summarizes these actions along with corresponding shortcuts Table 5 Smart JavaDoc Key Bindings aon Sorte Cut to clipboard Paste from clipboard Insert new paragraph Insert new line in the PRE block Select word left Go to start of line
145. uctivity will automatically recreate it before the next Class Insight use Productivity User Manual Copyright 2000 2004 jProductivity L L C http www jproductivity com 17 Productivity Power Tools Center rex swing TabbeaPane Dimension Dimension Browse Class fra Cd XI if frame Awe tele Ee Javax swing framesii JTable de javax swing if frame y JTableHead framesize width sc frame setLlocation screensize midth framesize width 2 Screensize lavax suing table JTableHeader frame setWisible true Figure 1 Class I nsight Popup Window When editing a file place the cursor over the word you want to expand as a class name or at a blank space and press Ctrl Alt Space Ctri Alt H CUA to invoke Class Insight The Class Insight popup will be shown with the list of classes matching the word at the cursor position You can select a class navigating through the list with the help of the usual keyboard An Alternative way to do it is to continue typing the word the list selection will be changed to produce the closest match possible Class Insight Actions On selecting a class you may choose from several options with the help of the following shortcuts Enter Class Insight replaces the word at the cursor position with a class name and adds the appropriate import statement Ctrl Enter Class nsight replaces the word at the cursor position with a full qualified class name Alt
146. wnloaded archive Otherwise please visit http www productivity com or contact mailto sales jproductivity com to obtain an evaluation or commercial key How to Install Key File The key file should be located in the same directory as used by J Builder for storing its preferences and license The location of this directory depends on the operating system installed on your computer Browse your HOME directory you can find it using the Home button in the J Builder Open File dialog In the home directory you ll find the jbuilderX or jbuilder9 jJbuilder8 builder7 depending on your version of J Builder subdirectory where the key file should be placed Another way to find the location where the Productivity key file should be placed is starting up J Builder with Productivity installed If there is no key file Productivity will inform you of the fact with the appropriate message dialog from this dialog you can conclude about the location of the key file To install the key file just copy the key file productivity key or productivityPro key to the location as specified above Productivity Help Installation To install documentation for Productivity please copy productivity docs jar to the doc directory under your J Builder installation License Agreement Acceptance After the first start of J Builder with Productivity Installed you ll be prompted to accept the Productivity License Agreement It should be accepted t
147. ws using templates those need one or several times only without having to manually manage template definitions Dimension screensize Toolkit getbefaultToolkit 1 get creensizel Dimension framesize frame getizel if framesize height gt screensize height framesize height screensize helght if framesize midth gt screensize width framesize vidth screensize width frame setlocation screensize width framesize width 2 screen Figure 34 Selected Code Fragment will be Copied Productivity User Manual 48 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity Power Tools screensize Toolkit getbefaultToolEiti getScreensizel Dimension framesize frame qetalzel 1f framesize height gt Screensize height framesize height screensize height 1f framesize width gt screensize width Pramesize wWidth screensize width frame setLocation acreensize width framesize width 2 scre Figure 35 The Same Code Fragment Inserted Using On The Fly Templates To invoke On The Fly template based on the clipboard content please use Alt Shift J CUA shortcut Another option to invoke On The Fly template is using Clipboard Insight You just need to select required item from the local clipboard list and press Ctri Enter shortcut to invoke template based on it Options Dependency You can control Smart Templates behavior and manage the template list using
148. xit actionPerformed He VMenuHelpAbout setText about VMenuHelp About addactionListener new ActionListener public void actionPerformed ActionEvent el JMenunelpabout actionPerformed e Class LocalClass i public void ai 4 Vie JMenmuibarl add 3MenuHelp fOverridden so we can exit when window is closed protected void processWindowEvent WindowEvent ej if fe getID WindowEvent WINDOW CLOSING System exitii I File Exit action performed public void jJMenuFileExit actionPerformed ActionEvent e Figure 63 Visual separation of Methods and Classes Productivity User Manual 31 Copyright 2000 2004 Productivity L L C http www jproductivity com Productivity I DE I mprovements IDE Improvements Productivity offers rich set of powerful JBuilder IDE improvements intended to increase J Builder usability These tools covers very common tasks and allows significantly minimize time required for their completion These tools help in solving of the following tasks e Synchronization of currently opened file with appropriate node in the J Builder Project View Project View Synchronizer e Getting more detailed information about Java file structure as well as filtering of Java Structure content Advanced J ava Structure e Synchronization of the current caret position in the editor with Java code with appropriate structure element Java Structure Synchronizer

Download Pdf Manuals

Related Search

Related Contents

  Hewlett Packard Enterprise H241  純正LEDリフレクター 取扱説明書  Vacuum Pack Machine Instruction manual  HP Mini 110-1030NR  Guide de l`utilisateur DOCEE  Midland XTC200VP3 hand-held camcorder  SA 16.2 SAR 07.2 – SAR 16.2 Unidad de mando: electro  Leviton Piccolo Scan  

Copyright © All rights reserved. Failed to retrieve file