Cet article présente l’intégration des librairies WebLogic Server 12.2.1.3 dans un repository Maven local. Cela permettra ensuite de construire des projets Java utilisant les librairies de WebLogic Server.

Avant toute chose, il est nécessaire de s’enregistrer chez Oracle pour pouvoir accéder à distance à ses repos Maven :

https://www.oracle.com/webapps/maven/register/license.html

Installation de Maven

Vous pouvez utiliser votre propre installation de Maven pour peu que sa version soit au minimum la 3.0.5 ou en installer une depuis http://maven.apache.org

Si vous ne disposez pas d’une installation Maven, WebLogic Server 12.2.1.3 en propose une dans le répertoire

ORACLE_HOME/oracle_common/modules/org.apache.maven_3.0.5

Ne pas oublier de fixer les variables d’environnement M2_HOME et PATH pour localiser l’installation Maven.

WINDOWS :

set M2_HOME=<emplacement de Maven>
set PATH=%M2_HOME%\bin;%PATH%

LINUX :

export M2_HOME=<emplacement de Maven>
export PATH=${M2_HOME}/bin:$PATH%

 Configuration de Maven

L’accès aux repositories distants est assurée par défaut par le plugin HTTP WAGON, inclu dans Maven.

Ce plugin doit être configuré dans le fichier M2_HOME/conf/settings.xml pour y indiquer l’identifiant et le mot de passe de l’utilisateur enregistré auprès d’Oracle.

[pastacode lang= »markup » manual= »%20%3Cserver%3E%0A%20%20%20%20%3Cid%3Emaven.oracle.com%3C%2Fid%3E%0A%20%20%20%20%3Cusername%3EIDENTIFIANT%3C%2Fusername%3E%0A%20%20%20%20%3Cpassword%3EMOT%20DE%20PASSE%3C%2Fpassword%3E%0A%20%20%20%20%3Cconfiguration%3E%0A%20%20%20%20%20%20%3CbasicAuthScope%3E%0A%20%20%20%20%20%20%20%20%3Chost%3EANY%3C%2Fhost%3E%0A%20%20%20%20%20%20%20%20%3Cport%3EANY%3C%2Fport%3E%0A%20%20%20%20%20%20%20%20%3Crealm%3EOAM%2011g%3C%2Frealm%3E%0A%20%20%20%20%20%20%3C%2FbasicAuthScope%3E%0A%20%20%20%20%20%20%3ChttpConfiguration%3E%0A%20%20%20%20%20%20%20%20%3Call%3E%0A%20%20%20%20%20%20%20%20%20%20%3Cparams%3E%0A%20%20%20%20%20%20%20%20%20%20%20%20%3Cproperty%3E%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%3Cname%3Ehttp.protocol.allow-circular-redirects%3C%2Fname%3E%0A%20%20%20%20%20%20%20%20%20%20%20%20%20%20%3Cvalue%3E%25b%2Ctrue%3C%2Fvalue%3E%0A%20%20%20%20%20%20%20%20%20%20%20%20%3C%2Fproperty%3E%0A%20%20%20%20%20%20%20%20%20%20%3C%2Fparams%3E%0A%20%20%20%20%20%20%20%20%3C%2Fall%3E%0A%20%20%20%20%20%20%3C%2FhttpConfiguration%3E%0A%20%20%20%20%3C%2Fconfiguration%3E%0A%20%20%3C%2Fserver%3E » message= »Extrait du fichier de configuration settings.xml » highlight= »3,4″ provider= »manual »/]

Remplacer IDENTIFIANT et MOT DE PASSE par leur valeur.

Le mot de passe peut être inscrit en clair mais il est plus sage de le chiffrer avant :

Créer un fichier settings-security.xml dans le répertoire HOME/.m2

Créer et chiffrer le master password Maven à l’aide de la commande

[pastacode lang= »bash » manual= »mvn%20–encrypt-master-password%20%3Cpassword%3E » message= » » highlight= » » provider= »manual »/]

