Java Web Start

Commençons par mettre en place notre serveur.

Vous utilisez APACHE

Pour activer la reconnaissance des fichiers .jnlp, il vous faudra éditer le fichier mime.types .
Installation classique sous Windows : C:\Program Files\Apache Group\Apache2\conf\mime.types.

Ajouter dans le fichier la ligne : application/x-java-jnlp_file jnlp

Vous utilisez IIS
Il faut ajouter un type de fichier.

Rien de plus côté serveur.

Attachons-nous maintenant au logiciel.
Dans ce tutoriel, je vais utiliser une Jframe avec un petit mot.

Ce sera un logiciel exécutable uniquement à partir d'Internet, sans création de raccourcis, sans accès aux ressources système… bref le strict minimum.

package prog;

import javax.swing.JFrame;
import javax.swing.JLabel;

public class HelloYou extends JFrame{

private static final long    serialVersionUID    = 1L;

    public static void main( String[] args ){
        new HelloYou();
    }
    
    
    public HelloYou(){
        super("Hello You");        
        getContentPane().add(new JLabel("Hello YOU!"));        
        setDefaultCloseOperation(EXIT_ON_CLOSE);
        setLocationRelativeTo(null);
        pack();        
        setVisible(true);        
    }
}

Compilez et faites-en un jar.

Particularité

