DataSiftConfig (DataSift Java Client library 3.3.2 API)

java.lang.Object
- com.datasift.client.DataSiftConfig

public class DataSiftConfig
extends java.lang.Object

Field Summary

Fields
Modifier and Type	Field and Description
`protected java.lang.String`	`apiKey`
`protected boolean`	`compatibleSSLProtocolsFound`
`protected int`	`connectTimeout`
`protected java.lang.String`	`host`
`protected io.higgs.http.client.HttpRequestBuilder`	`http` This instance should be used as a base for configurations.
`protected java.lang.String`	`ingestionHost`
`protected boolean`	`manualPort`
`protected int`	`port`
`protected boolean`	`sslEnabled`
`protected java.util.List<java.lang.String>`	`sslProtocols`
`protected java.lang.String`	`urlEncodingFormat`
`protected java.lang.String`	`username`
`protected java.lang.String`	`versionPrefix`
`protected java.lang.String`	`wsHost`

Constructor Summary

Constructors
Constructor and Description
`DataSiftConfig()`
`DataSiftConfig(java.lang.String username, java.lang.String apiKey)` Initialize a new config instance with the given username and api key

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`DataSiftConfig`	`auth(java.lang.String username, java.lang.String apiKey)` Provide the user credentials that should be used for authentication
`java.lang.String`	`authAsHeader()`
`java.net.URI`	`baseIngestionURL()`
`java.net.URI`	`baseURL()`
`boolean`	`compatibleSSLProtocolsFound()`
`int`	`connectTimeout()`
`void`	`connectTimeout(int connectTimeout)`
`java.lang.String`	`getApiKey()`
`java.lang.String`	`getClientVersion()`
`java.lang.String`	`getUsername()`
`java.lang.String`	`host()`
`DataSiftConfig`	`host(java.lang.String host)`
`io.higgs.http.client.HttpRequestBuilder`	`http()`
`java.lang.String`	`ingestionHost()`
`DataSiftConfig`	`ingestionHost(java.lang.String host)`
`boolean`	`isAutoReconnect()`
`boolean`	`isSslEnabled()`
`java.net.URI`	`newAPIEndpointURI(java.lang.String endpoint)` Generate a new URI object given an endpoint relative to the base url of this configuration.
`java.net.URI`	`newAPIEndpointURI(java.net.URI endpoint)` Generate a new URI object given an endpoint relative to the base url of this configuration.
`java.net.URI`	`newIngestionAPIEndpointURI(java.lang.String endpoint)` Generate a new URI object given an endpoint relative to the base ingestion url of this configuration.
`java.net.URI`	`newIngestionAPIEndpointURI(java.net.URI endpoint)` Generate a new URI object given an endpoint relative to the base ingestion url of this configuration.
`int`	`port()`
`void`	`port(int p)`
`java.lang.String`	`protocol()`
`DataSiftConfig`	`proxy(java.lang.String host, int port)` Sets a host and port for a proxy that all requests should be sent to
`DataSiftConfig`	`proxy(java.lang.String host, int port, java.lang.String username, java.lang.String password)`
`void`	`setAutoReconnect(boolean autoReconnect)` Sets whether streams are automatically reconnected when a websocket connection is closed
`void`	`setSslEnabled(boolean sslEnabled)`
`java.lang.String[]`	`sslProtocols()` Gets an array of compatible SSL protocols found on this JVM
`java.lang.String`	`urlEncodingFormat()`
`DataSiftConfig`	`urlEncodingFormat(java.lang.String format)` Sets the format that should be used to encode URL parameters when the option arises e.g.
`java.lang.String`	`versionPrefix()`
`DataSiftConfig`	`versionPrefix(java.lang.String prefix)` Force the client to use a version other than the default.
`java.lang.String`	`wsHost()`
`DataSiftConfig`	`wsHost(java.lang.String host)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - compatibleSSLProtocolsFound
```
protected boolean compatibleSSLProtocolsFound
```
  - sslProtocols
```
protected java.util.List<java.lang.String> sslProtocols
```
  - username
```
protected java.lang.String username
```
  - apiKey
```
protected java.lang.String apiKey
```
  - sslEnabled
```
protected boolean sslEnabled
```
  - host
```
protected java.lang.String host
```
  - wsHost
```
protected java.lang.String wsHost
```
  - ingestionHost
```
protected java.lang.String ingestionHost
```
  - http
```
protected io.higgs.http.client.HttpRequestBuilder http
```
    This instance should be used as a base for configurations. All new requests should use HttpRequestBuilder.copy() Although a single instance would work, this keeps things simple and ensures no stale data is passed in subsequent requests. It is also very cheap in terms of Netty's thread usage because Higgs re-uses the same event loop group so it'll never be creating a whole new load of resources for each instance.
  - versionPrefix
```
protected java.lang.String versionPrefix
```
  - urlEncodingFormat
```
protected java.lang.String urlEncodingFormat
```
  - port
```
protected int port
```
  - manualPort
```
protected boolean manualPort
```
  - connectTimeout
```
protected int connectTimeout
```
- Constructor Detail
  - DataSiftConfig
```
public DataSiftConfig()
```
  - DataSiftConfig
```
public DataSiftConfig(java.lang.String username,
                      java.lang.String apiKey)
