com.marklogic.ps

Class Connection

java.lang.Object

com.marklogic.ps.Connection

All Implemented Interfaces:

com.marklogic.xcc.ContentSource

public class Connection
extends java.lang.Object
implements com.marklogic.xcc.ContentSource

Field Summary

Fields

Modifier and Type	Field and Description
protected int	count
protected com.marklogic.xcc.ContentSource[]	cs
protected static com.marklogic.xcc.SecurityOptions	securityOptions
protected java.net.URI[]	uri

Constructor Summary

Constructors

Constructor and Description
Connection(java.net.URI uri)
Connection(java.net.URI[] uris)

Method Summary

Modifier and Type	Method and Description
com.marklogic.xcc.spi.ConnectionProvider	getConnectionProvider()
com.marklogic.xcc.ContentSource	getContentSource()
java.util.logging.Logger	getDefaultLogger()
java.net.URI	getUri()
boolean	isAuthenticationPreemptive()
com.marklogic.xcc.Session	newSession()
com.marklogic.xcc.Session	newSession(java.lang.String contentbaseId)
com.marklogic.xcc.Session	newSession(java.lang.String userName, char[] password)
com.marklogic.xcc.Session	newSession(java.lang.String userName, char[] password, java.lang.String contentbaseId)
com.marklogic.xcc.Session	newSession(java.lang.String userName, java.lang.String password) Deprecated.
com.marklogic.xcc.Session	newSession(java.lang.String userName, java.lang.String password, java.lang.String contentbaseId) Deprecated.
protected static com.marklogic.xcc.SecurityOptions	newTrustAnyoneOptions()
void	setAuthenticationPreemptive(boolean value) Sets whether basic authentication should be attempted preemptively, default is false.
void	setDefaultLogger(java.util.logging.Logger logger)

Methods inherited from class java.lang.Object

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

Field Detail

uri

protected java.net.URI[] uri

cs

protected com.marklogic.xcc.ContentSource[] cs

count

protected volatile int count

securityOptions

protected static com.marklogic.xcc.SecurityOptions securityOptions

Constructor Detail

Connection

public Connection(java.net.URI uri)
           throws com.marklogic.xcc.exceptions.XccException,
                  java.security.KeyManagementException,
                  java.security.NoSuchAlgorithmException

Parameters:

uri -

Throws:

com.marklogic.xcc.exceptions.XccException

java.security.NoSuchAlgorithmException

java.security.KeyManagementException

Connection

public Connection(java.net.URI[] uris)
           throws com.marklogic.xcc.exceptions.XccException,
                  java.security.KeyManagementException,
                  java.security.NoSuchAlgorithmException

Parameters:

uris -

Throws:

com.marklogic.xcc.exceptions.XccException

java.security.NoSuchAlgorithmException

java.security.KeyManagementException

Method Detail

getUri

public java.net.URI getUri()

Returns:

newSession

public com.marklogic.xcc.Session newSession()

Specified by:

newSession in interface com.marklogic.xcc.ContentSource

isAuthenticationPreemptive

public boolean isAuthenticationPreemptive()

Specified by:

isAuthenticationPreemptive in interface com.marklogic.xcc.ContentSource

Returns:

true if basic authentication will be attempted preemptively, false otherwise.

setAuthenticationPreemptive

public void setAuthenticationPreemptive(boolean value)

Sets whether basic authentication should be attempted preemptively, default is false.

Preemptive authentication can reduce the overhead of making connections to servers that accept basic authentication by eliminating the challenge-response interaction otherwise required.

Note that misuse of preemptive authentication entails potential security risks, and under most circumstances the credentials used to authenticate will be cached after the first connection. To avoid creating the illusion that credentials are protected, connections to a server requiring digest authentication will not be retried if this flag is set.

Specified by:

setAuthenticationPreemptive in interface com.marklogic.xcc.ContentSource

Parameters:

value - true if basic authentication should be attempted preemptively, false otherwise.

getConnectionProvider

public com.marklogic.xcc.spi.ConnectionProvider getConnectionProvider()

Specified by:

getConnectionProvider in interface com.marklogic.xcc.ContentSource

Returns:

The ConnectionProvider used to construct this ContentSource.

getContentSource

public com.marklogic.xcc.ContentSource getContentSource()

Returns:

newSession

public com.marklogic.xcc.Session newSession(java.lang.String userName,
                                            char[] password)

Specified by:

newSession in interface com.marklogic.xcc.ContentSource

newSession

public com.marklogic.xcc.Session newSession(java.lang.String userName,
                                            char[] password,
                                            java.lang.String contentbaseId)

Specified by:

newSession in interface com.marklogic.xcc.ContentSource

newSession

public com.marklogic.xcc.Session newSession(java.lang.String contentbaseId)

Specified by:

newSession in interface com.marklogic.xcc.ContentSource

newSession

@Deprecated
public com.marklogic.xcc.Session newSession(java.lang.String userName,
                                                        java.lang.String password)

Deprecated.

Specified by:

newSession in interface com.marklogic.xcc.ContentSource

newSession

@Deprecated
public com.marklogic.xcc.Session newSession(java.lang.String userName,
                                                        java.lang.String password,
                                                        java.lang.String contentbaseId)

Deprecated.

Specified by:

newSession in interface com.marklogic.xcc.ContentSource

getDefaultLogger

public java.util.logging.Logger getDefaultLogger()

Specified by:

getDefaultLogger in interface com.marklogic.xcc.ContentSource

setDefaultLogger

public void setDefaultLogger(java.util.logging.Logger logger)

Specified by:

setDefaultLogger in interface com.marklogic.xcc.ContentSource

newTrustAnyoneOptions

protected static com.marklogic.xcc.SecurityOptions newTrustAnyoneOptions()
                                                                  throws java.security.KeyManagementException,
                                                                         java.security.NoSuchAlgorithmException

Throws:

java.security.KeyManagementException

java.security.NoSuchAlgorithmException