com.belladati.sdk

Class BellaDati

java.lang.Object

com.belladati.sdk.BellaDati

public class BellaDati
extends Object

Serves as the entry point to the BellaDati SDK. Use either of the connect methods to connect to a server, then authenticate to access a user's data.

It is recommended to use only one BellaDatiConnection per server to allow reuse of connection resources. Most client applications will connect only to a single BellaDati server - BellaDati cloud or an on-premise installation - meaning only one connection should be used.

The SDK uses default timeouts of 10 seconds which should work fine for most servers and internet connections. For environments that require different settings, timeouts and connection management can be configured using system properties:

• bdTimeout: Sets all timeouts without an individual setting to the given value.
• bdConnectionRequestTimeout: Timeout for getting a connection from the local connection manager.
• bdConnectTimeout: Timeout for establishing a connection to the server.
• bdSocketTimeout: Timeout while waiting for data from the server.
• bdMaxConnections: Maximum number of simultaneous API connections. Defaults to 40, which should be plenty for most applications. If your application sends large amounts of concurrent requests, local caching may result in better performance than increasing this setting.

All timeouts are set in milliseconds. These properties only affect new connections being created and don't change existing connections. If needed, set the timeouts before calling any of the connect() methods.

Author:

Chris Hennigfeld

Constructor Summary

Constructors

Constructor and Description
BellaDati()

Method Summary

Methods

Modifier and Type	Method and Description
static BellaDatiConnection	connect() Connects to the BellaDati cloud service.
static BellaDatiConnection	connect(String baseUrl) Connects to a BellaDati server hosted at the specified URL.
static BellaDatiConnection	connectInsecure(String baseUrl) Connects to a BellaDati server hosted at the specified URL.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BellaDati

public BellaDati()

Method Detail

connect

public static BellaDatiConnection connect()

Connects to the BellaDati cloud service.

Returns:

a connection to the BellaDati cloud service

connect

public static BellaDatiConnection connect(String baseUrl)

Connects to a BellaDati server hosted at the specified URL.

Parameters:

baseUrl - URL of the BellaDati server

Returns:

a connection to the BellaDati server hosted at the specified URL

connectInsecure

public static BellaDatiConnection connectInsecure(String baseUrl)

Connects to a BellaDati server hosted at the specified URL. This connection accepts servers using self-signed SSL certificates.

Warning: Avoid using this type of connection whenever possible. When using a server without a certificate signed by a known certificate authority, an attacker could impersonate your server and intercept passwords or sensitive data sent by the SDK.

Parameters:

baseUrl - URL of the BellaDati server

Returns:

a connection to the BellaDati server hosted at the specified URL