Changes for page WOLips-Eclipse beginner mistakes and questions
Last modified by Ray Kiddy on 2010/02/27 14:51
From version 134.1
edited by Johan Henselmans
on 2007/06/20 04:14
on 2007/06/20 04:14
Change comment:
There is no comment for this version
Summary
-
Page properties (4 modified, 0 added, 0 removed)
-
Attachments (0 modified, 15 added, 0 removed)
- ContextualContentAssist.png
- FilterProperties.png
- JavaPrefs.png
- JavaPrefs_10.5.8.png
- JavaRunTimeApplicationSettings.png
- LaunchArgs1.png
- Launchsaving.png
- OpenEntityModelerInNewWindowAnnot.png
- RefactorAfter.png
- Refactorbefore.png
- SeeFileinProject.png
- StrangePerspective1.png
- StrangePerspective2.png
- chooseperspective.png
- filters.png
-
Objects (0 modified, 1 added, 0 removed)
Details
- Page properties
-
- Parent
-
... ... @@ -1,0 +1,1 @@ 1 +WOLips - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. johanhenselmans1 +XWiki.kiddyr - Tags
-
... ... @@ -1,0 +1,1 @@ 1 +wikitodo|devtools - Content
-
... ... @@ -1,151 +1,201 @@ 1 1 This document tries to catch the errors that every beginner seems to have to go through before reaching Eclipse/WOLips nirvana. The path is narrow and slippery, but thou shalt be rewarded.... 2 2 3 - === The firstmostcommon error: ===3 +{{toc/}} 4 4 5 - Eclipse/WOLipsdoes not runproperlyin java 1.4.2.5 += Common errors = 6 6 7 - Runitusing**JavaVM1.5**.7 +== The first most common error: == 8 8 9 -Only Way:**1.5**.9 +Eclipse/WOLips does not run properly in java 1.4.2. 10 10 11 +Run it using **JavaVM1.5**. 12 + 13 +Only Way: **1.5**. 14 + 11 11 **One more time: 1.5** 12 12 13 - ====How to get eclipse running with Java1.5?====17 +How to get eclipse running with Java1.5? 14 14 15 - 19 +go to /Applications/Utilities/Java/J2SE 5.0/Java Preferences. Select J2SE5.0 16 16 17 -[[image:JavaRunTimeApplicationSettings.png]] 21 +[[image:attach:JavaRunTimeApplicationSettings.png]] 18 18 19 -== =The second most common error ===23 +== The second most common error == 20 20 21 -=== =I can not get help to start in my browser, things work flakey ====25 +=== I can not get help to start in my browser, things work flakey === 22 22 23 -Eclipse 3.2.2 is a big, big project. It uses lots of frameworks. Sometimes these frameworks are already in some way available in your environment, but they are old versions, that do not do the expected thing in Eclipse. I had the experience that the help did not start in the browser. If that happens to you, remove all the jars of which you are not sure why they are there in /Library/Java/Extensions. You do not have to remove things like frontbase.jar, postgresql.jar etc. 27 +{{tip}} 28 +The following is somewhat out of date - in general terms it is still true but (as of mid-Feb 2009) Eclipse 3.4(.1) is the required version for (nightly and stable) WOLips, and WOLips nightly is around build number (3.4.)5676. 29 +{{/tip}} 24 24 25 - This is actuallyfixed inEclipse3.3(Eclipse readsfirst it'sownpaths, andthenthe systempaths),butWOLips doesnotsupportEclipse3.3yet.31 +Eclipse 3.3 is a big, big project. It uses lots of frameworks. Sometimes these frameworks are already in some way available in your environment, but they are old versions, that do not do the expected thing in Eclipse. I had the experience that the help did not start in the browser. If that happens to you, remove all the jars of which you are not sure why they are there in /Library/Java/Extensions. You do not have to remove things like frontbase.jar, postgresql.jar etc. 26 26 27 - ===Thethirdmostcommon error===33 +This should actually fixed in Eclipse 3.3 (Eclipse reads first it's own paths, and then the system paths), but WOLips supports Eclipse3.3 only in the nightly builds. For 3.2.2 you should use the stable build. 28 28 29 -== ==WOLips doesnotbehave likeyou describe.(Usenightly)====35 +== The third most common error == 30 30 31 -WOLips updatesoften. And althoughthereis a stablersion,the nightly version is whereit's at. It is used in production bythe wonderfulpeople from MDimension whodevelop WOLipsand otherWebObjects developers.Ifsomethingbreaks innightly,it gets fixed immediately.They dependonit themselves.37 +=== WOLips does not behave like you describe. (Use nightly only on 3.3) === 32 32 33 - http:~/~/webobjects.mdimension.com/wolips/nightly/shouldbe inyourEclipseupdate site,underHelp->SoftwareUpdate->Find andinstall->Searchfor newfeaturesto install39 +WOLips updates often. There is a stable version, (4118) that should be used on Eclipse 3.2.2, the nightly version is where it's at now for 3.3 (Officially released 29th of june 2007). It is used in production by the wonderful people from MDimension who develop WOLips and other WebObjects developers. If something breaks in nightly, it gets fixed immediately. They depend on it themselves. 34 34 35 -= ==Thefourthmostcommon error===41 +[[http:~~/~~/webobjects.mdimension.com/wolips/nightly/>>url:http://webobjects.mdimension.com/wolips/nightly/||shape="rect"]] should be in your Eclipse update site, under Help->Software Update->Find and install->Search for new features to install 36 36 37 -== ==I can not install theprojects I built, theWOLipsinstalldoes notwork,strange things happen. (be admin)====43 +== The fourth most common error == 38 38 39 - Allthoughweall knowthat we shouldnotrun as admin, for installingEclipse you'd better be. If youhaveinstalled Eclipseon oneof thecommon places, or ithasbeeninstalled for you, than thepermission from the Eclipsefolder will prevent you to installWOLips andther plugins.Make surethat,if you areinstallingplugins,Youareallowedtodoso.45 +=== I can not install the projects I built, the WOLips install does not work, strange things happen. (be admin) === 40 40 41 - ====More admin problems====47 +Allthough we all know that we should not run as admin, for installing Eclipse you'd better be. If you have installed Eclipse on one of the common places, or it has been installed for you, than the permission from the Eclipse folder will prevent you to install WOLips and other plugins. Make sure that, if you are installing plugins, You are allowed to do so. 42 42 43 -If installingyourframeworksdoesnotwork,thanitmightbethat youareunningasa plain user,not adminuser.TheWOLips antinstallbydefaulttriesto installin /Library/Frameworks,and Apps in /Library/WebObjects/JavaApplications.As a plainuseryoushouldnothavepermissionto write there.49 +If you are working on a Mac where multiple users will need to use Eclipse, you have to change Eclipse's permissions because it will not allow other people to install features, even if they are in the admin group. 44 44 45 - === Userquestions===51 +More admin problems 46 46 47 - ====Why don'tIsee allmy files?====53 +If installing your frameworks does not work, than it might be that you are running as a plain user, not admin user. The WOLips ant install by default tries to install in /Library/Frameworks, and Apps in /Library/WebObjects/Applications. As a plain user you should not have permission to write there. 48 48 55 += User questions = 56 + 57 +== I created a component but I don't see it in the Components folder! == 58 + 59 +When you create a new component, it will put the component into the highlighted folder in the Package Explorer. For example, if the current highlighted folder is the project name, the component will be created in the top-level folder of the project. So you will find your component there and you can move it to the Components folder. 60 + 61 +So when you create a new component, make sure that you highlight the Components folder, or right-click on the Components folder and select New->Component, it will be created into the good folder. 62 + 63 +== Why don't I see all my files? == 64 + 49 49 Not all the files are presented, some are filtered away. In Package Explorer (In WOLips pespective, the upper left window), go to the right corner of that window, there is a caret. Under this caret, there is a Filter option.Click on it to see what get's filtered away. 50 50 51 -[[image:filters.png]] 67 +[[image:attach:filters.png]] 52 52 53 53 As you can see, quite a lot of files are excluded from the view. 54 54 55 -[[image:FilterProperties.png]] 71 +[[image:attach:FilterProperties.png]] 56 56 57 -== ==Where did all my code go?==73 +== Where did all my code go? == 58 58 59 59 Suppose you suddenly ended up with something like this: 60 60 61 -[[image:StrangePerspective1.png]] 77 +[[image:attach:StrangePerspective1.png]] 62 62 63 63 Or this: 64 64 65 -[[image:StrangePerspective2.png]] 81 +[[image:attach:StrangePerspective2.png]] 66 66 67 67 Most of the times this is caused by inadvertently clicking on the menu-bar of the subwindow. That window will then fill the whole workspace.Clicking the menubar one more time will restore the view. 68 68 69 69 Or it is happened because your perspective has changed inadertently, because you clicked on a file that caused another perspective to be fired up (like Entitymodeler) You can go to the top right, where there is a place where the currently loaded perspectives are located. Choose WOLips again. You're done. 70 70 71 -[[image:chooseperspective.png]] 87 +[[image:attach:chooseperspective.png]] 72 72 73 -== ==I have the right perspective, but it is all screwed up.==89 +== I have the right perspective, but it is all screwed up. == 74 74 75 -That happens. A lot, if you are inexperienced. And even if you are experienced. Eclipse does some things inadvertently, and as it does not conform to the Apple Interface guidelines, you might press something that has an other effect in Eclipse. 91 +That happens. A lot, if you are inexperienced. And even if you are experienced. Eclipse does some things inadvertently, and as it does not conform to the Apple Interface guidelines, you might press something that has an other effect in Eclipse. 76 76 77 -Do not worry: there is a menu button, Windown->Reset Perspective that will give you the original settings back. 93 +Do not worry: there is a menu button, Windown->Reset Perspective that will give you the original settings back. 78 78 79 -== ==Which file from which project am I editing? ====95 +== Which file from which project am I editing? == 80 80 81 -If you open a lot of projects at the same time, you'll sometime find yourself editing a few Session.java or localizable.strings files at the same time. 97 +If you open a lot of projects at the same time, you'll sometime find yourself editing a few Session.java or localizable.strings files at the same time. How can you see which file from what project you are editing? There is a simple trick for that: in the Package Explorer window, click on the icon with the two arrows on it. From now on, if you select another file in the editor window, you'll be directed to that file in the project in Package Explorer. 82 82 83 -[[image:SeeFileinProject.png]] 99 +[[image:attach:SeeFileinProject.png]] 84 84 85 -== ==Another app is running than I expected: ====101 +== Another app is running than I expected: == 86 86 87 -Running an app works a bit different from running an app in XCode. 103 +Running an app works a bit different from running an app in XCode. 88 88 89 -Normally you select the project in the Package Explorer, goto to the contextual menu (via right click), then click Run WOApplication. you can also go to the Run menu. Or to the Run icon. 105 +Normally you select the project in the Package Explorer, goto to the contextual menu (via right click), then click Run WOApplication. you can also go to the Run menu. Or to the Run icon. 90 90 91 91 Don't suppose you are running the app you are running because you selected the project and pressed the run button in the toolbar. It will run the last application you have run, no matter what you have selected in the package explorer. You have to do a "run as", select your program and then you might get your app. 92 92 93 -== =I want to run my app with some other arguments.=109 +== I want to run my app with some other arguments. == 94 94 95 -The way eclipse works, it saves a set of arguments in which your app has run. This set of arguments have some default settings, depending on which type of application you are running. You can save these arguments in your project, for later use. 111 +The way eclipse works, it saves a set of arguments in which your app has run. This set of arguments have some default settings, depending on which type of application you are running. You can save these arguments in your project, for later use. 96 96 97 -== ==Changing the Launch arguments: ====113 +== Changing the Launch arguments: == 98 98 99 -Select Project in Package Explorer, 115 +Select Project in Package Explorer, from menu choose Run->Run... , from contextual menu choose Run As->Run 100 100 101 -[[image:LaunchArgs1.png]] 117 +[[image:attach:LaunchArgs1.png]] 102 102 103 -You'll get into the create,manage and run configurations window. If there are any launch configurations available in your projects, you will already see them here. If there aren't any, a new one will be created. 119 +You'll get into the create,manage and run configurations window. If there are any launch configurations available in your projects, you will already see them here. If there aren't any, a new one will be created. Normally the proper settings for a WOApplication are all in place, if you have created the application from the contextual menu. See the tutorials. 104 104 105 -No rmallytheproper settingsforaWOApplication are allinplace,ifyouhavecreated the applicationfromthecontextualmenu.Seethetutorials.121 + Note that if you are overriding a parameter supplied by WebObjects, such as WOPort or WOAutoOpenInBrowser, then you need to add the parameter settings in the Arguments tab that you see above. For example, you can add "-WOPort 55555 -WOAutoOpenInBrowser NO". BUT, you also need to uncheck these entries in the "WO" tab above. If you do uncheck them, your suggestions may be ignored. 106 106 107 -By default these settings are stored in the workspace, not in the project. If you want to store them in the project, you have to change the settings under the "Common" tab, from "local" file to "shared file", and you can save it then in your project for future use. 123 +By default these settings are stored in the workspace, not in the project. If you want to store them in the project, you have to change the settings under the "Common" tab, from "local" file to "shared file", and you can save it then in your project for future use. 108 108 109 -[[image:Launchsaving.png]] 125 +[[image:attach:Launchsaving.png]] 110 110 111 -== ==I want to open EntityModeler in a new window, so it does not get in the way of WOLips ====127 +== I want to open EntityModeler in a new window, so it does not get in the way of WOLips == 112 112 113 113 There is a setting in the WOLips preferences, which will get your EOModel started in a separate EntityModelere window: 114 114 115 -[[image:OpenEntityModelerInNewWindowAnnot.png]] 131 +[[image:attach:OpenEntityModelerInNewWindowAnnot.png]] 116 116 117 -== ==I see all that magic typing with code completion going on. How do you do that? ====133 +== I see all that magic typing with code completion going on. How do you do that? == 118 118 119 -The shortcut is C MD-space on the Mac, by default. It is also known as contextual assist.135 +The shortcut is Control-space on the Mac, by default. It is also known as contextual assist. 120 120 121 -Actually, it is real magic. The trick is that it works in a contextual way. So the program knows what kind code can be expected where. MD-Space, and you will get the possible endings.137 +Actually, it is real magic. The trick is that it works in a contextual way. So the program knows what kind code can be expected where. For instance, if you are inside the bindings of a WOComponent, it will know which bindings are there. Just press Control-Space, and you will get the possible endings. 122 122 123 -[[image:ContextualContentAssist.png]] 139 +[[image:attach:ContextualContentAssist.png]] 124 124 125 -==== Which shortcuts are available? ==== 141 +{{warning}} 142 +Please note that Control-Space is also the key combo for Spotlight. You need to either change the key combo for Eclipse (Preferences->General->Keys) or for Spotlight (System Prefences->Spotlight). 143 +{{/warning}} 126 126 145 +== Which shortcuts are available? == 146 + 127 127 I don't know. It depends on the plugins you are running. Fortunately, there is a shortcut to end all shortcuts: 128 128 129 -cmd-shift-l= show the shortcuts in a popup-window. Pressing cmd-shift-l one more time will show you all the shortcuts via the preferences. 149 +cmd-shift-l= show the shortcuts in a popup-window. Pressing cmd-shift-l one more time will show you all the shortcuts via the preferences. 130 130 131 131 Some general Eclipse shortcuts: 132 132 133 133 cmd-1 = Quickfix: suggest you a fix for your errror 134 -cmd-e = quick switch to other open documents 135 -cmd-space = completion, also known as content assist. This one screws up with the standard settings for Spotlight, which are also cmd-space. Some have tried to move cmd-space to something else in Eclipse, but that does not seems to be picked up everywhere. Better replace Spotlight to something else. 154 + cmd-e = quick switch to other open documents 155 + cmd-space = completion, also known as content assist. This one screws up with the standard settings for Spotlight, which are also cmd-space. Some have tried to move cmd-space to something else in Eclipse, but that does not seems to be picked up everywhere. Better replace Spotlight to something else. 136 136 137 137 Some shortcuts that are available from WOLips (gracefully donated by Mike Schrag): 138 138 139 139 Ten ShortCut Commandments for Mike: 140 -cmd-shift-t = open type 141 -cmd-shift-r = open resource 142 -cmd-shift-o = auto-import 143 -cmd-opt-r = refactor rename (global) 144 -cmd-2 r = refactor local rename 145 -cmd-opt-1 / 2 / 3 = switch between java/wod/html 146 -cmd-o = in-place outline view 147 -cmd-o o = include superclass 148 -cmd-shift-g = show references 149 -F3 = go to declaration 160 + cmd-shift-t = open type 161 + cmd-shift-r = open resource 162 + cmd-shift-o = auto-import 163 + cmd-opt-r = refactor rename (global) 164 + cmd-2 r = refactor local rename 165 + cmd-opt-1 / 2 / 3 = switch between java/wod/html 166 + cmd-o = in-place outline view 167 + cmd-o o = include superclass 168 + cmd-shift-g = show references 169 + F3 = go to declaration 150 150 151 -Another nice overview of shortcuts that Edgar Klein sent me can be found here: [[http://eclipse-tools.sourceforge.net/Keyboard_shortcuts_(3.0).pdf]]. It can be even printed out on one double page, so you can put it above your bed. 171 +Another nice overview of shortcuts that Edgar Klein sent me can be found here: [[http:~~/~~/eclipse-tools.sourceforge.net/Keyboard_shortcuts_(3.0).pdf>>url:http://eclipse-tools.sourceforge.net/Keyboard_shortcuts_(3.0).pdf||shape="rect"]]. It can be even printed out on one double page, so you can put it above your bed. 172 + 173 +== I have the choice of doing a WOApplication or a WOnderApplication, which one should I use ? == 174 + 175 +If you use WOLips/Eclipse 3.2, or if you use a WOLips 3.3 from before December 2007, the layout for the WOApplication and for the WOnder Application was quite different. Starting in recent (December 2007 and later) builds of WOLips, the layout is the same ("WebObjects Application" use the "Wonder" layout), the only difference between them is that the Wonder-type application and framework will link to the Wonder frameworks (ERJars and ERExtensions), Application.java will extend from ERXApplication and Session.java will extend from ERXSession. 176 + 177 +If you are using a old build of WOLips, you should use the Wonder layout, you just need to remove the references to ER* if you don't use Wonder. 178 + 179 +== If I right-click on an folder and select "New", I don't see "EOModel" or "WOComponent" as options. == 180 + 181 +Make sure that your current perpective is "WOLips", if you are in the "Java" or "J2EE" perpective, all WebObjects-related file types are not available. 182 + 183 +== Component Bindings are Showing Errors, but No Error Is Present == 184 + 185 +This can occur for example where you are overriding {{code language="none"}}valueForKey(..){{/code}} and so the component editor is not able to know that a keypath is valid. In this case add {{code language="none"}}//VALID{{/code}} at the end the association and Eclipse will stop taking this to be a bad binding. An example follows; 186 + 187 +{{noformat}} 188 + 189 +SomeString : WOString { 190 +value = foo.bar; //VALID 191 +} 192 + 193 +{{/noformat}} 194 + 195 +== Classpath Order == 196 + 197 +[App] 198 + [Non-App-Projects] 199 + [Non-Apple-Framework jars] 200 + [Apple-Framework jars] 201 + [normal jars (everything not named Foo.framework/../Foo.jar)]
- ContextualContentAssist.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +64.4 KB - Content
- FilterProperties.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +49.7 KB - Content
- JavaPrefs.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +77.8 KB - Content
- JavaPrefs_10.5.8.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +48.5 KB - Content
- JavaRunTimeApplicationSettings.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +82.3 KB - Content
- LaunchArgs1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +99.2 KB - Content
- Launchsaving.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +155.3 KB - Content
- OpenEntityModelerInNewWindowAnnot.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +111.3 KB - Content
- RefactorAfter.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +58.4 KB - Content
- Refactorbefore.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +53.1 KB - Content
- SeeFileinProject.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +111.3 KB - Content
- StrangePerspective1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +93.9 KB - Content
- StrangePerspective2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +87.7 KB - Content
- chooseperspective.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +28.7 KB - Content
- filters.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.XWikiGuest - Size
-
... ... @@ -1,0 +1,1 @@ 1 +90.7 KB - Content
- XWiki.XWikiComments[0]
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.probert - Comment
-
... ... @@ -1,0 +1,1 @@ 1 +We need to fix the headers levels so it's easier to read and the TOC make sense. - Date
-
... ... @@ -1,0 +1,1 @@ 1 +2007-12-20 08:45:48.0