03 May Manual JavaHelp WebplusValencia

Posted at 23:16h in java, Aprende Java desde 0. by PanelEmilio2019

Tabla de Contenidos

Manual JavaHelp WebplusValencia

Manual JavaHelp WebplusValencia. Aquí os dejo un manual de JavaHelp el cual os va ayudar en vuestros Proyectos como desarrolladores.

Nos bajamos javaHelp

Descargaremos el Fichero aquí………

http://www.oracle.com/technetwork/java/index.html

Directorio para la ayuda

Meteremos todos los archivos en la misma carpeta lo llamamos help.
Los pondremos en formato html.

Nos creamos los Ficheros html

GestionClientes.html
GestionFacturashtml
GestionEventos.html
Bienvenida.html

Creamos ficheros mapa de JavaHelp

El siguiente paso es crear un fichero mapa de JavaHelp. Este fichero no es más que un fichero XML en el que se da una «clave» a cada uno de los ficheros html que creamos. Es decir, a cada fichero html se le da un nombre, que servirá para identificarlo a partir de ahora. Tanto el resto de los ficheros de configuración de JavaHelp como nuestro código Java referenciarán a los ficheros .html con el nombre que pongamos en este fichero mapa.

<?xml version=’1.0′ encoding=’ISO-8859-1′?>

<!DOCTYPE map

PUBLIC «-//Sun Microsystems Inc.//DTD JavaHelp Map Version 2.0//EN»

«http://java.sun.com/products/javahelp/map_2_0.dtd»>

</map>

Nos creamos el Fichero de la tabla de contendios de JavaHelp.
1. Nos saldrá una tabla de contenidos tal como así:
2. JavaHelp

<?xml version=»1.0″ encoding=»ISO-8859-1″?>
<toc version=»1.0″>
<tocitem text=»Ejemplo JavaHelp» target=»aplicacion»>
<tocitem text=»Ventana principal» target=»ventana_principal»/>
<tocitem text=»Ventana secundaria» target=»ventana_secundaria»/>
</tocitem>
</toc>

Además del encabezado de XML, vemos como tag principal <toc> y luego varios tags<tocitem> que podemos ir anidando como queramos que se muestre más adelante el árbol. En cada <tocitem> ponemos un text para indicar el texto visible y un target, para indicar la «clave» o «nombre» del fichero html de ayuda que queremos mostrar cuando se seleccione este item en el árbol. Estas «claves» o «nombres» son las que dimos anteriormente en el fichero mapa de JavaHelp.

Este fichero tox.xml lo colocaremos en el directorio help, junto con el fichero de mapamap_file.jhm.

Aquí veremos el fichero índice
JavaHelp
Este índice, cómo no, se crea por medio de otro fichero XML que tenemos que hacernos a mano. El fichero tiene extensión xml y para nuestro ejemplo puede ser como indice.xml. El contenido de este fichero es

<?xml version=’1.0′ encoding=’ISO-8859-1′ ?>
<!DOCTYPE index
PUBLIC «-//Sun Microsystems Inc.//DTD JavaHelp Index Version 1.0//EN»
«http://java.sun.com/products/javahelp/index_1_0.dtd»>
<index version=»1.0″>
<indexitem text=»Ejemplo JavaHelp» target=»aplicacion»/>
<indexitem text=»Ventana principal» target=»ventana_principal»/>
<indexitem text=»Ventana secundaria» target=»ventana_secundaria»/>
</index>
1. Ejecucion del Fichero
Para ejecutarla, vamos al directorio help y ejecutamos

$ cd /PATH_PROYECTO/help
$ java -jar /PATH_JAVAHELP/bin/jhindexer.jar html

y en mi caso concreto, que estoy en Windows y para mi aplicación, con mis paths concretos y demás…

