Integrating Openwave simulators with Borland JBuilder 7 Enterprise

If you are creating web content using JSP or Java servlet technology and are targeting mobile devices, you can test your content with the Openwave mobile browser simulators without leaving Borland JBuilder 7 Enterprise.

You do this by installing an Openwave add-on which enables integration of Openwave SDKs 6.1 and 6.2 with JBuilder 7.  This add-on was created using Borland's Open Tools API. 

SDK 6.1 and 6.2 contain Openwave mobile browser 6.1 and 6.2 respectively, adhere to the WAP 2.0 standard, and render content in XHTML Mobile Profile and CSS. These SDKs are also backward compatible with WML and cHTML.  You can use either or both simulators, depending on your needs and the target devices for your market. For details on browser capabilities and device deployments, see the Openwave Developer Web site .

Requirements

Installing the Openwave JBuilder add-on

  1. If JBuilder 7 is running, close it.

  2. Copy the Openwave JBuilder add-on (OpwvSim-JBuilder7.jar) to the directory:

    [jbuilder_home]\lib\ext

    If you performed a default installation of JBuilder 7, this is equivalent to:

    c:\jbuilder7\lib\ext

    If you installed a previous version of the Openwave Jbuilder add-on, just overwrite that file, or delete the old file and save the new one in this directory.

  3. Launch JBuilder 7.

  4. From the Tools menu, select Openwave Simulator > Openwave Simulator Options.

  5. In the Openwave Simulator Options dialog box, click on the 6.1 tab and enter the path to the Openwave SDK 6.1 executable in the Openwave 6.1 Path field.  If you installed the SDK in the default location, this path is:

    c:\Program Files\Openwave\SDK 6.1\program\http\OSDK61http.exe

    To configure SDK 6.2, just click on the 6.2 tab and enter the path to the Openwave SDK 6.2 executable, the default location is:

    c:\Program Files\Openwave\SDK 6.2\program\http\OSDK62http.exe

  6. In the Openwave Simulator Options dialog's Default Command-Line Options field, enter any special arguments you want passed to the Openwave SDK when it is launched, such as -clearcache or -lang ja-jp.  For a complete list and description of simulator command-line arguments, see the appropriate Openwave SDK release notes.

    Do not include the -reload argument in this field; it is automatically added at runtime.

  7. Click OK to close the dialog and save your settings.

Testing with the Openwave simulator

To test your JSP or servlet applications with the Openwave simulator in JBuilder 7, you must configure JBuilder to use Web View.  To do so, go to Tools->IDE Options, open the Web tab, and select one of the following two options:

Launch separate process and use Web View

Use Web View on running process if possible

Then, use the Run > Run Project or Run > Debug Project command to compile your project and launch it within its configured server.  After the project has opened in JBuilder's Web View browser, you can select the Tools > Openwave Simulator > View in Openwave 6.1 (or 6.2) command to launch the SDK and view the project.

As you make changes to your project, you can reload the content by again selecting the Tools > Openwave Simulator > View in Openwave 6.1 (or 6.2) command, or by selecting the Edit > Reload command from within the SDK.  You can also navigate using the Openwave simulator itself, selecting links or entering URLs in the simulator's "Go" field.