Installation drivers MySQL xCP Designer

De EjnTricks
Révision de 12 avril 2016 à 10:26 par Etienne (discussion | contributions)

(diff) ← Version précédente | Voir la version courante (diff) | Version suivante → (diff)

Dans le cadre d'un projet, il était demandé de pouvoir se connecter à une base de données MySql depuis les processus modélisés. Par défaut, il existe un ensemble de drivers mis en place sous xCP Designer, mais pas celui pour MySql.

Cet article présente les actions nécessaires, afin de pouvoir bénéficier du driver.


Hand-icon.png Votre avis

Nobody voted on this yet

 You need to enable JavaScript to vote


Download-icon.png Téléchargement

Afin de pouvoir l'installer, il faut l'avoir à disposition. Le driver est disponible sur le site de MySQL. Dans le cadre de cet article, la version 5.1.38 est téléchargée.


System-Install-icon.png Installation

L'installation consiste à référencer une nouvelle extension Java, tout simplement.

Java format icon.png Fichier jar

Une fois téléchargé, le fichier jar du driver est placé dans le sous répertoire content/modules de l'application, soit à l'emplacement content/modules/mysql-connector-java-5.1.38-bin.jar dans le cadre de cette mise en place.

XML format icon.png Définition extension

L'extension est définie à l'aide d'un fichier XML dans le répertoire Artifacts/Java Modules de l'application. Si besoin, le sous répertoire Java Modules doit être créé.

Pour cette installation, le driver sera installé avec les valeurs suivantes.

  • Nom artefact : mysql_driver;
  • Label artefact : MySQL Driver.

Le nom du fichier XML doit correspondre au pattern <NOM ARTEFACT>.javamodule, soit mysql_driver.javamodule pour cet exemple.

Lors de l'ajout d'une extension, le contenu du fichier XML est le suivant.

<?xml version="1.0" encoding="UTF-8"?>
    <nsJavaModule:JavaModule xmlns:nsJavaModule="http://xcp.emc.com/javamodule" urn="urn:xcp:com.emc.xcp.artifact.javamodule.category:Artifacts/Java Modules/<NOM ARTEFACT>.javamodule" categoryId="com.emc.xcp.artifact.javamodule.category" name="<NOM ARTEFACT>" label="<LABEL ARTEFACT>" implementationClass="<CLASS IMPLEMENTATION>">
        <interfaceClassNames><NOM DES INTERFACES></interfaceClassNames> <!-- Optional 0 or more-->
        <implementationJars contentPath="content/modules/<FICHIER JAR>"/> <!-- 1 or more -->
    </nsJavaModule:JavaModule>

Pour cette installation, le fichier est donc complété de la façon suivante.

  • <NOM ARTEFACT> remplacé par mysql_driver;
  • <LABEL ARTEFACT> remplacé par MySQL Driver;
  • <CLASS IMPLEMENTATION> remplacé par com.mysql.jdbc.Driver;
  • <NOM DES INTERFACES> remplacé par java.sql.Driver. Une seule interface est définie pour cette classe;
  • <FICHIER JAR> remplacé par mysql-connector-java-5.1.38-bin.jar. Un seul jar est mis à disposition.
<?xml version="1.0" encoding="UTF-8"?>
    <nsJavaModule:JavaModule xmlns:nsJavaModule="http://xcp.emc.com/javamodule" urn="urn:xcp:com.emc.xcp.artifact.javamodule.category:Artifacts/Java Modules/mysql_driver.javamodule" categoryId="com.emc.xcp.artifact.javamodule.category" name="mysql_driver" label="MySQL Driver" implementationClass="com.mysql.jdbc.Driver">
        <interfaceClassNames>java.sql.Driver</interfaceClassNames> <!-- Optional 0 or more-->
        <implementationJars contentPath="content/modules/mysql-connector-java-5.1.38-bin.jar"/> <!-- 1 or more -->
    </nsJavaModule:JavaModule>


Icon Personnalisation.png Utilisation

Une fois référencé, il suffit de redémarrer xCP Designer et le driver sera disponible lors de la déclaration d'un EndPoint de type Database. Pour cela, il faut ouvrir le panneau Application et activer le menu contextuel de l'élément Endpoints par un clic droit.


Sur la fenêtre affiché, il faut sélectionner le type Database et spécifier un nom, MySQL Access dans le cadre de cet article.


Sur la page de spécialisation du enpoint, le driver est alors disponible dans la liste de choix.