com.marklogic.xcc

Class ContentSourceFactory

java.lang.Object

com.marklogic.xcc.ContentSourceFactory

public class ContentSourceFactory
extends java.lang.Object

Static helper class with factory methods to create instances of ContentSource using explicit connection parameters.

See Also:

ContentSource

Method Summary

Modifier and Type	Method and Description
static ContentSource	newContentSource(ConnectionProvider connectionProvider, char[] apiKey, java.lang.String contentbaseName, java.lang.String basePath) Return a ContentSource object that will use the provided ConnectionProvider instance to obtain connections to MarkLogic Cloud, with the given user api key, contentbase and base path.
static ContentSource	newContentSource(ConnectionProvider connectionProvider, char[] authStr, java.lang.String authType, java.lang.String contentbaseName, java.lang.String basePath) Return a ContentSource object that will use the provided ConnectionProvider instance to obtain connections to MarkLogic Server (or the reverse proxy in front of it) using one of the token-based authentication protocols (OAuth or MarkLogic Cloud), with the given authentication string (OAuth JWT access token or MarkLogic Cloud api key), contentbase and base path.
static ContentSource	newContentSource(ConnectionProvider connectionProvider, java.lang.String user, char[] password, java.lang.String contentbaseName) Return a ContentSource object that will use the provided ConnectionProvider instance to obtain server connections, with the given default login credentials and contentbase values.
static ContentSource	newContentSource(ConnectionProvider connectionProvider, java.lang.String user, char[] password, java.lang.String contentbaseName, java.lang.String basePath) Return a ContentSource object that will use the provided ConnectionProvider instance to obtain connections to the reverse proxy, and to the server behind the reverse proxy, with the given default login credentials, contentbase and base path values.
static ContentSource	newContentSource(ConnectionProvider connectionProvider, java.lang.String user, java.lang.String password, java.lang.String contentbaseName) Deprecated.
static ContentSource	newContentSource(java.lang.String host, int port) Return a ContentSource object that will serve as the source of connections to the server on the given host and port, with no default login credentials.
static ContentSource	newContentSource(java.lang.String host, int port, char[] authStr, java.lang.String authType) Equivalent to newContentSource(host, port, authStr, authType, null, null, null)
static ContentSource	newContentSource(java.lang.String host, int port, char[] authStr, java.lang.String authType, java.lang.String contentbaseName) Equivalent to newContentSource(host, port, authStr, authType, contentbaseName, null, null)
static ContentSource	newContentSource(java.lang.String host, int port, char[] apiKey, java.lang.String contentbaseName, java.lang.String basePath, SecurityOptions options) Return a ContentSource object that will serve as the source of connections to MarkLogic Cloud on the given cloud tenancy URL and port (by default the user should use 443), with the given user api key, contentbase name and base path.
static ContentSource	newContentSource(java.lang.String host, int port, char[] authStr, java.lang.String authType, java.lang.String contentbaseName, java.lang.String basePath) Equivalent to newContentSource(host, port, authStr, authType, contentbaseName, basePath, null)
static ContentSource	newContentSource(java.lang.String host, int port, char[] authStr, java.lang.String authType, java.lang.String contentbaseName, java.lang.String basePath, SecurityOptions options) Return a ContentSource object that will serve as the source of connections to the server (or the reverse proxy) on the given host and port using one of the token-based authentication protocols (OAuth or MarkLogic Cloud), with the given authentication string (OAuth JWT access token or MarkLogic Cloud apiKey) contentbase and base path.
static ContentSource	newContentSource(java.lang.String host, int port, com.marklogic.xcc.impl.Credentials credentials, java.lang.String contentbaseName, java.lang.String basePath) NOTE: Not meant for public use
static ContentSource	newContentSource(java.lang.String host, int port, com.marklogic.xcc.impl.Credentials credentials, java.lang.String contentbaseName, java.lang.String basePath, SecurityOptions options) NOTE: Not meant for public use
static ContentSource	newContentSource(java.lang.String host, int port, java.lang.String user, char[] password) Equivalent to newContentSource (host, port, user, password, null)
static ContentSource	newContentSource(java.lang.String host, int port, java.lang.String user, char[] password, java.lang.String contentbaseName) Equivalent to newContentSource (host, port, user, password, contentbaseName, null, null)
static ContentSource	newContentSource(java.lang.String host, int port, java.lang.String user, char[] password, java.lang.String contentbaseName, SecurityOptions options) Return a ContentSource object that will serve as the source of connections to the server on the given host and port, with login credentials of the given user and password.
static ContentSource	newContentSource(java.lang.String host, int port, java.lang.String user, char[] password, java.lang.String contentbaseName, java.lang.String basePath) Equivalent to newContentSource (host, port, user, password, contentbaseName, basePath, null)
static ContentSource	newContentSource(java.lang.String host, int port, java.lang.String user, char[] password, java.lang.String contentbaseName, java.lang.String basePath, SecurityOptions options) Return a ContentSource object that will serve as the source of connections to the reverse proxy on the given proxy host and proxy port, and the server behind the reverse proxy, with login credentials of the given user and password, contentbase name and base path.
static ContentSource	newContentSource(java.lang.String host, int port, java.lang.String user, java.lang.String password) Deprecated.
static ContentSource	newContentSource(java.lang.String host, int port, java.lang.String user, java.lang.String password, java.lang.String contentbaseName) Deprecated.
static ContentSource	newContentSource(java.lang.String host, int port, java.lang.String user, java.lang.String password, java.lang.String contentbaseName, SecurityOptions options) Deprecated.
static ContentSource	newContentSource(java.net.URI uri) Equivalent to newContentSource(uri, null).
static ContentSource	newContentSource(java.net.URI uri, SecurityOptions options) Return a ContentSource object that will serve as the source of connections to the server specified by the given URI.

