JavaHelp - Tutorial?

Question

Hi, I just downloaded the JavaHelp API.
I have to admit, I'm stumped, no idea how to use it. The demos are more complex than anything I want to implement, and would take me far longer than I have to understand. I need a simple guide that starts from the beginning. Again, the provided documentation is complex and just refers you to the demos.
Anyone seen a tutorial? Or have any useful hints?!
Thanks.

Answer 1

I am writing the following code for an applet:
* JavaHelpApplet.java
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
import javax.help.*;
import java.net.*;
public class JavaHelpApplet extends JApplet{
private JButton openHelp;
private HelpSet hs=null;
private HelpBroker hb;
private String helpset;
private String name;
private String startup;
public void init() {
helpset = getParameter( "helpset0" );
startup = getParameter( "startup" );
name = "jar:"+helpset+"!/"+startup;
try {
UIManager.setLookAndFeel( "com.sun.java.swing.plaf.windows.WindowsLookAndFeel" );
SwingUtilities.updateComponentTreeUI( this );
catch (Exception ee)
ee.printStackTrace();
if (hs == null)
try {
URL url = this.getClass().getResource( name );
hs = new HelpSet(null, url );
catch (Exception ee)
ee.printStackTrace();
hb = hs.createHelpBroker();
hb.setCurrentID("introduction");
hb.setDisplayed( true );
The applet html page has the following:
<applet code="JavaHelpApplet.class" width="100" height="40">
<param name = "helpset0" value = "http://localhost/help.jar">
<param name = "startup" value = "help.hs">
</applet>
where,
helpset0 parameter is the web server that I have my helpset jar
startup is the parameter where my helpset file is named.
When I run it from Sun ONE Studio 4 Update 1 CE, it gives me the following errors in the Output Window:
GetIcon
name: images/toc.gif
klass: class javax.help.plaf.basic.BasicTOCNavigatorUI
URL is null
ImageIcon is null
GetIcon
name: images/index.gif
klass: class javax.help.plaf.basic.BasicIndexNavigatorUI
URL is null
ImageIcon is null
GetIcon
name: images/search.gif
klass: class javax.help.plaf.basic.BasicSearchNavigatorUI
URL is null
ImageIcon is null
GetIcon
name: images/high.gif
klass: class javax.help.plaf.basic.BasicSearchCellRenderer
URL is null
ImageIcon is null
GetIcon
name: images/medhigh.gif
klass: class javax.help.plaf.basic.BasicSearchCellRenderer
URL is null
ImageIcon is null
GetIcon
name: images/med.gif
klass: class javax.help.plaf.basic.BasicSearchCellRenderer
URL is null
ImageIcon is null
GetIcon
name: images/medlow.gif
klass: class javax.help.plaf.basic.BasicSearchCellRenderer
URL is null
ImageIcon is null
GetIcon
name: images/low.gif
klass: class javax.help.plaf.basic.BasicSearchCellRenderer
URL is null
ImageIcon is null
GetIcon
name: images/prev.gif
klass: class javax.help.plaf.basic.BasicHelpUI
URL is null
ImageIcon is null
GetIcon
name: images/next.gif
klass: class javax.help.plaf.basic.BasicHelpUI
URL is null
ImageIcon is null
GetIcon
name: images/print.gif
klass: class javax.help.plaf.basic.BasicHelpUI
URL is null
ImageIcon is null
GetIcon
name: images/pageSetup.gif
klass: class javax.help.plaf.basic.BasicHelpUI
URL is null
ImageIcon is null
My thought is that I can't get the resources from jhall.jar. How do I get them from jar? I use jhall.jar which is included on my project's classpath, also in the lib/ext on both the JRE and the JDK and S1Studio.
What I am trying to do is have an applet that when loaded from an html page will popup a jhelp applet window.
Is this possible to be done from struts framework?
Thanks in advance.