Setting up a consistent development environment in Java is way harder than it looks. It would be great if this could be automated. Until that time here is a record of the manual steps taken to setting up the BonsaiFramework,
Configure Eclipse Editor for UTF-8
On a Linux environment the Text file encoding will already default to UTF-8 so you can skip this step.
On the Windows environment, the default encoding is not UTF-8. As such modification need to be made ensure special characters work properly.
Enable UTF-8 for Java Files
All our property files must be UTF-8 with no BOM (Byte Order Marking). For Eclipse to properly edit the UTF-8 property files,
- Window, Preferences
- General, Content Types, Text,
- Java Properties File
- Change Default encoding from ISO-8859-1 to UTF-8
- Click Update
- JSP
- Change Default encoding from ISO-8859-1 to UTF-8
- Click Update
- Java Properties File
- General, Workspace *
- Text file encoding, Other
- Change Cp1252(this may differ depending on your OS) to UTF-8
- Click Apply
Enable UTF-8 for Web Files
This changes what format and automatic encoding tags used when you use Eclipse wizards to create web file.
- Window, Preferences, Web
- Encoding, change the following to ISO 10646/Unicode(UTF-8),
- CSS Files
- HTML Files
- JSP Files
This article http://www.eclipsezone.com/eclipse/forums/t93442.rhtml shows how to do it with a file in Windows. I am a bit suspicious if this covers everything though... need to confirm.
Create Web Application Project
At this point there are two methods of setting up the Project, manual or automatic.
Configure Web Jar Files
Eclipse by default does not ship with the Java Servlet library file servlet.jar. As far as I understand it, this is on purpose as this library file resides with your particular application server.
So you must manually do this.
Two techniques here... not sure if happy with it - http://tech.amikelive.com/node-269/eclipse-quick-tip-resolving-error-the-import-javaxservlet-cannot-be-resolved/