Java 2 Micro Edition (J2ME)

Transcript

1 Università degli Studi di Modena e Reggio Emilia Facoltà di Ingegneria Reggio Emilia CORSO DI TECNOLOGIE E APPLICAZIONI WEB Java 2 Micro Edition (J2ME) Ing. Marco Mamei

2 J2ME Introduzione Il linguaggio di programmazione Java rappresenta una piattaforma ideale per lo sviluppo di applicazioni. Per coprire al meglio le esigenze di diversi scenari, la Sun (la ditta alla base di Java) offre diverse versioni della piattaforma Java: J2SE (Standard Edition) è la piattaforma di riferimento per lo sviluppo di applicazioni desktop (scenario obsoleto???) J2EE (Enterprise Edition) è la piattaforma di riferimento per le applicazioni Web. Da notare che Tomcat, JSP, etc. fanno parte di J2EE J2ME (Micro Edition) è la piattaforma di riferimento per applicazioni embedded (es. Cellulari, palmari, ma anche giocattoli ed elettrodomestici). I vantaggi (e gli svantaggi) di Java per quanto riguarda J2ME si accentuano: La portabilità del codice diventa ancora più importante che per le applicazioni desktop e server perchè aumenta l eterogeneità dell hardware. Le applicazioni embedded tendono ad essere molto complicate. Quindi è le caratteristiche di java come linguaggio di programmazione pulito e potente sono molto utili Si sta imponendo come standard (quasi tutti i cellulari offrono J2ME) Problemi di performance (sia velocità che occupazione di memoria)

3 Struttura J2ME La struttura J2ME nel suo complesso è abbastanza complicata e modulare. Questo perché gli scenari hardware J2ME sono molteplici e molto diversi tra loro (es. da un computer palmare a un giocattolo di ultima generazione). Per questo motivo J2ME si compone si compone di due parti separate: Configurations Profiles Una Configuration è un infrastruttura per eseguire programmi Java in una certa classe di dispositivi. Fondamentalmente si compone di una Java Virtual Machine ottimizzata per quella classe di dispositivi. Allo stato attuale esistono solo 2 configuration: CLDC (Connected Limited Device Configuration) che si basa sulla KVM ( Kilo Virtual Machine). Questa è la configurazione presente in quasi tutti i cellulari moderni CLC (Connected Device Configuration) che si basa sulla CVM (Compact Virtual Machine). Questa è la configurazione presente sui palmari, il Sony- Ericsson P9000 e il Nokia Communicator I Profiles sono componenti aggiuntivi (delle specie di librerie package java) che offrono strumenti e funzionalità evolute. Allo stato attuale sono disponibili diversi profiles, ma il più usato in assoluto e montato su tutti i cellulari che offrono CLDC è: MIDP (Mobile Information Device Profile e 2.0) In questa lezione ci occuperemo di CLDC-MIDP 1.0

4 MIDlet Le applicazioni che realizzo con il pacchetto MIDP si chiamano MIDlet. Sono applicazioni simili alle Applet, ma eseguono su un cellulare anziché in un browser. Vediamo subito un esempio di codice: import javax.microedition.lcdui.*; import javax.microedition.midlet.*; // notare extends MIDlet e implements CommandListener. // E come extends JApplet implements ActionListener public class HelloMIDlet extends MIDlet implements CommandListener { private Form mmainform; public HelloMIDlet() { mmainform = new Form("HelloMIDlet"); mmainform.append(new StringItem(null, "Hello, MIDP!")); mmainform.addcommand(new Command("Exit", Command.EXIT, 0)); mmainform.setcommandlistener(this); public void startapp() { Display.getDisplay(this).setCurrent(mMainForm); public void pauseapp() { public void destroyapp(boolean unconditional) { public void commandaction(command c, Displayable s) { notifydestroyed(); Notare che si tratta di un esempio di applicazione managed (senza main).

