PersonalJava Tutorial

Not quite what I usually post and oddly specific, here is a PersonalJava tutorial to help people getting started with developing Java applications for old Handhelds.

What do you do when you want to create applications for Handheld PCs? There is a variety of options including the Windows CE SDK, Visual Basic, PocketC and others. Usually they require an understanding of the Windows CE API. There is another, often overlooked piece of software that is PersonalJava, an almost full implementation of the Java 1.1.8 standard for Windows CE 2.11 and 3.0, released by Sun in 1999.
The purpose of this article is to show how easy it is to develop Java applications for your Handheld.

What you need:

Get started by creating a new project in Eclipse.

Select JRE-1.1
Select JRE-1.1

Now we need the archive with the PersonalJava classes. While you could also use the library of the JRE you’re using, Eclipse won’t tell you which classes are not available in Java 1.1, so using the actual library makes it much easier.

Locate the classes.zip file on your Handheld PC after installing PersonalJava, create a /lib/ folder in your Java project and copy the zip there.

Should look like this
Should look like this

Right-click on your Project, click Properties and navigate to Java Build Path – Libraries. First, remove the rt.jar as we won’t need it. Then click “Add JARs” and add classes.zip

Remove rt.jar, add classes.zip
Remove rt.jar, add classes.zip

Now, what is missing is the JavaDoc which helps a lot with developing. Eclipse automatically integrates the JavaDoc into the user interface, but requires the doc to use a specific formatting standard. A workaround is using a JavaDoc from a newer version of Java, which might include some wrong information about deprecated methods, but – since Java is backwards-compatible – should include all the information you need.
To do this, right click on “classes.zip” in your Referenced Libraries project folder, click Properties, and under JavaDoc location, point it to the folder that contains the JavaDoc (I used http://www.cs.xu.edu/jdk1.3.1doc/ as 1.3 seems to be the first version to have a format that works with Eclipse)

Create a new Class and call it HelloWorld.java, then our project is all set up now and we’re ready to start coding!

The project structure
The project structure

Here is a short example code:

import java.awt.BorderLayout;
import java.awt.Frame;
import java.awt.Label;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
class HelloWorld extends Frame {

private static final long serialVersionUID = 1L;
     HelloWorld(){
          super("Hello World");
          setLayout(new BorderLayout());
          add(new Label("Wow!"), "Center");
          setSize(320, 200);
          addWindowListener(new WindowAdapter() {
               public void windowClosing(WindowEvent windowevent) {
                    System.exit(0);
               }
          });
          show();
     }
     public static void main(String args[]) {
          new HelloWorld();
     }
}

To compile and run the application, navigate to Run – Run configurations, double click “Java Application” and click Run.

Run it!
Run it!

Here’s how it looks on Windows 7:

Hello World!
Hello World!

To run it on your HPC, simply copy all class files from the /bin/ folder of your project to your HPC, then start HelloWorld.class

Java application running on a HP Jornada 820
Running on a HP Jornada 820

Happy coding!

Leave a Reply

Your email address will not be published.