setterjbuilder8

Productivity!
2.
0forBorlandJBuilderUserManualjjjPPPrrroooddduuuccctttiiivvviiitttyyyLLLLLLCCChttp://www.
jproductivity.
comProductivity!
–ThenamespeaksforitselfProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com2Copyright(c)2000-2004jProductivityL.
L.
C.
Allrightsreserved.
JBuilderisregisteredtrademarkofBorlandSoftwareCorporation.
JavaandallJava-basedmarksaretrademarksorregisteredtrademarksofSunMicrosystems,IncintheUnitedStatesandothercountries.
Otherbrandandproductnamesaretrademarksorregisteredtrademarksoftheirrespectiveowners.
ContentsPRODUCTIVITY!
OVERVIEW7INSTALLATIONINSTRUCTIONS.
9Productivity!
KeyInstallation.
9HowtoObtainKeyFile9HowtoInstallKeyFile9Productivity!
HelpInstallation.
9LicenseAgreementAcceptance.
9UninstallingProductivity!
10COMPATIBILITY11PRODUCTIVITY!
TOOLS12CommonInsightsFeatures16ContextSwitching16HelpSupport16CodeGenerationTools17Class.
Insight17Class.
InsightActions18ShowingNavigationPane.
18OptionsDependency19Implement.
Insight19CodeChangesSynchronization20OptionsDependency20Override.
InsightandConstructor.
Insight20CodeChangesSynchronization21OptionsDependency22Smart.
Instantiate22ShowingNavigationPane.
23OptionsDependency23GetSet.
Creator23Introduce.
Constructor–Pro!
25OptionsDependency26Delegate.
Insight–Pro!
26OptionsDependency27Easy.
JavaDocandEasy.
JavaDoc.
Insight27Easy.
JavaDoc28Easy.
JavaDoc.
Insight.
28OptionsDependency29PowerTools29RenameAssistant-Pro!
29OptionsDependency30Assistant-Pro!
30OptionsDependency33AdvancedTo-Do's-Pro!
33OptionsDependency34TaskList-Pro!
34IntroductiontoTasks'Concept35TaskListUserInterface35MaintainingTasksUsingTaskList37Reminders38OptionsDependency38Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com3Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com4Smart.
Templates-Pro!
39PredefinedFields.
41Expressions.
42Smart.
Templates.
Insight.
47"OntheFly"SmartTemplates48OptionsDependency49Smart.
JavaDoc-Pro!
50Smart.
JavaDocUserInterface51JavaDocEditingUsingSmart.
JavaDoc53Smart.
JavaDocToolbar.
55JavaDocErrorsHighlighting.
59Smart.
JavaDocShortcuts.
60EditorEnhancements62Smart.
Clipboard-Pro!
62PasteAction62Copy/CutActions62SwapAction62PopPasteAction63Clipboard.
Insight63OptionsDependency63Smart.
Selection-Pro!
63Smart.
Gutter-Pro!
64ThumbnailGutter-Pro!
65ClassesHighlight-Pro!
66AdvancedTextViewStatus-Pro!
67Smart.
Braces68OptionsDependency68Matching.
Code.
Highlight-Pro!
68OptionsDependency69Smart.
Braces.
Highlight-Pro!
69OptionsDependency70Changes.
Highlight-Pro!
70CurrentLineHighlight-Pro!
70ClassesandMethodsSeparator-Pro!
71IDEImprovements72ProjectViewSynchronizer-Pro!
72OptionsDependency73StructureViewSynchronizer-Pro!
73Change.
ReadOnly-Pro!
73NavigationTools.
75Browse.
Insight75Browse.
InsightActions75OptionsDependency76Browse.
Members76Hyperlink.
Navigate.
77OptionsDependency77SearchResultsandReferencesHighlight-Pro!
77PersistentBookmarks-Pro!
78Persistent.
Bookmarks.
Navigate.
79ManageBookmarksDialog80ViewNavigatorandNavigator.
Insight-Pro!
81InformationTools83Help.
Insight83NavigationPane.
83Hyperlink.
Help.
84Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com5IntegrationwithOtherInsights.
84OptionsDependency85Hyperlink.
Help.
85OptionsDependency85Context.
Insight85OptionsDependency86PRODUCTIVITY!
OPTIONS87ProjectPropertiesDialog.
88GeneralPage.
88CodeStylePage.
89JavaDocPage91CachePage93AssistantPage95ToolsPage97EditorOptionsDialog.
98Smart.
BracesOptions(EditorOptions)98GeneralPage.
100UsagePage103DelaysPage105ToolsPage–Pro!
106AssistantPage–Pro!
108Smart.
JavaDocPage–Pro!
109Smart.
TemplatesPage–Pro!
110EditTemplateDialog–Pro!
112GeneralPage.
112OptionsPage114FieldsPage.
115ShortcutsPage117EditTemplateFieldDialog–Pro!
118IDEOptionsDialog.
121PRODUCTIVITY!
KEYBINDINGS123KeyBindingsforCUA,BriefandVisualStudiokeymaps124KeyBindingsforEmacs,MacintoshandMacintoshCodeWarriorkeymaps126PRODUCTIVITY!
TOOLSICONS129KNOWNISSUESANDLIMITATIONS131PRODUCTIVITY!
FEEDBACK133Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com6TablesTable1Productivity!
Tools.
12Table2Productivity!
KeyBindingsforCUA,BriefandVisualStudiokeymaps124Table3Productivity!
KeyKeyBindingsforEmacs,MacintoshandMacintoshCodeWarriorkeymaps126Table4Productivity!
Icons.
129Productivity!
OverviewProductivity!
OverviewProductivity!
isagenuineandrichsetoftoolsintendedtogreatlysimplifyroutinecodingandnavigationoperations.
Asaresult,itallowssignificantlygreaterdevelopmentproductivity.
AllProductivity!
toolsarecarefullydesignedandtunedtominimizeeffortstoinvokeandusethemsoyoucanenjoythefriendlyenvironmentProductivity!
offers.
WithProductivity!
tools:Beawareofanyerrorsinyourcodeandgetassistancetofixthem!
BealwaysonschedulewithhelpofTaskList!
Writebulletproofdocumentationforyourcode!
Easilyreuseyourfavoritecodefragments!
Writewell-composedandeasymaintainablecode!
Forgetabouttypingyourimports!
ForgetaboutannoyingdialogsandWizardswhileyouarecoding!
Discovercontextandnavigatethroughit!
Usehyperlinkstosurfandtogetinformed!
Navigatefreelythroughyourclasses,methods,fieldsandeveneditingpoints!
Obtainquickhelponclassesandmethodsexactlywhereandwhenyouneed!
Addsuperinterfaces,changesuperclassesinseveralsimplesteps!
Overridemethodsandconstructorsinacoupleofclicks!
Addaccessmethodsforyoufieldsinstantly!
Useyourownuniquenamingstandards!
Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com7Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com8Andfinally,forgetthatyouareusingProductivity!
-justenjoyyourfavoriteIDE,interestingworkandyoursuperiorperformance!
UseProductivity!
toaddunleashedpowertoyourJBuilderenvironment!
InstallationinstructionsInstallationinstructionsToinstallProductivity!
youshouldunpackthearchiveyou'vedownloadedandcopyproductivity.
jar(productivityPro.
jarforProfessionalEdition)tothelib/extdirectoryunderyourJBuilderinstallation.
IfyoualreadyhaveProductivity!
installedinyoursystemandyouaregoingtoinstallProductivity!
Pro,pleaseremoveitsinceallfunctionalityofProductivity!
isincludedtoProductivity!
Pro.
Also,youshouldremovepreviousversionsofProductivity!
/Productivity!
Pro(ifany).
Productivity!
KeyInstallationProductivity!
requiresakeyfile,whichenablestheProductivity!
functionality.
Instandardeditionthisfileisnamedproductivity.
key,whileinProfessionalEditionfilenameisproductivityPro.
key.
HowtoObtainKeyFileInsomecases,theevaluationkeyfilecanbefoundinthedownloadedarchive.
Otherwise,pleasevisithttp://www.
jproductivity.
comorcontactmailto:sales@jproductivity.
comtoobtainanevaluationorcommercialkey.
HowtoInstallKeyFileThekeyfileshouldbelocatedinthesamedirectoryasusedbyJBuilderforstoringitspreferencesandlicense.
Thelocationofthisdirectorydependsontheoperatingsysteminstalledonyourcomputer.
BrowseyourHOMEdirectory(youcanfinditusingtheHomebuttonintheJBuilderOpenFiledialog).
Inthehomedirectoryyou'llfindthe.
jbuilderX(or.
jbuilder9,.
jbuilder8,.
jbuilder7)dependingonyourversionofJBuilder)subdirectory,wherethekeyfileshouldbeplaced.
AnotherwaytofindthelocationwheretheProductivity!
keyfileshouldbeplacedisstartingupJBuilderwithProductivity!
installed.
Ifthereisnokeyfile,Productivity!
willinformyouofthefactwiththeappropriatemessagedialog;fromthisdialog,youcanconcludeaboutthelocationofthekeyfile.
Toinstallthekeyfile,justcopythekeyfile(productivity.
keyorproductivityPro.
key)tothelocationasspecifiedabove.
Productivity!
HelpInstallationToinstalldocumentationforProductivity!
pleasecopyproductivity_docs.
jartothedocdirectoryunderyourJBuilderinstallation.
LicenseAgreementAcceptanceNOTE:AfterthefirststartofJBuilderwithProductivity!
Installedyou'llbepromptedtoaccepttheProductivity!
LicenseAgreement.
ItshouldbeacceptedtoallowrunninganyProductivity!
Tools.
YoucanrejecttheProductivity!
LicenseAgreementandcanacceptitlaterusingtheHelp|AboutProductivity!
Dialog.
Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com9Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com10UninstallingProductivity!
TouninstallProductivity!
pleasecloseJBuilderandremovecopiedjarsandthekeyfile.
CompatibilityCompatibilityProductivity!
2.
0supportsJBuilderversionXonlywhileProductivity!
1.
xsupportsanyJBuilderversionfrom4upto9.
Itdoesn'timposebiglimitationsrelatedtoJBuildereditionorhostplatform.
Pleasenote,torunProductivity!
Pro1.
XunderJBuilder4thexerces.
jarshouldbeinstalledinthesystemandpathtoitshouldbestatedintheclasspath.
Productivity!
ProeditionisknowntobenotcompatibleorprovidingfunctionalitythatoverlapswiththefollowingJBuilderOpenTools:SyntaxChecker(byStevenLee);ExtendedHighlighting(byVolkerMalzahn);SelectionMargin2.
01(byKarlTauber);NumberLine(byGillmerDerge);HighlightMatchingParenthesis,BraceorBracket(byGillmerDerge);JavaNodeIconTip(byKeithWood);RefactorIt(byAqrisSoftwareAS);TextDragDrop(byKarlTauber);ChangeReadOnly(byLukeHutterman);TagReadOnly(byFabrizioGiustina);StructureSynchronizer(byBrianSayatovic);SynchronizeProjectViewandBroserselection(byTorstenWelches);WhereAmIByDavidPierron;JbPropStructure(byAngusChan);ClipboardManager(byJacobRoberson);Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com11Productivity!
ToolsProductivity!
ToolsProductivity!
Offersapowerfulsetoftoolsintendedtoreduceroutinecodingtasks.
Thesetoolsarecarefullydesignedtoallowsolvingsuchtaskswithminimumeffortsandinminimaltime.
ThefollowingtoolsareavailableafterinstallingProductivity!
.
Theexactsetoftoolsincludeddependsonedition–thePro!
markhighlightstoolsavailableinProductivity!
ProfessionalEditiononly.
NOTE:AlltoolsofferedbyProductivity!
belongtothefollowinggroups:CodeGenerationToolsPowerToolsEditorEnhancementsIDEimprovementsNavigationToolsInformationToolsPleasereferthetablebelowtofindmoreaboutcontentofthesegroups.
Also,thereyoucanfindshortdescriptionofeverytoolincludedintoProductivity!
Table1Productivity!
ProToolsToolDescriptionCodeGenerationToolsPro!
Delegate.
InsightDelegate.
Insightprovidesaneasywaytogeneratemethods,whichimplementationsaredelegatedtoanotherobject(delegate).
Pro!
Introduce.
ConstructorIntroduce.
Constructorallowseasygenerationofconstructorsintendedtoinitializeappropriatefieldsoftheclass.
Class.
InsightClass.
InsightallowsquickfindingJavaclasseswithshortnamesmatchingthewordatthecursorposition,andinsertingtheclassnamefoundintothecursorpositionaswellasinsertingimportstatement.
Implement.
InsightImplement.
InsightallowsquickfindingJavaclasseswithshortnamesmatchingthewordatthecursorpositionandusingthemeitherasasuperinterfaceorasasuperclass.
Override.
InsightOverride.
Insightallowsquickfindingmethodstooverridewithnamesmatchingthewordatthecursorpositionoratypedword,andoverridingthemintotheclassatthecursorProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com12Productivity!
ToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com13position.
Constructor.
InsightConstructor.
Insightallowsquickoverridingclassconstructors.
Easy.
JavaDocEasy.
JavaDocallowseasyandconvenientgeneratingtemplatesforJavaDoccommentsforaparticularmethodorclass.
Smart.
InstantiateSmart.
InstantiateisanadditionalClass.
Insightfunctionalitythatallowsaddinginstantiationofaparticularclassorinterface.
GetSet.
CreatorGetSet.
Creatorisatoolthatallowseasycreationofaccessorsand/ormutatorsforselectedfieldsofaclass.
PowerToolsPro!
RenameAssistantThistoolsimplifiesidentifiersrenamingbyintroducing"in-place"renameapproach.
Pro!
AssistantsThesetofassistantsthoseshowinformationabouttheparticularissueand/orlistofpossibleactionstocomplete.
Pro!
TaskListTheTaskListisatoolthatallowsviewingandmanagingthelistoftasks,codeissuesandto-do's.
Pro!
AdvancedTo-Do'sTheAdvancedToDo'stoolisfurtherexpansionoftheToDocommentsconceptbytreatingthemastaskswithsetofattributeslikepriority,status,owneretc.
Pro!
Smart.
TemplatesTheSmart.
Templatesisadvancedtemplateenginethatprovidessetofsophisticatedfeatures,likelinkedfields,calculatedfields;expressionandfunctionssupports.
Itintroducesadvancedcodetemplatesthosecanbeeasilyadaptedtoparticularcodingstylecodingstyle.
Pro!
Smart.
JavaDocTheSmart.
JavaDoctoolisadditionalviewerforJavafilenodethatoffersJavaDocauthoringinmodethatisveryclosetoWYSIWYGone.
EditorEnhancementsSmart.
BracesTheSmart.
Bracesisatoolthatallowseasycreationofclosingbraceswhileyouaretyping.
Pro!
CodeFoldingEnhancementsAbilitytofoldJavaDoccommentsandcollapseallofthem(byusingspecialbuttonontheviewtoolbar.
Pro!
ClassesHighlightAllowshighlightingclassesusedinthecode.
Pro!
ThumbnailGutterTheThumbnailGutterrepresentsadditionalgutterplacedneartheverticalscrollbarofeditorpaneandallowsshowingguttermarksforthewholesourcefileaswellasnavigatetothem.
Pro!
Smart.
ClipboardTheSmart.
Clipboardrepresentsseveraltoolsusedforprovidemoreefficientclipboardoperations.
ThesetoolsProductivity!
ToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com14includeclipboardmanagement,swappingcontextofclipboardwithcurrentselection,insertingpastedJavacodewithcorrectindentalongwithrequiredimportstatementsetc.
Pro!
Smart.
GutterTheSmart.
GutterisadditionalgutterplacednearstandardJBuildereditorgutterandisusedforshowingvarioushintsconcerningcorrespondingcodeineditorbyarrangingappropriateguttermarks.
Pro!
Smart.
Braces.
HighlightTheSmart.
Braces.
Highlighttoolprovidersmatchingbraceshighlightandnavigationoperationsaswellasshowingcodefragmentthatcorrespondstoappropriatebrace.
Pro!
Matching.
Code.
HighlightTheMatching.
Code.
Highlighttoolperformshighlightingofcodematchingtooneatcaretpositionaswellasdisplayingappropriatecodefragmentinthepopupwindow.
Pro!
ChangesHighlightTheChangesHighlightHighlightschangedlinesifJavasourceonthegutter.
Pro!
MethodsandClassesSeparatorTheMethodsandClassesSeparatortoolvisuallyseparatesclassesandmethodsfromeachotherbypaintinghorizontallineatthetopofdeclaration.
Pro!
CurrentLineHighlightTheCurrentLineHighlighttoolhighlightsthelineundercursorinthecurrenteditorwithappropriatebackgroundcolor.
Pro!
Smart.
SelectionTheSmart.
SelectiontoolofferssophisticatedcodeselectionfunctionalitythatisbasedonnstructureofJavaprogram.
Itallowsexpanding/narrowingselectionincrementallyusingappropriatecodeelementsaswellasquicklyselectionofwholestatement,codeblock,methodorclass.
Pro!
AdvancedTextViewStatusBarTheAdvancedTextViewStatusBarrepresentsareplacementofstandardcomponentthatallowsviewingofclassandmethodforcurrentcaretposition,caretoffset,andlinescount.
IDEImprovementsPro!
ProjectViewSynchronizerThistoolprovidesfunctionalityforsynchronizingofcurrentlyactivefilewiththecorrespondingnodeintheJBuilderProjectView.
Pro!
JavaStructureSynchronizerTheJavaStructureSynchronizerallowssynchronizingtheJavaStructureViewwithcurrentcaretpositionintheeditor.
Pro!
Change.
ReadOnlyTheChange.
ReadOnlyallowseasyviewingandmanagingtheread-onlystatusforfilenodes.
NavigationToolsPro!
Persistent.
BookmarksThePersistent.
Bookmarkstooloffersadvancedbookmarksfunctionality.
ThesebookmarksarepersistentbetweensessionsofJBuilder,areassociatednotonlywitheditor,butalsowithfileandJBuilderproject.
Productivity!
ToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com15Pro!
ViewNavigatorTheViewNavigatortoolallowsquicknavigationbysourceelements(classes,methods,fields),issues/errors,editingpointsorsearchresults.
Pro!
Navigator.
InsightTheNavigator.
InsightisspecializedinsightusedforquickcontrollingofViewNavigator.
Browse.
InsightTheBrowse.
InsighttoolallowsquickfindingJavaclasseswithshortnamesmatchingthewordatthecursorpositionandbrowsingthemortheappropriatehelptopics.
Browse.
MembersTheBrowse.
Memberstoolallowsquickfindingmembersbelongingtothecurrentdiscoveredcontextandbrowsingthem.
Hyperlink.
NavigateHyperlink.
Navigateisatoolthatallowseasyandconvenientnavigationthroughsymbolsdefinitionsbasingontheconceptofhyperlinks.
Pro!
SearchResultsandReferencesHighlightThistoolisintendedtohighlightintheeditorvariousthingsfoundduringsearchorfindreferencesoperations.
Pro!
LocalReferencesHighlightThistoolallowsfindinglocalreferencesofthesymbolundercaretandhighlightingthem.
InformationToolsHelp.
InsightHelp.
Insightallowseasyviewinghelptopics,ifany,fortheidentifieratthecursorposition.
Also,itprovidesquickhelpforitemsshowninJBuilderbuilt-inMemberInsightandProductivity!
insights.
Hyperlink.
HelpHyperlink.
Helpallowseasyandconvenientviewinghelptopicsforparticularsymbols.
Context.
InsightContext.
Insightisatoolthatallowsyoutocheckcontextofthecurrentcursorposition.
Context.
Insightcollectsinformationaboutallclassesandmethodsandshowsitusingtheinsightpopupwindow.
Productivity!
ToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com16CommonInsightsFeaturesMostofProductivity!
Insightssharethefollowingapproaches.
ContextSwitchingDuringinvocation,anycontextdependentInsightanalysescontextstructureandselectsthetargetformodification:thedeepestclassormethodfoundforthecursorposition.
TheContextlabelshowsthefull-qualifiednameofthisclassormethod.
Ifthereareseveralclassesormethodsfoundinthecontextpathyoucanchooseadifferentclassasatarget.
UseSwitchContextuptoandSwitchContextdowntobuttonsorkeyboardshortcutsAlt+UporAlt+Down,respectively,toselectaclassormethodsasthetarget;theContextlabelwillreflectthechanges.
Thisfunctionalityisusefulwhencursorisplacedwithinaninnerclasswhileyouneedtoexecuteappropriateactionstotheouterone.
HelpSupportToviewhelppresstheappropriatekeymappedtothehelpactioninthecurrentkeymap(typically,thisisF1).
IfanInsightshowsthelistofmembersandthereisamember(eitherclass,methodorfield)selectedinthelist,theHelpViewerwillshowtheappropriatedocumentationpageforthismember(ifany).
Ifthememberslistisemptyorthereisnomemberselected,thehelpontheInsightwillbeshown.
YoucanusetheHelpbuttonintheNavigationPanetoinvokehelpontheInsightdirectly.
Help.
InsightisanAlternativewayofgettinghelponaselectedmember.
ToallowHelp.
InsightinvocationwhenusingtheInsightyoushouldturnontheEditorOptions|Productivity!
|Usage|IntegrateHelp.
InsightwithProductivity!
Insightscheckbox.
Withthisoptionturnedon,justselectamemberandwaituntilHelp.
InsightpopupwillshowtheappropriateJavaDochelppage(ifany).
YoucanalsoforceHelp.
InsightinvocationusingtheshortcutShift+F1(CUA).
YoucanspecifyHelp.
InsightinvocationdelayusingtheEditorOptions|Productivity!
|Delays|Help.
InsightInvocationDelayslider.
Productivity!
–PowerToolsCodeGenerationToolsProductivity!
offerspowerfulsetofcodegenerationtoolsintendedtosimplifyroutingbutverycommonoperationslike:Insertingappropriateimportstatementsforclass(usingshortclassname)–theClass.
Insighttool;Implementinginterfaceorextendingclass–theImplement.
Insighttool;Overridingmethods–theOverride.
Insighttool;Creationofconstructorwiththesamesignatureasonedefinedinsuperclass–theConstructor.
Insighttool;Instantiationofvariable-theSmart.
Instantiatetool;Creatingofgetter/settermethods–theGetSet.
Creatortool;Creatingofconstructorusedtoinitializesetofclassfields–theIntroduce.
Constructortool;Creatingofproxydelegatemethodsthoseactuallycallsmethodsofclassmember–theDelegate.
InsighttoolCreationofdefaultJavaDoccomment–theEasy.
JavaDoctool;Importstatementsoptimization–theImports.
Beautifytool.
Allthesetoolsprovideverysimpleandintuitiveinterfaceandallowyoutogetrequiredtaskcompleteusingminimalamountofactionsneeded.
Class.
InsightClass.
Insight-Forgetabouttypingyourimportstatements!
Class.
InsightallowsquickfindingJavaclasseswithshortnamesmatchingthewordatthecursorposition,andinsertingtheretheclassnamefoundanditsimportstatement.
Tochooseaclassfromseveralpossiblevariants,itemploysapopupwindowsimilartootherJavaInsightpopups(MemberInsight,ParameterInsightetc.
).
Youdon'tneedtotypeimportstatementsmanually-justuseClass.
Insighttofindandinserttherequiredclassandletitmakeallotherjobforyou!
TheClass.
Insightbackendcachesalltherequiredinformationaboutclassescontaininginproject,JDKandprojectrequiredlibrariestospeedupusage.
ThecachebuildisinitiatedonlyonthefirstClass.
Insightinvocationsoitdoesn'taffectJBuilderstartupandaprojectopeningtime.
TheClass.
Insightsavesthecacheintheprojectdirectorywhileprojectclosingandloadsthecachefromdiskwhentheprojectisopenednexttime.
Thecachefileisnamed.
cacheanditcanbeeasilyremovedwhenunneededusProductivity!
willautomaticallyrecreateitbeforethenextClass.
Insightuse.
Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com17Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com18Figure1Class.
InsightPopupWindowWheneditingafile,placethecursoroverthewordyouwanttoexpandasaclassname(oratablankspace)andpressCtrl+Alt+Space(Ctrl+Alt+H)(CUA)toinvokeClass.
Insight.
TheClass.
Insightpopupwillbeshownwiththelistofclassesmatchingthewordatthecursorposition.
Youcanselectaclassnavigatingthroughthelistwiththehelpoftheusualkeyboard.
AnAlternativewaytodoitistocontinuetypingtheword;thelistselectionwillbechangedtoproducetheclosestmatchpossible.
Class.
InsightActionsOnselectingaclass,youmaychoosefromseveraloptionswiththehelpofthefollowingshortcuts:Enter:-Class.
Insightreplacesthewordatthecursorpositionwithaclassnameandaddstheappropriateimportstatement;Ctrl+Enter:-Class.
Insightreplacesthewordatthecursorpositionwithafull-qualifiedclassname;Alt+Enter:-Class.
Insightswitchesbetweenimportingaparticularclassandthewholepackage.
Shift+Enter:-Class.
Insightproducesacodeforinstantiationoftheselectedclassvariable.
Iftherearenomatchesfound,Java.
Insight-SelectClassdialogisshown.
SelectaclassinthisdialogandpressOK.
TheClass.
Insightwillreplace(orjustinsert)thewordatthecursorpositionwithaselectedclassnameaddingtheappropriateimportstatement.
ShowingNavigationPaneYoucanswitchClass.
InsightpopuptoshowtheNavigationPanebyturningofftheEditorOptions|Productivity!
|Usage|ShowClass.
Insightpopupaslistcheckbox.
Withthisoptionturnedoff,Class.
InsightpopupwillbeshownwiththeNavigationPane,thatallowsusingClass.
Insightpopupevenifthereisnowordatthecursorpositionoriftherearenomatchingclassesfound.
Tofindmatches,typeawordintheUseClasseditboxandClass.
Insightwilldynamicallyrearrangetheclasses'listtoshowthematchingones.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com19OptionsDependencyPleasenotethatthesetofclassesshownintheClass.
InsightlistdependsonPackagesExclusionsettingsontheProjectProperties|Productivity!
|Generalpropertypage.
ImportstatementsaregeneratedbasingonImportsGenerationsettingsontheEditorOptions|Productivity!
|Generalpropertypage.
ThereyoucanalsocustomizeotherClass.
Insightoptions,suchasSearchOptions,SortClassesBy,AutocompleteandProductivity!
InsightsUsageImplement.
InsightImplement.
InsightallowsquickfindingofJavaclasseswithshortnamesmatchingthewordatthecursorpositionandusingthemeitherasasuperinterfaceorsuperclassfortheclassatthecursorposition.
Figure2Implement.
InsightPopupWindowWheneditingafile,placethecursorwithintheboundsoftheclassyouwanttoaddasuperinterfaceorsetasuperclassto,andpressCtrl+Alt+I(CUA)toinvokeImplement.
Insight.
TheImplement.
Insightpopupwillbeshownwiththelistofclassesmatchingthewordatthecursorposition.
Thelistmaybeemptyiftherearenomatchingclassesthough.
Tofindmatches,typethewordintheImplementInterfaceeditboxandImplement.
Insightwilldynamicallyrearrangetheclasses'listtoshowthematchingones.
Youcanselectaclassnavigatingthroughthelistwiththehelpoftheusualkeyboard.
AnAlternativewaytodoitistocontinuetypingtheword;thelistselectionwillbechangedtoproducetheclosestmatchpossible.
PresstheEnterkeywhenyoufindtherequiredclassandImplement.
Insightwilladdthisclasstothelistofsuperinterfacesorsetitasthesuperclassforthetargetone.
Implement.
Insightwillalsowriteallthemethodsdefinedintheinterfaceoralltheabstractmethodsdefinedintheclass(ifyouhaveselectedaninterfaceandaclass,respectively).
Ifyouhaveselectedaclass(notaninterface)andthetargetonealreadyhasasuperclassyouwillbepromptedtoconfirmmodifications.
Also,thereisapossibilityofinvokingthebuilt-inImplementInterfaceWizard.
Youcanusetheappropriatebuttoninthetopleftcornerofthepopup.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com20Figure3CodeGeneratedbyImplement.
InsightThefigureaboveillustratescodegeneratedbyImplement.
Insight.
CodeChangesSynchronizationImplement.
Insightanalyseschangesinalldependantsourcefilesandcorrectlyreflectsthemduringgenerationofabstractmethodsimplementations.
ButformostofthecasesyouneedtocompilealldependantclassesbeforeinvocationofImplement.
Insight.
Iftherequiredclassisnotcompiledyetortherequiredmethodsarenotfoundinthecompiledclass,theseerrorswillbeshownintheStatusView.
OptionsDependencyPleasenotethatthesetofclassesshowninImplement.
InsightlistdependsonPackagesExclusionsettingsontheProjectProperties|Productivity!
|Generalpropertypage.
AlsothereyoucancustomizeCodeGenerationOptions,whichallowyoutoadjustthecodestyleforthegeneratedmethodscode.
ImportstatementswillbegeneratedbasingonImportsGenerationsettingsontheEditorOptions|Productivity!
|Generalpropertypage.
ThereyoucanalsocustomizeotherImplement.
Insightoptions,suchasSearchOptionsandSortClassesBy.
Override.
InsightandConstructor.
InsightOverride.
Insightallowsquickfindingofmethodsandconstructorstooverridewithnamesmatchingawordatthecursorpositionoratypedwordandoverridingthemintheclassatthecursorposition.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com21Figure4Override.
InsightPopupWindowWheneditingafile,placethecursorwithintheboundsoftheclassyouwanttooverridemethodsfor,andpressCtrl+M(CUA)toinvokeOverride.
Insight.
TheOverride.
Insightpopupwillbeshownwiththelistofmethodsthosematchthewordatthecursorposition.
Thelistmaybeemptyiftherearenomatchingmethodsthough.
Tofindmatches,typeawordintheOverrideMethodseditboxandOverride.
Insightwilldynamicallyrearrangethemethods'listtoshowthematchingones.
YoucanalsoleavetheOverrideMethodseditboxblanktoviewallthemethodstooverride.
Override.
Insighthighlightsthemethodswithnamesexactlymatchingthetypedwordwithboldfontandtheabstractmethodswithitalicfont.
Inadditiontothemethodsinheritedfromthesuperclass,Override.
Insightshowsthemethodsdefinedintheinterfacesbutnotimplementeddirectlybythetargetclass.
Youcanselectamethod,eitheroneorany,navigatingthroughthelistwiththehelpoftheusualkeyboard.
AnAlternativewaytodoitistocontinuetypingtheword;thelistselectionwillbechangedtoproducetheclosestmatchpossible.
PresstheEnterkeywhenyouselecttherequiredmethodsandOverride.
Insightwilloverridethemandaddcallstotheappropriatemethodsofthesuperclass,ifneeded.
YoucancallOverride.
InsightwithconstructorsonlyusingtheshortcutCtrl+Shift+M(CUA).
Also,thereisapossibilityofinvokingthebuilt-inOverrideMethodsWizard.
Youcanusetheappropriatebuttoninthelefttopcornerofthepopuptoinvokeit.
CodeChangesSynchronizationOverride.
Insightanalyseschangesinalldependantsourcefilesandcorrectlyreflectstheminthemethodslist.
ButinmostcasesyouneedtocompilealldependantclassesbeforeinvocatingOverride.
Insight.
Iftherequiredclassisnotcompiledyetortherequiredmethodsarenotfoundinthecompiledclass,theseerrorswillbeshownintheStatusView.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com22OptionsDependencyUsingtheProjectProperties|Productivity!
|GeneralpropertypageyoucancustomizeCodeGenerationOptions,whichallowyoutoadjustthecodestyleforthegeneratedmethodscode.
ImportstatementsaregeneratedbasingonImportsGenerationsettingsontheEditorOptions|Productivity!
|Generalpropertypage.
ThereyoualsocancustomizeotherOverride.
Insightoptions,suchasSearchOptionsandSortClassesBy.
Smart.
InstantiateSmart.
InstantiateisanadditionalfunctionalityofClass.
InsightthatallowsaddinginstantiationofaparticularclassbyinvokingClass.
Insight,selectingtheclassandpressingShift+Enter.
Smart.
Instantiaterecognizestheneedtodefineavariableorjusttocreateanewobject.
Forexample,whenyoutypeListfList=newList(100);anduseSmart.
InstantiatetocreateanArrayListinstance,Class.
Insightreplacesonlytheappropriateclassnameandpreservesthevariabledefinitionandconstructorparameters.
YouwillgetthefollowingListfList=newArrayList(100);ThesamebehaviorisexhibitedwhenusingSmart.
Instantiatetocreateanewinstanceandasaparametertoamethodcall.
Inothercases,Smart.
Instantiateinsertsdefinitionandinitializationofthevariablewithanewinstanceoftheselectedclass.
Figure5Smart.
InstantiatePopupWindowWhenaninterfaceisselectedtobeinstantiated,Smart.
Instantiateautomaticallyinsertsimplementationoftheinterfaceasananonymousinnerclass.
YoucancontrolthisbehaviorusingtheProjectProperties|Class.
Insight|Generalpropertypage.
AnAlternativewaytogetSmart.
InstantiateexecutedisusingtheshortcutAlt+I(CUA)thatinvokesaparticularSmart.
Instantiatepopup.
ThispopupissimilartotheClass.
Insightonebutitdoesn'trequireholdingtheShiftkeytoactivateSmart.
Instantiate-youjustneedtoselectaclassandpresstheEnterkeytoinstantiateit.
AcoupleofsamplesofillustratingwhatSmart.
Instantiatecandoforyou!
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com23Figure6CodeBeforeInvocationofSmart.
InstantiateFigure7CodeAfterInvocationofSmart.
InstantiateShowingNavigationPaneYoucanswitchtheSmart.
InstantiatepopuptoshowtheNavigationPanebyturningofftheEditorOptions|Productivity!
|Usage|ShowClass.
Insightpopupaslistcheckbox.
Withthisoptionturnedoff,Smart.
InstantiatepopupwillbeshownwiththeNavigationPane,thatallowtouseSmart.
Instantiateevenifthereisnowordatthecursorpositionoriftherearenoclassesmatchingit.
Tofindmatches,typeawordintheInstantiateClasseditboxandSmart.
Instantiatewilldynamicallyrearrangetheclasses'listtoshowthematchingones.
OptionsDependencyPleasenotethatthesetofclassesshownintheSmart.
InstantiatelistdependsonPackagesExclusionsettingsontheProjectProperties|Productivity!
|Generalpropertypage.
ImportstatementsaregeneratedbasingonImportsGenerationsettingsontheEditorOptions|Productivity!
|Generalpropertypage.
ThereyoucanalsocustomizeotheroptionsofSmart.
Instantiate,suchasSearchOptions,SortClassesBy,AutocompleteandProductivity!
InsightsUsage.
UsingtheProjectProperties|Productivity!
|GeneralpropertypageyoucancustomizeCodeGenerationOptions,whichallowyoutoadjustthecodestyleforthegeneratedmethodscode.
GetSet.
CreatorGetSet.
Creatorisatoolthatallowseasycreationofaccessorsand/ormutatorsforselectedfieldsofaclass.
Wheneditingafile,pressAlt+Shift+A(CUA)toinvokeGetSet.
CreatorInsight.
TheGetSet.
Creatorpopupwillbeshownwiththelistoffieldsmatchingawordatthecursorposition.
Thelistmaybeemptyiftherearenomatchingfieldsthough.
Tofindmatches,typeawordintheFieldseditboxandGetSet.
Creatorwilldynamicallyrearrangethelistoffieldstoshowthematchingones.
YoucanalsoleavetheFieldseditboxblanktoviewallfields.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com24Figure8GetSet.
CreatorPopupWindowGetSet.
Creatorhighlightsthefieldswithnamesexactlymatchingthetypedwordusingboldfont.
GetSet.
Creatoranalysesallthefieldsandallthemethodsthosemaybeconsideredasaccessorormutatoronesandremovescertainfieldsfromthelistifappropriatemethodsarealreadyexist.
Youcanselectafield,eitheroneorany,navigatingthroughthelistwiththehelpoftheusualkeyboard.
AnAlternativewaytodoitistocontinuetypingtheword;thelistselectionwillbechangedtoproducetheclosestmatchpossible.
PresstheEnterkeywhenyouselecttherequiredfields(s)andGetSet.
Creatorwillgenerateapplicableaccessorsand(or)mutatorstoit(youcanselectallitemsinthelistusingtheCtrl+Ashortcut).
Whengeneratingamethod,GetSet.
Creatoranalysesthecurrentclassaswellasallitssuperclassesandsuperinterfaces,soitcancalltheappropriatemethodofthesuperclassorskipparticularmethodgenerationincaseofanycontradictions.
ThereisanabilitytoinvokeGetSet.
CreatorinthemodethatallowgeneratingeitheraccessorsormutatorsmethodsonlyusingtheAlt+Shift+GorAlt+Shift+S(CUA)shortcuts,respectively.
Figure9CodeGeneratedbyGetSet.
CreatorIngeneral,GetSet.
CreatorusesJavaBeansconventionfornamingtheaccessorandmutatormethods.
Butifyourcodestyleassumesusingprefixesor(and)suffixesforfieldsnaming,GetSet.
CreatorallowsyoutousethemwithoutdistortionofmethodProductivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com25names-youjustneedtospecifycorrectprefixesandsuffixesintheProjectProperties|Productivity!
|CodeStyle|FieldsNamingoptionsgroup.
Forexample,ifyouspecifyprefixm_andnameyourfieldasm_count,GetSet.
CreatorgeneratesmethodsasgetCount()andsetCount(.
.
.
).
GetSet.
CreatorcangenerateJavaDoccommentsduringmethodsgeneration.
Tocontrolthis,pleaseusetheoptionsontheProjectProperties|Productivity!
|JavaDocpropertypage.
Introduce.
Constructor–Pro!
Introduce.
Constructorisatoolthatallowseasygenerationofconstructorsthoseareintendedtoinitializeselectedclass'fields.
ItcanbeinvokedusingAlt+Shift+C(CUA)shortcut.
TheIntroduce.
Constructorpopupwillbeshownwiththelistoffieldsmatchingawordatthecursorposition.
Thelistmaybeemptyiftherearenomatchingfieldsthough.
Tofindmatches,typeawordintheFieldseditboxandIntroduce.
Constructorwilldynamicallyrearrangethelistoffieldstoshowthematchingones.
TheFieldseditboxcanbeblankthatallowsviewingallfields.
Figure10Introduce.
ConstructorPopupWindowFigure11SelectionofFieldsShouldbeInitializedOneormorefieldscanbeselectedusingthefields'list.
Theorderoffields'selectionexactlydefinesthedefinitionorderofconstructorparametersand,inturn,theorderoffields'initialization.
NOTE:Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com26AssoonasfieldstoinitializeareselectedpressingtheEnterkeyclosesIntroduce.
Constructorpopupandintroducesconstructorthatinitializesallselectedfields.
Figure12CodeGeneratedbyIntroduce.
ConstructorPleasenotethatifconstructorwiththesamesignatureisalreadyexists,Introduce.
ConstructorpopupwillnotbeclosedandappropriateerrormessagewillbedisplayedintheStatusBar.
OptionsDependencyTheProjectProperties|Productivity!
|CodeStylepropertypageallowscustomizingcodestyleandplacementforthegeneratedconstructors.
SettingsforJavaDoccommentsthosecanbeoptionallygeneratedduringconstructors'introducingcanbecustomizedusingtheProjectProperties|Productivity!
|JavaDocpropertypage.
Delegate.
Insight–Pro!
TheDelegate.
Insighttoolprovidesaneasywaytogeneratemethodsthoseactualimplementationsaredelegatedtoanotherobject(delegate).
ToinvokeDelegate.
InsightpleaseuseAlt+Shift+M(CUA)shortcut.
Afterinvocation,theDelegate.
Insightpopupisshownwiththelistofmembers(fieldsandmethods)matchingawordatthecursorposition.
Thelistmaybeemptyiftherearenomatchingorsuitablemembersthough.
Tofindmatches,typeawordintheChooseDelegateeditboxandDelegate.
Insightwilldynamicallyrearrangethelistofmemberstoshowthematchingones.
TheChooseDelegateeditboxcanbeblankthatallowsviewingofallmembers.
Figure13Delegate.
InsightPopupWindow–SelectingaDelegateAssoonasamembertobecomethedelegateisselected(multipleselectionisnotsupportedbythistool)andpresstheEnterkey,theDelegate.
InsightpopupshowstheProductivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com27listofmethodsbelongingtothedelegateandsuitabletobeintroducedinthetargetclass.
Figure14Delegate.
InsightPopupWindow–SelectingMethodsTofindmatchespleasetypeawordintheChooseMethodseditboxandDelegate.
Insightwilldynamicallyrearrangethelistofmethodstoshowthematchingones.
TheChooseMethodeditboxcanbeblankthatallowsviewingallmethods.
Figure15CodeGeneratedbyDelegate.
InsightDelegate.
Insightcorrectlyrecognizesdelegatemodifiersandgeneratesstaticmethodsifrequired(preservingothermodifiersaswell).
Itutilizesallmajordelegatepatternsandallowsusingthefollowingentitiesasdelegates:Fielddeclaredeitherincurrentlyeditedclassorinanyofitsparents;Executionresultofmethodwithoutparameters;Executionresultofmethodwithparameters.
InthiscaseDelegate.
Insightgeneratesmethods,whichhavemergedlistofparameters-onepartisneededtoobtainadelegateandanotheronetobepassedtodelegates'methodscall.
OptionsDependencyTheProjectProperties|Productivity!
|CodeStylepropertypageallowscustomizingcodestyleandplacementforthegeneratedmethods.
SettingsforJavaDoccommentsthosecanbeoptionallygeneratedduringmethods'generationcanbecustomizedusingtheProjectProperties|Productivity!
|JavaDocpropertypage.
Easy.
JavaDocandEasy.
JavaDoc.
InsightEasy.
JavaDocisatoolthatallowseasyandconvenientgeneratingoftemplatesforJavaDoccommentsonparticularmethodsorclasses(exceptfortheanonymousones).
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com28Easy.
JavaDocToinvokeEasy.
JavaDoc,placethecursorwithinamethodorclassforwhichyouwanttogenerateJavaDocandpressCtrl+D(CUA).
JavaDoccommentwillbeautomaticallyinsertedjustbeforethemethod.
Sincethemethodcommentscontaintagsforalldeclaredfields,exceptionscanbethrownbythemethod.
That'sreallyeasy!
Easy.
JavaDoc.
InsightEasy.
JavaDoc.
InsightallowschoosingofseveralmethodsorclassesforJavaDocgeneration.
Figure16Easy.
JavaDoc.
InsightPopupWindowPressCtrl+Shift+D(CUA)toinvokeEasy.
JavaDoc.
Insight.
TheEasy.
JavaDoc.
Insightpopupwillbeshownwiththelistofmembers(methodsand/orclasses)matchingthewordtypedintheMemberseditbox.
Thelistmaybeemptyiftherearenomatchingmembersthough.
Tofindmatches,typeawordintheMemberseditboxandEasy.
JavaDoc.
Insightwilldynamicallyrearrangethemembers'listtoshowthematchingones.
IfyouleavetheMemberseditboxblank,allmemberswithinthecurrentcontextareshown.
UnlikeotherInsights,Easy.
JavaDoc.
Insightdoesn'tmerelyemploythewordatthecursorposition;itratherusesthenameforthemethodorclassatthecursorposition.
ThisapproachallowseasygenerationofJavaDoccommentsforthemethodorclassatthecursorposition.
NOTE:Figure17CodeGeneratedbyEasy.
JavaDocYoucanselectamembernavigatingthroughthelistwiththehelpoftheusualkeyboard.
AnAlternativewaytodoitistocontinuetypingtheword;thelistselectionwillbechangedtoproducetheclosestmatchpossible.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com29OnselectingthememberspressEntertogenerateJavaDoccoveringallofthem.
OptionsDependencyYoumayadjustcontentofJavaDocgeneratedbyEasy.
JavaDocusingProjectOptions|Productivity!
|Easy.
JavaDoc.
Bydefault,Easy.
JavaDocgenerates@return,@paramand@throwstags.
Youmayalsospecifythatitshouldgenerate@author,@seeand@sincetags.
Toenableordisabletheirgeneration,pleaseopentheProjectOptions|Productivity!
|Easy.
JavaDocpropertypageandselecttheappropriatecheckboxes.
Pleasenotethatifyouselectgenerationofthe@authortag,theEasy.
JavaDocinsertsthetag'svalueasitisspecifiedontheProjectProperties|Generalpropertypage.
Inaddition,onthesamepageyoucanspecifythepolicytobeusedbyEasy.
JavaDocifJavaDoccommentalreadyexistsforamethodorclass.
Basedonyourselection,Easy.
JavaDoccanoverwriteoldcomments,skipgenerationoraskyourconfirmationoncommentsrewriting.
Notethattheseoptionsmayaffectthemembers'listcontentinEasy.
JavaDoc.
Insightpopup-iftheoptiontoskipmemberswithexistingJavaDocisspecified,allsuchmemberswillbeexcludedfromthemembers'list.
PowerToolsProductivity!
includessetofadvancedtoolsthosemakeProductivity!
reallyunique.
AsallotherProductivity!
tools,theseonesareintendedtodramaticallyincreaseproductivityofJavadeveloper.
Thesetoolsinclude:RenameAssistant–uniquetoolthatsimplifiesidentifiersrenamingbyintroducing"in-place"renameapproach;Assistants–richsetofcodeandinformationassistantsthoseprovidequickinformationaboutcodeissuesand,ifpossible,setofchoicesthoseallowproblemresolving;TaskList–thetoolthatallowsviewingandmanaginglistcontainingtasks,codeissuesandto-dos.
Smart.
Templates–theadvancedcodetemplatesenginewithabilitytoliveupdateofrelatedfieldswhiletyping.
Smart.
JavaDoc–thetoolthatallowsJavaDocauthoringinmodeisveryclosetoWYSIWYGone.
ItisavailableasanadditionalviewerforJavafilenode.
RenameAssistant-Pro!
RenameAssistantisatoolintendedtosimplifyidentifiersrenaming.
Itintroduces"in-place"editingapproachandlettheusertoenteranewnameandthenchoosewhetherhi/shelikestorefactor,simplyrenameorskipchangesofidentifiername.
ToseeRenameAssistantinactionjustplacethecarettoanidentifieryouwishtorenameandstartrenamingitsimplybytypingnewname.
RenameAssistantpopsuprightintheplaceofyouridentifier;youcanrecognizeitbythelinesshownonthetopandbottomofidentifierbeingrenamedandRenameAssistanticonplacedongutter.
Whennewnameisenteredit'spossibleto:Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com30PresstheEnterkeytorenameidentifierusingrefactoringprocedures.
PresstheCtrl+Enterkeytosimplyrenameidentifier.
PresstheEsckeyormouseclickoutsideRenameAssistanttoskipanychanges.
Figure18RenameAssistantIt'spossibletotuneRenameAssistantbehaviorusingtheEditorPreferences|Productivity!
|Assistantpropertypage.
Thereisabilitytoquicklyturnassistanton/offusingtheEnableRenameAssistantbuttonontheviewtoolbar.
PleasenotethatRenameAssistantworksonlyiftherearenosyntaxerrorsinthesourcecode.
OptionsDependencyYoucancontrolRenameAssistantbehaviorusingtheEditorOptions|Productivity!
|Assistantpropertypage.
Assistant-Pro!
TheAssistanttoolprovidesvisualfeedbackintheeditoraboutanycodeissuebyhighlightingcorrespondingsymbolsusingstyledandcoloredline.
Bydefault,errors,warningsandTo-Do'sarehighlightedusingred,greenandgraywavylinerespectively.
Eachissuehasdescriptionassociatedwithitanddescriptiontextforeveryissuecanbeshowninthehintwindowthatappearsifmousecursorisplacedunderthecodeissue.
AssistantprovidesspecialInsightwindow,whichcanautomaticallypop-upinthelocationofcodeissuenearesttothecaretpositionandshowsinformationabouttheparticularissueorlistofpossibleactionstocomplete(resolve)it.
TherearetwokindsofAssistants:InfoAssistantandCodeAssistant.
TheInfoAssistantshowsdescriptionfortheissueiftherearenoactionsthatmaybeperformedtoresolvetheissue.
ItisusefulasitcanprovidemoreconvenientfeedbackaboutthecodeissuethanStructureViewasitalwaysvisibleandplacednearcaretandprobablynearthepointoftheuserview.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com31Figure19InfoAssistantTheCodeAssistantshowsdescriptionfortheissuealongwiththelistofactionsthosecanhelptoresolveit.
CodeAssistantprovidesmostconvenientwaytoresolveissuesasitallowsfixingofissuewithouthavingtoleavecurrentcursorposition.
Itallowsfixingoftheissuemanuallyorbyinvokingofappropriatetool.
Assoonasissueisresolved,itrestoresoriginalcaretposition.
Theuserisabletofixtheissuequicklyusingpromptedshortcutorjustusingmouse.
ThereisalsoabilitytopopupandfocusCodeAssistantusingAlt-Enter(CUA)keystrokeanduseusualkeystonavigatethroughthefixactionsandtheEnterkeytochoose(invoke)requiredone.
Figure20CodeAssistantAnotherwaytofixissueisusingcontextpopupmenuandthiswayisusefulwhenCodeAssistantisdisabled.
Figure21CodeAssistantIntegratedIntoContextMenuAssistantcanbeconfiguredtoautomaticallyfixcertaintypesoferrorswithoutpromptingtotheuser.
Thefollowingerrorscurrentlycanbeautomaticallyfixed:1.
Typecasterrors-byaddingrequiredtypecast.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com322.
Unknownclasserrors-byaddingappropriateimportstatement.
It'spossibletospecifypolicyforeachshortclassnamethatexactlydefineswhatactionshouldbedonetomakethisnameknowninthecode.
Itisusualthingwhenseveralclasseswiththesameshortnamesarebedefinedindifferentpackages(java.
util.
Listandjava.
awt.
Lististhegoodexample).
Tosimplifyworkingwithsuchclassesit'spossibletospecifyalistofmostfrequentlyusedclassesusingtheProjectProperties|Productivity!
|Assistantpropertypage.
Suchlistisusedtodetermineparticularclasstoimportortoshowinthetopofthelistincaseofexistenceofseveraldifferentcandidates.
It'spossibletodisableassistantseitherglobally(foralltypesofissues)usingmenuinthebottomrightcornerofThumbnailGutterordisableassistantforonlyspecificgroupofissues.
Figure22Disabling/EnablingAssistants'MenuBelowareseveralexamplesofCodeAssistant:Figure23AmbiguousNamesIssueCodeAssistantProductivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com33Figure24InvalidmethoddeclarationissueCodeAssistantFigure25UnknownClassIssueCodeAssistantOptionsDependencyYoucancontrolAssistantsbehaviorusingtheEditorOptions|Productivity!
|Assistantpropertypage.
TheProjectProperties|Productivity|AssistantpropertypagecanbeusedtospecifyprojectdependentAssistantoptions.
AdvancedTo-Do's-Pro!
TheAdvancedTo-DotoolexpandstheconceptofTo-Docommentsbytreatingthemastasksratherthensimpleentitiesthosecanholdonlytextualinformation.
ThefollowingattributescanbeassignedtoTo-Dotask:Priority;CompletionStatus;Owner;StartDate;DueDate;Reminder;URL.
AlltheseattributesareencodedinthebodyofTo-Do,soconceptofAdvancedToDo'sdoesn'trequireusingofanyadditionalstorage.
ToolsthoseworkwithTo-Do'se.
g.
AdvancedJavaStructureView)areawareofhavingsuchattributesandareabletocorrectlyshowonlydescriptionofTo-Docomment.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com34Figure26AdvancedTo-DoandAssistantAnycustomattributescanbedirectlyaddedorchangedmanuallyinthesourcecodeaccordingtothesupportedsyntax.
ThemostconvenientwayofworkingwithTo-Do'sisusingTaskList.
TheTaskListallowsnavigationtoaselectedTo-Do,changingofanyTo-Do'sattributes(certainlyexcludingfileURL)andremovingtheTo-Dofromthesourcefile.
TheTo-DoAssistantallowsexecutionofthemosthelpfulactionsfortheTo-Doatthecaretposition.
ThoseactionsincludeComplete,EditandRemovethecurrentTo-Dotask.
OptionsDependencyYoucancontrolthebehaviorofAssistantsusingtheEditorOptions|Productivity!
|Assistantpropertypage.
TaskList-Pro!
TheTaskListtoolallowsviewingandmanagingthelistoftasks.
TaskListisembeddedintoJBuilderMessagePane.
ToshoworhideTaskListpleaseuseView|TaskListmenuitemorappropriatemenuitemineditorcontextmenu.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com35Figure27TaskListPanelIntroductiontoTasks'ConceptEachtaskisanentitythatrepresentssomeworktobedone.
Thefollowingattributesarebelongtoeachtask:Priority–canbeoneofthefollowing:Low,Medium,High,Highest;CompletionStatus–specifieswhetherthetaskiscompletedornot;Description–specifiesthedescriptionofthetask;Owner–specifiestheusernamewhichownsthetask;StartDate–specifiesthedatethetaskwas/shouldbestarted;DueDate–specifiesthedatewhenthetaskshouldbedone;ReminderStatus–specifieswhetherremindershouldbeshowntotheuseraboutthetaskneartotheduedate.
Thefollowingtasktypesarecurrentlysupported:CodeIssues–errorsandwarningscollectedfromthefilecurrentlyopenedintheeditor.
Theyareinterpretedastasksbecauseallerrorsandmostofwarningsshouldbefixedinordertosuccessfullybuildsourcefile;To-Do's–all@todocommentscollectedfromthefilecurrentlyopenedintheeditorand(optionally)collectedforthewholeproject.
Alltaskscollectedforthewholeprojectarecachedinthefilewith".
todos"extensionstoredintheprojectfolder.
TaskListtriestokeepthiscacheup-to-date(assoonasfileisopened)thoughthereisabilitytorebuildallofthemmanually;GeneralTasks–simplepersistenttasksintendedtogeneraluse.
Theyarenotrelatedtoanyfilebutratherarerelatedtothewholeproject.
Allthosetasksarestoredinthefilewith".
tasks"extensionstoredintheprojectfolder.
TaskListUserInterfaceTheTaskListconsistsoftoolbarwhichprovidescontrolsthoseallowmaintainingandcontrollingTaskListandTaskListViewwhichshowstasks.
TaskListViewcanbeeitherPlainorOutlinedone.
ThePlainViewshowsthetableinwhicheachtaskoccupiesonerowandeachcolumnrepresentsappropriatesingleattributeoftask.
Thereisabilitytoresize,moveorhidecolumnsaswellastospecifysortingorderbyclickingtodesiredcolumnheader.
OutlinedViewconsistsofTasksFolderTreeViewattheleftandPlainViewattherightofTaskList.
TasksFolderTreeViewallowsselectionoftasksgroupingandfilteringcriteriaanditactsas"Master"whilePlainViewacts,as"Details"istheirrelationship.
Thefollowingfoldersareavailable:Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com36ProjectFolder–therootforallotherfolders;OverdueTasks–containsalloverduetasks;CodeIssues–containscodeissues;Tasks–containsGeneralTasks;ToDo's–containsallTo-Do'soutlinedbypackagesofclassesthoseTo-Do'sarebelongingto.
Itispossibletospecifyfilters,sortingorder,columnsset,columnsplacementandsizesindividuallyforeachviewandfolder.
AllthesesettingsarepersistentbetweenJBuildersessions.
TheTaskListprovidesabilitytosynchronizeselectedtaskwithfileitisrelatedto(ifany).
Toopenfileassociatedwiththetaskusedouble-clickonthetaskintasklisttable.
Thefollowingtableoutlinesactionsavailableonthetoolbar:Table2TaskListToobarActionsIconDescriptionTogglesPlain/OutlinedViewsSpecifiesiftasksdetailsviewwillincludetasksfromdescendantsofthecurrentlyselectedpackageExpandsallnodesintreeCollapsesallnodesintreeAllowscreationofnewtasksRemovescurrentlyselectedtask/sRefreshescurrentviewandoptionallyrefreshesTo-Do'sforthewholeprojectAllowsapplyingfiltersforthecurrentviewAllowschoosingvisiblecolumnsforthecurrentview.
SpecifieswhethertodocommentsshouldbeshownforthewholeprojectorforactivefileonlySpecifieswhethercompletedtasksshouldbevisibleEnables/DisablesreminderstrackingProductivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com37SpecifieswhetherremindersshouldbeshownonlyfortasksassignedtothecurrentuserMaintainingTasksUsingTaskListTheTaskListallowscreationofnewtasks,removalofexistingonesandchangingattributesofthem.
Tochangetaskattributes,TaskListoffersin-placeeditingcapabilitiesandprovidesappropriatecelleditorfortheeachattribute.
Figure28ChangingPriorityoftheTaskThefollowingtableshowsoperationsapplicabletoeachtasktype.
Table3TaskOperationsOperationTaskTypeNewChangeAttributesRemoveCodeIssueNo'Completed'attribute*NoGeneralTaskYesYesYesTo-DoYes**Yes**Yes***-Thisoperationisapplicableifthereisatleastone"Complete"actionavailablefortheparticularCodeIssue;**-TheseoperationsareapplicableifJavafilethisTo-Doisbelongingtoisbeingeditedandthisfileisnotread-onlyone;Changingof'Completed'attributeforTo-Do'sandGeneralTasksdoesn'tleadtoanyotheractionsratherthensimpleassigningofappropriatevaluetothetask.
ThisbehavioriscompletelydifferentforCodeIssuesasthenatureofCodeIssuesisProductivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com38different.
TomakeCodeIssuecompleted,thereasonofitshouldberemovedortheproblemshouldbefixedsomeway.
ThusCodeIssuecanbecompletedifthereareactionsthosecanfixitandtocompleteitoneofthemshouldexecutedaswell.
Forexample,ifcodeissueis"unknownclass"or"ambiguous"one,it'spossibletoselectcorrectclassfromlistofoptions,fixtheissueandthuscompletethetask.
Figure29FixingCodeIssuesUsingTaskListRemindersThereisabilitytosetupremindersfortaskswhicharenotcompletedyetandhaveduedateassigned.
Tosetupreminder,theappropriateattributeofrequiredtaskshouldbechecked.
Thebuttonshouldbepressedtoenablereminderstracking.
ItispossibletoinstructTaskListtoshowremindersfortasks,whichownedbycurrentuseronly.
Toturnthismodeonthebuttonshouldbepressed.
TheReminderdialogisdisplayedwhenthetimegapbetweencurrentdateandduedateforparticulartaskislessthenspecifiedvalue.
Inaddition,thereisanoptionalabilitytoplaysoundwhenreminderisoccurring.
Figure30ReminderDialogThefollowingactionsareavailablefromthisdialog:NavigatetotheparticulartaskusingtheGotoTaskbutton;DismissreminderusingtheDismissbutton;SnoozereminderforthecertainperiodoftimeusingtheSnoozebuttonandappropriatecombobox.
TheTaskListhidesalltheshownReminderdialogsforprojectdependenttaskswhentheuserclosesparticularprojectorselectsanotherone.
OptionsDependencyYoucantuneremindersbehaviorusingtheIDEOptions|Productivitypropertypage.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com39Smart.
Templates-Pro!
Thistoolintroducesadvancedtemplatesconceptandoffersalotofnewpossibilitiesandusabilityfeatures.
Smart.
TemplatesmaybeinvokedusingusualCtrl+J(CUA)shortcutorbytypingtemplatenameandpressingTab(bydefault)key.
ThereisalsopossibilitytoexpandlastusedtemplatebypressingCtrl+Shift+J(CUA)shortcut.
Thisisusefuliftemplateisdefinedasonethatmaystoreandutilizeuserinputcollectedduringpreviousinvocation.
Thepurposeofthistoolisabilitytomaintain,easyfindandpastefrequentlyusedcodesnippets(templateshereafter)tothecurrentlyeditingdocument.
JBuilderbuilt-intemplatesrepresentsusualcodefragment,whichpastes"asis"andmaybeoptionallyformattedaccordingtoprojectcodestyle(built-intemplatesonly).
Suchatemplatesconceptsuitswellforsimpleneedswhileleavinglotsofmanualmodificationsofpastedcodeformostofcomplicatecases.
Smart.
Templatesprovidesallfunctionalityofferedbybuild-inJBuildertemplatesandcorrectlyindentsthecodefragmentandoptionallyformatsitaccordingtocurrentindentlevelandbraces'style.
Tominimazeeffortsneededtofittemplatestothedevelopers'needstheconceptofadvancedtemplatesisused.
Themaindifferenceofthisconceptisabilitytospecifytemplatefieldsinsidethecodesnippet.
Eachfieldisrepresentedbyitsownnameenclosuedby#signwrittenrightinthecodesnippet.
Inthiscasetemplateactsas"live"runningformratherthensimplecodefragment.
Ontemplateexpansion,allthecodeoutsidefieldsispastedexactlyasitisdefined,whilefieldsarerepresentedbyasetofeditorsthoseallowsenteringvaluesusingusualway.
Eachfield"editor"haseachownborderandthefocusedonehasthespecialborder,whichhighlightsit.
ThereisabilitytonavigatethroughallthefieldsusingtheTabandShift+Tabshortcuts.
TheEnterandShift+Entershortcutsallownavigatingthroughthefieldsskippingoneswiththesametype.
Figure31SmartTemplatewithFieldsIt'spossibletoinvokeanothertoolslikeMemberInsightforselectingvaluesoftemplatefields.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com40Figure32EnteringFieldValueUsingJBuilderMemberInsightThefollowingmajorfeaturesareapplicabletotemplatefields:Allthetemplatefieldsofsamenameareautomaticallysynchronizedthatallowenteringfieldvalueonlyonce;Abilitytospecifydefaultvalueorinitializationexpressionforatemplatefield.
Thedefaultvalueorresultofexpressionexecutionisautomaticallyassignedtothefieldontemplateexpansion;Abilitytospecifycalculatedexpressionforatemplatefield.
Thisallowsdynamicallycalculatefieldvaluetoreflectchangesmadebytheuserinthisfieldorintheotherones;Abilitytospecify"change"expressionforatemplatefield.
Thisallowsmakingsomeactionsafterthefieldischangedand/orcalculated.
Abilitytostorevaluesenteredinthetemplatefieldsandloadpreviouslystoredvaluesonthenexttemplateinvocation.
Thisallowstofillfieldsautomaticallyduringtheconsecutivetemplatecalls;Abilitytoutilizeselectedblockofcodeasfieldvalue.
Expandedtamplateentersthe"running"stateafterinvocationanduserisabletofilltemplatefiels.
ArunningtemplatecanbecompletedbypressingEsckey,changingcodeoutsideofanytemplatefields(ifappropriateoptionisturnedon)orbyfillingallfieldsandusingEnterkeytonavigatebetweenthem.
Afterthecompletionofrunningtemplate,allthecodewritteninthefield"editor'ispasteddirectlytothedocumentandtheeditorcaretisoptionallyplacedtothepositionspecifiedbylocationofpredefinedfield#|#(ifoneisincludedintotemplatedefinition).
Inaddition,theSmart.
Templatestoolintroducesthefollowingfeatures:Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com41Abilitytoshortenfull-qualifiednamesforclassesstatedinthetemplateandaddingappropriateimportstatementstothesourcefile;Abilitytousepreprocessorinstructionsthoseallowdynamicbuildingoftemplatecodeusingconditionalanditerationstatements;Abilitytoformattemplatecodeaccordingtothecurrentprojectcodestyleandcurrentindentlevel;Abilitytospecifysupportedfiletypes(Java,HMLetc)foranytemplate;Abilitytospecifysupportedcontext(e.
g.
"symbol","comment"or"string")foranytemplate;Abilitytoassignkeyboardshortcutforanytemplate.
Shortcutassignmentsfordifferentkeymapsaresupportedtoo.
PredefinedFieldsThefollowingtableoutlinespredefinedtemplatefieldswhichalwaysavailabletoanytemplatedefinition.
Productivity!
–PowerToolsTable4PredefinedTemplateFieldsFieldNameDescription|SpecifiesthelocationshouldbeusedforcaretaftertemplatecompletionselBlockInsertscontentofthecodeblockhasbeenselectedbeforethetemplateexpansion.
selBlock.
asCommentInsertsacodeblockhasbeenselectedbeforethetemplateexpansionandtransformsitintoaJavablockcomment.
selBlock.
asStringInsertsacodeblockhasbeenselectedbeforethetemplateexpansionandcorrectlytransformsittoaJavastring.
currentDateInsertscurrentdatestring.
currentDateTimeInsertcurrentdateandtimestring.
ExpressionsThemostpowerfulfeatureofSmart.
Templatesisabilitytospecifyexpressionsneededtobeevaluatedduringtemplateexecution.
Thisallowsdevelopingtruly"smart"anddynamictemplatesthosecanbeeasyadaptedtodevelopers'needs.
Ingeneral,anyexpressionshouldconformtoexpressions'definitionrulesinJavalanguageandcancontainsonlythefollowinglexemes:String,characterandnumericliterals;operators;Variables;Functionscalls;Openandcloseparenthesis;TheSmart.
Templatesprovidesautomatictypesconversionduringevaluationofexpressionssoexpressioncancontainsliterals,variablesandfunctionswithdifferenttypesand/orreturntypes.
Ifpossible,allthesedifferenttypeswillbecorrectlycased.
Thefollowingfunctionsareavailable:UtilityFunctionsFunctionsareincludedintothisgroupareintendedtosuitmiscellaneousutilitypurposes.
StringgetLocalVariableName(StringaType)Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com42Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com43Composesvariablenamebasedonpassedvariabletype.
Parameters:aType–stringthatrepresentsvariabletypeReturn:nameforvariablebasedonvariabletypeStringgetVariableInitValue(StringaType)Composesvariableinitializationvaluebasedonpassedvariabletype.
Parameters:aType–variabletypeReturn:variableinitializationvalue.
Itwillbe–1fornumerictypes,falseforbooleanandnullforanyotherJavatype.
TemplateFunctionsFunctionsareincludedintothisgroupallowgainingaccesstoanyfieldwithinrunningtemplate.
StringgetFieldValue(StringaName)ReturnscurrentvalueofthetemplatefieldParameters:aName–nameofthefieldReturn:valueofthefield;nulliffieldwithpassednameisnotfoundvoidsaveFieldValue(StringaName)SavesfieldvalueasstringtoallowitfutureuseParameters:aName–nameofthefieldvoidsaveFieldValueAsInteger(StringaName)SavesfieldvalueasintegertoallowitfutureuseParameters:aName–nameofthefieldObjectloadFieldValue(StringaName,ObjectaDefaultValue)ObtainspreviouslysavedfieldvalueParameters:Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com44aName–nameofthefieldaDefaultValue–optionaldefaultvalueReturn:previouslysavedfieldvalue;iffieldvaluewasnotsavedbeforeitreturnsaDefaultValueornullifdefaultvalueisnotspecified.
SystemFunctionsFunctionsfromthisgroupprovideaccesstosomeofsystempropertiesandresources.
StringgetSystemProperty(StringaName)ObtainsthevalueofsystempropertyParameters:aName–nameofsystempropertytogetReturn:valueofsystemproperty;nullifpropertywithsuchnameisnotfoundStringgetDate(StringaFormat)ObtainsstringrepresentationofcurrentdateaccordingtooptionalformatParameters:aFormat–optionalparameterthatdefinestheformofdateoutput.
Thevalidvaluesare"SHORT","MEDIUM","LONG","FULL".
Return:stringrepresentationofcurrentdateStringgetDateTime(StringaDateFormat,StringaTimeFormat)ObtainsstringrepresentationofcurrentdateandtimeaccordingtooptionalformatParameters:aDateFormat–optionalparameterthatdefinestheformofdateoutput.
Thevalidvaluesare"SHORT","MEDIUM","LONG","FULL".
aTimeFormat–optionalparameterthatdefinestheformoftimeoutput.
Thevalidvaluesare"SHORT","MEDIUM","LONG","FULL".
Return:stringrepresentationofcurrentdateStringFunctionsFunctionsfromthisgroupprovidedifferentstringmanipulationroutines.
StringtoUpper(StringaString)Convertspassedstringtouppercase.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com45Parameters:aString–stringneedtobeconvertedReturn:stringconvertedtouppercaseStringtoLower(StringaString)Convertspassedstringtolowercase.
Parameters:aString–stringneedtobeconvertedReturn:stringconvertedtolowercaseStringtoggleCase(StringaString)Convertspassedstringsoeachcharacterofitbecametoggledfromlowercasetoupperoneandviceversa.
Parameters:aString–stringneedtobeconvertedReturn:convertedstringStringtoConst(StringaLiteralValue)Composesnameforstringliteralbasedonpassedliteralvalue.
Itiscomposedas"C"styleconstantwherelocationsofunderscoresarematchtolocationsofcharactersinuppercaseintheliteralvalue.
Parameters:aLiteralValue–stringliteralvalueReturn:nameforstringliteralbasedonliteralvalueStringfromConst(StringaLiteralName)Composesvalueforstringliteralbasedonpassedliteralnameusingthesamerulesasforcomposingnameforliteralbasedonitsvalue.
Parameters:aLiteralName–stringliteralnameReturn:valueforstringliteralbasedonliteralnameStringcapitalize(StringaString)Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com46Capitalizesthefirstletterofpassedstring.
Parameters:aString–stringtocapitalizeReturn:capitalizedstringvalueStringdeCapitalize(StringaString)Decapitalizesthefirstletterofpassedstring.
Parameters:aString–stringtocapitalizeReturn:decapitalizedstringvalueStringsubString(StringaString,StringaStringToFind)Obtainsanewstringbytrimmingtherightpartofpassedonestartingfromoccurrenceofanotherstring.
Parameters:aString–stringtobetrimmedaStringToFind–stringtofindReturn:trimmedstringvalueStringgetConstPrefix(StringaName)Obtainstheprefixfromthepassedliteralname.
Parameters:aName–nameofliteralReturn:obtainedprefixorpassedliteralnameifprefixcan'tbeobtainedProjectandEditorDependantFunctionsFunctionsincludedintothisgroupprovideaccesstosomepropertiesoftheactiveprojectandtoinformationaboutcontextavailableforthecaretpositionoftheeditor.
StringgetProjectProperty(StringaName)ObtainsthevalueofpropertyofactiveprojectParameters:aName–nameofprojectpropertytogetReturn:valueofprojectproperty;nullifpropertywithsuchnameisnotfoundProductivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com47StringgetFullClassName()ObtainsthenameofJavaclassatcaretpositionReturn:full-qualifiednameofclassStringgetClassName()ObtainstheshortnameofJavaclassatcaretpositionReturn:shortnameofclassStringgetPackageName()ObtainsthepackagenameofJavaclassatcaretpositionReturn:packagenameSmart.
Templates.
InsightThistoolallowschoosingatemplatetoexpand.
Wheneditingafile,pressCtrl+J(CUA)toinvokeSmart.
Templates.
Insight.
TheSmart.
Templates.
Insightpopupwillbeshownwiththelistoftemplatematchingawordatthecursorposition.
Thelistmaybeemptyiftherearenomatchingtemplatesthough.
Tofindmatches,typeawordintheTemplateeditboxandSmart.
Templates.
Insightwilldynamicallyrearrangethelistoftemplatestoshowthematchingones.
YoucanalsoleavetheTemplateeditboxblanktoviewalltemplates.
Youcanselectatemplatenavigatingthroughthelistwiththehelpoftheusualkeyboard.
Analternativewaytodoitistocontinuetypingtheword;thelistselectionwillbechangedtoproducetheclosestmatchpossible.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com48Figure33Smart.
Templates.
InsightPopupWindowPresstheEnterkeywhenyouselectthetemplateandSmart.
Templates.
Insightwillexpandselectedone.
"OntheFly"SmartTemplatesThemainideaofsuchtemplatesisabilitytoquicklygenerateandusetemplatedefinitionbasedontheblockoftext.
Alltherepetitivetokensfromtheblockthosearenotpredefinedoneswillbereplacedbythetemplatefieldsdefinitions.
Thisapproachallowsusingtemplatesthoseneedoneorseveraltimesonlywithouthavingtomanuallymanagetemplatedefinitions.
Figure34SelectedCodeFragmentwillbeCopiedProductivity!
–PowerToolsFigure35TheSameCodeFragmentInsertedUsing"OnTheFly"TemplatesToinvoke"OnTheFly"templatebasedontheclipboardcontentpleaseuseAlt+Shift+J(CUA)shortcut.
Anotheroptiontoinvoke"OnTheFly"templateisusingClipboard.
Insight.
YoujustneedtoselectrequireditemfromthelocalclipboardlistandpressCtrl+Entershortcuttoinvoketemplatebasedonit.
OptionsDependencyYoucancontrolSmart.
TemplatesbehaviorandmanagethetemplatelistusingtheEditorOptions|Productivity|Smart.
Templatespropertypage.
Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com49Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com50Smart.
JavaDoc-Pro!
Creationandeditingofsourcecodedocumentationisanimportantpartofthedevelopmentprocess.
Unfortunately,JBuilderprovidesverybasicsupportforthissodeveloperisforcedtocreatetheentireJavaDoccommentsmarkupmanually.
Tosignificantlyincreaseproductivityofsourcecodedocumentationcreation,toreduceamountofpossibleJavaDocerrorsthosecanoccurduringthisprocessandtoinsurethatdocumentationisstillvalidafterperformedrefactoring,Productivity!
offersverypowerfultoolintendedtoprovidevisualJavaDocediting.
TheSmart.
JavaDoctooloffersrichJavaDoccreation,navigationandeditingfunctionality.
ItrepresentsadditionalviewerforJavafilesandisaccessibleviaappropriatetabatthebottomoftheeditor.
Figure36Smart.
JavaDocOverviewThemajorfeaturesofSmart.
JavaDocare:ClosetoWYSIWYGmodeofJavaDoccommenteditor(accordingtoHTMLoutputprovidedbystandardJavaDocdoclet);RichHTMLeditingcapabilities(Smart.
JavaDocdoesnotsupportwholesetofHTMLtags.
However,thesupportedsetisquiteenoughforcreationofprofessionalqualitydocumentation);AbilitytodiscoverandvisuallyhighlightJavaDocconflictsanderrors(suchasunsupportedtags,parametersandthrowsconflicts,missingtagsetc);AbilitytoeasilycorrectfoundJavaDocconflictsanderrors;Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com51RichfunctionalityofJavaDoccommentstructuremanagement(addingspecifictags,addingallrequiredtags,removingallinvalidandunusedtags,tagsrenamingmaybeperformedincoupleofclicks);ConvenientfunctionalityfornavigationandinstantaccessingmembersforwhichJavaDoccommentsshouldbecreated;AbilitytofiltermembersusedfordocumentationcreationviaadvancedJavaStructureComponent;Abilitytoperformtwo-wayeditingofJavaDoccomment–usingbothSmart.
JavaDocandusualJavasourceeditor;AbilitytobrowsesourcecodewhileeditingJavaDoc;AbilitytoinstantlygetpreviewofJavaDoccommentwillbegenerated;Sophisticatedmultilevelundo/redosupport;Smart.
JavaDocUserInterfaceTheSmart.
JavaDoctoolisanadditionalvieweravailableforJavafiles.
Itconsistsoftwomajorparts:JavaStructureView,whichallowsyoueasilynavigatebetweenmembersforwhichJavaDoccommentshouldbegenerated;JavaDocView,intendedtoprovideJavaDoccommenteditingandpreviewing;Figure37Smart.
JavaDocJavaStructureViewTheJavaStructureViewofferedbySmart.
JavaDocissimilartooneprovidedforJavafiles.
Themaindifferenceisthatallunimportantandnotsuitablemembersarefilteredoutfromitsview.
Therearetwoadditionalactions,thoseallowstonavigatetothenext/previousmemberofJavaStructureView.
TheseactionsmaybeinvokedusingCtrl+PageDownandCtrl+PageUpshortcuts,respectively.
PleasenotethattheseshortcutsareoperationalevenifJavaStructureViewisnotvisible.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com52TheJavaDocViewcontainstoolbarwithsetofactionsusedforJavaDocediting,theJavaDoceditorand,optionally,thepreviewpanel.
Figure38Smart.
JavaDocViewwithSourceCodeViewThereisabilitytoshowing/hidingofthepreviewpanelusingthebuttonontheSmart.
JavaDoctoolbar.
Thepreviewpanelconsistsoftwotabs.
TheSourceoneallowsyouquicklyviewsourcecodeforthecurrentlyeditedmemberaswellasforthewholefile.
TheHTMLtabcontainslivepreviewoftheJavaDoccommentthatwillbegeneratedforcurrentmember.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com53Figure39Smart.
JavaDocViewwithJavaDocCommentPreviewTheJavaDoceditorpanelincludessetofeditors(oneeditorperoneJavaDoctag).
Eacheditororeditors'groupislabeledwiththenameofthetagitbelongsto.
Tonavigatetothenext/previoustageditor,theTab(orCtrl+Down)/Shift+Tab(orCtrl+Up)shortcutsareprovidedrespectively.
JavaDocEditingUsingSmart.
JavaDocTheSmart.
JavaDoctooloffersrichfunctionalityforWYSIWYGeditingoftheJavaDoccommentinformclosetoonewillbegeneratedbystandardJavaDocdocletand,inturn,renderedbyHelpViewer.
EditingofJavaDocisstartedbyactivationofSmart.
JavaDocusingappropriatetabatthebottomoftheeditor.
Smart.
JavaDocfirsttriestodiscovermemberinthecurrentcaretpositionandofferseditingofJavaDoccommentforit.
IftherearenoJavaDoccommentexistsforthecurrentsourcecodemember,thedefaultJavaDoctemplateforallsuitabletagsisoffered.
IfJavaDoccommentexists,Smart.
JavaDocwillshoweditorsonlyfortagsdefinedinit.
ChangesmadebyuserwhileeditingtheJavaDoccommentarewrittentothesourcefileonclosingtheSmart.
JavaDoctab,onselectionofanothermember(class,fieldormethod)orbysavingthedocument.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com54PleasenotethatSmart.
JavaDocmayperformconversionofsomeunsupportedtagsfoundinJavaDoccomment.
ThefollowingarelimitationsofSmart.
JavaDocregardingsupportofHTMLtags:1.
Smart.
JavaDocdoesn'tsupportthefollowingHTMLtagssoitskipsandignoresthem,,,,,,,,,,,,2.
ThefollowingtagsarepartiallysupportedbySmart.
JavaDoc–theywillbedisplayedbutinsomecasestheymaybeeditedincorrectly:,,,,,,,3.
Thereissetoftagsthosewillbereplacedbyequivalentones:OriginaltagReplacingTag4.
Smart.
JavaDocdoesnotsupportnestingofcontainertagslike,,,,,,.
IfJavaDoccommenttobeeditedcontainssuchnestedstructures,theywillbetranslatedtolinearones,ifpossible;5.
Ifthecolorattributesarenotsetforthefollowingtags,Smart.
JavaDocartificiallyaddsthemtoallowvisualrecognitionofthetagscontent.
TheseartificialcolorsaretemporaryonesandwillnotappearintheresultingJavaDoc.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com55TagColorAssignedGreenMaroonBlueNavy6.
Smart.
JavaDocdoesn'tsupportparagraphalignattributesforthefollowingtags:,,,Also,pleasenotethatSmart.
JavaDocconsidersallwordsstartingfrom@asJavaDoctags.
Smart.
JavaDocToolbarMostoftheactionsaccessibleforJavaDoceditingareprovidedbySmart.
JavaDoctoolbar.
Figure40Smart.
JavaDocToolbarThefollowinggroupsofactionscanbefoundintheSmart.
JavaDoctoolbar:Tags–actionsgroupprovidesabilitytomanipulatetheJavaDocstructurebyadding,editingorremovingparticularJavaDoctags.
Figure41AddingRequiredTagsFont-actionsgroupprovidesabilitytoapplyappropriatefontsizeandfamilytothecurrentlyselectedblockoftext;Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com56FontStyle–actionsgroupprovidesabilitytoapplyappropriatefontstyle(bold,italic,underlineandsubscript/superscriptones)tothecurrentlyselectedblockoftext;Figure42ApplyingSubscriptStyleFormatPainter–atoolissimilartoonecanbefoundinMicrosoftWord.
Allowsperformingofquickcopyingofformattingstylefromonetextfragmenttoanotherone;ParagraphAlignment–actionsgroupprovidesabilitytosetalignmentofparagraph;BulletsandNumbering–actionsgroupprovidesabilitytoconvertcurrentlyselectedcodefragmenttoalist(eithernumberedorunnumbered);Figure43ListStyleSelectionIndents–actionsgroupthatprovidesabilitytoincreaseordecreasetheindentlevelofthecurrentparagraph;Figure44ControllingIndentLevelInsertObjects–actionsgroupthatprovidesabilitytoinsertvariousHTMLobjects.
Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com57Figure45InsertingSpecialObjectsThefollowingobjectsaresupported:a.
Link-correspondstotheJavaDoc@linktag.
TheuserisabletospecifypropertiesofanewlinkorchangethemforexistingonebyusingLinkPropertiesDialogFigure46LinkPropertiesDialogb.
Hyperlink–correspondstoHTMLtag;c.
Horizontalline–correspondstoHTMLtag;d.
LineBreak-correspondstoHTMLtag;e.
Border–appliesappropriateHTMLstyletothecurrentparagraph;f.
Image–correspondstoHTMLtag.
TheuserisabletospecifypropertiesofanewlycreatedimageorchangethemforexistingoneusingtheImagePropertiesDialogProductivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com58Figure47ImagePropertiesDialogg.
InsertSymbol–allowstoinsertspecialsymboltoJavaDoccommentusingtheInsertSpecialSymboldialogFigure48InsertSpecialCharacterDialogColors–actionsgroupwhichprovidesabilitytospecifyforegroundandbackgroundcolorfortheselectedfragmentofcode;Options–providesabilitytoenable/disabledisplayingofthepreviewpanel;Navigation-includestwoactionsthoseallownavigationtothenext/previousmemberofJavafile.
TheseactionsmaybeinvokedusingCtrl+PageDownandCtrl+PageUpshortcuts,respectively.
BlockStyle–actionsgroupwhichprovidesabilitytospecifystyleofthetextblock–paragraph(),preformattedblock(),code()orvariablewidth();Productivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com59Figure49TextBlockStyleSelectionThereisabilitytospecifywhichactionsgroupshouldbevisibleontheSmart.
JavaDoctoolbarusingthetoolbarcontextmenu.
Figure50ControllingSmart.
JavaDocToolbarJavaDocErrorsHighlightingTheSmart.
JavaDoctoolprovidesrichfunctionalitythatallowsdetectingwhethererrorsorconflictsbetweenJavacodedefinitionandcorrespondingJavaDocexist.
Ifsomeerrororconflictisdetected,Smart.
JavaDochighlightsappropriateelementusingtheunderlinewithstyleandcolorcorrespondingtotheissuepriority.
ThereasonProductivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com60ofthehighlightedissuecanbefoundinthehintthatappearswhenmousecursorisplacedoverthehighlightedelement.
Figure51JavaDocCommentsErrorsDetectionThestyleoftheissuehighlightisdefinedbysettingscanbefoundontheEditorOptions|Productivity!
|Smart.
JavaDocpropertypage.
Youcaneasilyfixfounderrorsutilizingappropriatecommandsavailablefromthepopupmenuorfromtoolbar.
Usingthemyoucanadd,removeoreditrequiredJavaDoctags.
Smart.
JavaDocShortcutsTherearealotofactionsprovidedbySmart.
JavaDocthoseareaccessibleusingkeyboardshortcuts.
Thefollowingtablesummarizestheseactionsalongwithcorrespondingshortcuts.
Table5Smart.
JavaDocKeyBindingsActionShortcutCopytoclipboardCtrl+CCuttoclipboardCtrl+XPastefromclipboardCtrl+VSelectallCtrl+AInsertnewparagraph/InsertnewlineinthePREblockEnterWordleftCtrl+LeftWordrightCtrl+RightSelectwordleftCtrl+Shift+leftSelectwordrightCtrl+Shift+RightGotostartoflineHomeGotostartofdocumentCtrl+HomeProductivity!
–PowerToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com61GotoendoflineEndGotoendofdocumentCtrl+EndSelecttolinestartShift+HomeSelecttodocumentstartShift+Ctrl+HomeSelecttolineendShift+EndSelecttodocumentendShift+Ctrl+EndGotolineaboveUpGotolinebelowDownSelecttolineaboveShift+UpSelecttolinebelowShift+DownIncreaseparagraphindentCtrl+TabDecreaseparagraphindentCtrl+Shift+TabGotothenexttagTaborCtrl+DownGototheprevioustagShift+TaborCtrl+UpGotothenextmemberCtrl+PageUpGotothenextmemberCtrl+PageDownOnlinkorimage–activatepropertyactionOtherwise–selectparagraphMouse-double-clickSetselectedtextBOLD/DEFAULTCtrl+BSetselectedtextITALIC/DEFAULTCtrl+ISetselectedtextUNDERLINE/DEFAULTCtrl+UInsertHorizontalruler()Ctrl+LInsertlinebreak()Ctrl+EnterFormatpainterMouseclick–tocopyformat,mouseclicktopasteformat,EscorclickonbuttontoclearProductivity!
–EditorEnhancementsEditorEnhancementsTheoverallproductivityofdevelopergreatlydependsonsourcecodeeditor.
That'swhyProductivity!
includesseveraltoolsthoseenhancesbuilt-inJBuildereditorandallowstogainProductivity!
usersevenhigherlevelofproductivity.
Thesetoolsmaybeseparatedonseveralcategories:Codeeditingimprovements-Smart.
Clipboard,Auto.
Indent,Smart.
Selection,Smart.
Bracestools;Matchingelementshighlights-Smart.
Braces.
Highlight,Matching.
Code.
Highlighttools;Usabilityimprovements-ThumbnailGutter,Smart.
Gutter,AdvancedTextViewStatusBar,LineNumberstools;Editorlookandfeelimprovements-MethodsandClassesSeparator,ChangesHighlight,ClassesHighlighttools;Smart.
Clipboard-Pro!
Thistoolintroducesthereplacementforstandardclipboardactionsandoffersanumberofimprovementsandnewfeatures.
PasteActionIngeneral,thisactionactsasusualPasteactionbut,inaddition,alsoallowsmakingthefollowingactions:AutoindentationofJavacodeduringpasteoperationaccordingtotheindentlevelatthepointofpasting;Automaticallyinsertionofappropriateimportstatementsonpasteforclassesusedinthecopiedfragment(ifclipboardcontentwascopiesfromJBuildereditorwithJavacode).
Copy/CutActionsIngeneral,thoseactionsactsasusualCopy/Cutactionsbuttheyallowsmakingthefollowingadditionalactions:Collectinginformationaboutclassesusedinthecopied/cutcodefragment.
Storingthecopied/cutcodefragmentinthelocalclipboardqueuethatallowsfutureuseofseveralcodefragments.
SwapActionThisactionallowsswappingthecontentoftheclipboardwithcurrentlyselectedblockofcode.
ItcanbeinvokedusingtheCtrl+Shift+Insert(CUA)shortcut.
Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com62Productivity!
–EditorEnhancementsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com63PopPasteActionThisactionallowsconsecutivepoppingandpastingofcodefragmentsfromthelocalclipboardhistoryintheLIFOorder.
ItcanbeinvokedusingtheCtrl+Alt+Insert(CUA)shortcut.
Clipboard.
InsightThistoolallowsviewingoflocalclipboardqueueandpastingoneorseveralselectedfragmentsintheeditor.
Wheneditingafile,pressAlt+Shift+V(CUA)toinvokeClipboard.
Insight.
TheClipboard.
Insightpopupwillbeshownwiththelistofcodefragmentscopied/cuttoclipboardduringtheJBuildersession.
Figure52Smart.
Clipboard.
InsightWindowAlongwithClipboardContentPopupYoucanselectacodefragmentnavigatingthroughthelistwiththehelpoftheusualkeyboard.
Clipboard.
Insightlistsupportsmultiselectionfeature,thusit'spossibletopasteseveralitemsatonce.
Todothis,selectthecodefragmentsshouldbepastedusingtheCtrlkeyandmouseandthenpresstheEnterkey-Clipboard.
Insightwillinsertallselecteditems.
It'spossibletocontroltheorderofinserteditems.
HoldingChiftwhilepressingEnterwillleadtoinsertingselecteditemsinreverseorder.
OptionsDependencyYoucancontrolthebehaviorofSmart.
ClipboardusingtheEditorOptions|Productivity!
|Toolspropertypage.
Smart.
Selection-Pro!
TheSmart.
SelectiontoolrepresentssetofseveralselectionenhancementactionsthoseallowtosimplifyselectionoperationswhileeditingJavafiles.
Thefollowingactionsareprovided:Selectionofthewholecodeblock,statement,methodorclass.
TheseactionsareavailableintheeditorcontextpopupmenuaswellasintheJBuildermenubar.
TherearenodefaultkeybindingsfortheseactionsbutyouareabletoeasyassignthemusingtheKeyMapeditor.
Productivity!
–EditorEnhancementsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com64ExpandingSelectionCtrl+W(CUA)andNarrowingSelectionCtrl+Shift+W(CUA).
TheseactionsarealsoavailableineditorcontextpopupmenuandintheJBuildermenubaraswell.
Theyallowtoexpand/narrowcurrentselectionincrementallytoouter/innersourceelementrespectively.
Theapproximateorderofselectionsisasfollows(theexactonedependsoncurrentstructureoftheJavacodeandcurrentcaretposition):oWordundercursor;oExpression;oStatement;oCodeblockoEnclosingstatementsandcodeblocks;oMethod;oClass;oWholefile.
Smart.
Gutter-Pro!
TheSmart.
Gutterisagutterplacedattheleftsideoftheeditor(andrightfromJBuildereditorgutter)anditisintendedtoshowmiscellaneoushintsconcerningcorrespondingJavacodebyarrangingappropriateguttermarks.
TheSmart.
GutterallowsviewingtooltipsthoseshowdescriptionofaSmart.
Guttermarkwhenmousecursorismovingoverit.
Optionally,anySmart.
Guttermarkcanprovideoperationsapplicabletothecorrespondingcode.
Ifthereisatleastoneoperationavailable,thesignisshownattheleftofaguttermark.
Inthiscase,mousecursorischangedtothehandoneandtheoperationscanbeexecutedbymousebuttonclick.
Themosttypicaloperationisnavigationtosomepieceofcoderelatedsomewaytothecodecorrespondingtothemark.
Figure53Smart.
GutterTheSmart.
Guttermarksarecurrentlysupportedforthefollowingcases:-Thereismethodoverriding;Productivity!
–EditorEnhancementsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com65-Thereisdeclarationofconstructorwiththesamesignatureastheonedefinedinthesuperclass.
-Thereisabreakstatement.
-Thereisacontinuestatement.
-Thereisareturnstatement.
-Thereisathrowstatement.
Figure54Smart.
GutterMarksShow/HideButtonThereisabilitytoturnSmart.
Guttermarkson/offusingthebuttonintheViewToolbar.
ThumbnailGutter-Pro!
TheThumbnailGutterisanadditionalgutterattherightsideoftheview.
It'sintendedtoquicklyprovideinformationaboutstateofthecurrentlyeditedJavasourcefile.
Unliketothebuilt-inJBuildergutter,ThumbnailGutteralwaysshowsguttermarksforthewholesourcefile.
Supportedguttermarksareerrors,warningsandToDos.
Figure55ThumbnailGutterInaddition,thegutterallowsquicknavigationtoacorrespondingcodeissuebysinglemousebuttonclick.
Productivity!
–EditorEnhancementsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com66Figure56ThumbnailGutterwithHintforErrorThisguttershowsdistributionofcodeissuesalongthewholefile.
Also,itallowsquicklygetinformationaboutparticularmarkusinghintthatappearsifmousecursorisplacedoverappropriateguttermark.
ThereareseveraladditionalfeaturesprovidedbyThumbnailGutter:Abilitytonavigatetoanypositionwithinfileusingmousebuttondouble-clickinthedesiredlocationonthegutter;Statusiconatthetopofthegutter,whichshowsthestatusofthefile.
Therearefollowingstatuses:oOK-noerrorsorwarningsfound;oErrors–anyerrorsfound;oWarnings-anywarningsfound;oRunning–Codeisbeinganalyzed.
Assistanticonatthebottomofthegutter,whichprovidersaccesstoAssistantsmenuthatallowscontrollingofCodeAssistantandInfoAssistantstatus;Abilitytodisplayboundsoftheclasswhichcaretpositionbelongsto.
Thisfeatureallowsinstantlyunderstandwhethererrorsandwarningsexistthosearerelatedtothatclass.
ClassesHighlight-Pro!
ClassesHighlightisatoolintendedtohighlightclassesusedinthecode.
Ituses"Extrakeyword"stylesotoseeitinactionpleasecustomizethisstyle(tomakeitdifferentfrom"Identifier"style)usingtheEditorPreferences|Editor|Color|Javapropertypage.
Productivity!
–EditorEnhancementsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com67Figure57ClassesHighlightBydefaultall(*)classesarehighlightedbutit'spossibletospecifywhichclassesshouldbehighlighted(e.
g.
java.
*;javax.
*;)foreachprojectusingtheProjectProperties|Productivity|Toolspropertypage.
AdvancedTextViewStatus-Pro!
Productivity!
includesenhancededitorstatusbarintendedtoprovidemoreinformationaboutthecurrentstatusoffileintheeditoraswellastosimplifynavigationoperations.
Figure58AdvancedTextViewStatusBarTheAdvancedTextViewStatusprovidesallfunctionalityofbuilt-inJBuilderstatusbarandoffersthefollowingadditionalfeatures:Displayingnameofclasscorrespondstocaretposition(Javafilesonly);Nameofmethodcorrespondstocaretposition(Javafilesonly);Caretposition(offsetofcaretlocationwithineditordocument);Numberoflinesineditordocument;Abilitytoinstantlychangeread-onlystatus(iffileisnotmodifiedandisstoredinfilesystem)usingmousedoubleclickonfilestatuslabel;Abilitytochangeinsert/overridestatususingmousedoubleclickoninsertstatuslabel;AbilitytoinvokeJBuilder"Gotolinenumber"dialogusingmousedoubleclickoncaretpositionorcaretlocationlabel;AbilitytoinvokeBrowse.
Insightpopupusingmousedoubleclickontheclassnamelabel(ifoneisvisible);Productivity!
–EditorEnhancementsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com68AbilitytoinvokeBrowse.
Memberspopupusingmousedoubleclickonthemethodnamelabel(ifoneisvisible);AbilitytocustomizesetoflabelsshouldbevisiblewithinAdvancedTextViewStatususingpopupmenuwhichcanbeinvokedusingrightmouseclickonanystatuslabel;Smart.
BracesSmart.
Bracesisatoolthatallowseasycreationofmatchingbracesrightwhileyouaretyping.
JusttypeanopeningbraceandSmart.
Braceswillautomaticallyaddtheclosingone.
Inadditiontobracescompletion,Smart.
Bracessupportscompletionofstringandcharacterenclosingsymbols-"and',respectively.
Smart.
Bracesaddsclosingcharactersaftertheopeningonesforallcharactersexceptcurlybraces;theclosingcurlybraceisinsertedintothenextlineandmayrequireanadditionalline,forthecursorwiththeappropriateindenttobeplaced(accordingtotheCompletecurlybraceandindentoption).
OptionsDependencyYoucancontrolthebehaviorofSmart.
BracesusingtheEditorOptions|Editor|EditorOptionstreeview-expandtheSmart.
Bracesoptionsnodeandturnonoroffoptionsyouneed.
Withanon-standardJBuilderkeymapused(suchasVi/VIM),Smart.
Bracesmayconflictwithkeymapsettings.
Apparently,fortheVIkeymap,'and"symbolsmaybeoverriddenbySmart.
Braces.
Thereasonofsuchbehaviorliesinthefeaturesoftheviimplementation(notabsolutelycorrectimplementationoftheKeymapdefaultaction).
However,youcandisablethepartoftheSmart.
Bracesfunctionality,whichleadstotheconflict.
Todothis,pleaseaddthefollowinglinestoyourJBuilder.
configfile(locatedintheJBuilder/bindirectory):vmparam–DProductivity.
Smart.
Braces.
CompleteCharacters=novmparam–DProductivity.
Smart.
Braces.
CompleteStrings=noMatching.
Code.
Highlight-Pro!
NOTE:Javaiswell-structuredlanguage,butseveralstatementsexiststhatgreatlydecreasereadabilityoftheprogram–thoseones,whichbreaksnormalcodeflowexecution.
Insomecases,especiallyifsourcecodeiswrittenbyanotherdeveloper,itcanbehardtounderstandtowhichstatement,forexample,breakonepointstoo.
Thesituationbecomeevenworseifthesebreakstatementhaslabelandlabeledstatementisfarfrombreakone.
TheMatching.
Code.
Highlightbecomereallyinvaluableinsuchsituations.
Matching.
Code.
Highlighttoolprovideshelpinsourcecodeinvestigationandhelpstounderstandwhichcodeismatchingtooneatthecaretposition.
Inaddition,thistoolprovideseasynavigationtoit.
Productivity!
–EditorEnhancementsProductivityCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com69Figure59Matching.
Code.
HighlightItintroducesthefollowingfeatures:Abilitytohighlightthebreaktargetstatementsforreturn,break,labeledbreak(break),continue,andlabeledcontinue(continuestatements);AbilitytohighlightmatchingcodeusingdottedpathwitharrowontheGutter;Abilitytoviewmatchingbracecodewhenit'shasbeenscrolledoutofview.
Thespecialpopupwindowshowsthematchingcodeinthetopoftheeditor;AbilitytonavigatetomatchingcodeusingCtrl+Shift+\(CUA)shortcut.
OptionsDependencyYoucancontrolthebehaviorofMatching.
Code.
HighlightusingtheEditorOptions|Productivity!
|Toolspropertypage.
Usingthispageyouareabletospecifywhetherthecodepopupwindowshouldbedisplayedaswellastosetthepopupwindowinvocationdelay.
Smart.
Braces.
Highlight-Pro!
TheSmart.
Braces.
Highlighttooloffersmatchingbraceshighlightandnavigationoperations.
!
UserManualProductivity!
–EditorEnhancementsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com70Figure60Smart.
Braces.
HighlightwithhintwindowThemajorfeaturesofSmart.
Braces.
Highlightare:Abilitytofindandhighlightmatchingbracewhenthecaretisplacedatanysideofabrace;AbilitytonavigatetothematchingbraceusingonlyoneshortcutCtrl+Backslash(CUA)foropeningandclosingones;Abilitytoviewmatchingbracecodewhenit'shasbeenscrolledoutofview.
Thespecialpopupwindowshowstheopenbracecodeinthetopandclosebracecodeinthebottomoftheeditorcorrespondingly.
Pleasenotethattheclosebracecodecanbeshownfortry/catch/finalanddo/whilestatementsonly;AbilitytoshowmatchingbracesscopeontheGutter.
OptionsDependencyTheSmart.
Braces.
HighlightbehaviorcanbecontrolledusingtheEditorOptions|Productivity!
|Toolspropertypage.
Changes.
Highlight-Pro!
TheChanges.
Highlighttoolhighlightschangedlinesofcodeusingthespecialmarksinthegutter.
Themainfeaturesare:Changemarkscantrackamountofchangesintheparticularlineofcodeandreflectthenumberofthemusingdifferentcolors.
Thus,moretimeslinewasedited,morebrightcolorwillbeusedtohighlightchanges;Fullsupportofundo/redofunctionalityaswellasre-readingofdocument;FullsupportofMVCarchitecturethatallowtrackingandshowingchangesinthedocumentacrossdifferentviewsandbrowsers.
Figure61Changes.
HighlightandCurrentLineHighlightCurrentLineHighlight-Pro!
TheCurrentLineHighlightincreasesusabilityoftheJBuildereditor.
Asitfollowsfromitname,thistoolsimplyhighlightsthelineofcodeatthecaretpositionusingspecifiedbackgroundcolor.
Productivity!
–EditorEnhancementsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com71Figure62CurrentlinehighlightingswitchLinehighlightingcanbeturnedon/offusingthebuttonfromtheViewToolbar(onethatisplacedattheleftbottomoftheeditornearhorizontalscrollbarleftcorner).
ClassesandMethodsSeparator-Pro!
ThisisanothertoolincludedintoProductivity!
intendedtoincreasereadabilityoftheJavasourcecode.
Itvisuallyseparatesclassesandmethodsfromeachotherbypaintinghorizontallineatthetopofcorrespondingclassesandmethodsdeclarations.
PleasenotethatthisfeaturedependsontheerrorsinJavasourcefile.
IftherearesomeseveresyntaxerrorstheJavasourcecodeparserisunabletoparsecodecorrectly.
Insuchacasesomeofthedividersmaybedisplayedincorrectly.
Figure63VisualseparationofMethodsandClassesProductivity!
–IDEImprovementsIDEImprovementsProductivity!
offersrichsetofpowerfulJBuilderIDEimprovements,intendedtoincreaseJBuilderusability.
Thesetoolscoversverycommontasksandallowssignificantlyminimizetimerequiredfortheircompletion.
Thesetoolshelpinsolvingofthefollowingtasks:SynchronizationofcurrentlyopenedfilewithappropriatenodeintheJBuilderProjectView–ProjectViewSynchronizer;GettingmoredetailedinformationaboutJavafilestructureaswellasfilteringofJavaStructurecontent–AdvancedJavaStructure;SynchronizationofthecurrentcaretpositionintheeditorwithJavacodewithappropriatestructureelement–JavaStructureSynchronizer;Quickobtaininginformationaboutread-onlystatusoffileandchangingit–Change.
ReadOnly;ProjectViewSynchronizer-Pro!
TheProjectViewSynchronizerprovidesabilitytosynchronizefileiscurrentlybeingeditingwiththecorrespondingnodeintheJBuilderProjectView.
ThereispossibilitytohavecontinuoussynchronizationthatautomaticallytracksthechangingofthecurrentfileandfindscorrespondingnodeintheProjectView.
Figure64ForceProjectViewSynchronizerButtonFigure65ProjectViewSynchronizerButtonsIfcontinuoussynchronizationisdisabled,thereisanabilitytoforcesynchronizationmanually.
ProjectViewSynchronizerbehaviorcanbecontrolledusingandViewToolbarbuttonsplacedattheleftbottomoftheeditor(nearhorizontalscrollbarleftcorner).
Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com72Productivity!
–IDEimprovementsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com73OptionsDependencyTheProjectViewSynchronizerbehaviorcanbecontrolledusingtheIDEOptions|Productivity!
propertypagewhichmaybeusedtospecifyifallnodesexceptthecurrentoneshouldbecollapsedafterProjectViewSynchronizerinvocation.
StructureViewSynchronizer-Pro!
ThistoolallowssynchronizingofJavastructureelementatthecaretpositionintheeditorwiththecorrespondingelementintheJavaStructureView.
ThereispossibilitytohavecontinuoussynchronizationthatautomaticallytrackscaretpositionchangesandfindscorrespondingelementintheStructureView.
Ifcontinuoussynchronizationisdisabled,thereisanabilitytoforcesynchronizationmanually.
Figure66JavaStructureSynchronizerButtonsFigure67JavaStructureSynchronizerButtonsStructureViewSynchronizerbehaviorcanbecontrolledusingtheandViewToolbarbuttonsplacedattheleftbottomoftheeditor(nearhorizontalscrollbarleftcorner).
Change.
ReadOnly-Pro!
Thistoolallowseasyviewingandmanagingread-onlystatusforfilenodes.
Themainfeaturesare:Abilitytochangeread-onlystatus(iffileisstoredinfilesystem)foroneoranyfilesusingpopupmenuonviewertab,filenodeintheProjectVieworbymousedoubleclickonappropriatepanelinstatusbar(thelastapproachisapplicabletoJavafilesonly);Abilitytohighlightread-onlystatususingreddotinthetop-rightcornerofthenodeicon(forJavafiles);Abilitytohighlightmodifiedstatususingbluedotinthetop-rightcornerofthenodeicon(forJavafiles);Abilitytotrackouterchangesofread-onlystatusaswellasfilemodifications.
Productivity!
–IDEImprovementsFigure68JavaStructureSynchronizerButtonsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com74Productivity!
–NavigationToolsNavigationToolsProductivity!
offersrichsetofpowerfultoolsintendedtosimplifynavigationandallowquickfindingofrequiredinformation.
Thereareseveraltypesofnavigationaresupported:Navigationtoappropriateclassusingshortclassname-Browse.
Insight;QuicknavigationtoappropriatememberofJavaClass–Browse.
Members;Navigationtoparticularsymboldefinition–Hyperlink.
Navigate;Navigationtoappropriatebookmarkineditor–Persistent.
Bookmarks;Navigationanditerationtosourcecodeelement(class,method,fields)codeissue,to-docommentofsearchresult–ViewNavigatorandNavigator;Browse.
InsightBrowse.
InsightallowsquickfindingJavaclasseswithshortnamescorrespondingtothewordatthecursorposition,browsingthemoropeningtheappropriatehelptopicforthem.
Figure69Browse.
InsightPopupWindowToinvokeBrowse.
InsightpressCtrl+Minus(CUA).
TheBrowse.
Insightpopupwillbeshownwiththelistofclassesmatchingthewordatthecursorposition.
Thelistmaybeemptyiftherearenomatchingclassesthough.
Tofindmatches,typeawordintheBrowseClasseditboxandBrowse.
Insightwilldynamicallyrearrangetheclasses'listtoshowthematchingones.
Youcanselectaclassnavigatingthroughthelistwiththehelpoftheusualkeyboard.
AnAlternativetodoitistocontinuetypingtheword;thelistselectionwillbechangedtoproducetheclosestmatchpossible.
Browse.
InsightActionsPressEnterwhenyoufindtherequiredclassandBrowse.
Insightwillopenthisclassinthebrowser.
Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com75Productivity!
–NavigationToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com76PressCtrl+EnterwhenyoufindtherequiredclassandBrowse.
Insightwillopentheappropriatehelptopicforit.
Also,thereisapossibilityofemployingtheBrowseClassesdialog,whichshowspackagesstructureandallowschoosingaclassbyspecifyingitsfullpath.
Youcanusetheappropriatebuttoninthetopleftcornerofthepopuptoinvokeit.
OptionsDependencyPleasenotethatthesetofclassesshowninBrowse.
InsightdependsonPackagesExclusionsettingsontheProjectProperties|Productivity!
|Generalpropertypage.
YoucanadjustthewayofclassessortingaswellasthealgorithmusedforclassessearchusingtheEditorOptions|Productivity!
|Generalpropertypage.
There,usingtheProductivity!
InsightsUsageoption,youcanspecifywhetherProductivity!
Browse.
InsighttoolorJBuilderbuilt-inBrowseclassesshouldbeinvoked.
Browse.
MembersBrowse.
Membersallowsquickfindingmembersbelongingtothecurrentdiscoveredcontextandbrowsingthem.
Figure70Browse.
MembersPopupWindowPressAlt+Minus(CUA)wheneditingafiletoinvokeBrowse.
MembersInsight.
TheBrowse.
Memberspopupwillbeshownwiththelistofmembers(eitherclasses,methodsorfields)matchingthewordatthecursorposition.
Thelistmaybeemptyiftherearenomatchingmethodsthough.
Tofindmatches,typethewordintheBrowseMembereditboxandBrowse.
Memberswilldynamicallyrearrangethemembers'listtoshowthematchingones.
YoucanalsoleavetheBrowse.
Memberseditboxblanktoviewallthemembersfornavigationpurposes.
Browse.
Membershighlightsthememberswithnamesexactlymatchingthetypedwordusingboldfontandabstractmethodsusingitalicfont.
Youcanselectamemberbynavigatingthroughthelistwiththehelpoftheusualkeyboard.
AnAlternativewaytodoitistocontinuetypingtheword;thelistselectionwillbechangedtoproducetheclosestmatchpossible.
PressEnterwhenselectingamemberandBrowse.
Memberswillbrowseit.
Productivity!
–NavigationToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com77Hyperlink.
NavigateHyperlink.
NavigateisatoolallowingeasyandconvenientnavigationwithamethodsimilartothatoftheJBuilderbuilt-inSymbolInsighttool.
Figure71Hyperlink.
NavigatewithHintthatDescribesIdentifierUnderCursorToinvokeHyperlink.
Navigate,pressandholdtheCtrlkeypointingthemouseovertheidentifieryouaregoingtonavigateto.
Ahyperlinkwillappear,andifyoupresstheleftmousebutton,JBuilderwillnavigatetoit(inthesamemannerasSymbolInsightdoes).
IfyouplacethemouseovertheidentifierwiththeCtrlkeypressed,aftersomedelaytheHyperlink.
Navigatepopupappearsthatcontainsinformationaboutthesymbolunderthecursor.
OptionsDependencyYoucancustomizedelaysusedforinvocationandclosingoftheHyperlink.
NavigatepopupwindowusingtheHyperlink.
NavigateDelaysoptionsontheEditorOption|Productivity|Delayspropertypage.
Also,youcanspecifywhetherHyperlink.
NavigateshouldbeinvokedduringadebugsessionusingtheInvokeinsightsduringdebuggingoptionontheEditorOption|Productivity|Usagepropertypage.
SearchResultsandReferencesHighlight-Pro!
Thistoolisintendedtohighlightintheeditorvariousthingsfoundduringsearchorfindreferencesoperations(thosethingsshouldbelistedinthemessagepaneaswell).
Toplacehighlightsthespecialbuttonontheviewtoolbarshouldbeused.
Ifnothingselectedinthemessagepanethistoolusesthemostrecentsearchresultsrelatedtothecurrentfile.
Butit'spossibletoexactlyspecifyresultsettohighlightbyselectingrootnodeinthesearchtree(e.
g.
"Directusages"or"Declarations").
TonavigatethroughthehighlightsusualNavigatorkeys(Ctrl+PageUp/PageDown(CUA))areused.
Productivity!
–NavigationToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com78Figure72SearchResultsandReferencesHighlightPersistentBookmarks-Pro!
JBuilderprovidesbookmarkfunctionalitythatallowstosetbookmarkassociatedwithparticularlineofthefileandthereturntoit.
However,JBuilderbuilt-inimplementationoftheeditorbookmarkshassomedrawback–allbookmarksareactuallyassociatedwitheditors,notwithfilesthusbookmarksarenotpersistentbetweenJBuildersessions.
ThePersistent.
BookmarkstoolincludedintoProductivity!
isfreefromdrawbacksmentionedaboveandintroducesadvancedbookmarksconceptaswellasofferslotsofnewpossibilities.
Eachbookmarkislinkedtoaproject(ifany)andtoafileandisholditsownlocation(aslinenumber)inthefileaswell.
EverybookmarkcanoptionallycontaintheDescriptionattributethosecanbespecifiedtoalloweasyidentifyingofparticularbookmark.
Therearetwotypesofbookmarksarecurrentlysupported–persistentonesandtemporaryones.
AllbookmarkswithPersistentattributeenabledarestoredtotheIDEpropertiesonJBuilderexitand,correspondently,allsuchbookmarksareloadedduringthefollowingJBuilderrun.
Thisbehaviorallowspointingtothemostusedfilesandeasynavigatingthemanytime.
Thefollowingactionscanbeexecutedduringnavigatingtoapersistentbookmark:1.
Ifparticularbookmarkcontainsreferencetoaprojectthisprojectwillbeopened(ifitstillnotopenedyet)andactivated;2.
Thefilewhichbookmarkreferstowillbeopened(ifitstillnot)andactivated;3.
Ifbookmarklocationwithinfilehasavalidvalue,theeditorwillbescrolledtothebookmark'location.
PersistentbookmarkscanbetoggledandnavigatedusingusualJBuildershortcuts.
Numberedbookmarksaresupportedtoo.
TheonlywaytonavigateunnumberedbookmarkisusingthePersistent.
Bookmarks.
Navigatetool.
Productivity!
–NavigationToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com79Figure73SettingaBookmarkUsingtheGutterContextMenuAnotherwayofworkingwithpersistentbookmarksisusingcontextmenuontheeditorgutter.
Also,ifbookmarkhasdescriptionassociatedwithit,itmaybedisplayedashintifmouseisplacedoverbookmarkicon.
Figure74HintwithDescriptionofBookmarkPersistent.
Bookmarks.
NavigateThistoolallowseasynavigationtoanybookmarkfromthebookmarklist.
Persistent.
Bookmarks.
NavigatecanbeinvokedusingtheAlt+Shift+B(CUA)shortcut.
Productivity!
–NavigationToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com80Figure75Persistent.
Bookmarks.
NavigateManageBookmarksDialogProductivity!
providesrichfunctionalitythatallowsbookmarksmanaging.
TheManageBookmarksDialogallowsmaintainingthebookmarkslist.
Figure76ManageBookmarksDialogTheManageBookmarksdialogcanbeinvokedusingtheEdit|ManageBookmarksmenuitemorusingtheeditorguttercontextmenu.
Thisdialogprovidesthefollowingcontrols,whichallowviewingandmaintainingthebookmarkslist:BookmarksTableTheBookmarksTableshowsthelistofbookmarks.
Eachbookmarkoccupiesonerowinthetablewhileeachtable'scolumnrepresentsparticularattributeofbookmark.
TheDescriptionandPersistentcolumnsareeditable.
Thisallowsspecifyingvaluesofthemusingin-placeeditingcapabilities.
IfDescriptionattributeisspecified,itwillbedisplayedinthePersistent.
Bookmarks.
Navigatetoolandwillbeshownastooltipwhenmouseisplacedoverbookmarkinthegutter.
Ifbookmark'sPersistentattributeisturnedoff,suchabookmarkwillnotbestoredonJBuilderexit.
Productivity!
–NavigationToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com81GoToTheGoTobuttonprovidesnavigationtothecurrentlyselectedbookmarkwithoutclosingthedialog.
RemoveTheRemovebuttonallowsremovingofthebookmarkiscurrentlyselected.
RemoveAllTheRemoveAllbuttonremovesallbookmarks.
MoveUpTheMoveUpbuttonallowsmovingcurrentlyselectedbookmarkupinthebookmarkslist.
MoveDownTheMoveDownbuttonallowsmovingcurrentlyselectedbookmarkdowninthebookmarkslist.
Note:TheManageBookmarksDialogallowsactualmaintenanceofbookmarkslistsonochangescanbediscardedorundonebyclosingthisdialog.
ViewNavigatorandNavigator.
Insight-Pro!
TheViewNavigatortoolprovidesabilitytocontrolsetofsourcecoderelatednavigationoperationsusingthesamewayanduniformmanner.
Themainideaofthistoolisutilizingofpairofshortcutsandapairofappropriatebuttonstoexecute'previous'and'next'navigationoperationsagainstspecifiedNavigateObject.
FollowingNavigateObjectsarecurrentlysupportedforJavafiles:WarningorErrorLowPriorityIssueAnyIssueEditingPointMethodClassClassorMethodSearchResultLocalReferenceFollowingNavigateObjectsareavailableforothertypesoftextfiles:Productivity!
–NavigationToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com82EditingPointSearchResultFigure77ViewNavigatorandViewNavigatormenuTheNavigatorcontrolisplacedatthebottomrightoftheeditorview(rightundertheverticalscrollbar)andincludesthePrevious,NextandSelectObjectToNavigatebuttons.
ThePreviousandNextbuttonsallowsnavigatingthroughtheobjects(youcanuseCtrl+PageUpandCtrl+PageDownshortcuts(CUA)too).
TheSelectObjectToNavigatebuttonallowschoosinganobjecttonavigatebyusingappropriatemenuitemsformpopupmenushownonbuttonrelease.
AnotherwaychooseobjecttypetonavigateisusingNavigator.
Insight,whichcanbeinvokedusingtheAlt+Shift+N(CUA)shortcut.
Figure78Navigator.
InsightProductivity!
–InformationToolsInformationToolsProductivity!
includesseveraladvancedtoolsthoseallowsyouinstantlygetinformationaboutrequiredJavasourcecodeelement.
WithProductivity!
Informationtoolsyoucan:Easilyviewhelptopic(ifoneexist)fortheidentifierinthecaretposition–Help.
InsightandHyperlink.
Help;GetinstanthelpselectediteminJBuilderCodeInsight–Help.
Insight;Getfullinformationaboutcontextofsourcecodeinthecurrentcaretposition–Context.
Insight;Help.
InsightHelp.
Insightisatoolallowingyoutoeasilyviewhelptopics,ifany,foranidentifieroramemberwithinthecurrentcontextinthecursorposition.
Helpisshowninaconvenientpopupwindow.
Help.
Insightextractsanddisplaysinformationrelatingtoaparticularcodeonly-forexample,foraparticularmethod,notforallclasses.
Figure79Help.
InsightPopupWindowToinvokeHelp.
Insightforasymbolatthecursorposition,placethecursorovertheidentifierforwhichyouneedhelpandpressShift+F1(CUA).
ToinvokeHelp.
Insightforamemberwithinthecurrentcontext,placethecursorintheboundsofamethodorclassforwhichyouneedhelpandpresstheAlt+F1(CUA)shortcut.
Help.
InsightshowstheappropriateJavaDochelptopic,ifany,ortriestofindandshowtheappropriateoneforasuperclassormethodinothercase.
NavigationPaneTheNavigationPaneatthetopofthepopupshowsdifferentgadgetsintendedtocontrolthepopup.
YoucanusetheBackandForwardbuttons(orAlt+LeftandAlt+Rightkeys,respectively)tonavigatethroughthehelptopicshistoryoryoucanusetheOpentheProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com83Productivity!
-InformationToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com84WholeTopicbuttontoopenthecompletehelptopicintheHelpViewerwindow.
TheContextlabelshowsthecontextoranHTMLfilenamedependingontheabilitytoresolveany.
Hyperlink.
HelpAnAlternativewaytoinvokeHelp.
InsightistouseHyperlink.
HelpbyplacingthemousecursoroveranidentifierforwhichyouneedhelpwhileholdingtheAltbutton.
Figure80Help.
InsightPopupInvokedviaHyperlink.
HelpInthiscase,forspace-savingpurposes,theHelp.
Insightpopupdoesn'tshowtheNavigationPanel.
Itwillonlybeshownafteractivatinganyhyperlinkwithinthepopupwindow.
IntegrationwithOtherInsightsAnotherfeatureofHelp.
InsightisintegrationwithJBuilderbuilt-inMemberInsightandotherProductivity!
Insights.
Figure81JBuilderMemberInsightwithHelp.
InsightInvokedIfsuchintegrationisenabled,thepopupwindowofHelp.
InsightwillbeautomaticallyshownforacurrentlyselectediteminMemberInsightorProductivity!
Insightpopup.
YoucanalsoforceshowingHelp.
InsightforaselecteditemusingShift+F1shortcut(CUA).
Productivity!
-InformationToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com85OptionsDependencyYoumayenableintegrationofHelp.
InsightwithotherInsightsusingHelp.
InsightoptionsontheEditorOptions|Productivity!
|Usagepropertypage.
TospecifydelaysofHelp.
InsightinvocationyoucanusetheEditorOptions|Productivity!
|Delayspropertypage.
Hyperlink.
HelpHyperlink.
Helpisatoolthatallowseasyandconvenientviewinghelptopicsforparticularsymbols.
Figure82Hyperlink.
HelpPopupWindowwithHelpforMethodToinvokeHyperlink.
Help,pressandholdtheAltkeyandpointthemouseovertheidentifier,whichyouneedhelpwith.
Theidentifierbecomesahyperlink,andifyoupresstheleftmousebutton,thebuilt-inJBuilderhelpisshownforit.
IfyouplacethemouseovertheidentifierwiththeAltkeypressed,aftersomedelaytheHelp.
Insightpopupappearsthatcontainsexacthelpaboutthesymbolunderthecursor.
OptionsDependencyYoucancustomizedelaysoninvocationandclosingoftheHyperlink.
HelppopupwindowusingtheHelp.
InsightoptionsontheEditorOption|Productivity!
|Delayspropertypage.
Also,youcanspecifywhetherHyperlink.
HelpshouldbeinvokedduringadebugsessionusingtheInvokeinsightsduringdebuggingoptionontheEditorOption|Productivity|Usagepropertypage.
Context.
InsightContext.
Insightisatoolthatallowsyoutocheckcontextofthecurrentcursorposition.
Context.
InsightcollectsinformationaboutallclassesandmethodsandshowsitusingtheInsightpopupwindow.
ToinvokeContext.
InsightpleaseusetheCtrl+Q(CUA)shortcut.
Productivity!
-InformationToolsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com86Figure83Context.
InsightPopupWindowAnotherfeaturesupportedbyContext.
Insightisnavigation.
IfyouplacethemousecursoroveranidentifierwithintheContext.
Insightpopupwindow,thehyperlinkappearsandactivationofhyperlinkleadstonavigationtotheidentifier.
Insomecases(particularly,withinclasseswithsignificantamountofinnerclasses),theContext.
Insightmaydisplayonlyupperclassinformation.
SuchbehaviorisexplainedbydefinitelimitationsoftheJBuilderJOTsubsystemthatrequiressignificantamountoftime(uptotensofseconds)toretrieveinformationabouttheinnerclasses.
Toavoidhang-upofJBuilder,thetimerequiredforcontextinformationgatheringmaybelimitedinEditorOptions|Productivity!
|Delayspage.
So,ifJOTprovidesnodatawithinthisinterval,onlyupperclassinformationisprovided.
ThesamereasonmaycauserelativelyslowperformanceofContext.
Insightifthecursorisonthewhitespacebetweenclassmethods.
Thesamelimitationsmayaffectothertoolsusingthesamefunctionality(Override.
Insight,Implement.
Insight).
OptionsDependencyYoucanspecifyContextDiscoveringTimeoutusingtheEditorOptions|Productivity!
|Delayspropertypage.
Productivity!
–OptionsProductivity!
OptionsProductivity!
Prooffersrichabilitiesforcustomizingitsfunctionalityandtuningitexactlyforyourownuniquecodestyleandyourparticularneeds.
YoucanmanageProductivity!
settingsinconvenientandcustomarywaysusingstandardJBuilderapproachesforconfiguration.
MostofProductivity!
settingsareconcentratedintwoJBuilderdialogs:theProjectPropertiesandEditorOptionsdialogs.
TheProjectPropertiesdialogcontainsthefollowingpropertypagesaddedbyProductivity!
:GeneralwhereyoucanspecifyoptionsforImports.
BeautifyandPackagesExclusion.
CodeStylewhereyoucanspecifyoptionsforCodeGeneration.
JavaDocwhereyoucanspecifyoptionsforJavaDocgeneration.
CachewhereyoucanspecifyoptionsformanagingProductivity!
classescache.
AssistantwhereyoucanspecifyoptionsformanagingAssistantbehavior.
ToolswhereyoucanspecifyoptionsforvariousProductivity!
tools.
TheEditorOptionsdialogincludesthefollowingpropertypagesaddedbyProductivity!
:GeneralwhereyoucanspecifyoptionsforImportStatementsGeneration,SearchOptions,Sortingoptions,Autocomplete,InsightUsageandInvocationinsightsduringdebugging.
Usagewhereyoucanspecifyhowtouse(ornotuse)theappropriatetoolsDelayswhereyoucanspecifyoptionsforHyperlink.
HelpandHyperlink.
Navigateinvocationandclosingdelays,Help.
InsightdelayusedforintegrationwithJBuilderMemberInsight,andContextDiscoveringtimeout.
Smart.
TemplateswhereyoucancustomizetheSmart.
Templatesbehaviorandmaintainthetemplateslist.
AssistantwhereyoucancustomizetheAssistantbehavior.
Toolswhereyoucancustomizemiscellaneoustoolsbehavior.
Smart.
JavaDocwhereyoucancustomizetheSmart.
JavaDocbehavior.
Inaddition,withthehelpofEditorOptionsDialogyouareabletocustomizeoptionsfortheSmart.
Bracestool.
TheseoptionscanbefoundontheEditorpropertypageintheEditorOptionstreeview.
Also,theIDEOptionsdialogincludesapropertypageaddedbyProductivity!
,whichallowsusertoselecttheMetalthemetobeusedbyJBuilder.
Productivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com87Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com88ProjectPropertiesDialogTheProjectPropertiesdialogcontainsthefollowingpropertypagesaddedbyProductivity!
:GeneralwhereyoucanspecifyoptionsforImports.
BeautifyandPackagesExclusionCodeStylewhereyoucanspecifyoptionsforCodeGenerationJavaDocwhereyoucanspecifyoptionsforJavaDocgenerationCachewhereyoucanspecifyoptionsformanagingProductivity!
classescacheGeneralPageTheOptionspageoftheProductivity!
ProjectPropertiespagesallowstospecifythefollowingoptions:1.
PackagesExclusionTosettheseoptionsforallnewprojects,chooseProject|DefaultProjectProperties.
Productivity!
usescacheofclassesincludedintoparticularproject.
Bydefault,thiscacheincludesallclassesfoundaccordingtoJBuilderpathssettings.
Ingeneral,thisincludes:classesfromJDK,classesinprojectlibrariesandprojectclassesthemselves.
Itisobviousthatinlargeprojectstheamountofsuchclassesmayachieveseveralthousands.
TheProductivity!
popupwindowsallowreducingtheexcessiveamountofclassesbyeliminatingthosenotused(suchassun.
*andsunw.
*,whichareincludedintoJDKbuthardlyusedinyourprojectdirectly)-withthehelpofthisoptionyoucanexcludeunnecessarypackages.
PackagesExclusionFigure84PackageExclusionOptionsEnablepackagesexclusionSelectthischeckboxifyouwishtoexcludeclassesbelongingtoparticularpackagesfromshowingthemintheProductivity!
insights.
Withthischeckboxdisabled,allclassesfromProductivity!
cacheareshown.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com89ExcludepackagesUsingthispanel,youcanspecifypackagestobeexcluded.
Eithertypethepackagenametoexcludeitmanually(onlyvalidJavasymbolsareallowed,';'separatespackages)oraddthepackageusingtheSelectPackagedialoginvokedbytheAdd.
.
.
button.
Thesequenceorderofpackagesbeingspecifiedisinessential.
CodeStylePageTheOptionspageoftheProductivity!
ProjectPropertiesallowsusertospecifythefollowingoptions:1.
MethodsParametersNaming2.
FieldsNaming3.
GenerateThrowingjava.
lang.
UnsupportedOperationException4.
GeneralOptionsTosettheseoptionsforallnewprojects,chooseProject|DefaultProjectProperties.
ThispropertypageallowscustomizingthecodegeneratedwithProductivity!
toolsandadjustittoyourpersonalcodingstyle.
ThisoptionallowscustomizingnamesofparametersusedinmethodsgeneratedbyProductivity!
tools.
Anyparameternamehasacustomizableprefixandsuffix.
Withtheappropriatecheckboxenabled,you'llbeabletospecifytherespectivepartofaparameternameintheeditbox.
Inotherwords,youcanspecifythevaluetobeusedwhennamingparameters.
Figure85MethodsParametersNamingOptionsProductivity!
toolsgeneratenamesofparametersiftheiractualnamesareunknown(whensourcecodeofaclassisunavailable).
Bydefault,itutilizesusualJavaconventionforparametersnaming,butyoucanforceittouseprefixesand/orsuffixesaccordingtoyourownrequirements.
Thisoptionallowscustomizingnamesoffieldsaccordingtothecodingstyleyouprefer.
MethodsParametersNamingFieldsNamingProductivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com90Figure86FieldsNamingOptionsYoucancustomizeaprefixandsuffixofafieldname.
Withappropriatecheckboxenabled,you'llbeabletospecifytherespectivepartofafieldnameintheeditbox.
ThecurrentversionofProductivity!
usesthisoptioninGetSet.
Creator.
Dependingonvaluesspecified,GetSet.
Creatorcandefinetheappropriatenameoftheget/setmethod(byremovingaprefixandsuffix)andtheappropriateparameternames.
Usingtheseradiobuttonsyoucanexactlyspecifytherulesofcodegeneratinginthemethodbody.
IfyouenableGeneratealwaysradiobutton,Productivity!
alwaysgeneratesmethodbodywithTODOcommentandthecodethatthrowsjava.
lang.
UnsupportedOperationexception.
Figure87GeneratethrowingofUnsupportedOperationExceptionOptionsIfyouenableGenerateonlywhenneededradiobutton,Productivity!
generatesthecodethatthrowsexceptiononlyforthemethodwithnon-voidreturntype.
Theseoptionsprovidemoreopportunitiesforyoutofine-tunethecodegeneratedbyProductivity!
GenerateThrowing…GeneralFigure88GeneralCodeStyleOptionsGeneratemethodbodynearthecurrentcursorpositionThisoptionallowsyoutospecifytheanchorpositionwherethegeneratedcodewillbeinserted.
Iftheappropriatecheckboxisselected,thewholecodewillbegeneratedinthepositionclosetocursor(ifthecursoriswithinamethod,thecodewillbegeneratednearthismethod).
Ifthisoptionisdisabled,allthemethodswillbeinsertedintheendofaclassdefinitionandtheconstructorswillbeinsertedafterthelastdefinedconstructor.
Theonlyexceptionisthegenerationofget/setmethods-ifthisoptionisdisabled,aget/setmethodwillbeinsertedaftertheappropriateset/getmethod.
GenerateJavaDocduringmethodsgenerationProductivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com91ThischeckboxisusedtospecifywhethertheJavaDoccommenttemplateswillbegeneratedduringthemethodsgeneration.
Ifyouenableit,allthemethodsgeneratedbytheProductivity!
toolswillincludetheJavaDoccommenttemplates(thesameasthoseproducedbyEasy.
JavaDoc).
Theonlyexceptionisthegenerationofanonymousinnerclasses-JavaDocwillneverbegeneratedduringtheanonymousinnerclassgeneration.
JavaDocPageTheEasy.
JavaDocpageoftheProductivity!
ProjectPropertiespagesprovidesthefollowingoptions:1.
PolicyforhandlingtheexistingJavaDoccomments2.
MethodsJavaDocGeneration3.
ClassesJavaDocGeneration4.
AutoGenerationTosettheseoptionsforallthenewprojects,selectProject|DefaultfromtheProjectProperties.
AlltheoptionsonthispageareapplicabletoJavaDocgenerationbybothmanualinvocationofEasy.
JavaDoc(defaultshortcutisCTRL+D)andbyinvokingEasy.
JavaDocduringmethodgeneration(inOverride.
Insight,Constructor.
Insight,Implement.
InsightandSmart.
Instantiatetools).
Pleasenotethatalltheseoptionsarenotapplicabletothecodegeneratedforanonymousclasses,sinceJavaDocisnevergeneratedforthem.
ThisoptionallowsyoutospecifytheprocessingpolicyfortheexistingJavaDoccomments.
Figure89IfJavaDocexistsOptionsYoumaydefinehowEasy.
JavaDocwillhandletheexistingJavaDoccomments.
IfJavaDocalreadyexistsforamethodorclass,Easy.
JavaDocmayeitherskipthegenerationofJavaDoctemplateandoverridetheexistingblockbyitsownone,orpromptyourconfirmationforoverridingoftheexistingcomment.
TheseoptionsallowyoutospecifythetagsthatwillbeincludedintothegeneratedJavaDoctemplateforthemethod.
IfJavaDocAlreadyExistsMethodsJavaDocGenerationProductivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com92Figure90MethodsJavaDocGenerationOptionsBydefault,Easy.
JavaDocalwaysgenerates@param,@throwand@return(exceptvoidmethodsandconstructors)tagsbasedonthemethoddefinition.
However,youmayexpandthecontentofgeneratedtemplateusingMethodsJavaDocGenerationoption.
Youmayselecttheappropriatecheckboxtoenablegenerationofthecorrespondingtag.
Pleasenotethatifyouselectthe"Generate@author"checkbox,Easy.
JavaDocwillusethenameoftheAuthorasspecifiedontheProjectProperties|Generalpropertypage.
ThisoptionallowsspecifyingthetagsthatwillbeincludedintothegeneratedJavaDoctemplateforthemethod.
Figure91ClassesJavaDocGenerationOptionsBydefault,Easy.
JavaDocalwaysgeneratesadescriptiononly.
However,youmayexpandthecontentofgeneratedtemplateviatheMethodsJavaDocGenerationoption.
Youmayselecttheappropriatecheckboxtoenablegenerationofthecorrespondingtag.
PleasenotethatifyouselecttheGenerate@authorcheckbox,theEasy.
JavaDocwillusethenameoftheAuthorasspecifiedontheProjectProperties|Generalpropertypage.
ThesamehappenswiththeGenerate@versioncheckbox.
Youmayspecifywhetherdefaultcommentsshouldbegeneratedfortheget/setmethodsusingAutomaticallygeneratetextofcommentsforget/setmethods.
PleasenotethatthisoptionisapplicableonlytoGetSet.
Creatortool.
ClassesJavaDocGenerationAutoGenerationProductivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com93Figure92JavaDocAutoGenerationOptionsIfyouenablethischeckboxtogetherwiththeautomaticgenerationofJavaDocduringmethodsgeneration(ProjectProperties|Productivity!
|CodeStyle|General),thentheGetSet.
Creatortoolwillinsertdefaultdescriptionforthemethod,defaultdescriptionforthemethodreturnvalue(getter)anddefaultdescriptionforthemethodparameters(setter).
CachePageTheCachepageoftheProductivity!
ProjectPropertiespagesprovidesthefollowingoptions:1.
Autorefreshoption2.
Refreshgroups3.
RefreshNowTosettheseoptionsforallthenewprojects,selectProject|DefaultfromtheProjectProperties.
ThemaingoalofProductivity!
istoincreasethedevelopers'productivitytoitsmaximum.
Since,presumablytheapplicationwillbefrequentlyused,itshouldworkasquicklyaspossible.
Theprojectmaycontainseveralthousandsofclasses(includingtheclassesdirectlyincludedintotheproject,JDKsandrequiredlibrariesclasses)andconstantsearchthroughthemwouldbehighlyinconvenient.
Thus,Productivity!
buildsclassescacherightafterthefirstinvocationandthenstoresittoharddriveprovidingforfuturere-use.
Aftercachebuildorload,Productivity!
usesitforquickaccesstotheclassesaccordingtothespecifiedcriteria.
Optionsgroupedonthispageallowyoutocontroltheprocessofclasscachebuildingandrefreshing.
Thisoptionallowsyoutospecifywhethercachewillberefreshedautomatically.
AutorefreshOptionsThemostfrequentlychangedclassesfromalltheclassesusedbytheprojectarethoseincludedintotheprojectitself,inotherwords,theclassesdevelopedbyyouwithinaproject.
WhereaschangingJDKandaddingorremovinglibrariesareveryrareoperations,newclasseswithinaprojectappear,changetheirlocationorbecomerenamedeveryday.
Figure93CacheAutoRefreshOptionsTheAutorefreshoptionsaredesignedtomakethecachecontentasup-to-dateaspossible,offeringconvenientusageofsuchProductivity!
toolsasClass.
InsightandProductivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com94Browse.
Insightwithyourclasses,andalsotoreducethenecessityofmanualrefreshofProductivity!
classescache.
Thisoptionenablesyourclasscachetoberefreshedaftereverysuccessfulprojectbuildormake.
Refreshofclassesincludedintheprojectisnormallyashortoperationthatrequiresmuchlesstimecomparedtoprojectbuild,sowerecommendthattheseoptionsbealwaysenabled.
Pleasenotethattheclasscacherefreshwillbeperformedonlyundertheconditionthatthewholeprojectbuildormakeissuccessfullycompleted(notjustsomeofitsfiles),andthattherewerenocompilererrorsduringthebuildprocess.
RefreshgroupsYoumaytunethecacherefreshprocessbyusingtherefreshgroups.
Refreshgroupisasetofpackagesthatmayberefreshedindependently.
Thusyoumayspecifyasetofrefreshgroupsthatwouldincludethemostfrequentlychangingclasses,andrefreshtheircacheindividually.
Figure94RefreshGroupsOptionsYoumayspecifyyourrefreshgroupsusingthetableshownabove.
UseAddnew…buttontocreateanewgroup,Editbuttontoedittheexistinggroup,andRemovebuttontodeleteagroup.
Refreshbuttonallowsyoutorefreshtheselectedgroup.
Pleasenotethatdouble-clickingagrouprowbringsyouuptogroupediting(similartopressingtheEdit.
.
.
button).
CreatingnewgroupsaswellaseditingtheexistingonesisperformedviatheNew/EditRefreshGroupDialog.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com95Figure95New/EditRefreshGroupDialogPleaseusetheGroupNamefieldtospecifythenameofthegrouptoberefreshed,andthePackagestorefreshfieldtospecifythepackagestobeincludedintothegroup.
Youmayspecifythepackagesforinclusionbyeithermanualtyping(onlyvalidJavasymbolsareallowed,separatorforpackagesis;),orbyaddingthemviatheSelectPackagedialog,invokedbytheAdd.
.
.
button.
Theorderofspecifiedpackagesisnotessential.
TheseoptionsenableimmediatestartoftherefreshoperationfortheProductivity!
classescache.
Figure96RefreshNowOptionsYoumaychoosefromthefollowingrefreshtypes:oftheclassesincludedintotheprojectonly;oftheprojectlibraries(whichiscrucialtodoafteraddingorremovinglibraries);orofthewholecache(includingtheclassesfromJDK).
AssistantPageTheAssistantpageallowsspecifyingthefollowingoptions:1.
AutoImportPolicy2.
FrequentlyUsedClassesTosettheseoptionsforallthenewprojects,selectProject|DefaultfromtheProjectProperties.
RefreshNowAutoImportPolicyThisoptionpanelallowsmaintainingthelistofAutoImportPolicyentries.
Suchlistisusedtodetermine,whichactionshouldbeexecutedforeachparticularshortclassnameduringautoimportprocess.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com96Figure97AutoImportPolicyEachentryoccupiesonerowinthelistandit'spropertiesareshownintheappropriatecolumns.
Allthosepropertiescanebeeditedrightinthelistusing"in-placeediting"approach.
AutoImportPolicyentrypropertiesare:Name-specifiesshortnameoftheclass.
Predefinedentrywithname"*"allowsspecifyingdefaultbehaviorforallnamesnotstatedinthelist.
Import-specifiesactiontobedone.
Possibleactionsare:oNever-noclasswillbeimported.
oAny-firstsuitableclasswillbeimported.
oParticular-classwithexactlyspecifiednamewillbeimported.
oUnique-uniquesuitableclasswillbeimported.
FullClassName-specifiesfullclassnametoimport.
ThispropertycanbeappliedtoParticularactiononly.
TheAddandRemovebuttonsallowaddingnewandremovingexistingentries.
Note,predefinedentry"*"can'tberemoved.
FrequentlyUsedClassesThisoptionpanelallowsmaintainingthelistoffrequentlyusedclasses.
Suchlistisusedtodetermineparticularclasstoimportorpromptincaseofexistenceofseveraldifferentcandidates.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com97Figure98FrequentlyUsedClassesEachentryinthatpanelshouldbeendedby';'symbol.
Thesequenceorderofclassesbeingspecifiedisinessential.
TheAdd.
.
.
buttonallowsaddingaclassusingtheSelectClassdialog.
ToolsPageTheToolspageallowsspecifyingthefollowingoptions:1.
ClassesHighlightTosettheseoptionsforallthenewprojects,selectProject|DefaultfromtheProjectProperties.
ClassesHighlightProductivity!
allowshighlightingofcertainclassesusingJava|Extrakeywordstyleandtheseoptionsallowsfinetuningthisfunctionality.
Figure99ClassesHighlightEnableClassesHighlightSelectthischeckboxifyouwishtoturnhighlightclasseson.
ClassestoHighlightProductivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com98Usingthispanel,youcanspecifylistofclassestobehighlighted.
Eachentryinthatpanelshouldbeendedby';'symbol.
Thesequenceorderofpackagesandclassesbeingspecifiedisinessential.
It'spossibletousethefollowingentries:*-tohighlightallclasses.
package.
*-tohighlightallclassesbelongingtospecifiedpackage.
package.
class-tohighlightexactlyspecifiedclass.
TheAdd.
.
.
buttonallowsaddingapackageorclassusingtheSelectPackageorClassdialog.
EditorOptionsDialogTheEditorOptionsdialogincludesthefollowingpropertypagesaddedbyProductivity!
:GeneralwhereyoucanspecifyoptionsforImportStatementsGeneration,SearchOptions,Sortingoptions,Autocomplete,InsightUsageandInvocationinsightsduringdebugging.
Usagewhereyoucanspecifyhowtouse(ornotuse)theappropriatetoolsDelayswhereyoucanspecifyoptionsforHyperlink.
HelpandHyperlink.
Navigateinvocationandclosingdelays,Help.
InsightdelayusedforintegrationwithJBuilderMemberInsight,andContextDiscoveringtimeout.
Tools-Pro!
Assistant–Pro!
Smart.
Templates–Pro!
Smart.
JavaDoc–Pro!
Inaddition,withthehelpofEditorOptionsDialogyouareabletocustomizeoptionsfortheSmart.
Bracestool.
TheseoptionscanbefoundontheEditorpropertypageintheEditorOptionstreeview.
Smart.
BracesOptions(EditorOptions)TheSmart.
BracestoolcanbecustomizedviatheEditorOptionsdialogbox.
AssoonasProductivity!
isinstalled,additionalnodeappearsintheEditorOptionstreeview(EditorOptions|Editorpropertypage)Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com99Figure100Smart.
BracesOptionsThisnodecontainstheSmart.
Bracescustomizationoptions.
YoumayfullycustomizeallthefeaturesofSmart.
Bracestosatisfyyourneedsandgoals.
Figure101Smart.
BracesOptions(Expanded)Thefollowingoptionsareavailable:CompletecurlybraceAllowsyoutospecifywhetherSmart.
Bracesshouldcompletethecurlybrace({)CompletecurlybraceandindentAllowsyoutospecifywhetherSmart.
Bracesshouldcompletethecurlybrace({)andmaketheindentinaccordancewiththecurrentlysetsizeCompletebraceAllowsyoutospecifywhetherSmart.
Bracesshouldcompletethebrace(()CompletesquarebraceAllowsyoutospecifywhetherSmart.
Bracesshouldcompletethebrace([)CompleteStringsAllowsyoutospecifywhetherSmart.
Bracesshouldcompletethestringconstants(")CompletecharactersAllowsyoutospecifywhetherSmart.
Bracesshouldcompletethecharacterconstants(')UseALTkeytooverridethecurrentoptionsWiththisoptionenabled,thecurrentoptionscanbeoverriddenprovidedtheALTkeyispressedwhentyping.
Forexample,ifCompletecurlybraceoptionisenabled,pressing{withtheALTkeywillonlyinserttheopeningcurlybracewithoutthecorrespondingclosingone.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com100Ifanon-standardJBuilderkeymapisused(suchasVi/VIM),theSmart.
Bracesmayconflictwiththekeymapsettings.
Apparently,forkeymapVIthe'and"symbolsmaybeoverriddenbySmart.
Braces.
Itisjustifiedbythefeaturesoftheviimplementation(improperimplementationoftheKeymapdefaultaction).
NOTE:HoweverthepartofSmart.
Bracesfunctionalitythatcausestheconflictcanbedisabled.
Todothis,youshouldaddthefollowinglinesintoyourJBuilder.
configfile(placedinJBuilder/bindirectory):vmparam–DProductivity.
Smart.
Braces.
CompleteCharacters=novmparam–DProductivity.
Smart.
Braces.
CompleteStrings=noGeneralPageTheGeneralpageoftheProductivity!
EditorOptionspageprovidesthefollowingoptions:ImportstatementgenerationSearchoptionsSortclassesbyAutocompleteProductivity!
containsanumberoftoolsdesignedforimportsmodification-Class.
Insight,Implement.
Insight,Override.
Insight,Constructor.
Insight,Imports.
BeautifyandSmart.
Instantiate.
ImportstatementsgenerationAllthesetoolssharecommonsettingsfortheimportstatementsmodificationsomodificationoftheseoptionswillaffectalltoolsmentionedabove.
Figure102ImportstatementsgenerationoptionsThefollowingoptionsareavailableformanagementofimportstatementmodifications:ImportparticularclassIfthisoptionisturnedon,theimportstatementfortherequiredclasswillbeinserted,howeverimportsconsolidationwillnotbeapplied.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com101Importall(*)classesfrompackageIfthisoptionisturnedon,all(*)classesfromallthepackageswillbeimportedandparticularimportsfromthesamepackagewillberemoved.
Thisoptionisusefulwhenalargeamountofclassesfromthesamepackageareused.
ImportparticularclassandconsolidatepackagesIfthisoptionisturnedon,aparticularclasswillbeimportedifthenumberofimportsfromthesamepackagedoesnotexceedthemaximumallowed.
Themaximumamountofclassestobeimportedwithoutimportstatementsconsolidationiscontrolledbythe"ImportmaximumNclassesfromthesamepackagefield.
Ifthenumberofimportsfromthesamepackagesexceedsthespecifiedlimit,alltheimportsofaparticularclassfromtherequiredpackagewillberemovedandimportstatementforthewhole(*)packagewillbeinsertedinstead.
SearchoptionsTheseoptionsallowyoutotunethealgorithmusedforsearchofitemswithintheProductivity!
popuplists.
Figure103SearchoptionsThefollowingoptionsareavailableforsearchcontrol:Use"startsWith"methodIfthisoptionisturnedon,allthesearchoperationswillbeperformedforthestringwiththevalueofthewordatcursor.
Otherwise,thesearchwillincludethestringsthatcontaintherequiredsubstring(usuallyawordatcursor).
CasesensitiveIfthisoptionisturnedon,thecasesensitivesearchalgorithmwillbeused.
StoponexactmatchIfthisoptionisturnedon,onlyclasseswiththenamesthatexactlymatchthewordatcursorwillbeshown.
ShowadditionalclassesProductivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com102IftheStoponexactmatchoptionisdisabled,youmayspecifytheamountofclassesyouwouldliketoseeinthepopuplist.
Sincetheoverallamountofclassesmaybequiteimportant,youmaymakethelistofclasseslessextended.
ThisoptioniscommonforthefollowingInsights:Class.
Insight,Browse.
Insight,Implement.
InsightandSmart.
InstantiateNOTE:TheseoptionsallowcontrollingthesortingofclassesforthefollowingInsights:Class.
Insight,Browse.
Insight,Implement.
InsightandSmart.
Instantiate.
Figure104SortClassesByoptionsThefollowingoptionsareavailableforclassessortingcontrol:ClassnamethenbypackagenameIfyouselectthisoption,theclasseswillbesortedaccordingtotheclassnameandthenclasspackage;Full-qualifiedclassnameIfyouselectthisoption,theclasseswillbesortedaccordingtotheirfull-qualifiednames.
Productivity!
allowsautomaticexecutionoftheInsightprimaryactionwhenthereisonlyonepossiblevariantfound.
InthiscasetheactionwillbeperformedwithouttheInsightpopupwindowbeingshown.
SortclassesbyAutocompleteFigure105AutocompleteoptionsUseautocompleteIfthischeckboxisenabled,theautocompleteoptionwillbeturnedon,andProductivity!
willautomaticallycompletetheactionsifpossible.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com103UsagePageTheGeneralpageoftheProductivity!
EditorOptionspageprovidesthefollowingoptions:1.
Productivity!
Insightsusage2.
Invokeinsightsduringdebugging3.
Help.
Insight4.
Highlight.
Navigatepopuphidingmode5.
SuperclassChangingPolicyTwotoolsincludedintoProductivity!
-Class.
InsightandBrowse.
Insight-usethesamedefaultshortcuts(Ctrl+Alt+SpaceandCtrl+Minus,respectively(CUA))asJBuilderbuilt-intools.
IfyouwanttocontinueusingtheJBuilderbuilt-intoolsyoumaydisabletheProductivity!
insightsstartupusingthisoption.
Productivity!
InsightsUsageFigure106Productivity!
InsightsUsageoptionsUseClass.
InsightIfthischeckboxisnotselected,theoriginalJBuildertoolswillbeinvokedinsteadofProductivity!
Class.
Insightbypressingtheappropriateshortcut.
ShowClass.
InsightandSmart.
InstantiatepopupaslistIfthischeckboxisselected,thepopupwindowusedbyClass.
InsightandSmart.
InstantiatewillnotincludetheNavigationPaneandwillbesimilartoJBuilderbuilt-inMemberInsight.
UseBrowse.
InsightIfthischeckboxisnotselected,theoriginalJBuildertoolwillbeinvokedinsteadofProductivity!
Browse.
Insightbypressingtheappropriateshortcut.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com104Duringdebugging,JBuilderprovidesabilitytoinspectthesymbolundercursorusingtheappropriatepopupwindow.
SincebothJBuilderandProductivity!
Hyperlink.
NavigatewindowsareinvokedbyplacingmouseoverthesymbolwiththeCTRLkeypresseddown,insomecasesthesewindowsmayoverlap.
Figure107InvokepopupsduringdebuggingoptionsToeliminatethis,youmaydisableHyperlink.
HelpandHyperlink.
Navigatepopupwindowsifthereisanactivedebuggingsession.
YoumayspecifywhetherHelp.
Insightshouldbeintegratedwithanotherinsights.
Figure108Help.
InsightoptionsIntegrateHelp.
InsightwithJBuilderMemberInsightIfthischeckboxisselected,Help.
InsightwillbeintegratedwithJBuilderMemberInsight.
Insuchmode,assoonasyouchangetheselectionwithintheMemberInsightpopupwindowlist,Help.
InsightwiththehelpforaselecteditemwillappearneartheMemberInsightpopupwindow.
IntegrateHelp.
InsightwithProductivity!
InsightsIfthischeckboxisselected,Help.
InsightisintegratedwithalltheinsightsincludedintoProductivity!
.
Pleasenotethatevenifyoudisablethisintegration,youwillstillbeabletoinvokeHelp.
Insightforaselecteditemintheinsightpopuplist.
Todothis,youjustneedtopresstheshortcutkeynormallyusedforHelp.
Insightinvocation(thedefaultshortcutisCTRL+F1underCUA)whenProductivity!
insightisbeingused.
InvokepopupsduringdebuggingHelp.
InsightHyperlinkpopuphidingmodeThisoptionallowsyoutohidetheHyperlink.
Navigatepopupwindow.
Figure109Highlight.
NavigateoptionsIfselected,thepopupwindowwillbehiddentogetherwiththehyperlink.
Ifnot,thepopupwindowwillbeclosedinaccordancewiththedelayspecifiedontheDelayspage.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com105ThisoptionallowsyoutospecifyhowtheProductivity!
Implement.
Insighttoolwillhandlethesituationwhenanextrasuperclassisassignedtoaclass.
Figure110SuperclassChangingPolicyoptionsInsuchcaseImplement.
Insightwillperformthefollowingactionsdependingonthecurrentlyselectedvalue:Neverchange-Implement.
Insightwillnotchangethesuperclassandwillnotimplementmethodsfromtheproposedsuperclass.
Alwayschange-Implement.
Insightwillchangethesuperclasstotheselectedoneandwilloverrideallabstractmethods.
Showprompt-Implement.
Insightwillshowapromptdialogallowingyoutospecifywhatshouldbedone.
DelaysPageTheDelayspageoftheProductivity!
EditorOptionspageprovidesthefollowingoptions:1.
Hyperlink.
HelpDelays2.
Hyperlink.
NavigateDelays3.
Help.
InsightDelay4.
ContextDiscoveringTimeoutWiththeseoptionsyoumayspecifythedelaysusedforinvocationandclosingofpopupwindowsdisplayedbytheHyperlink.
HelpandHyperlink.
Navigatetools.
SuperClassChangingPolicyHyperlinksDelaysFigure111HyperlinksoptionsProductivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com106Help.
InsightDelayWiththisoptionyoumayspecifytheHelp.
InsightdelayforJBuilderbuilt-inMemberInsightaswellasforProductivity!
insights.
Figure112Help.
InsightoptionsYoumayalsoindicatewhetherHelp.
InsightwillbeintegratedwiththeJBuilderbuilt-ininsightsusingtheEnableHelpforbuilt-inJBuilderinsightscheckbox.
FromtheEnableHelpforProductivity!
InsightsoptionyoucanspecifywhetherornotHelp.
InsightwillbeintegratedwiththeinsightsincludedintoProductivity!
.
InvocationdelayWiththisslideryoumaydefinethetimeoutbetweenthetimewhenamemberinMemberInsight(orProductivity!
Insights)isselectedandwhentheHelp.
Insightpopupwindowisdisplayed.
Incertaincases,(particularly,fortheclasseswithalargenumberofinnerclasses),Context.
Insightmaydisplayonlytheupperclassinformation.
ContextDiscoveringFigure113ContextDiscoveringoptionsThereasonforthisisthelimitationofJBuilderJOTsubsystemthatrequiressignificantamountoftime(uptotensofseconds)toretrieveinformationabouttheinnerclasses.
Toavoidhang-upofJBuilder,thetimerequiredforcollectionofcontextinformationwaslimitedto2seconds.
Thus,ifJOTfailstoprovidethedatawithinthisinterval,onlytheupperclassinformationisselected.
RelativelyslowperformanceofContext.
Insightwhencursorisplacedonthewhitespacebetweenclassmethodscanalsobejustifiedbythesereasons.
Thesamelimitationsmayaffectothertoolsthatusethesamefunctionality(Override.
Insight,Implement.
Insight).
Fromthisoptionyoucanspecifythemaximumtimerequiredtodiscoverthecontext.
ToolsPage–Pro!
TheToolspageoftheProductivity!
EditorOptionspageprovidesthefollowingoptions:1.
Smart.
Clipboard;Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com1072.
Smart.
Braces;TheSmart.
ClipboardgroupallowsperformingtuningofSmart.
ClipboardTools.
Figure114Smart.
ClipboardoptionsGeneralOptionsThisoptionsgroupprovidesabilitytospecifysizeofclipboardhistory(clipboardbuffer)andenable/disableautomaticindentationoftheinsertedblockaccordingtocurrentindentlevel(thisoptionisapplicabletopastingJavacodeintoJavafiles).
InsertImportStatementsOnPasteThissetofradiobuttonsprovidesabilitytospecifypolicyforimportstatementsgenerationthatshouldbeusedduringpastingofJavacodeblock(thisoptionisapplicabletopastingJavacodeintoJavafiles).
Ifthisoptionisnotdisabled,Smart.
Clipboardwilloptionallyinsertappropriateimportstatementsforallclassesfoundinthecopiedcodefragment.
TheSmart.
BracesoptionsgroupprovidesabilitytocustomizebehaviorofSmart.
BracesandMatching.
Code.
Highlighttools.
Smart.
ClipboardSmart.
BracesFigure115Smart.
BracesoptionsProductivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com108Usingthisoptionsgroup,theuserisabletospecifydelaysusedforhighlight,expirationandmatchingcodepopupdisplaying.
AssistantPage–Pro!
TheAssistantpageoftheProductivity!
EditorOptionspageisusedforcustomizingofProductivity!
Assistantandprovidesthefollowingoptions:1.
IssueHighlightStyle2.
AssistantPopupDelay3.
AutoFixErrors4.
RenameAssistantTheIssueHighlightStyleoptionsgroupprovidesabilitytospecifylinestyleandcolorforvisualmarksthoseareusedtohighlightissueineditor.
Figure116AssistantIssueHighlightStyleoptionsTheAssistantsDisplayingDelayoptionallowsspecifyingdelayshouldbeusedtodisplayAssistantpopup.
Figure117AssistantDisplayingDelayTheAutoFixErrorsoptionsallowenabling/disablingautofixfunctionalityforallorparticulartypesoferrors.
IssueHighlightStyleAssistantsDisplayingDelayAutoFixFigure118AutoFixOptionsProductivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com109TheRenameAssistantoptionsallowsenabling/disablingrenamefunctionalityforallorparticulartypesofentities.
It'salsopossibletospecifyshortcuttostartrefactoringusingtheseoptions.
IftheEnterkeyischosentostartrefactoringtheCtrl+Enterkeyallowssimplerenamingandviceversa.
Figure119RenameAssistantOptionsSmart.
JavaDocPage–Pro!
TheSmart.
JavaDocpageoftheProductivity!
EditorOptionspageisusedforcustomizingoftheSmart.
JavaDoctoolandprovidesthefollowingoptions:1.
IssueHighlightStyle2.
JavaDocGenerationStyleTheIssueHighlightStyleoptionsgroupprovidesabilitytocustomizestyleandcolorofmarksshouldbeusedtovisuallyhighlighterrorsinJavaDoccomments(suchasmissingorredundantparameters,missingthrows,unknowntagsetc).
Figure120Smart.
JavaDocIssueHighlightoptionsRenameAssistantIssueHighlightStyleJavaDocGenerationStyleTheJavaDocGenerationstyleoptionsgroupprovidesabilitytocustomizestyleofJavaDoccommentgeneratedbySmart.
JavaDoc.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com110Figure121JavaDocGenerationStyleoptionsTherearethefollowingoptions:SeparateHTMLtags-ifenabled,alltagssuchaswillbeplacedondifferentlines;InsertemptylineafterJavaDoctag-ifenabled,theemptylinewillbeinsertedbetweenJavaDoctags;IndentJavaDoctagtext–ifenabled,themulti-linetagdescriptionwillbeindentedfromleftbythetagitself;Smart.
TemplatesPage–Pro!
ThispageallowscustomizingofSmart.
Templatesbehaviorandmaintainingthetemplateslist.
Itprovidesthefollowingoptions:1.
Scope2.
Template3.
Code4.
QuickExpandKeyTheScopecomboboxallowsselectionoftemplatelisttomaintain.
Figure122TemplatesListScopeoptionsThefollowingscopesarecurrentlysupported.
UserHome–specifiesthetemplatelistthatbelongstothecurrentlyloggedinuser.
Allthetemplatesbelongingtothisscopearestoredinthefiles.
templateslocatedinthe/.
jbuilderfolder.
JBuilderHome–specifiesthetemplatelistthatisJBuilderwidesoitisavailableforallusersthoseusethisinstallationofJBuilder.
Allthetemplatesbelongingtothisscopearestoredinthefiles.
templateslocatedinthe/Productivityfolder.
Allthetemplatesfromallavailablescopesaremergedallowingtransparentusageoftemplatesdefinedinanyscope.
TemplatesdefinedintheUserHomescopehavepriorityoveronesdefinedinJBuilderHomeone.
TheTemplatestableshowsthelistoftemplatesavailableincurrentlyselectedscopeScopeTemplatesProductivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com111anditallowsselectionofparticulartemplatetomaintain.
Figure123TemplateslistNewTheNewbuttonallowscreationofanewtemplate.
AfterpressingofthisbuttontheEditTemplateDialogisshowingwhichallowsspecifyingmiscellaneousattributesofnewlycreatedtemplate.
EditTheEditbuttonallowsmaintenanceofcurrentlyselectedtemplate.
AfterpressingofthisbuttontheEditTemplateDialogisshowingwhichallowsspecifyingmiscellaneousattributesofselectedtemplate.
CopyTheCopybuttonallowscreationofanewtemplateusingcurrentlyselectedtemplateasaprototype.
AfterpressingofthisbuttontheEditTemplateDialogisshowingwhichallowsspecifyingmiscellaneousattributesofnewlycreatedtemplate.
RemoveTheRemovebuttonallowsremovalofcurrentlyselectedtemplate.
CodeTheCodeeditorpaneprovidespreviewofcurrentlyselectedtemplate.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com112Figure124TemplateCodepreviewThisoptionsgroupallowsselectionofkeycanbeusedtoquicklyexpandatemplatewhichnameismatchtothewordatcaret.
Figure125QuickExpandKeyoptionsEditTemplateDialog–Pro!
TheEditTemplateDialogallowsmaintenanceofatemplateandspecifyingitsstructureandproperties.
Itcontainsthefollowingpages:General–onethatallowsmaintaininggeneralpropertiesoftemplate;Options–onethatallowsspecifyingmiscellaneouspropertiesoftemplate;Fields–onethatallowsmaintainingthefieldsbelongingtotemplate;Shortcuts–oneallowsspecifyingofshortcutsforeachsupportedkeymap.
GeneralPageQuickExpandKeyTheGeneralpageallowsmaintenanceoftemplategeneralproperties.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com113Figure126EditTemplateDefinitionDialog–GeneralPageItprovidesthefollowingoptions:NameTheNameeditboxallowsspecifyingthenameforthetemplate.
Thisnamewouldbeshortaspossiblethoughitshouldbemeaningfulenoughtorecognizethetemplate.
Pleasenotethattemplatenameshouldbeuniquewithincurrentscope.
DescriptionTheDescriptioneditboxallowsspecifyingthedescriptionforthetemplate.
GroupTheGroupcomboboxallowsspecifyingthegroupthistemplatebelongsto.
Thegroupdefinesthenameofthefileinwhichthistemplatewillbestoredaftersavingofthetemplatelist.
Allocationoftemplatesacrossscopesandgroupsallowsbettercontrollingthemandprovideseasywaytosharethembetweenteammembers.
ActiveTheActivecheckboxallowsspecifyingwhetherthistemplateisavailableforuse.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com114CodeTheCodeeditorpaneallowstypingthecodeofthetemplate.
Thecodeofthetemplateconsistsofcodefragmentsandoptionallytemplatefieldswithinthem.
Eachfieldisrepresentedbyitsnameenclosedby#sign.
Ingeneral,it'senoughjusttostatefieldsinthetemplatecodeandtheywillbeautomaticallyaddedtothetemplate.
TospecifypropertiesforthedesiredtemplatefieldstheFieldspageisused.
OptionsPageTheOptionspageallowsspecifyingmiscellaneouspropertiesoftemplate.
Figure127EditTemplateDefinitionDialog–OptionsPageOptionsThisgroupprovidesoptionsthosecontrolgeneraltemplatebehavior.
FormatExpandedStringTheFormatExpandedStringoptionspecifieswhethertemplatecodeshouldbeformattedandindentedaccordingtothecurrentindentlevelandcodestyle.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com115CompleteonFillTheCompleteonFilloptionallowsspecifyingwhethertherunningtemplateshouldbecompletedwhenalltemplatefieldsarefilled.
CompleteonChangeTheCompleteonChangeoptionallowswhethertherunningtemplateshouldbecompletedwhenthereisanychangeoccurredinthedocumentoutsideoftemplate.
ExpandinContextThisgroupprovidesoptionsthoseallowspecifyingthecontextapplicabletoexpandthistemplate.
CodeThisoptionspecifieswhetherthistemplatecanbeexpandedinJavacode(reservedwords,identifiers,expressionsetc.
).
ShortenFullClassNamesThisoptionspecifieswhetherallknownclasses'referencesfromthetemplatecodeshouldbeshortenaswellasappropriateimportstatementsshouldbeadded.
Thisgroupprovidesoptionsthoseallowspecifyingthedocumenttypeapplicabletoexpandthistemplate.
FieldsPageExpandinDocumentTheFieldspageallowsmaintainingthefieldsarebelongingtothetemplateisbeingediting.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com116Figure128EditTemplateDefinitionDialog–FieldsPageFieldsTheFieldstableshowsthelistoffieldsdefinedinthetemplateanditallowsselectionofparticularfieldtomaintain.
Inthistableeachfieldoccupiesonerowandeachtablecolumnrepresentsparticularfields'attribute.
TheNameandExpressioncolumnsshowthenameandcalculateexpressionforthefield.
TheInUsecolumnshowswhetherthisfieldisusedsomewhereinthetemplatecode.
NewTheNewbuttonallowscreationofanewfield.
EditTheEditbuttonallowsmaintenanceofcurrentlyselectedfield.
CopyTheCopybuttonallowscreationofanewfieldusingcurrentlyselectedfieldasaprototype.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com117RemoveTheRemovebuttonallowsremovalofcurrentlyselectedfield.
ShortcutsPageTheShortcutspageallowsassigningkeyboardshortcutstothetemplatefortheeachkeymapsinstalledintheJBuilder.
Figure129EditTemplateDefinitionDialog–ShortcutsPageShortcutsTheShortcutstableshowsthelistofkeymapsalongwithshortcutsassignedtothetemplatefortheeachparticularkeymap.
ChangeTheChangebuttonallowsassigningorchangingtheshortcutfortheselectedkeymap.
OnpressingthisbuttontheAssignKeyStrokedialogisshowingthatallowsdefiningtheshortcutsattributes.
RemoveTheRemovebuttonallowsremovalofshortcutfortheselectedkeymap.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com118EditTemplateFieldDialog–Pro!
Thisdialogallowsmaintenanceoftemplatefieldproperties.
Figure130EditTemplateFieldDefinitionDialogThefollowingoptionsareavailable:GeneralNameTheNamefieldallowsspecifyingthenameofthetemplatefield.
Pleasenotethatthisnameshouldbeuniquewithinparticulartemplate.
DefaultValueTheDefaultValuefieldallowsspecifyingtheinitialvalueshouldbeassignedtothefieldontemplateexecution.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com119CompleteonInitTheCompleteonInitcheckboxspecifieswhetherthefieldshouldbecompletedifitgetsavalueafterinitialization.
Completedfieldsarerepresentedintherunningtemplateassimplefragmentsofcoderathertheneditors.
ExpressionsThisgroupallowsspecifyingtheexpressionsapplicabletodifferentstagesoftemplatefieldlifecycle.
TheCheckbuttonallowscheckingenteredexpressionstoavoidsyntaxerrors.
OnInitTheOnIniteditorpaneallowsspecifyingtheexpressionwillbeevaluatedtoassigninitialvalueforthetemplatefield.
OnCalculateTheOnCalculateeditorpaneallowsspecifyingtheexpressionwillbeevaluatedtoassignvalueforthetemplatefieldtoreflectchangesinthisoneorinotherfields.
OnChangeTheOnChangeeditorpaneallowsspecifyingtheexpressionwillbeexecutedtomakesomeactionstoreflectvaluechangesofthisfield.
Pleasenotethatifthisexpressionreturnssomevalue,thisvaluewillbeignoredsoexecutionofthisexpressioncan'tchangeanyfieldsanyway.
IsDefaultThisgroupallowsdefiningthepolicyandconditionsusedtodeterminewhetherthisfieldshouldbefirstfocusedoneontemplateexpand.
Thefollowingoptionsareavailable:NoneIfthisoptionisturnedon,thisfieldcanbethefirstfocusedfieldonlyiftherearenoothercandidatefields.
WhenhasValueIfthisoptionisturnedon,thisfieldcanbethefirstfocusedfieldonlyifithasvalueafterinitialization.
WhenhasnoValueIfthisoptionisturnedon,thisfieldcanbethefirstfocusedfieldonlyifithasnovalueafterinitialization.
AlwaysIfthisoptionisturnedon,thisfieldcanbethefirstfocusedfieldwithoutanyconditions.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com120ThisgroupdefineswhichfieldshouldbefocusedwhentheuserpressestheEnterkeywithinthisfield.
Thefollowingoptionsareavailable:Fields'TraversalNextFieldIfthisoptionisturnedon,thenextfieldwiththedifferentnamewillbefocused.
NextDefaultFieldIfthisoptionisturnedon,thefieldtobefocusedwillbedeterminedusingtheDefaultPolicyoftherestoffields.
Productivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com121IDEOptionsDialogTheIDEOptionsdialogincludesapropertypageaddedbyProductivity!
,whichallowsusertoselecttheMetalthemetobeusedbyJBuilderandcustomizeTaskListRemindersoptions.
TheLook&FillImprovementsgroupprovidesthethemestoselectfromfortheMetallookandfeel.
Look&FillImprovementsProductivity!
allowsyoutocustomizethecurrentthemeofSwingMetalLF.
Therearetwoadditionalthemesadded-PlainSteelandPlainSteel(W2K).
Figure131MetalthemeoptionsBelowyoucanseethesamplesofUIunderdifferentthemes.
Figure132DefaultSteelMetalThemesampleFigure133PlainSteelThemesampleIfyouareusingMetalLF,youmayselectoneofthethemesprovided.
Plainthemesaresimilartothestandardoneastheyarederivedfromit,howevertheboldattributesoffontswereremovedandthefontsizewasslightlydecreased.
PlainSteel(W2K),inProductivity!
-OptionsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com122addition,setsfontstothemimiconesusedinWindows2000(Tahoma)andthereforerequiresthisfonttobeinstalled.
TaskListReminders-Pro!
TheTaskListRemindersgroupsallowsyoutotunehowProductivity!
shouldhandleremindersdefinedintheTaskList.
Figure134TaskListRemindersGroupThisgroupincludesthefollowingoptions:Showreminders[]beforeduedateAllowstospecifytimeintervalshouldbeusedtoshowreminderbeforereminder'staskduedate.
Asunitsoftimeintervalmeasurementminutes,hoursordaysmaybeselected.
MaximumreminderstoshowAllowsspecifyingthemaximalamountofremindersthosemaybesimultaneouslyvisible.
PlaySoundProvidesabilitytospecifythatsomesoundshouldbeplayedonreminderdisplayingandassignappropriatesoundfileshouldbeusedbyreminder.
Productivity!
KeyBindingsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com123Productivity!
KeyBindingsProductivity!
supportsallJBuilderbuilt-inkeymaps,suchas:1.
Brief2.
CUA3.
Emacs4.
Macintosh(Mac)5.
MacintoshCodeWarrior(MacCW)6.
VisualStudio(VS)Also,anadditionalkeymapisprovided–MacSafe,intendedtoimproveProductivity!
usabilityontheMacintoshplatform.
IfyouuseProfessionalorEnterpriseeditionofJBuilder,youareabletocustomizetheseshortcutsbyusingeitherEditorOptions|Editor|Keymap|Customize.
.
.
orIDEOptions|Browser|Keymap|Customize.
.
.
dialogs.
AlltheProductivity!
shortcutsareplacedintheProductivity!
group.
NOTE:Productivity!
KeyBindingsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com124KeyBindingsforCUA,BriefandVisualStudiokeymapsThefollowingtableoutlinestheshortcutstoProductivity!
features.
ForadetaileddescriptionofthesefeaturespleaseseeProductivity!
Tools.
Table6Productivity!
KeyBindingsforCUA,BriefandVisualStudiokeymapsToolCUABriefVSClass.
InsightCtrl+Alt+SpaceCtrl+Alt+SpaceCtrl+Alt+SpaceClass.
InsightCtrl+Alt+HCtrl+Alt+HCtrl+Alt+HBrowse.
InsightCtrl+MinusCtrl+Shift+MinusCtrl+MinusBrowse.
MembersAlt+MinusCtrl+Alt+MinusAlt+MinusHelp.
InsightShift+F1Shift+F1Shift+F1Help.
Insight.
OnMembersAlt+F1Alt+F1Alt+F1Implement.
InsightCtrl+Alt+ICtrl+Alt+ICtrl+Alt+IOverride.
InsightCtrl+MCtrl+MCtrl+MConstructor.
InsightCtrl+Shift+MCtrl+Shift+MCtrl+Shift+MContext.
InsightCtrl+QCtrl+QCtrl+QImports.
BeautifyCtrl+Alt+BCtrl+Alt+BCtrl+Alt+BSmart.
InstantiateAlt+ICtrl+Shift+IAlt+IHyperlink.
NavigateCtrl+MOUSECtrl+MOUSECtrl+MOUSEHyperlink.
HelpAlt+MOUSEAlt+MOUSEAlt+MOUSEEasy.
JavaDocCtrl+DCtrl+Alt+DCtrl+Alt+DEasy.
JavaDoc.
InsightCtrl+Shift+DCtrl+Shift+DCtrl+Shift+DGetSet.
CreatorAlt+Shift+ACtrl+Shift+AAlt+Shift+AGet.
CreatorAlt+Shift+GCtrl+Shift+GCtrl+Shift+GSet.
CreatorAlt+Shift+SCtrl+Shift+SCtrl+Shift+SProductivity!
KeyBindingsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com125Table7Productivity!
ProKeyBindingsforCUA,BriefandVisualStudiokeymapsToolCUABriefVSAssistantsAlt+EnterAlt+EnterAlt+EnterDelegate.
InsightAlt+Shift+MAlt+Shift+MAlt+Shift+MFind.
Matching.
BraceCtrl+\Ctrl+\Ctrl+\Find.
Matching.
CodeCtrl+Shift+\Ctrl+Shift+\Ctrl+Shift+\Introduce.
ConstructorsAlt+Shift+CAlt+Shift+CAlt+Shift+CNavigator.
InsightAlt+Shift+NAlt+Shift+NAlt+Shift+NNavigator.
NextCtrl+PageDownAlt+PageDownCtrl+PageDownNavigator.
PreviousCtrl+PageUpAlt+PageUpCtrl+PageUpPersistent.
Bookmarks.
NavigateAlt+Shift+BAlt+Shift+BAlt+Shift+BSelect.
ClassNotAssignedNotAssignedNotAssignedSelect.
CodeBlockNotAssignedNotAssignedNotAssignedSelect.
MethodNotAssignedNotAssignedNotAssignedSelect.
StatementNotAssignedNotAssignedNotAssignedSelection.
NarrowCtrl+Shift+WCtrl+Shift+WCtrl+Shift+WSelection.
ExpandCtrl+WAlt+Shift+WCtrl+WSmart.
Clipboard.
InsightALt+Shift+VALt+Shift+VALt+Shift+VSmart.
Clipboard.
PopPasteCtrl+Alt+InsertCtrl+Alt+InsertCtrl+Alt+InsertSmart.
Clipboard.
SwapCtrl+Shift+InsertCtrl+Shift+InsertCtrl+Shift+InsertSmart.
Templates.
ExpandCtrl+JCtrl+JCtrl+JSmart.
Templates.
ExpandLastCtrl+Shift+JCtrl+Shift+JCtrl+Shift+JSmart.
Templates.
ExpandOnTheFlyAlt+Shift+JAlt+Shift+JAlt+Shift+JHighlightLocalReferencesCtrl+Alt+EnterCtrl+Alt+EnterCtrl+Alt+EnterProductivity!
KeyBindingsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com126KeyBindingsforEmacs,MacintoshandMacintoshCodeWarriorkeymapsThefollowingtableoutlinestheshortcutstoProductivity!
features.
ForadetaileddescriptionofthesefeaturespleaseseeProductivity!
Tools.
Table8Productivity!
KeyKeyBindingsforEmacs,MacintoshandMacintoshCodeWarriorkeymapsToolEmacsMacMacCWMacSafeClass.
InsightCtrl+Alt+SpaceCtrl+Alt+SpaceCtrl+Alt+SpaceCtrl+Alt+SpaceClass.
InsightCtrl+Alt+HCtrl+Alt+HCtrl+Alt+HCtrl+Alt+HBrowse.
InsightCtrl+MinusCtrl+MinusCtrl+MinusCtrl+MinusBrowse.
MembersAlt+MinusAlt+MinusAlt+MinusAlt+MinusHelp.
InsightShift+F1Shift+F1Shift+F1Shift+F1Help.
Insight.
OnMembersAlt+F1Alt+F1Alt+F1Alt+F1Implement.
InsightCtrl+Alt+ICtrl+Alt+ICtrl+Alt+ICtrl+Alt+IOverride.
InsightCtrl+Alt+MCtrl+MCtrl+MCtrl+MConstructor.
InsightCtrl+Shift+MCtrl+Shift+MCtrl+Shift+MCtrl+Shift+MContext.
InsightCtrl+QCtrl+QCtrl+QCtrl+QImports.
BeautifyCtrl+Shift+BCtrl+Alt+BCtrl+Alt+BCtrl+Alt+BSmart.
InstantiateAlt+IAlt+IAlt+IAlt+IHyperlink.
NavigateCtrl+MOUSECtrl+MOUSECtrl+MOUSECtrl+MOUSEHyperlink.
HelpAlt+MOUSEAlt+MOUSEAlt+MOUSEAlt+MOUSEEasy.
JavaDocCtrl+Alt+DCtrl+DCtrl+DCtrl+DEasy.
JavaDoc.
InsightCtrl+Shift+DCtrl+Shift+DCtrl+Shift+DCtrl+Shift+DGetSet.
CreatorAlt+Shift+AAlt+Shift+AAlt+Shift+AAlt+Shift+AGet.
CreatorAlt+Shift+GAlt+Shift+GAlt+Shift+GAlt+Shift+GSet.
CreatorAlt+Shift+SAlt+Shift+SAlt+Shift+SAlt+Shift+SProductivity!
ToolsIconsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com127Table9Productivity!
ProKeyBindingsforEmacs,MacintoshandMacintoshCodeWarriorkeymapsToolEmacsMacMacCWMacSafeAssistantsAlt+EnterAlt+EnterAlt+EnterAlt+EnterDelegate.
InsightAlt+Shift+MAlt+Shift+MAlt+Shift+MAlt+Shift+MFind.
Matching.
BraceCtrl+\Ctrl+\Ctrl+\Ctrl+\Find.
Matching.
CodeCtrl+Shift+\Ctrl+Shift+\Ctrl+Shift+\Ctrl+Shift+\Introduce.
ConstructorsAlt+Shift+CAlt+Shift+CAlt+Shift+CAlt+Shift+CNavigator.
InsightAlt+Shift+NAlt+Shift+NAlt+Shift+NAlt+Shift+NNavigator.
NextCtrl+PageDownAlt+PageDownCtrl+PageDownCtrl+PageDownNavigator.
PreviousCtrl+PageUpAlt+PageUpCtrl+PageUpCtrl+PageUpPersistent.
Bookmarks.
NavigateAlt+Shift+BAlt+Shift+BAlt+Shift+BAlt+Shift+BSelect.
ClassNotAssignedNotAssignedNotAssignedNotAssignedSelect.
CodeBlockNotAssignedNotAssignedNotAssignedNotAssignedSelect.
MethodNotAssignedNotAssignedNotAssignedNotAssignedSelect.
StatementNotAssignedNotAssignedNotAssignedNotAssignedSelection.
NarrowCtrl+Shift+WCtrl+Shift+WCtrl+Shift+WCtrl+Shift+WSelection.
ExpandCtrl+WAlt+Shift+WCtrl+WCtrl+WSmart.
Clipboard.
InsightALt+Shift+VALt+Shift+VALt+Shift+VALt+Shift+VSmart.
Clipboard.
PopPasteCtrl+Alt+InsertCtrl+Alt+InsertCtrl+Alt+InsertCtrl+Alt+InsertSmart.
Clipboard.
SwapCtrl+Shift+InsertCtrl+Shift+InsertCtrl+Shift+InsertCtrl+Shift+InsertSmart.
Templates.
ExpandCtrl+JCtrl+JCtrl+JCtrl+JProductivity!
ToolsIconsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com128Smart.
Templates.
ExpandLastCtrl+Shift+JCtrl+Shift+JCtrl+Shift+JCtrl+Shift+JSmart.
Templates.
ExpandOnTheFlyAlt+Shift+JAlt+Shift+JAlt+Shift+JAlt+Shift+JHighlightLocalReferencesCtrl+Alt+EnterCtrl+Alt+EnterCtrl+Alt+EnterCtrl+Alt+EnterProductivity!
ToolsIconsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com129Productivity!
ToolsIconsThefollowingtableshowsiconsusedbytoolsincludedintoProductivity!
Table10.
Productivity!
ToolsIconsIconDescriptionBrowse.
InsightusedforfastbrowsingclassesusingshortclassnamesBrowse.
MembersusedforfastbrowsingdeclaredmembersofaclassClass.
InsightallowsfindingandinsertingaclassusingashortclassnameEasy.
JavaDocprovideseasygenerationofJavaDocforselectedmembersEasy.
JavaDoc.
InsightprovideseasygenerationofJavaDocforselectedmembersGet.
CreatoreasycreationofgettersGetSet.
CreatoreasycreationofgettersandsettersforselectedfieldsSet.
CreatoreasycreationofsettermethodsImplement.
InsightusedforfastinterfaceimplementingSmart.
InstantiateallowsyoutoinstantiateaclassvariableorevenimplementananonymousclassinsecondsConstructor.
InsightallowsyoutoquicklycreateconstructorsOverride.
InsightallowsyoutoeasilyoverridemethodsContext.
InsightallowsyoutocheckthecurrentcontextandnavigatefromthereHelp.
Insightallowseasyviewingofhelptopics(ifany)foranidentifierwithinthecurrentcontextinthecursorpositionHelp.
Insight.
OnMembersallowseasyviewingofhelptopicsforamemberwithinthecurrentcontextinthecursorpositionSmart.
BracesoptionsiconCacheRefreshActionsGroupFullrefreshofProductivity!
classescacheRefreshcacheforclassesincludedintoselectedRefreshGroupsRefreshcacheforclassesincludedintoprojectlibrariesRefreshcacheforclassesincludedintoprojectonlyProductivity!
ToolsIconsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com130ProfessionalEditionTools'IconsDelegate.
Insightprovidesaneasywaytogeneratemethods,whichimplementationsaredelegatedtoanotherobject(delegate).
Introduce.
Constructorallowseasygenerationofconstructorsintendedtoinitializeappropriatefieldsoftheclass.
ExpandsSmart.
TemplatewiththenamecorrespondingthewordatcaretorinvokesSmart.
Templates.
Insight.
InvokesPersistent.
Bookmarks.
Navigatethatallowsnavigationtodesiredbookmark.
Thistoolallowsviewingoflocalclipboardqueueandpastingoneorseveralselectedfragmentsintheeditor.
Thisactionallowsswappingthecontentoftheclipboardwithcurrentlyselectedblockofcode.
ThisactionallowsconsecutivepoppingandpastingofcodefragmentsfromthelocalclipboardhistoryintheLIFOorder.
InvokestheNavigator.
Insightwindowthatallowschoosinganobjecttonavigate.
ThisactionallowstoexpandcurrentselectionincrementallytooutersourceelementThisactionallowtonarrowcurrentselectionincrementallytoinnersourceelement.
ShowstheTaskList,whichallowsviewingandmanagingtasks.
KnownIssuesandLimitationsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com131KnownIssuesandLimitations1.
Productivity!
ClassesCacheSinceonlypublicclassesmaybecached,thetoolsthatdependonthecacheallowworkingwiththepublicclassesonly.
Cachemaynotbeautomaticallyrefreshedduringaddingand/orremovingclasses,packages,andlibraries,aswellasuponchangestotheprojectclassandsourcepaths.
Insuchcasesyoushouldrefreshtheclasscachemanuallyorscheduletherefreshattheprojectmakeorbuild.
Toavoidusingthealreadycachedclassesthatbelongtothepreviouslyremovedpackages,youshouldrefreshthecacheforallclasses.
2.
Thetoolsthatoperatewiththewordsundercursormaysometimesimproperlyhandlethewordswithunderscores.
3.
Productivity!
shortcutsaredesignedandtestedtoeliminateanypossibleconflictswiththeJBuildershortcutsinanystandardJBuilderkeymap.
HoweverthereremainsapossibilityofconflictswithsomeofJBuilderplug-ins,otherapplicationsandthosefunctionalityoftheoperationalsystemthatusethesameshortcutsforotherpurposes.
4.
SeveraldifferentInsightsmaybeshownsimultaneously.
5.
Smart.
Instantiatealwaysallowsinstantiationofclassesthathaveconstructorswiththepackageaccessonly,withoutcheckingtheactualpackage.
6.
WorkingwithInnerClasses.
Override.
InsightandGetSet.
Creatorareunabletoplacecaretatthemethodsgeneratedforanonymousinnerclassesorforinnerclassesdefinedinthemethods.
Thecaretpositioninthiscasewillbeunchanged.
Override.
InsightandGetSet.
Creatorareunabletoresolvetheinnerclassesstatedassuperclassesorsuperinterfacesforanyotherinnerclass.
Thusitisnotpossibletooverridemethodsortogenerateaccessmethodsforthefieldsdefinedinsuchinnerclasses.
7.
Help.
Insight.
Shortcutstonon-localHTMLpagesmaynotworkforexternalbrowsersunderMicrosoftWindows2000.
JTextPaneusedinHelp.
InsightmayhangJBuilderwhendisplayinghugeHTMLpagesand/orjumpingtonon-existinganchors.
Help.
InsightmayfindclassesmembersifthedocumentationwasgeneratedincompliancewithstandardJavaDocdocletonly.
Help.
Insightmayshowimproperdocumentationpageforjava.
iopackage.
8.
ExternalbrowserinvocationworksunderWin32platformonly.
KnownIssuesandLimitationsProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com1329.
ResizingoftheInsightpopupsmaynotworkproperlyinsomecases.
10.
TheHelpbuttonintheInsightpopupsmayremainhighlightedafterinvocationofJBuilderhelpviewer.
Productivity!
FeedbackProductivity!
UserManualCopyright2000-2004jProductivityL.
L.
C.
http://www.
jproductivity.
com133Productivity!
FeedbackAspartofcontinuingeffortstoimproveourproduct,wewelcomeyourcomments,suggestionsandgeneralfeedbackontheproject.
IfyouhavequestionsaboutProductivity!
,pleasefeelfreetocontactusforfurtherinformationatproductivity@jproductivity.
comorvisitoursiteusingthefollowingURL:http://www.
jproductivity.
com.
IfyoudiscoveranyissuesordefectsinProductivity!
,pleasesendthedescriptionofthemtoproductivity@jproductivity.
com.
We'dappreciateifyoucouldprovideusadditionalinformationthatmaydefinitelyhelpustofixtheseproblems:1.
JBuilderversion.
2.
Operationalsystemversionandvendor.
3.
Listofthird-partyopentoolsinstalledinyourJBuilder.
4.
Exceptionsstacktraceandanyerroroutput.
YoucanseeitifyourunJBuilderalongwithconsole.
5.
Runningthreadsdump(itmakessenseifJBuilderisnotresponding).
YoucanseeitifyourunJBuilderalongwithconsoleandpressCtrl+Breakshortcutinthefocusedconsole