Methods inherited from class java.lang.Object

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

Method Detail

newContentSource

public static ContentSource newContentSource(ConnectionProvider connectionProvider,
                                             char[] authStr,
                                             java.lang.String authType,
                                             java.lang.String contentbaseName,
                                             java.lang.String basePath)

Return a ContentSource object that will use the provided ConnectionProvider instance to obtain connections to MarkLogic Server (or the reverse proxy in front of it) using one of the token-based authentication protocols (OAuth or MarkLogic Cloud), with the given authentication string (OAuth JWT access token or MarkLogic Cloud api key), contentbase and base path. Custom connection management policies may be implemented by the ConnectionProvider object.

NOTE: This factory method should only be used by advanced users. A misbehaving ConnectionProvider implementation can result in connection failures and potentially even data loss.

Parameters:

connectionProvider - An instance of ConnectionProvider that will be used to obtain sockets to connect to the ContentSource when needed. The client is responsible for properly initializing this object with the information it needs to make the appropriate connections.

authStr - JWT access token if using OAuth, apiKey if connecting to MarkLogic Cloud.

authType - The token-based authentication type: use "OAUTH" for OAuth, "MLCLOUD" for connecting to MarkLogic Cloud.

contentbaseName - The contentbase (database) on the ContentSource to run queries against. The contentbase numeric id may be supplied instead, if prepended by '#'. Pass null to use the default configured on the server.

basePath - The base path configured on a reverse proxy which maps to a MarkLogic Application Server through which operations run. Pass null if not using reverse proxy.

Returns:

A ContentSource instance representing the ContentSource.

Since:

11.2.0

See Also:

ContentSource, ContentbaseMetaData

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port,
                                             char[] authStr,
                                             java.lang.String authType,
                                             java.lang.String contentbaseName,
                                             java.lang.String basePath,
                                             SecurityOptions options)

Return a ContentSource object that will serve as the source of connections to the server (or the reverse proxy) on the given host and port using one of the token-based authentication protocols (OAuth or MarkLogic Cloud), with the given authentication string (OAuth JWT access token or MarkLogic Cloud apiKey) contentbase and base path.

Parameters:

host - The name or dotted-quad IP address of the server host or reverse proxy.

port - The port on the host or reverse proxy to connect to.

authStr - JWT access token if using OAuth, apiKey if connecting to MarkLogic Cloud.

authType - The token-based authentication type: use "OAUTH" for OAuth, "MLCLOUD" for connecting to MarkLogic Cloud.

contentbaseName - The ContentBase (database) on the ContentSource to run queries against. The contentbase numeric id may be supplied instead, if prepended by '#'. Pass null to use the default configured on the server.

basePath - The base path configured on a reverse proxy which maps to a MarkLogic Application Server through which operations run. Pass null if not using reverse proxy.

options - Security settings to be used for secure connections. Pass null if not using secure connections.

Returns:

A ContentSource instance representing the ContentSource.

Since:

11.2.0

See Also:

ContentSource, ContentbaseMetaData

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port,
                                             char[] authStr,
                                             java.lang.String authType,
                                             java.lang.String contentbaseName,
                                             java.lang.String basePath)

