Java[tm] Smart Ticket Sample Application 1.2 Release Notes CONTENTS - Overview - User Documentation - What's New - Known Issues - Code Obfuscation - Sending Feedback OVERVIEW The Java Smart Ticket Sample Application is a sample wireless enterprise application using Java technology. In this movie ticketing application, customers may purchase movie tickets using a mobile device such as a cell phone, palmtop, or two-way pager. The sample application is a client-server application. The client part uses the Mobile Information Device Profile (MIDP) of the Java 2 Platform, Micro Edition (J2ME[tm]), and the server part runs on a Java 2 Platform, Enterprise Edition (J2EE[tm]) application server. Developers wishing to learn more about the design principles behind the Java Smart Ticket Sample Application should visit the Java BluePrints for Wireless Web site at: http://java.sun.com/blueprints/wireless/ USER DOCUMENTATION Please consult the user documentation (installation instructions, etc.) in the directory {smart_ticket.dir}/docs/user/, where {smart_ticket.dir} is the root directory of the sample application bundle. WHAT'S NEW In version 1.2 of the application, a disconnected mode of operation was added, providing the following enhancements: - Downloading (persistence) of movie listings to enable browsing offline - Caching of movie listings to speed up browsing online - Synchronization of movie ratings so that users may enter movie ratings from different devices or different types of clients (e.g. mobile devices, desktops, laptops) Also, this application attempts to demonstrate some of the usability guidelines documented in the MIDP 1.0 Style Guide (http://java.sun.com/j2me/docs/alt-html/midp-style-guide7/index.html). CODE OBFUSCATION The sample application's client code may be obfuscated by using the following third-party tools in conjunction with the Ant build scripts supplied in the sample application bundle: - One of the ProGuard or RetroGuard obfuscators. The ProGuard obfuscator is available through http://proguard.sourceforge.net/. The RetroGuard obfuscator is available through http://retrologic.com/. - Antenna, Ant tasks for wireless development--including one to invoke the ProGuard or RetroGuard obfuscators by Jorg Pleumann, available through http://antenna.sourceforge.net/ (and linked through the Apache Ant site at http://ant.apache.org/external.html). The Antenna JAR file, antenna-bin.jar, should be placed inside {smart_ticket.dir}/src/tools/ant/lib/, where {smart_ticket.dir} is the root directory of the sample application bundle. The ProGuard or RetroGuard JAR should be placed inside {j2mewtk.dir}/bin/, where {j2mewtk.dir} is the root directory of the J2ME Wireless Toolkit installation. To build an obfuscated version of the sample application's client code: 1. Open a command or shell prompt. 2. Change the current directory to {smart_ticket.dir}/src/, and type: asant obfuscate The obfuscated builds will appear in {smart_ticket.dir}/src/app/client/midp/build/ and {smart_ticket.dir}/src/app/client/midp-optim/build/. KNOWN ISSUES This sample application is intended to be educational. Some functionality may be missing or incomplete. Known issues for this release include the following: - The sample requires the J2ME Wireless Toolkit (J2MEWTK). The Java 2 Platform, Micro Edition Wireless Toolkit (v1.0.4) is not available for x86 sample. This sample application may not work on Solaris 9 x86. For this x86 platform, you can try to install and use the J2ME wireless toolkit for linux from http://java.sun.com/j2me. - The application is internationalized but not localized. - For the application to filter theaters by ZIP code, you must use the ZIP code 95130 or 95054 when you create your account. - Account information needs to be synchronized on both the client and server parts. If you ever have problems accessing user information, remove the record store data on the client side, re-populate the database on the server side, and then re-enter your account information the next time you start the application, as if you were using it for the very first time. SENDING FEEDBACK Please send any feedback on this release to javablueprintswireless-feedback@sun.com. Copyright 2001, 2002, 2003 Sun Microsystems, Inc. All rights reserved.