5 MIDlet Una MIDlet rispecchia il seguente ciclo di vita. Midlet Life Cycle I metodi startapp(), pauseapp(), destroyapp() sono definiti nella classe astratta MIDlet e devono essere implementati a livello di sottoclasse. Oltre ai metodi sopraccitati, le Midlet devono essere provviste di un sistema di gestione di eventi che si costruisce in modo analogo a quanto visto per Java Swing. mmainform.addcommand(new Command("Exit", Command.EXIT, 0)); mmainform.setcommandlistener(this); un Command è un tasto (tipo JButton) che compare sullo schermo. Il setcommandlistener sottoscrive un oggetto (di tipo CommandListener) a reagire al pulsante. Notare che, a differenza di Java Swing, non si associa l oggeto al singolo pulsante ma a tutta la finestra. public void commandaction(command c, Displayable s) { notifydestroyed(); Il metodo commandaction (che deve essere definito da un oggetto che implementa CommandListener) permette di reagire all evento. Il tutto è simile all actionperformed di Java Swing. L oggetto Command c, permette di discriminare tra diversi comandi, proprio come ActionEvent in Java Swing

6 MIDP Development This lecture contains everything you need to know to get started developing in the Java 2 Platform, Micro Edition (J2ME) environment. You'll learn how to install the development tools, how to write your first J2ME application, how to build it, and how to test the application in an emulator. The application you'll build, a MIDlet, runs on implementations of the Mobile Information Device Profile, one of the J2ME specifications. (For a background on wireless Java technology, read Introduction to Wireless.) What You Need You have lots of choices for a MIDP development environment. In this lecture you'll use Sun's J2ME Wireless Toolkit, which is both free and lightweight. The J2ME Wireless Toolkit can be integrated into IDEs but it can also run standalone, which is how I'll describe it in this lecture. Installing the J2ME Wireless Toolkit The next step is to install the J2ME Wireless Toolkit, a set of tools that make it easy to build and test MIDP applications. (You can think of the toolkit as a miniature IDE; it automates several of the tasks related to building MIDP applications.) Begin by downloading the J2ME Wireless Toolkit from Execute the installation file. The installer tries to locate your J2SE SDK; if it's having trouble, make sure you are pointing it to the directory where you installed the J2SE SDK. You will also need to specify whether the toolkit will run by itself (standalone) or be integrated with an IDE. This lecture assumes you will be running the toolkit in standalone mode. The files for the toolkit will go into c:\wtk22 unless you specify a different directory, and the installer creates shortcuts for various parts of the toolkit. To run the toolkit itself, select the KToolbar shortcut. You should see the following screen. Opening screen of the J2ME Wireless Toolkit

7 The J2ME Wireless Toolkit works with projects, where the end result of each project is one MIDlet suite. The toolkit works with one project at a time. You can change properties of the current project, build the project, and run the project in a device emulator. Several example projects come installed with the toolkit; we'll look at these later. Let's jump right in the water by creating a new project. Click on New Project in the button bar. The toolkit prompts you for a project name and the name of a MIDlet class in the project. Fill in HelloSuite and HelloMIDlet as shown below. Creating a new project Once you fill in the project name and first MIDlet name, the toolkit gives you a chance to edit the project settings. Just accept the defaults for now; press OK to finish creating the new project. In the text output pane of the J2ME Wireless Toolkit, you'll see several helpful messages telling you where to store the project's source files. The toolkit stores each project in a subdirectory of the apps directory. The name of the subdirectory is the same as the name of the project. Here, the toolkit has created a new directory, c:\wtk22\apps\hellosuite. Each project subdirectory has a standard structure: Project directory structure The bin directory contains the compiled MIDlet suite (a.jar file) and the MIDlet suite descriptor (a.jad file). The lib directory is the location for any additional JAR files you would like to include in your project. res is the location for resource files, like images or text files, that should be bundled with your MIDlet suite. Finally, the src directory is the place where your source code should be saved. The standard rules about packages and directories apply; for example, source code for a users.root class would go in src/users/root.java.

8 Create a MIDlet To get you started with MIDlet development, let's write a simple MIDlet. Once you've chosen a text editor, type or cut-and-paste the code reported at the beginning. Save this code as HelloMIDlet.java in the src directory of your project. On my computer, this file is saved in c:\wtk22\apps\hellosuite\src\hellomidlet.java. Next, press the Build button in KToolbar. The toolkit will attempt to compile your project. If there are any compiler errors, you'll see them in the text output area of KToolbar. Fix the errors until the project builds successfully. Now you're ready to test your MIDlet suite. Click on the Run button. You should see a mobile phone emulator pop up: HelloSuite running on the emulator The emulator is showing a list of MIDlets in the MIDlet suite. This example shows only one MIDlet. Although the name you see here is HelloSuite, the class that will be run is HelloMIDlet. To see where this mapping occurs, go to KToolbar and select Settings... Then click on the MIDlets tab to see a list of the MIDlets in the project. Back in the emulator, click on the soft button below Launch to start up the MIDlet. It will display a simple screen like the one below. Click on Exit to leave the MIDlet. Close the emulator window or hit the Escape key to end the emulator session.

9 HelloMIDlet running on the emulator The emulator you've just used is the DefaultColorPhone. The J2ME Wireless Toolkit has other emulators as well. Try running HelloMIDlet on some other devices to see how the user interface adapts. Simply select the emulator you'd like in the combo box in KToolbar, then click on Run again. A Quick Look Under the Hood Now that you've had some fun, let's take a step back and talk about what it is that the J2ME Wireless Toolkit does for you. None of it is too complicated, but the toolkit takes several potentially aggravating steps and condenses them into a single button push. First, what happens when you press the Build button? The toolkit finds all the.java files in the src directory of your project and compiles them. This is no ordinary compilation, however, because the source files must be compiled in a MIDP environment rather than a J2SE environment. To understand this departure, think of a MIDlet that uses the java.lang.system class. This class has different APIs in J2SE and MIDP. When the toolkit compiles your MIDlet class, you want it to use the MIDP java.lang.system, not the J2SE version of the class. You could make this selection yourself, using the command javac and the - bootclasspath option, but it's much simpler just to let the toolkit worry about it. Beyond compilation, MIDP classes must be preverified before they can be run on a MIDP device. You may recall that J2SE has a bytecode verifier that checks.class files before they are loaded. In the MIDP world, verification is split into two phases. The toolkit performs an initial verification at build time, then the device's runtime system performs a second verification when it loads the classes. You could perform the first verification yourself using the command line preverify tool, but it's much easier to leave this detail to the toolkit. Finally, MIDlets are bundled into MIDlet suites for distribution to actual devices. This process entails JARing the MIDlet suite class files and the resource files, and putting some extra information in the JAR manifest. Again, these chores are best

10 left to the J2ME Wireless Toolkit. To bundle up your MIDlet suite, select Project Package from the menu. The.jad and.jar files for the MIDlet suite will be generated and placed in the bin directory of the project.

11 Hooking Up a MIDlet to a JSP The real power of MIDlet applications comes from the possibility of using them to access remote HTTP services. We already know how to program HTTP services via JSP. It s time to have a MIDlet connect to the JSP. Start KToolbar (part of the J2ME Wireless Toolkit) and create a new MIDlet project with the code shown below. Then create a suitable i.e., simple JSP. import java.io.*; import javax.microedition.io.*; import javax.microedition.lcdui.*; import javax.microedition.midlet.*; public class HitMIDlet extends MIDlet implements CommandListener { private Display mdisplay; private Form mmainform; private StringItem mmessageitem; private Command mexitcommand, mconnectcommand; public HitMIDlet() { mmainform = new Form("HitMIDlet"); mmessageitem = new StringItem(null, ""); mexitcommand = new Command("Exit", Command.EXIT, 0); mconnectcommand = new Command("Connect", Command.SCREEN, 0); mmainform.append(mmessageitem); mmainform.addcommand(mexitcommand); mmainform.addcommand(mconnectcommand); mmainform.setcommandlistener(this); public void startapp() { mdisplay = Display.getDisplay(this); mdisplay.setcurrent(mmainform); public void pauseapp() { public void destroyapp(boolean unconditional) { public void commandaction(command c, Displayable s) { if (c == mexitcommand) notifydestroyed(); else if (c == mconnectcommand) { Form waitform = new Form("Waiting..."); mdisplay.setcurrent(waitform); Thread t = new Thread() { public void run() { connect(); ; t.start(); private void connect() { HttpConnection hc = null;

12 InputStream in = null; String url = " try { hc = (HttpConnection)Connector.open(url); in = hc.openinputstream(); int contentlength = (int)hc.getlength(); byte[] raw = new byte[contentlength]; int length = in.read(raw); in.close(); hc.close(); // Show the response to the user. String s = new String(raw, 0, length); mmessageitem.settext(s); catch (IOException ioe) { mmessageitem.settext(ioe.tostring()); mdisplay.setcurrent(mmainform); The main screen of HitMIDlet is similar to HelloMIDlet, but it includes two commands, Exit and Connect. Connect sets up a separate thread and calls the connect() method, which takes care of making a network connection and retrieving the results. Now, in the J2ME Wireless Toolkit, click on Build to build the project. Assuming you don't see any error messages, you are now ready to test the application. Make sure your server is running first. Then click on Run and select HitMIDlet. Select the Connect command. If everything goes well, HitMIDlet will invoke HitServlet and display the results on the device emulator screen: HitMIDlet running on the emulator

13 OTA (Over The Air) MIDlet Provisioning The J2ME Wireless Toolkit is a powerful tool to develop and test MIDlets, but how to upload them into real phones?? Some phones can be connected to computers and the phone manufacturer provides suitable software to install.jad and.jar files on the phone. Alternatively, OTA MIDlet provisioning is a powerful protocol to install them over the network. Test OTA with Tomcat is very simple! You have to create a web application with the following index.html <html> <head> <title>test</title> </head> <body> <a href=" Midlet</a> </body> </html> File index.html The web application directory contains (at the top level) the.jad and.jar files of your midlet. Then you have to change the web.xml file in WEB-INF to let it contain the following lines. <?xml version="1.0" encoding="iso "?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" " <web-app>  <mime-mapping> <extension>jad</extension> <mime-type>text/vnd.sun.j2me.app-descriptor</mime-type> </mime-mapping>  <mime-mapping> <extension>jar</extension> <mime-type>application/java-archive</mime-type> </mime-mapping> </web-app> File web.xml At last it is important to change the JAD file (you can open it with any text editor) so that the MIDlet-Jar-URL is a complete URL MIDlet-Jar-URL:

14 Now simply use the phone browser to access the index.html page. Follow the link and the MIDlet should install.