Vous allez travailler avec Java EE 8 et l'IDE NetBeans 9 (toutes les captures d'écran et les explications techniques sont données pour cet IDE).
Si vous avez déjà installé NetBeans, attention, il vou faut la version 9.0 ou une version plus récente.
Vous travaillerez avec Java SE 10 (ou une version plus récente). Vous aurez aussi besoin de Java 8 car Payara (ou GlassFish) ne fonctionne pas pour le moment avec une version plus récente de Java. Il vous faudra donc avoir installé 2 versions de Java SE : 8 et 10 (ou plus récente que 10)
La base de données "sample" de Java DB (le SGBD utilisé par défaut par NetBeans) sera utilisée dans le TP 1.
IMPORTANT : Si vous avez déjà installé une version de NetBeans plus ancienne que la version 9 vous pouvez avoir une ancienne version de la base "sample" qui sera utilisée dans le TP 1. Dans le cas où vous avez déjà une base "sample" pour Java DB, vérifiez qu'elle contient bien une table MICRO_MARKET. Si c'est le cas, gardez cette base ; sinon il va falloir installer une nouvelle version de cette base de données. Pour faire cette vérification, ouvrez l'ancienne version de NetBeans que vous avez installée, onglet Services en haut à gauche, entrée Databases > Java DB. Démarrez le serveur (clic droit et Start) s'il le faut et ouvrez l'entrée Java DB en cliquant sur le "+". Si vous n'avez pas d'entrée sample c'est que vous n'avez pas de base sample. Si vous avez une entrée sample, clic droit dessus et "Connect...". Ensuite ouvrez l'entrée jdbc:derby///localhost:1527/sample, entrée APP > Tables qui donne la liste des tables de la base de données.
Pour le cas où vous auriez une mauvaise version de la base sample, il va falloir faire la place pour une nouvelle base sample. Vous le ferez plus tard, après l'installation de NetBeans (section "Base de données sample").
Aller à la page https://netbeans.apache.org/. Cliquer sur « Download ». Récupérer le fichier zip des binaires, "incubating-netbeans-java-9.0-bin.zip" (161 Mo) à la date de l'écriture de cet énoncé. La vidéo https://www.youtube.com/watch?v=am-7aa2hYgc donne quelques détails du téléchargement et de l' installation (installation pour MacOSX mais très semblable à l’installation pour Windows).
Pour l’installer, il suffit de dézipper le fichier dans un répertoire de votre choix (pour Windows, ne choisissez pas C:\Program Files ou C:\Programmes qui sont protégés).
L’exécutable est dans le répertoire netbeans/bin (version 64 ou 32 bit pour Windows ; il y a aussi une version Unix).
Quand on lance NetBeans pour la première fois une fenêtre pop-up s'affiche :
Lire cet article pour une explication de ce message. Rapidement on peut dire que nb-javac est une version modifiée de javac qui est mieux adaptée à NetBeans. Cliquez donc sur "Install nb-javac". Redémarrez ensuite NetBeans.
En attendant l’intégration de Java EE / Jakarta dans NetBeans 9 il faut installer les plugins de NetBeans 8.2 dans NetBeans 9.
https://dzone.com/articles/notes-on-java-eejakarta-ee-support-for-netbeans-9 explique comment charger et installer NetBeans 9.0 et aussi comment installer un nouvel entrepôt de plugins pour récupérer les plugins de NetBeans 8.2 (ils sont compatibles avec NetBeans 9).
Pour installer l’entrepôt il faut aller dans le menu de NetBeans Tools > Plugins > Settings et ajouter cette adresse (donnez le nom « NetBeans 8.2 » à cet entrepôt) : http://updates.netbeans.org/netbeans/updates/8.2/uc/final/distribution/catalog.xml.gz.
Cherchez ensuite tous les plugins qui contiennent le mot « Kit » et cochez ceux-ci :
Il faut alors redémarrer NetBeans.
Le SGBD Java DB, est fourni avec NetBeans. Vous n'avez donc rien à faire pour l'installer. :-)
Cependant, il est possible que le port 1527 utilisé par défaut par Java DB soit déjà occupé par un autre programme. Pour le savoir démarrez NetBeans. En haut à gauche, dans l'onglet "Services" faites un clic droit sur l'entrée "Java DB". Si le choix "Start Server" est grisé c'est que Java DB a bien démarré. Si ça n'est pas le cas, lancez le choix "Start Server". Ce lancement doit ouvrir dans la partie basse à droite de NetBeans un onglet "Output - Java DB Database process" dans lequel vous aurez un message du type "Apache Derby Network Server - 10.11.1.2 - (1629631) démarré et prêt à accepter les connexions sur le port 1527". Si vous n'arrivez pas à démarrer Java DB, lisez cette page.
Si vous avez déjà une base de données sample et qu'elle contient bien la table MICRO_MARKET vous n'avez rien à faire et vous pouvez passer directement à l'installation de Payara.
Sinon, vous allez devoir créer cette base et y insérer des données.
Si vous avez déjà une base sample mais qu'elle contient un ancien schéma (pas de table MICRO_MARKET), suivez cette procédure avant de passer à la suite.
Vous n'avez pas (plus) de base sample.
Dans NetBeans créez une base sample : clic droit sur Java DB dans l'onglet Services et "Create Database...". Nommez-la "sample" et donnez le nom d'utilisateur "app" et le mot de passe "app".
Cliquez sur la ligne de la base sample que vous venez de créer et clic droit > "Execute Command...". Une fenêtre SQL s'ouvre dans NetBeans. Ouvrez cette page dans votre navigateur Web. Copiez le contenu dans la fenêtre SQL de NetBeans et lancez l'exécution des commandes SQL dans la fenêtre SQL de NetBeans (clic sur l'icône "Run SQL" en haut de la fenêtre ou tapez Ctrl+Maj+E).
Ouvrez maintenant la base sample (clic sur le "+") et vous devriez voir les tables de la base. Clic droit sur une des tables et "View Data..." pour voir les données de la table.
Vous devez déjà avoir installé un serveur Java EE pour continuer. Nous utiliserons Payara 5 (compatible Java EE 8) pour les TPs de ce cours.
Aller à l’adresse https://www.payara.fish/. Clic sur « Downloads » en haut de la page.
Guide rapide d'installation et d'intégration à NetBeans.
Un des avantages de GlassFish est que la source de données jdbc/sample est déjà définie dans le serveur quand on l'installe. Les utilisateurs du serveur peuvent ainsi faire rapidement des tests qui utilisent une base de données.
Cette source de données n'est pas définie dans Payara et vous allez donc devoir la définir en utilisant la console d'administration du serveur. Ce petit inconvénient a l'avantage de vous permettre de voir comment on peut définir une source de données dans Payara (la procédure de déclaration d'une source de données dépend du serveur d'application mais Payara et GlassFish ont la même procédure).
Vous allez définir la source de données jdbc/sample dans Payara. Cette page explique en détails comment faire.
Si tout a bien marché vous avez fait le plus dur.
Nous utiliserons également quelques composants de la librairie JSF "PrimeFaces", provenant du site http://www.primefaces.org/. PrimeFaces est intégré dans NetBeans 8.2 avec la version 5.0 qui convient pour faire les TPs.
Je vous conseille d'utiliser plutôt la dernière version 6.1. Vous pouvez récupérer le fichier jar à la page http://www.primefaces.org/downloads/ (il faut descendre dans la page jusqu'à la section "Community Downloads" pour avoir les versions gratuites ; il faut payer pour avoir les versions intermédiaires, 6.1.5 par exemple). Récupérez le jar de la colonne "Binary", à moins que vous ne souhaitiez étudier le code source. Vous pouvez télécharger la version 6.2 si elle est disponible au moment de votre installation.
Vous installez le jar dans un répertoire quelconque et vous ajoutez ensuite une nouvelle librairie dans NetBeans pour pouvoir l'utiliser.
**************
Cette base de données était installée avec GlassFish qui est le serveur d'application standard livré avec la version Java EE de NetBeans. Si vous avez déjà installé NetBeans ou GlassFish (par exemple en installant une version précédente de NetBeans), vous avez déjà installé Java DB et la base de données "sample" de java DB. Pour le savoir, il suffit d'aller voir voir dans votre répertoire HOME (C:\Users\toto\ si vous êtes sous Windows et si vous vous appelez toto). Si vous avez un répertoire .netbeans-derby c'est que Java DB a déjà été installé. En ce cas, renommez le répertoire .netbeans-derby\sample (ou déplacez-le ailleurs que dans .netbeans-derby) avant d'installer NetBeans. Ainsi la nouvelle version de la base sample sera installée lors de l'installation de NetBeans.