Copier le mot de passe chiffré et insérez-le dans le fichier settings-security.xml entre les balises <master>

[pastacode lang= »markup » manual= »%3CsettingsSecurity%3E%0A%20%20%3Cmaster%3E%7BMOT%20DE%20PASSE%20CHIFFRE%7D%3C%2Fmaster%3E%0A%3C%2FsettingsSecurity%3E » message= »settings-security.xml » highlight= » » provider= »manual »/]

Sauvegarder le fichier.

Générer ensuite une version chiffrée du mot de passe d’accès à votre compte Oracle :

[pastacode lang= »bash » manual= »mvn%20–encrypt-password%20%3CMOT%20DE%20PASSE%20DU%20COMPTE%20ORACLE%3E » message= » » highlight= » » provider= »manual »/]

Faire un copier/coller du mot de passe chiffré obtenu avec cette commande dans le fichier M2_HOME/conf/settings.xml
Référence : https://maven.apache.org/guides/mini/guide-encryption.html

Installation du plugin de synchronisation

Le plugin est disponible dans l’installation WebLogic :

ORACLE_HOME/oracle_common/plugins/maven/com/oracle/maven/oracle-maven-sync/12.1.3/oracle-maven-sync-12.2.1.pom
ORACLE_HOME/oracle_common/plugins/maven/com/oracle/maven/oracle-maven-sync/12.2.1/oracle-maven-sync-12.2.1.jar

Lancer un shell et se placer dans le répertoire ORACLE_HOME/oracle_common/plugins/maven/com/oracle/maven/oracle-maven-sync/12.2.1

Lancer l’installation

[pastacode lang= »bash » manual= »mvn%20install%3Ainstall-file%20-DpomFile%3Doracle-maven-sync-12.2.1.pom%20-Dfile%3Doracle-maven-sync-12.2.1.jar » message= » » highlight= » » provider= »manual »/]

Vérifier l’installation du plugin en demandant l’aide

[pastacode lang= »bash » manual= »mvn%20help%3Adescribe%20-Dplugin%3Dcom.oracle.maven%3Aoracle-maven-sync%20-Ddetail » message= » » highlight= » » provider= »manual »/]

Synchronisation du repository local

La synchronisation est réalisée avec la commande suivante :

[pastacode lang= »bash » manual= »mvn%20com.oracle.maven%3Aoracle-maven-sync%3Apush%20-DoracleHome%3D%3CORACLE_HOME%3E » message= » » highlight= » » provider= »manual »/]

Remplacer <ORACLE_HOME> par sa valeur.

Cette synchronisation est nécessaire chaque fois que votre installation WebLogic Server est modifiée, lors de l’application d’un pathc par exemple.

Configuration pom.xml

Ajouter la déclaration du repository Oracle dans le pom.xml du projet

[pastacode lang= »markup » manual= »%3Crepositories%3E%0A%20%20%3Crepository%3E%0A%20%20%20%20%3Cid%3Emaven.oracle.com%3C%2Fid%3E%0A%20%20%20%20%3Creleases%3E%0A%20%20%20%20%20%20%3Cenabled%3Etrue%3C%2Fenabled%3E%0A%20%20%20%20%3C%2Freleases%3E%0A%20%20%20%20%3Csnapshots%3E%0A%20%20%20%20%20%20%3Cenabled%3Efalse%3C%2Fenabled%3E%0A%20%20%20%20%3C%2Fsnapshots%3E%0A%20%20%20%20%3Curl%3Ehttps%3A%2F%2Fmaven.oracle.com%3C%2Furl%3E%0A%20%20%20%20%3Clayout%3Edefault%3C%2Flayout%3E%0A%20%20%3C%2Frepository%3E%0A%3C%2Frepositories%3E%20%20″ message= »extrait du pom.xml » highlight= » » provider= »manual »/]

C’est tout.