c:\> cd c:\proyectos\ejemplo_java_help\help
c:\> java -jar C:\Aplicaciones\jh2.0\javahelp\bin\jhindexer.jar html
1. Fichero principal de configuracion de Javahelp
Hasta aquí los ficheros «secundarios» de JavaHelp. Ahora necesitamos hacer el fichero principal, el que lo configura todo. Este fichero, para variar, va en formato XML, pero se le pone extensión .hs -Help Set- Para nuestro ejemplo, el fichero será este –>help_set.hs
```
<?xml version="1.0" encoding='ISO-8859-1' ?>
<!DOCTYPE helpset
  PUBLIC "-//Sun Microsystems Inc.//DTD JavaHelp HelpSet Version 1.0//EN"
         "http://java.sun.com/products/javahelp/helpset_1_0.dtd">
 

<helpset version="1.0">
        <title>Ejemplo ayuda JavaHelp</title>
        <maps>
                
                <homeID>aplicacion</homeID>
                
                <mapref location="map_file.jhm"/>
        </maps>

        
        <view>
                <name>Tabla Contenidos</name>
                <label>Tabla de contenidos</label>
                <type>javax.help.TOCView</type>
                <data>toc.xml</data>
        </view>

  <view>
    <name>Indice</name>
    <label>El indice</label>
    <type>javax.help.IndexView</type>
    <data>indice.xml</data>
  </view>
  
  <view>
    <name>Buscar</name>
    <label>Buscar</label>
    <type>javax.help.SearchView</type>
    <data engine="com.sun.java.help.search.DefaultSearchEngine">
      JavaHelpSearch
    </data>
  </view>
  
</helpset>
```
El contenido de este fichero es más o menos

<?xml version=»1.0″ encoding=’ISO-8859-1′ ?>
<!DOCTYPE helpset
PUBLIC «-//Sun Microsystems Inc.//DTD JavaHelp HelpSet Version 1.0//EN»
«http://java.sun.com/products/javahelp/helpset_1_0.dtd»>
<helpset version=»1.0″>
<title>Ejemplo ayuda JavaHelp</title>
<maps>
<!– Pagina por defecto al mostrar la ayuda –>
<homeID>aplicacion</homeID>
<!– Que mapa deseamos –>
<mapref location=»map_file.jhm»/>
</maps>

<!– Las Vistas que deseamos mostrar en la ayuda –>
<!– La tabla de contenidos –>
<view>
<name>Tabla Contenidos</name>
<label>Tabla de contenidos</label>
<type>javax.help.TOCView</type>
<data>toc.xml</data>
</view>

<!– El indice –>
<view>
<name>Indice</name>
<label>El indice</label>
<type>javax.help.IndexView</type>
<data>indice.xml</data>
</view>

<!– La pestana de busqueda –>
<view>
<name>Buscar</name>
<label>Buscar</label>
<type>javax.help.SearchView</type>
<data engine=»com.sun.java.help.search.DefaultSearchEngine»>
JavaHelpSearch
</data>
</view>

</helpset>
1. El codigo java para manejar el JavaHelp
Lo primero que tenemos que hacer en nuestro código java, es leer el fichero de configuración help_set.hs. El código para ello puede ser este.

// Carga el fichero de ayuda
File fichero = new File(«../help/help_set.hs»);
URL hsURL = fichero.toURI().toURL();

// Crea el HelpSet
HelpSet helpset = new HelpSet(getClass().getClassLoader(), hsURL);

En primer lugar construimos en formato URL el path del fichero. Lo de «../help/help_set.hs» es en mi ejemplo concreto. Tú pon el path que te toque a tí.

Una vez que tenemos el fichero en formato URL, instanciamos la clase HelpSet, pasándole un ClassLoader y la URL del fichero. Lo del ClassLoader es importante porque el ficherohelp_set.hs podría estar dentro de nuestro jar o bien en un fichero suelto en el disco. En general, bastará con obtener el ClassLoader con getClass().getClassLoader(), como hemos hecho en el trozo de código. La clase HelpSet de alguna forma contiene todos los datos relativos a nuestra ayuda, leídos de los ficheros de configuración que creamos antes.

Una vez que tenemos el HelpSet, para hacerlo fácil, obtenemos un HelpBroker. Esta claseHelpBroker no es más que una clase de ayuda que nos ofrece JavaHelp para facilitarnos un uso por defecto de la ayuda desde código. Para obtener el HelpBroker

HelpBroker hb = helpset.createHelpBroker();

El código para conseguir esto es

// Ayuda al hacer click en el JMenuItem itemAyuda.
hb.enableHelpOnButton(itemAyuda, «aplicacion», helpset);

// Ayuda al pulsar F1 sobre la ventana principal
hb.enableHelpKey(principal.getContentPane(), «ventana_principal», helpset);

// Ayuda al pulsar F1 sobre la ventana secundaria
hb.enableHelpKey(secundaria.getContentPane(), «ventana_secundaria», helpset);