Equivalent to newContentSource(host, port, authStr, authType, contentbaseName, basePath, null)

Parameters:

host - The name or dotted-quad IP address of the reverse proxy host.

port - The port on the host or reverse proxy to connect to.

authStr - JWT access token if using OAuth, apiKey if connecting to MarkLogic Cloud.

authType - The token-based authentication type: use "OAUTH" for OAuth, "MLCLOUD" for connecting to MarkLogic Cloud.

contentbaseName - The ContentBase (database) on the ContentSource to run queries against. The contentbase numeric id may be supplied instead, if prepended by '#'. Pass null to use the default configured on the server.

basePath - The base path configured on a reverse proxy which maps to a MarkLogic Application Server through which operations run. Pass null if not using reverse proxy.

Returns:

A ContentSource instance representing the ContentSource. The configured ContentSource implementation class cannot be instantiated.

Since:

11.2.0

See Also:

ContentSource

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port,
                                             char[] authStr,
                                             java.lang.String authType,
                                             java.lang.String contentbaseName)

Equivalent to newContentSource(host, port, authStr, authType, contentbaseName, null, null)

Parameters:

host - The name or dotted-quad IP address of the reverse proxy host.

port - TThe port on the host or reverse proxy to connect to.

authStr - JWT access token if using OAuth, apiKey if connecting to MarkLogic Cloud.

authType - The token-based authentication type: use "OAUTH" for OAuth, "MLCLOUD" for connecting to MarkLogic Cloud.

contentbaseName - The ContentBase (database) on the ContentSource to run queries against. The contentbase numeric id may be supplied instead, if prepended by '#'. Pass null to use the default configured on the server.

Returns:

A ContentSource instance representing the ContentSource. The configured ContentSource implementation class cannot be instantiated.

Since:

11.2.0

See Also:

ContentSource

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port,
                                             char[] authStr,
                                             java.lang.String authType)

Equivalent to newContentSource(host, port, authStr, authType, null, null, null)

Parameters:

host - The name or dotted-quad IP address of the reverse proxy host.

port - The port on the host or reverse proxy to connect to.

authStr - JWT access token if using OAuth, apiKey if connecting to MarkLogic Cloud.

authType - The token-based authentication type: use "OAUTH" for OAuth, "MLCLOUD" for connecting to MarkLogic Cloud.

Returns:

A ContentSource instance representing the ContentSource. The configured ContentSource implementation class cannot be instantiated.

Since:

11.2.0

See Also:

ContentSource

newContentSource

public static ContentSource newContentSource(ConnectionProvider connectionProvider,
                                             java.lang.String user,
                                             char[] password,
                                             java.lang.String contentbaseName,
                                             java.lang.String basePath)

Return a ContentSource object that will use the provided ConnectionProvider instance to obtain connections to the reverse proxy, and to the server behind the reverse proxy, with the given default login credentials, contentbase and base path values. Custom connection management policies may be implemented by the ConnectionProvider object.

NOTE: This factory method should only be used by advanced users. A misbehaving ConnectionProvider implementation can result in connection failures and potentially even data loss.

Parameters:

connectionProvider - An instance of ConnectionProvider that will be used to obtain sockets to connect to the ContentSource when needed. The client is responsible for properly initializing this object with the information it needs to make the appropriate connections.

user - The default User Name to use for authentication.

password - The default Password to use for authentication.

contentbaseName - The contentbase (database) on the ContentSource to run queries against. The contentbase numeric id may be supplied instead, if prepended by '#'. Pass null to use the default configured on the server.

basePath - The base path configured on a reverse proxy which maps to a MarkLogic Application Server through which operations run.

Returns:

A ContentSource instance representing the ContentSource.

Since:

11.1.0

See Also:

ContentSource, ContentbaseMetaData

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port,
                                             java.lang.String user,
                                             char[] password,
                                             java.lang.String contentbaseName,
                                             java.lang.String basePath,
                                             SecurityOptions options)

Return a ContentSource object that will serve as the source of connections to the reverse proxy on the given proxy host and proxy port, and the server behind the reverse proxy, with login credentials of the given user and password, contentbase name and base path. No connections are made at this time.

Parameters:

host - The name or dotted-quad IP address of the reverse proxy host.

port - The reverse proxy port to connect to.

user - The default User Name to use for authentication.

password - The default Password to use for authentication.

contentbaseName - The ContentBase (database) on the ContentSource to run queries against. The contentbase numeric id may be supplied instead, if prepended by '#'. Pass null to use the default configured on the server.

