Après avoir installé le SDK Ultipa Java et mis en place une instance Ultipa fonctionnelle, vous devriez être en mesure de connecter votre application à la base de données de graph Ultipa.

La connexion à Ultipa peut être établie en créant un driver avec des configurations spécifiées en utilisant l'une ou les deux méthodes suivantes :

• Connexion par Configuration de Code : via la classe UltipaConfiguration
• Connexion par Configuration de Fichier : via le fichier ultipa.properties

Les valeurs des éléments de configuration sont déterminées de manière préférentielle par UltipaConfiguration, suivies par ultipa.properties. Si un élément n'est pas trouvé dans l'une ou l'autre configuration, la valeur par défaut est utilisée.

Connexion par Configuration de Code

package com.ultipa.www.sdk.api;

import com.ultipa.sdk.connect.Connection;
import com.ultipa.sdk.connect.conf.UltipaConfiguration;
import com.ultipa.sdk.connect.driver.UltipaClientDriver;

public class Main {
    public static void main(String[] args) {
        UltipaConfiguration myConfig = UltipaConfiguration.config()
            // Exemple d'URI : .hosts("mqj4zouys.us-east-1.cloud.ultipa.com:60010")
            .hosts("192.168.1.85:60061,192.168.1.86:60061,192.168.1.87:60061")
            .username("<username>")
            .password("<password>")
            .defaultGraph("default");

        UltipaClientDriver driver = null;
        try {
            driver = new UltipaClientDriver(myConfig);
            Connection client = driver.getConnection("amz");

            String reply = client.sayHello("Hi");
            System.out.println(reply);
        } finally {
            if (driver != null) {
                driver.close();
            }
        }
    }
}

Hi Welcome To Ultipa!

Un driver est créé avec les configurations spécifiées en utilisant UltipaConfiguration. Veuillez vous référer aux Éléments de Configuration pour tous les éléments disponibles pour configurer les détails de connexion avec UltipaConfiguration.

La méthode getConnection() obtient une connexion à Ultipa, vous permettant de spécifier, de façon facultative, un graphset comme le graphset actuel (dans ce cas, amz). Si aucun graph n'est spécifié, le graphset identifié par l'élément de configuration defaultGraph sera utilisé.

Connexion par Configuration de Fichier

package com.ultipa.www.sdk.api;

import com.ultipa.sdk.connect.Connection;
import com.ultipa.sdk.connect.conf.UltipaConfiguration;
import com.ultipa.sdk.connect.driver.UltipaClientDriver;

public class Main {
    public static void main(String[] args) {
        UltipaClientDriver driver = null;
        try {
            driver = new UltipaClientDriver();
            Connection client = driver.getConnection();

            String reply = client.sayHello("Hi");
            System.out.println(reply);
        } finally {
            if (driver != null) {
                driver.close();
            }
        }
    }
}

Un driver est créé avec les configurations spécifiées en utilisant le fichier ultipa.properties. Le fichier ultipa.properties doit être placé sous le classpath du projet Java, qui est par défaut ./src/main/resources.

Exemple du fichier ultipa.properties :

ultipa.hosts=192.168.1.85:60061,192.168.1.86:60061,192.168.1.87:60061
#ultipa.hosts=mqj4zouys.us-east-1.cloud.ultipa.com:60010
ultipa.username=<username>
ultipa.password=<password>
ultipa.passwordEncrypt=NOTHING
ultipa.defaultGraph=amz
# ultipa.crt=F:\\ultipa.crt
# ultipa.overrideAuthority=ultipa
# ultipa.crt=https
# ultipa.crt=
ultipa.keepAlive=180
ultipa.keepAliveWithoutCalls=true
ultipa.pool.maxIdle=50
ultipa.pool.minIdle=20
ultipa.pool.maxTotal=200
ultipa.pool.timeBetweenEvictionRunsMillis=3600000
ultipa.pool.testOnBorrow=true

Veuillez vous référer aux Éléments de Configuration pour tous les éléments disponibles pour configurer les détails de connexion avec le fichier ultipa.properties.

Éléments de Configuration

Voici tous les éléments de configuration disponibles pour UltipaConfiguration et ultipa.properties:

Pool de Connexion

PoolConfig contient les paramètres de configuration pour utiliser la bibliothèque Apache Commons Pool. Ces réglages sont nécessaires lors de la connexion à une base de données pour gérer et réutiliser efficacement les connexions.

package com.ultipa.www.sdk.api;

import com.ultipa.sdk.connect.Connection;
import com.ultipa.sdk.connect.conf.UltipaConfiguration;
import com.ultipa.sdk.connect.driver.UltipaClientDriver;

public class Main {
    public static void main(String[] args) {
        UltipaConfiguration myConfig = UltipaConfiguration.config()
            // Exemple d'URI : .hosts("mqj4zouys.us-east-1.cloud.ultipa.com:60010")
            .hosts("192.168.1.85:60061,192.168.1.86:60061,192.168.1.87:60061")
            .username("<username>")
            .password("<password>");

        PoolConfig poolConfig = myConfig.getPoolConfig();
        poolConfig.setMaxIdle(50);
        poolConfig.setMinIdle(2);
        poolConfig.setMaxTotal(200);

        UltipaClientDriver driver = null;
        try {
            driver = new UltipaClientDriver(myConfig);
            Connection client = driver.getConnection();

            String reply = client.sayHello("Hi");
            System.out.println(reply);
        } finally {
            if (driver != null) {
                driver.close();
            }
        }
    }
}

PoolConfig a les champs suivants :

Source de Données

En définissant les configurations et le graph cible dans un DataSource, vous pouvez facilement transmettre toutes les informations de connexion nécessaires au UltipaClientDriver lors de la création d'une connexion.

Lorsque UltipaClientDriver est instancié à l'aide de DataSource, le fichier ultipa.properties est ignoré.

package com.ultipa.www.sdk.api;

import com.ultipa.sdk.connect.Connection;
import com.ultipa.sdk.connect.conf.UltipaConfiguration;
import com.ultipa.sdk.connect.driver.UltipaClientDriver;

public class Main {
    public static void main(String[] args) {
        UltipaConfiguration myConfig = UltipaConfiguration.config()
            // Exemple d'URI : .hosts("mqj4zouys.us-east-1.cloud.ultipa.com:60010")
            .hosts("192.168.1.85:60061,192.168.1.86:60061,192.168.1.87:60061")
            .username("<username>")
            .password("<password>");

        PoolConfig poolConfig = myConfig.getPoolConfig();
        poolConfig.setMaxIdle(50);
        poolConfig.setMinIdle(2);
        poolConfig.setMaxTotal(200);

        DataSource dataSource = new DataSource();
        dataSource.setUltipaConfiguration(myConfig);
        dataSource.setDefaultGraph("amz");

        UltipaClientDriver driver = null;
        try {
            driver = new UltipaClientDriver(dataSource);
            Connection client = driver.getConnection();

            String reply = client.sayHello("Hi");
            System.out.println(reply);
        } finally {
            if (driver != null) {
                driver.close();
            }
        }
    }
}

Fermer la Connexion

L'objet driver peut être réutilisé à travers plusieurs threads, et la connexion peut être fermée correctement en appelant la méthode driver.close().