1 Introduction

The MapleNet™ Publisher's Guide provides instructions and examples for the following:

Installing MapleNet Publisher	Prerequisites Installing MapleNet Publisher General Notes
Developing Java-based Applets for MapleNet	Writing Java™-based Applets Compiling Java Code Creating a JAR File Creating an HTML Page Publishing Applets to the MapleNet Server
Developing Maplet Applications for MapleNet	Writing a Maplet® Application Compliant with MapleNet Creating an HTML Page Publishing Maplets to the MapleNet Server
Developing JavaServer Pages for MapleNet	Prerequisites Creating MapleNet JSP Content Page Setup Using Maple Tags Examples Publishing JSP Content to the MapleNet Server
Developing Worksheets for MapleNet	Writing Worksheets for Use on MapleNet Passing Parameters to the Worksheet Client Considerations Server Considerations Customization of the MapleNet Worksheet Interface Publishing Worksheets to the MapleNet Server
Using MapleNet's Image Generation	Description of Image Generation URL Specification Usage Examples
Using MapleNet's Web Service	MapleNet Simple Web Service Web Services Description Language File Methods Available in the MapleService Web Service

In this Chapter

• Prerequisites
• Installing MapleNet Publisher
• General Notes

1.1 Prerequisites

Required

• Java 2 Software Development Kit (J2SDK), 1.6
• Java 2 Runtime Environment (J2RE), 1.6.0_10 (minimum)
• Maple™ 16
• File transfer software, such as FTP, SCP, or WebDAV

Note: If you do not have SDK and J2RE installed, visit the Sun Microsystems™, Inc. web site at http://java.sun.com/j2se/ to download and install the latest version of Java 1.6.

Recommended

• Java development environment for developing Java applets
• Web page development environment for creating HTML pages

1.2 Installing MapleNet Publisher

The publisher component of the MapleNet application is located in the Publisher directory of your installation disc. You can copy this directory to your network or copy the contents of the directory to another disc for distribution.

To install the publisher component of the MapleNet software:

• Double-click the WindowsPubInstall.exe file (Windows) or run the <UNIXplatform>PubInstall.bin file (UNIX) and follow the on-screen instructions.

When extracted, your directory structure should resemble the following.

Directory	Description
bin	Location of batch files required for bundling and publishing content
doc	Location of Javadoc files describing the MapleNet classes, the MapleNet HTML Publisher Guide files (this document) and the sample Java and HTML files
jar	Location of Java code files

 

Notes:

1. To access the script files from any directory, the bin directory must be added to the path environment variable.
2. The jar directory contains a script file, setclasspath (UNIX) or setclasspath.bat (Windows), that will append the JARs required for compiling MapleNet applications to the CLASSPATH environment variable.

1.3 General Notes

For applets, Maplets, and Java Server Pages, MapleNet initially sets the Maple kernel to printlevel:=0. When creating procedures for these applications, remember this default behavior.

If you package your applets in your own JAR files, the manifest extension information is no longer required. MapleNet no longer installs its client JAR files in the JRE extension directory. The JAR files are now downloaded and stored in the JRE cache using the normal caching mechanism.

Users viewing MapleNet content can gain some performance benefit by pre-loading these JAR files into their cache before accessing the content. This is done by viewing the cache loading web page, normally found at

   http://yourserver.com/maplenet/samples/LoadCache.html

This page contains a small applet that copies the JAR files to the JRE cache directory.