KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > HelpHandler


1 /*
2  * @(#)HelpHandler.java 1.5 05/11/17
3  *
4  * Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions are met:
8  *
9  * -Redistribution of source code must retain the above copyright notice, this
10  * list of conditions and the following disclaimer.
11  *
12  * -Redistribution in binary form must reproduce the above copyright notice,
13  * this list of conditions and the following disclaimer in the documentation
14  * and/or other materials provided with the distribution.
15  *
16  * Neither the name of Sun Microsystems, Inc. or the names of contributors may
17  * be used to endorse or promote products derived from this software without
18  * specific prior written permission.
19  *
20  * This software is provided "AS IS," without a warranty of any kind. ALL
21  * EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING
22  * ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
23  * OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN MIDROSYSTEMS, INC. ("SUN")
24  * AND ITS LICENSORS SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE
25  * AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THIS SOFTWARE OR ITS
26  * DERIVATIVES. IN NO EVENT WILL SUN OR ITS LICENSORS BE LIABLE FOR ANY LOST
27  * REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL,
28  * INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY
29  * OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE,
30  * EVEN IF SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
31  *
32  * You acknowledge that this software is not designed, licensed or intended
33  * for use in the design, construction, operation or maintenance of any
34  * nuclear facility.
35  */

36
37
38 import javax.help.*;
39 import java.util.*;
40 import java.net.*;
41 import javax.swing.*;
42 import java.awt.event.ActionEvent JavaDoc;
43 import javax.jnlp.DownloadService;
44 import javax.jnlp.DownloadServiceListener;
45 import javax.jnlp.ServiceManager;
46 import javax.jnlp.UnavailableServiceException;
47
48 public class HelpHandler {
49
50    static private DownloadService _ds = null;
51     
52     static public final String JavaDoc helpsetName = "HolidayHistory.hs";
53     
54     static public HelpBroker _hb = null;
55     
56     static public void showHelp(final ActionEvent JavaDoc evt) {
57     new Thread JavaDoc() {
58         public void run() {
59         showHelpHelper(evt);
60         }
61     }.start();
62     }
63     
64     static public void showHelpHelper(ActionEvent JavaDoc evt) {
65     checkForDownload();
66     initializeHelpSystem();
67     new CSH.DisplayHelpFromSource(_hb).actionPerformed(evt);
68     }
69     
70     static public synchronized void initializeHelpSystem() {
71     if (_hb != null) return;
72     try {
73         JOptionPane pane = new JOptionPane("Initializing help system. Please Wait...",
74                            JOptionPane.INFORMATION_MESSAGE);
75         JDialog dialog = pane.createDialog(null, "WebPad Help System");
76         dialog.setModal(false);
77         dialog.setVisible(true);
78         
79         HelpSet hs = null;
80         ClassLoader JavaDoc cl = HelpHandler.class.getClassLoader();
81         URL hsURL = HelpSet.findHelpSet(cl, helpsetName);
82         hs = new HelpSet(cl, hsURL);
83         _hb = hs.createHelpBroker();
84         _hb.initPresentation();
85         dialog.setVisible(false);
86     } catch (Exception JavaDoc ee) {
87         System.out.println("HelpSet " + helpsetName + " not found");
88         return;
89     }
90     }
91     
92     static private void checkForDownload() {
93     try {
94          _ds = (DownloadService)ServiceManager.lookup("javax.jnlp.DownloadService");
95         } catch (UnavailableServiceException e) {
96           _ds = null;
97
98         }
99
100         if (_ds != null) {
101         try {
102         
103            if (_ds.isPartCached("help")) {
104         System.out.println("Help System is cached");
105         return;
106         }
107         _ds.loadPart("help", _ds.getDefaultProgressWindow());
108       } catch(Exception JavaDoc e) {
109             e.printStackTrace();
110       }
111         }
112   }
113 }
114
115
Popular Tags