basePath - The base path configured on a reverse proxy which maps to a MarkLogic Application Server through which operations run.

options - Security settings to be used for secure connections.

Returns:

A ContentSource instance representing the ContentSource.

Since:

11.1.0

See Also:

ContentSource, ContentbaseMetaData

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port,
                                             java.lang.String user,
                                             char[] password,
                                             java.lang.String contentbaseName,
                                             java.lang.String basePath)

Equivalent to newContentSource (host, port, user, password, contentbaseName, basePath, null)

Parameters:

host - The name or dotted-quad IP address of the reverse proxy host.

port - The reverse proxy port to connect to.

user - The default User Name to use for authentication.

password - The default Password to use for authentication.

contentbaseName - The ContentBase (database) on the ContentSource to run.

basePath - The base path configured on a reverse proxy which maps to a MarkLogic Application Server through which operations run.

Returns:

A ContentSource instance representing the ContentSource. The configured ContentSource implementation class cannot be instantiated.

Since:

11.1.0

See Also:

ContentSource

newContentSource

public static ContentSource newContentSource(ConnectionProvider connectionProvider,
                                             char[] apiKey,
                                             java.lang.String contentbaseName,
                                             java.lang.String basePath)

Return a ContentSource object that will use the provided ConnectionProvider instance to obtain connections to MarkLogic Cloud, with the given user api key, contentbase and base path. Custom connection management policies may be implemented by the ConnectionProvider object.

NOTE: This factory method should only be used by advanced users. A misbehaving ConnectionProvider implementation can result in connection failures and potentially even data loss.

Parameters:

connectionProvider - An instance of ConnectionProvider that will be used to obtain sockets to connect to the ContentSource when needed. The client is responsible for properly initializing this object with the information it needs to make the appropriate connections.

apiKey - The unique key assigned to a MarkLogic Cloud user.

contentbaseName - The contentbase (database) on the ContentSource to run queries against. The contentbase numeric id may be supplied instead, if prepended by '#'. Pass null to use the default configured on the server.

basePath - The base path configured on MarkLogic Cloud which maps to a service hosted by MarkLogic Cloud through which operations run.

Returns:

A ContentSource instance representing the ContentSource.

Since:

11.1.0

See Also:

ContentSource, ContentbaseMetaData

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port,
                                             char[] apiKey,
                                             java.lang.String contentbaseName,
                                             java.lang.String basePath,
                                             SecurityOptions options)

Return a ContentSource object that will serve as the source of connections to MarkLogic Cloud on the given cloud tenancy URL and port (by default the user should use 443), with the given user api key, contentbase name and base path. No connections are made at this time. The base path is mapped to a specific service hosted by MarkLogic Cloud.

Parameters:

host - The name or dotted-quad IP address of the MarkLogic Cloud Tenancy.

port - The MarkLogic Cloud port to connect to (by default the user should use 443).

apiKey - The unique key assigned to a MarkLogic Cloud user.

contentbaseName - The ContentBase (database) on the ContentSource to run queries against. The contentbase numeric id may be supplied instead, if prepended by '#'. Pass null to use the default configured on the server.

basePath - The base path configured on MarkLogic Cloud which maps to a service hosted by MarkLogic Cloud through which operations run.

options - Security settings to be used for secure connections.

Returns:

A ContentSource instance representing the ContentSource.

Since:

11.1.0

See Also:

ContentSource, ContentbaseMetaData

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port,
                                             com.marklogic.xcc.impl.Credentials credentials,
                                             java.lang.String contentbaseName,
                                             java.lang.String basePath)

NOTE: Not meant for public use

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port,
                                             com.marklogic.xcc.impl.Credentials credentials,
                                             java.lang.String contentbaseName,
                                             java.lang.String basePath,
                                             SecurityOptions options)

NOTE: Not meant for public use

newContentSource

@Deprecated
public static ContentSource newContentSource(ConnectionProvider connectionProvider,
                                                         java.lang.String user,
                                                         java.lang.String password,
                                                         java.lang.String contentbaseName)

Deprecated.

Return a ContentSource object that will use the provided ConnectionProvider instance to obtain server connections, with the given default login credentials and contentbase values. Custom connection management policies may be implemented by the ConnectionProvider object.

NOTE: This factory method should only be used by advanced users. A misbehaving ConnectionProvider implementation can result in connection failures and potentially even data loss.

Parameters:

