oracle.pgx.api

Class Pgx

java.lang.Object

oracle.pgx.api.Pgx

public final class Pgx
extends java.lang.Object

Main entry point for PGX applications.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	EMBEDDED_URL constant indicating this URL refers to an embedded PGX instance.

Constructor Summary

Constructors

Constructor and Description
Pgx()

Method Summary

Modifier and Type	Method and Description
static PgxSession	createSession(java.lang.String source) Creates a session on the default instance.
static PgxSession	createSession(java.lang.String baseUrl, java.lang.String source) Creates a session.
static java.lang.String	getDefaultUrl() The default url is set by default to EMBEDDED_URL.
static ServerInstance	getInstance() Get a handle to a PGX instance using getDefaultUrl().
static ServerInstance	getInstance(ClientConfig config) Get a handle to a PGX instance.
static ServerInstance	getInstance(java.lang.String baseUrl) Get a handle to a PGX instance.
static ServerInstance	getInstance(java.lang.String baseUrl, java.lang.String username, java.lang.String password) Get a handle to a PGX instance.
static ServerInstance	getInstance(java.lang.String baseUrl, java.lang.String username, java.lang.String password, java.lang.Integer prefetchSize, java.lang.Integer uploadBatchSize, java.lang.Integer remoteFutureTimeout, java.lang.Integer remoteFuturePendingRetryInterval) Get a handle to a PGX instance.
static ServerInstance	getInstance(java.lang.String baseUrl, java.lang.String username, java.lang.String password, java.lang.Integer prefetchSize, java.lang.Integer uploadBatchSize, java.lang.Integer remoteFutureTimeout, java.lang.Integer remoteFuturePendingRetryInterval, java.lang.Boolean enableCcTrace) Get a handle to a PGX instance.
static oracle.pgx.api.internal.ApiProvider	getProviderFor(java.lang.String url)
static void	setDefaultUrl(java.lang.String url) set the default base url used by invocations of getInstance().

Methods inherited from class java.lang.Object

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

Field Detail

EMBEDDED_URL

public static final java.lang.String EMBEDDED_URL

constant indicating this URL refers to an embedded PGX instance.

Constructor Detail

Pgx

public Pgx()

Method Detail

createSession

public static PgxSession createSession(java.lang.String source)
                                throws java.util.concurrent.ExecutionException,
                                       java.lang.InterruptedException

Creates a session on the default instance. This is a convenience method around createSession(String, String) using getDefaultUrl() as base URL.

Parameters:

source - the session source string

Returns:

the created session

Throws:

java.util.concurrent.ExecutionException

java.lang.InterruptedException

createSession

public static PgxSession createSession(java.lang.String baseUrl,
                                       java.lang.String source)
                                throws java.util.concurrent.ExecutionException,
                                       java.lang.InterruptedException

Creates a session.

Parameters:

baseUrl - the base URL pointing to a PGX server instance the session should be created on

source - the session source string

Returns:

the created session

Throws:

java.util.concurrent.ExecutionException

java.lang.InterruptedException

getDefaultUrl

public static java.lang.String getDefaultUrl()

The default url is set by default to EMBEDDED_URL. You can overwrite the *default* default url by setting the -DpgxDefaultUrl system property.

Returns:

the currently set default url.

getInstance

public static ServerInstance getInstance()
                                  throws java.util.concurrent.ExecutionException,
                                         java.lang.InterruptedException

Get a handle to a PGX instance using getDefaultUrl().

Returns:

the ServerInstance instance

Throws:

java.util.concurrent.ExecutionException

java.lang.InterruptedException

getInstance

public static ServerInstance getInstance(ClientConfig config)

Get a handle to a PGX instance.

Parameters:

config - the config identifying the instance

Returns:

the ServerInstance instance

getInstance

public static ServerInstance getInstance(java.lang.String baseUrl)

Get a handle to a PGX instance.

Parameters:

baseUrl - base url pointing to a PGX server instance, e.g. myhost:7000/pgx

Returns:

the ServerInstance instance

getInstance

public static ServerInstance getInstance(java.lang.String baseUrl,
                                         java.lang.String username,
                                         java.lang.String password)

Get a handle to a PGX instance.

Parameters:

baseUrl - base url pointing to a PGX server instance, e.g. myhost:7000/pgx

username - the HTTP Basic Auth username

password - the HTTP Basic Auth password

Returns:

the ServerInstance instance

getInstance

public static ServerInstance getInstance(java.lang.String baseUrl,
                                         java.lang.String username,
                                         java.lang.String password,
                                         java.lang.Integer prefetchSize,
                                         java.lang.Integer uploadBatchSize,
                                         java.lang.Integer remoteFutureTimeout,
                                         java.lang.Integer remoteFuturePendingRetryInterval)

Get a handle to a PGX instance.

Parameters:

baseUrl - base url pointing to a PGX server instance, e.g. myhost:7000/pgx

username - the HTTP Basic Auth username

password - the HTTP Basic Auth password

prefetchSize - how many elements to pre-fetch from the server, e.g. when iterating over a collection

uploadBatchSize - how many elements to upload during one batch, e.g. when adding elements to a collection

remoteFutureTimeout - How long GET requests waiting for futures to complete will be alive before time out. Time in milliseconds, set to zero for an infinite timeout. See HTTP Client SO_TIMEOUT for more details.

remoteFuturePendingRetryInterval - How many milliseconds to wait before sending another request in case a GET request for a PgxRemoteFuture receives a 202 - Accepted response

Returns:

the ServerInstance instance

getInstance

public static ServerInstance getInstance(java.lang.String baseUrl,
                                         java.lang.String username,
                                         java.lang.String password,
                                         java.lang.Integer prefetchSize,
                                         java.lang.Integer uploadBatchSize,
                                         java.lang.Integer remoteFutureTimeout,
                                         java.lang.Integer remoteFuturePendingRetryInterval,
                                         java.lang.Boolean enableCcTrace)

Get a handle to a PGX instance.

Parameters:

baseUrl - base url pointing to a PGX server instance, e.g. myhost:7000/pgx

username - the HTTP Basic Auth username

password - the HTTP Basic Auth password

prefetchSize - how many elements to pre-fetch from the server, e.g. when iterating over a collection

uploadBatchSize - how many elements to upload during one batch, e.g. when adding elements to a collection

remoteFutureTimeout - How long GET requests waiting for futures to complete will be alive before time out. Time in milliseconds, set to zero for an infinite timeout. See HTTP Client SO_TIMEOUT for more details.

remoteFuturePendingRetryInterval - How many milliseconds to wait before sending another request in case a GET request for a PgxRemoteFuture receives a 202 - Accepted response

enableCcTrace - if true log every call to a Control or Core interface

Returns:

the ServerInstance instance

getProviderFor

public static oracle.pgx.api.internal.ApiProvider getProviderFor(java.lang.String url)

setDefaultUrl

public static void setDefaultUrl(java.lang.String url)

set the default base url used by invocations of getInstance(). The new default url affects sub-sequent calls of getInstance().

Parameters:

url - default url