完成安装嬴图Java SDK，设置一个运行的嬴图实例后，可以开始将您的应用连接到嬴图图数据库。

创建驱动程序并根据以下方法中的一种或两种进行配置，以建立与嬴图数据库的连接：

• 代码配置连接：通过UltipaConfiguration类
• 文件配置连接：通过ultipa.properties文件

配置项的值优先由UltipaConfiguration决定，其次是ultipa.properties。若配置项在两个配置方法中均未提及，则使用默认值。

代码配置连接

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()
            // 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!

使用UltipaConfiguration配置的驱动程序创建完成。请参考配置项，使用UltipaConfiguration为全部可配置项配置连接详情。

getConnection()方法用于获取与嬴图数据库的连接，您可选择是否指定图集为当前图集（本例选定图集amz）。若未指定图集，将使用配置项defaultGraph发现的图集。

文件配置连接

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();
            }
        }
    }
}

使用ultipa.properties文件配置的驱动程序创建完成。ultipa.properties文件应在Java项目的classpath下，默认路径为./src/main/resources。

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

请参考配置项，使用ultipa.properties文件为全部可配置项配置连接详情。

配置项

以下各项可通过UltipaConfiguration和ultipa.properties配置：

连接池

PoolConfig包含使用Apache Commons池库的配置设置。连接数据库时，需完成这些设置，以便高效处理和重用连接。

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()
            // 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包含以下字段：

数据源

通过在DataSource中进行配置并设置目标图集，您可在创建连接时轻松将全部必要连接信息传递给UltipaClientDriver。

若UltipaClientDriver通过DataSource实例化，ultipa.properties文件将被忽略。

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()
            // 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();
            }
        }
    }
}

关闭连接

驱动程序对象可在多线程间重复使用，您可通过调用driver.close()方法关闭连接。