connectionProvider - An instance of ConnectionProvider that will be used to obtain sockets to connect to the ContentSource when needed. The client is responsible for properly initializing this object with the information it needs to make the appropriate connections.

user - The default User Name to use for authentication.

password - The default Password to use for authentication.

contentbaseName - The contentbase (database) on the ContentSource to run queries against. The contentbase numeric id may be supplied instead, if prepended by '#'. Pass null to use the default configured on the server.

Returns:

A ContentSource instance representing the ContentSource.

See Also:

ContentSource, ContentbaseMetaData

newContentSource

public static ContentSource newContentSource(ConnectionProvider connectionProvider,
                                             java.lang.String user,
                                             char[] password,
                                             java.lang.String contentbaseName)

Return a ContentSource object that will use the provided ConnectionProvider instance to obtain server connections, with the given default login credentials and contentbase values. Custom connection management policies may be implemented by the ConnectionProvider object.

NOTE: This factory method should only be used by advanced users. A misbehaving ConnectionProvider implementation can result in connection failures and potentially even data loss.

Parameters:

connectionProvider - An instance of ConnectionProvider that will be used to obtain sockets to connect to the ContentSource when needed. The client is responsible for properly initializing this object with the information it needs to make the appropriate connections.

user - The default User Name to use for authentication.

password - The default Password to use for authentication.

contentbaseName - The contentbase (database) on the ContentSource to run queries against. The contentbase numeric id may be supplied instead, if prepended by '#'. Pass null to use the default configured on the server.

Returns:

A ContentSource instance representing the ContentSource.

See Also:

ContentSource, ContentbaseMetaData

newContentSource

public static ContentSource newContentSource(java.net.URI uri,
                                             SecurityOptions options)
                                      throws XccConfigException

Return a ContentSource object that will serve as the source of connections to the server specified by the given URI.

The format of the URI is: xcc://user:password@host:port/contentbase. For an SSL-enabled connection, the URI format is: xccs://user:password@host:port[/contentbase]. For example: xcc://joe:hush@myserver:8003, xccs://joe:hush@myserver:8003/production.

From 11.1.0, to specify base path through the URI, the format is: xcc://user:password@host:port[/contentbase]?basepath. For example: xcc://joe:hush@proxy.marklogic.com:8080/Documents?basepath=%2Fml%2Ftest%2Fmarklogic%2Fmlcp. NOTE: Base path should be URL encoded.

From 11.1.0, to construct ContentSource that connects to MarkLogic Cloud, the format is: xccs://host:port[/contentbase]?basepath&apikey. For example: xccs://cloud.marklogic.com:443/Documents?basepath=%2Fml%2Ftest%2Fmarklogic%2Fmlcp&apikey=XZvPaq%2B3HihncigeegZyA%3D%3D. NOTE: To connect to MarkLogic Cloud, an SSL-enabled connection (scheme xccs) should be used. Base path and api key should be URL encoded.

From 11.2.0, to construct ContentSource that uses OAuth to connect to MarkLogic Server, the format is: xcc://host:port[/contentbase]?oauthtoken. NOTE: OAuth token should be URL encoded.

The contentbase name is optional. If not specified the default database for the XDBC server configuration will be used. To reference a contentbase by numeric id (see ContentbaseMetaData.getContentBaseId()), prepend it with '#'. For example: xcc://joe:hush@myserver:8003/#84635406972362574.

The supported connection schemes are currently "xcc" ("xdbc" is an alias) for a non-secure connection and "xccs" for a secure connection, but others may be added in the future.

Parameters:

uri - A URI instance which encodes the connection scheme, host, port and optional user and password.

options - Security settings to be used for "xccs" secure connections.

Returns:

A ContentSource instance representing the ContentSource.

Throws:

XccConfigException - If there is a configuration problem or the configured ContentSource implementation class cannot be instantiated.

See Also:

ContentSource, ContentbaseMetaData

newContentSource

public static ContentSource newContentSource(java.net.URI uri)
                                      throws XccConfigException

Equivalent to newContentSource(uri, null).

Parameters:

uri - A URI instance which encodes the connection scheme, host, port and optional user and password. The format of the URI is: xcc://user:password@host:port/contentbase

Returns:

A ContentSource instance representing the ContentSource.

Throws:

XccConfigException - If there is a configuration problem or the configured ContentSource implementation class cannot be instantiated.

newContentSource

@Deprecated
public static ContentSource newContentSource(java.lang.String host,
                                                         int port,
                                                         java.lang.String user,
                                                         java.lang.String password,
                                                         java.lang.String contentbaseName,
                                                         SecurityOptions options)