Tout n'est pas merveilleux, voici un défaut de JWS , toutes les données dont vous avez besoin doivent être contenues dans des archives JAR. Heureusement ça ne change pas grand-chose dans la majorité des logiciels, c'est même plus propre ( c'est devenu une habitude chez moi ).

En pratique (cas d'une image)

ImageIcon jpg = new ImageIcon( "modele" + File.separator + "terrain" + File.separator + "land.jpg" );
devient
ImageIcon jpg = new ImageIcon( ImageIcon.class.getResource( "modele/terrain/land.jpg" ) );

<information locale=« fr_FR »>
La balise information contient la description de l'application.
Locale : précise le pays, la langue, la culture cf: annexe 1

<title>AlterSIG</title>
titre de l'application

<vendor>Johann Sorel</vendor>
nom du ou des développeurs/vendeurs

<homepage href=« http://localhost/jnlp/ »/>
site de l'application
href : url de l'application, adresse du site

<description>Alter-SIG</description>
<description kind=« short »>Logiciel 3D SIG Java, technologie de déploiement JWS/JNLP</description>
<description kind=« tooltip »>Alter-SIG</description>
description de l'application
kind : one-line / short / tooltip

<icon href=« http://localhost/jnlp/icon.gif » width=« 64 » height=« 64 »/>
<icon href=« http://localhost/jnlp/icon32.jpg » width=« 32 » height=« 32 »/>
icône utilisé pour les raccourcis
href : url de l'icone au format JPEG ou GIF
version : version de l'image
width : largeur de l'image
height : hauteur de l'image
kind : default / selected / disabled / rollover : type d'utilisation de l'image
depth : profondeur de couleur, généralement 8,16,24,32
size : poids de l'image en octets

<shortcut online=« true »>
Ajouter un raccourci pour le logiciel
online : visible uniquement si connexion au site mère présente
<desktop />
Raccourci sur le bureau
<menu submenu=« nomlogiciel »/>
Raccourci dans le menu démarrer
</shortcut>

<offline-allowed />
permet a l'application de se lancer sans avoir de connexion au site

</information>

<applet-desc main-class=« maclasse.class » name=« Prog » width=320 height=200>
Description de l'applet (s'il s’agit d'un applet uniquement)
main-class : nom de la classe principale
name : nom de l'applet
width : largeur de l'applet en pixel
height : hauteur de l'applet en pixel
documentbase : url pour les fichiers utilisés

<param name=« variableA » value=« Monsieur Jean »>
d'éventuels paramètres pour l'applet
name : nom du paramètre
value : valeur du paramètre

</applet-desc>

<application-desc main-class=« maclasse.class » >
Description de l'application (s'il s’agit d'une application uniquement)
main-class : nom de la classe principale, on peut sauter ce paramètre si la classe principale est dans la première archive jar et qu'elle contient un fichier manifest avec la classe principale

<argument>un argument</argument>
D'éventuels arguments pour l'application, ces arguments sont passés à la méthode main de l'application

</application-desc>

<component-desc/>
Spécifier une extension de composant

<installer-desc main-class=« classedinstallation.class »/>
Spécifiez une classe pour l'installation ou la désinstallation de l'application
main-class : nom de classe

<resources os=« Windows »>
La balise ressources contient les informations sur les données de l'application.
os : permet de spécifier pour quel système d'exploitation est destiné cette balise, on peut donc avoir des ressources différentes par système. cf. : annexe 2
arch : permet de spécifier une architecture processeur. cf. : annexe 2
locale: précise le pays, la langue, la culture. cf. : annexe 1

<j2se version=« 1.5+ »
href=« http://java.sun.com/products/autodl/j2se »
initial-heap-size=« 128m »
max-heap-size=« 1024m » />
Spécifiez les caractéristiques nécessaires pour la machine virtuel java
version : 1.4+ / 1.2 1.5 : version de la JVM nécessaire. Un + pour spécifier la version minimum ou mettre un espace entre chaque version.
href : url où l'on peut télécharger la JVM
initial-heap-size : 128m / 64M / 1024K / 512k : spécifiez l'espace mémoire initial. M ou m pour mega-octects, K ou k pour kilo-octets.
max-heap-size : 128m / 64M / 1024K / 512k : spécifiez la taille mémoire maximum

<jar href=« altersig.jar » main=« true » download=« eager » />
<jar href=« data.jar » download=« lazy » />
Spécifiez les jars nécessaires pour l'application
href : adresse de l'archive jar
version : version de l'archive
main : true / false : permet de spécifier si cette archive est la principale. Par défaut la première archive mentionnée est la principale.
download : eager / lazy : eager veut dire que l'archive sera téléchargée avant le lancement de l'application, lazy qu'elle le sera si nécessaire.
Size : taille en octets de l'archive
part : nom du groupe d'archive auquel appartient cette archive

<nativlib href=« lib/jogl_awt.dll.jar » />
<nativlib href=« lib/jogl_cg.dll.jar » />
Spécifiez les librairies natives nécessaires pour l'application. Il est souvent nécessaire de faire deux (ou plus) balises ressources pour spécifier des librairies natives différentes par système d'exploitation. Il est nécessaire de charger dynamiquement ces librairies dans l'application ( System.loadLibrary(« jogl ») )
href : adresse des archives. Les librairies (.dll / .so) doivent être contenues dans des.jar
version : version de l'archive
download : eager / lazy : eager veut dire que l'archive sera téléchargée avant le lancement de l'application, lazy qu'elle le sera si nécessaire.
Size : taille en octets de l'archive
part : nom du groupe d'archive auquel appartient cette archive


<extension name=« unAutresource » version=« 1 » href=« 3Dengine.jnlp »>
Spécifiez d'éventuelles extensions nécessaires à l'application.
href : adresse du fichier jnlp
version : version de l'extension
name : nom de l'extension
<ext-download ext-part=« unepartie » download=« lazy »>
Permet de définir la manière dont sera téléchargé chaque partie de l'extensions
ext-part : nom de la partie d'extension
download: eager / lazy : eager veut dire que l'archive sera téléchargée avant le lancement de l'application, lazy qu'elle le sera si nécessaire.
Part : nom du groupe où elle appartient

</extension>

<property name=« user.name » value=« Johann »/>
Permet de donner une valeur à une propriété du système de type System.getProperty ou System.getProperties
name : nom de la propriété
value : valeur de la propriété

<package name=« oracle.* » part=« oracle » recursive=« true »/>
Permet de définir une relation entre un package (ou une classe) et un groupe
name : nom du paquet
part : nom du groupe concerné
recursive : true / false : permet de préciser si le sous-package sont aussi compris dans cette relation

</resources>

<security>
La balise security: les sécurités à apporter pour l'application. S'il n'y a pas de précision l'applition s'éxecute dans le « bac à sable », donc comme un applet avec juste assez de droit pour son fonctionnement. Pas d'accès au disque, de communication réseau…
<all-permissions />
Définit l'application comme ayant tous les droits d'une application normale Java.
Il est nécessaire que TOUTES les archives jar soient signées (cf : signer un jar) et que l'utilisateur ait donné son accord au moment du lancement.
<j2ee-application-client-permissions/>
Indique que l'application doit avoir les droits d'une application de type J2EE

</security>

</jnlp>

La liste complète de toutes les langues :
www.unicode.org/unicode/onlinedat/languages.html

La liste complète de toutes les régions :
www.unicode.org/unicode/onlinedat/countries.html

Abréviations des systèmes d'exploitation :
http://www.vamphq.com/os.html