com.businessobjects.dsws
Class Connection

java.lang.Object
  com.businessobjects.dsws.Connection

All Implemented Interfaces:

java.io.Serializable

public class Connection
extends java.lang.Object
implements java.io.Serializable

The Connection class contains all information necessary to connect to Web Services.

Example:Create a Connection to the session service.

URL objURL = new URL("http://:/dswsbobje/services/session");
Connection objConnection = new Connection(objURL);


See Also:

AuthenticationCredential, Connection, ProxyParameters, Session, Serialized Form

Constructor Summary

Connection(java.net.URL url)
Initializes a new instance of the Connection class from the specified inquiry URL.

Method Summary

Connection	copy() Internal Use Only
Connection	copy(java.lang.String strUrl) Internal Use Only
Connection	copy(java.net.URL objUrl) Internal Use Only
void	enableKerberosAuthentication()
AuthenticationCredential	getAuthenticationCredential() Returns the Credentials to contact the server hosting BusinessObjects Web Services provider.
ProxyParameters	getProxyParameters() Returns the HTTP proxy settings used to connect to the Web Sevice.
int	getTimeOut() Returns the TimeOut property.
java.net.URL	getURL() Returns the URL the Web Sevice will connect to.
boolean	IsKerberosAuthenticationEnabled()
void	setAuthenticationCredential(AuthenticationCredential authenticationCredential) Set the Credentials to contact the server hosting the BusinessObjects Web Services provider.
void	setProxyParameters(ProxyParameters proxyParameter) Set the HTTP proxy settings used to connect to the Web Sevice.
void	setTimeOut(int timeOut) Set the TimeOut property.
void	setURL(java.net.URL url) Set the URL the Web Service will connect to.

Methods inherited from class java.lang.Object

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

Constructor Detail

Connection

public Connection(java.net.URL url)

Initializes a new instance of the Connection class from the specified inquiry URL.

Example:

URL objURL = new URL("http://:/dswsbobje/services/session");
Connection objConnection = new Connection(objURL);


Parameters:

url - a URL to connect to a specific web service. This URL is either supplied by the system administrator or obtained using the getAssociatedServicesURL method

See Also:

Session.getAssociatedServicesURL(java.lang.String strServiceName)

Method Detail

copy

public Connection copy()
                throws java.net.MalformedURLException

Internal Use Only

Throws:

java.net.MalformedURLException

copy

public Connection copy(java.lang.String strUrl)
                throws java.net.MalformedURLException

Internal Use Only

Throws:

java.net.MalformedURLException

copy

public Connection copy(java.net.URL objUrl)

Internal Use Only

setURL

public void setURL(java.net.URL url)

Set the URL the Web Service will connect to.

Parameters:

url - a URL to connect to a specific web service.

getURL

public java.net.URL getURL()

Returns the URL the Web Sevice will connect to.

Returns:

URL the Web Sevice will connect to.

setTimeOut

public void setTimeOut(int timeOut)

Set the TimeOut property.

Parameters:

timeOut - the Web Service timeout in seconds.

getTimeOut

public int getTimeOut()

Returns the TimeOut property.

Returns:

the Web Service timeout in seconds.

setProxyParameters

public void setProxyParameters(ProxyParameters proxyParameter)

Set the HTTP proxy settings used to connect to the Web Sevice.

Example:

com.businessobjects.dsws.Connection boConnection = new com.businessobjects.dsws.Connection(new URL(aURL)); ProxyParameters boProxyParams = new ProxyParameters( "http://proxy.myserver","8888",null,null); boConnection.setProxyParameters(boProxyParams);

Parameters:

proxyParameter - a ProxyParameters object

See Also:

ProxyParameters

getProxyParameters

public ProxyParameters getProxyParameters()

Returns the HTTP proxy settings used to connect to the Web Sevice.

Returns:

a ProxyParameters object containing HTTP proxy information.

See Also:

ProxyParameters

setAuthenticationCredential

public void setAuthenticationCredential(AuthenticationCredential authenticationCredential)

Set the Credentials to contact the server hosting the BusinessObjects Web Services provider.

Parameters:

authenticationCredential -

See Also:

AuthenticationCredential

getAuthenticationCredential

public AuthenticationCredential getAuthenticationCredential()

Returns the Credentials to contact the server hosting BusinessObjects Web Services provider.

Returns:

an AuthenticationCredential object

enableKerberosAuthentication

public void enableKerberosAuthentication()

IsKerberosAuthenticationEnabled

public boolean IsKerberosAuthenticationEnabled()