Deprecated.

Return a ContentSource object that will serve as the source of connections to the server on the given host and port, with login credentials of the given user and password. No connections are made at this time. Note that the ContentSource instance returned may be shared with other callers or threads. The implementation may choose to pool and re-use ContentSource objects for a particular host/port/user combination.

Parameters:

host - The name or dotted-quad IP address of the server host.

port - The port on the host to connect to.

user - The default User Name to use for authentication.

password - The default Password to use for authentication.

contentbaseName - The ContentBase (database) on the ContentSource to run queries against. The contentbase numeric id may be supplied instead, if prepended by '#'. Pass null to use the default configured on the server.

options - Security settings to be used for secure connections.

Returns:

A ContentSource instance representing the ContentSource.

See Also:

ContentSource, ContentbaseMetaData

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port,
                                             java.lang.String user,
                                             char[] password,
                                             java.lang.String contentbaseName,
                                             SecurityOptions options)

Return a ContentSource object that will serve as the source of connections to the server on the given host and port, with login credentials of the given user and password. No connections are made at this time. Note that the ContentSource instance returned may be shared with other callers or threads. The implementation may choose to pool and re-use ContentSource objects for a particular host/port/user combination.

Parameters:

host - The name or dotted-quad IP address of the server host.

port - The port on the host to connect to.

user - The default User Name to use for authentication.

password - The default Password to use for authentication.

contentbaseName - The ContentBase (database) on the ContentSource to run queries against. The contentbase numeric id may be supplied instead, if prepended by '#'. Pass null to use the default configured on the server.

options - Security settings to be used for secure connections.

Returns:

A ContentSource instance representing the ContentSource.

See Also:

ContentSource, ContentbaseMetaData

newContentSource

@Deprecated
public static ContentSource newContentSource(java.lang.String host,
                                                         int port,
                                                         java.lang.String user,
                                                         java.lang.String password,
                                                         java.lang.String contentbaseName)

Deprecated.

Equivalent to newContentSource (host, port, user, password, contentbaseName, null)

Parameters:

host - The name or dotted-quad IP address of the server host.

port - The port on the host to connect to.

user - The default User Name to use for authentication.

password - The default Password to use for authentication.

contentbaseName - The ContentBase (database) on the ContentSource to run

Returns:

A ContentSource instance representing the ContentSource. the configured ContentSource implementation class cannot be instantiated.

See Also:

ContentSource

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port,
                                             java.lang.String user,
                                             char[] password,
                                             java.lang.String contentbaseName)

Equivalent to newContentSource (host, port, user, password, contentbaseName, null, null)

Parameters:

host - The name or dotted-quad IP address of the server host.

port - The port on the host to connect to.

user - The default User Name to use for authentication.

password - The default Password to use for authentication.

contentbaseName - The ContentBase (database) on the ContentSource to run

Returns:

A ContentSource instance representing the ContentSource. the configured ContentSource implementation class cannot be instantiated.

See Also:

ContentSource

newContentSource

@Deprecated
public static ContentSource newContentSource(java.lang.String host,
                                                         int port,
                                                         java.lang.String user,
                                                         java.lang.String password)

Deprecated.

Equivalent to newContentSource (host, port, user, password, null)

Parameters:

host - The name or dotted-quad IP address of the server host.

port - The port on the host to connect to.

user - The default User Name to use for authentication.

password - The default Password to use for authentication.

Returns:

A ContentSource instance representing the ContentSource. the configured ContentSource implementation class cannot be instantiated.

See Also:

ContentSource

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port,
                                             java.lang.String user,
                                             char[] password)

Equivalent to newContentSource (host, port, user, password, null)

Parameters:

host - The name or dotted-quad IP address of the server host.

port - The port on the host to connect to.

user - The default User Name to use for authentication.

password - The default Password to use for authentication.

Returns:

A ContentSource instance representing the ContentSource. the configured ContentSource implementation class cannot be instantiated.

See Also:

ContentSource

newContentSource

public static ContentSource newContentSource(java.lang.String host,
                                             int port)

Return a ContentSource object that will serve as the source of connections to the server on the given host and port, with no default login credentials. Invoking newSession() on the returned ContentSource object, without providing a user name/password, will throw an IllegalStateException.

Parameters:

host - The name or dotted-quad IP address of the server host.

port - The port on the host to connect to.

Returns:

A ContentSource instance representing the ContentSource.

See Also:

ContentSource