This article is being pulled from the www.tinframework.homeip.net.
The BonsaiFramework uses a portable development environment that is composed of the following components,
- Eclipse
- Java
- Tomcat
To get quickly started download the package that matches your operating system. Unzip the package and launch Eclipse.
Package |
Operating Systems |
---|---|
Win.32bit_Eclipse.x.x-JRE.1.6_18_32-bit-Tomcat.6.0.26_x86_32-bit.zip |
Windows XP - Windows 7 |
Win.64bit_Eclipse.x.x-JRE.1.6_18_64-bit-Tomcat.6.0.26_x86_32-bit.zip |
Windows 64-bit XP - Windows 7 |
Linux_Eclipse.x.x-JRE.1.6_18_32-bit-Tomcat.6.0.26.zip |
Ubuntu 8.x - Current |
Win.64bit_Eclipse.x.x-JRE.1.6_18_64-bit-Tomcat.6.0.26_x86_32-bit |
Ubuntu 64-bit 8.x - Current |
Following the portability principle of the Bonsai Framework there is not installer. Just unzip and launch Eclipse.
The remainder of this document provides details about how to build/adjust the portable environment yourself. These same instructions shoudl also work for the SpringSource Tool Suite.
Eclipse Setup
Download Eclipse IDE for Java EE Developers. Eclipse has no install. It is simply a matter of uncompressing.
Select Location
The trick is that Eclipse, Tomcat and Java actually do not need to be "installed". They run fine just by being dropped into specific directories. Select a drive and directory your computer where you will be keeping everything. The Bonsai Framework uses,
- Windows = C:\apps\
Linux or Unix = /home/[your home directory]/apps for example, /home/tpham/apps/
Setup Package Java
Download Oracle's JRE (Java Runtime Environment) and follow the manual Java setup instructions.
Launch Eclipse
...
Configure Eclipse Editor on Windows
On the Windows environment, the default encoding is not UTF-8. As such modification need to be made ensure special characters work properly.
Editing UTF-8 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
On a Linux environment the Text file encoding will already default to UTF-8 so you can skip this step. 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... will check out soon.
Creation of Web Files in UTF-8
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
At this point there are two methods of setting up the Project, manual or automatic.