```
    Initialize a new config instance with the given username and api key
    
    Parameters:
    
    username - the DataSift username
    
    apiKey - the DataSift API key
- Method Detail
  - auth
```
public DataSiftConfig auth(java.lang.String username,
                           java.lang.String apiKey)
```
    Provide the user credentials that should be used for authentication
    
    Parameters:
    
    username - the DataSift username
    
    apiKey - the DataSift API key
    
    Returns:
    
    this object for further configuration
  - proxy
```
public DataSiftConfig proxy(java.lang.String host,
                            int port)
```
    Sets a host and port for a proxy that all requests should be sent to
    
    Parameters:
    
    host - proxy host
    
    port - proxy port
    
    Returns:
    
    this
  - proxy
```
public DataSiftConfig proxy(java.lang.String host,
                            int port,
                            java.lang.String username,
                            java.lang.String password)
```
    Parameters:
    
    username - the username the proxy requires
    
    password - the password the proxy requires
    
    Returns:
    
    this
  - protocol
```
public java.lang.String protocol()
```
    Returns:
    
    The HTTP protocol prefix to use. If SSL is enabled this will be "https://" if not it'll be "http://"
  - host
```
public DataSiftConfig host(java.lang.String host)
```
  - host
```
public java.lang.String host()
```
    Returns:
    
    The host name to which all api calls with this configurations will be made
  - wsHost
```
public DataSiftConfig wsHost(java.lang.String host)
```
  - wsHost
```
public java.lang.String wsHost()
```
    Returns:
    
    The host name used to stream
  - ingestionHost
```
public DataSiftConfig ingestionHost(java.lang.String host)
```
  - ingestionHost
```
public java.lang.String ingestionHost()
```
    Returns:
    
    The host name to which all ingestion api calls with this configurations will be made
  - port
```
public int port()
```
    Returns:
    
    The port on which connections should be made
  - port
```
public void port(int p)
```
  - baseURL
```
public java.net.URI baseURL()
```
    Returns:
    
    A base URL to the DataSift API. e.g. https://api.datasift.com/v1/
  - baseIngestionURL
```
public java.net.URI baseIngestionURL()
```
    Returns:
    
    A base URL to the DataSift Ingestion API. e.g. https://in.datasift.com/
  - newAPIEndpointURI
```
public java.net.URI newAPIEndpointURI(java.lang.String endpoint)
```
    Generate a new URI object given an endpoint relative to the base url of this configuration. For example, if the base URL is https://api.datasift.com/v1/ and the endpoint parameters is validate this will return the URI https://api.datasift.com/v1/validate. Technically any path acceptable by URI.resolve(String) is acceptable
    
    Parameters:
    
    endpoint - the endpoint to return a URI for.
    
    Returns:
    
    a new URI with the resolved URL that is safe to manipulate
  - newAPIEndpointURI
```
public java.net.URI newAPIEndpointURI(java.net.URI endpoint)
```
    Generate a new URI object given an endpoint relative to the base url of this configuration. For example, if the base URL is https://api.datasift.com/v1/ and the endpoint parameters is validate this will return the URI https://api.datasift.com/v1/validate. Technically any path acceptable by URI.resolve(URI) is acceptable
    
    Parameters:
    
    endpoint - the endpoint to return a URI for.
    
    Returns:
    
    a new URI with the resolved URL that is safe to manipulate
  - newIngestionAPIEndpointURI
```
public java.net.URI newIngestionAPIEndpointURI(java.lang.String endpoint)
```
    Generate a new URI object given an endpoint relative to the base ingestion url of this configuration. For example, if the base URL is https://in.datasift.com/ and the endpoint is the source ID, this would return a URI similar to https://in.datasift.com/9b101935be2044bb9cfdffbc953924e8. Technically any path acceptable by URI.resolve(String) is acceptable
    
    Parameters:
    
    endpoint - the endpoint to return a URI for.
    
    Returns:
    
    a new URI with the resolved URL that is safe to manipulate
  - newIngestionAPIEndpointURI
```
public java.net.URI newIngestionAPIEndpointURI(java.net.URI endpoint)
```
    Generate a new URI object given an endpoint relative to the base ingestion url of this configuration. For example, if the base URL is https://in.datasift.com/ and the endpoint is the source ID, this would return a URI similar to https://in.datasift.com/9b101935be2044bb9cfdffbc953924e8. Technically any path acceptable by URI.resolve(String) is acceptable
    
    Parameters:
    
    endpoint - the endpoint to return a URI for.
    
    Returns:
    
    a new URI with the resolved URL that is safe to manipulate
  - versionPrefix
```
public java.lang.String versionPrefix()
```
    Returns:
    
    The API version prefix to use, e.g. v1
  - versionPrefix
```
public DataSiftConfig versionPrefix(java.lang.String prefix)
```
    Force the client to use a version other than the default.
    
    Parameters:
    
    prefix - the prefix to use, this should be along the lines of v1.3 i.e. vMajor.Minor
  - getUsername
```
public java.lang.String getUsername()
```
  - getApiKey
```
public java.lang.String getApiKey()
```
  - isSslEnabled
```
public boolean isSslEnabled()
```
  - setSslEnabled
```
public void setSslEnabled(boolean sslEnabled)
```
  - authAsHeader
```
public java.lang.String authAsHeader()
```
  - http
```
public io.higgs.http.client.HttpRequestBuilder http()
```
  - urlEncodingFormat
```
public java.lang.String urlEncodingFormat()
```
    Returns:
    
    The format that should be used to URL encode prameters
  - urlEncodingFormat
```
public DataSiftConfig urlEncodingFormat(java.lang.String format)
```
    Sets the format that should be used to encode URL parameters when the option arises e.g. ISO-8859-1 or UTF-8
    
    Parameters:
    
    format - the format
    
    Returns:
    
    this
  - isAutoReconnect
```
public boolean isAutoReconnect()
```
  - setAutoReconnect
```
public void setAutoReconnect(boolean autoReconnect)
```
    Sets whether streams are automatically reconnected when a websocket connection is closed
    
    Parameters:
    
    autoReconnect - true or false, defaults to true
  - sslProtocols
```
public java.lang.String[] sslProtocols()
```
    Gets an array of compatible SSL protocols found on this JVM
    
    Returns:
    
    an array of SSL protocols or NULL if none are available
  - compatibleSSLProtocolsFound
```
public boolean compatibleSSLProtocolsFound()
```
    Returns:
    
    true if at least one compatible secure protocol is available
  - connectTimeout
```
public int connectTimeout()
```
  - connectTimeout
```
public void connectTimeout(int connectTimeout)
```
  - getClientVersion
```
public java.lang.String getClientVersion()
```

Class DataSiftConfig

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

compatibleSSLProtocolsFound

sslProtocols

username

apiKey

sslEnabled

host

wsHost

ingestionHost

http

versionPrefix

urlEncodingFormat

port

manualPort

connectTimeout

Constructor Detail

DataSiftConfig

DataSiftConfig

Method Detail

auth

proxy

proxy

protocol

host

host

wsHost

wsHost

ingestionHost

ingestionHost

port

port

baseURL

baseIngestionURL

newAPIEndpointURI

newAPIEndpointURI

newIngestionAPIEndpointURI

newIngestionAPIEndpointURI

versionPrefix

versionPrefix

getUsername

getApiKey

isSslEnabled

setSslEnabled

authAsHeader

http

urlEncodingFormat

urlEncodingFormat

isAutoReconnect

setAutoReconnect

sslProtocols

compatibleSSLProtocolsFound

connectTimeout

connectTimeout

getClientVersion