Package com.clickhouse.client.http

Class ClickHouseHttpConnection

java.lang.Object

com.clickhouse.client.http.ClickHouseHttpConnection

All Implemented Interfaces:

AutoCloseable

Direct Known Subclasses:

HttpUrlConnectionImpl

public abstract class ClickHouseHttpConnection
extends Object
implements AutoCloseable

Field Summary

Fields

Modifier and Type	Field	Description
protected ClickHouseConfig	config
protected Map<String,String>	defaultHeaders
protected ClickHouseNode	server
protected String	url

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ClickHouseHttpConnection(ClickHouseNode server, ClickHouseRequest<?> request)

Method Summary

Modifier and Type	Method	Description
protected void	closeQuietly()
protected String	getBaseUrl()
protected boolean	isReusable()	Checks whether the connection is reusable or not.
protected Map<String,String>	mergeHeaders(Map<String,String> requestHeaders)	Creates a merged map.
abstract boolean	ping(int timeout)	Sends a request to <baseUrl>/ping for liveness detection.
protected abstract ClickHouseHttpResponse	post(String query, InputStream data, List<ClickHouseExternalTable> tables, Map<String,String> headers)	Posts query and data to server.
ClickHouseHttpResponse	query(String query)
ClickHouseHttpResponse	query(String query, List<ClickHouseExternalTable> tables)
ClickHouseHttpResponse	query(String query, List<ClickHouseExternalTable> tables, Map<String,String> headers)
ClickHouseHttpResponse	query(String query, Map<String,String> headers)
ClickHouseHttpResponse	update(String query)
ClickHouseHttpResponse	update(String query, InputStream data)
ClickHouseHttpResponse	update(String query, InputStream data, Map<String,String> headers)
ClickHouseHttpResponse	update(String query, Map<String,String> headers)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.AutoCloseable

close

Field Detail

config

protected final ClickHouseConfig config

server

protected final ClickHouseNode server

defaultHeaders

protected final Map<String,String> defaultHeaders

url

protected final String url

Constructor Detail

ClickHouseHttpConnection

protected ClickHouseHttpConnection(ClickHouseNode server,
                                   ClickHouseRequest<?> request)

Method Detail

closeQuietly

protected void closeQuietly()

getBaseUrl

protected String getBaseUrl()

mergeHeaders

protected Map<String,String> mergeHeaders(Map<String,String> requestHeaders)

Creates a merged map.

Parameters:

requestHeaders - request headers

Returns:

post

protected abstract ClickHouseHttpResponse post(String query,
                                               InputStream data,
                                               List<ClickHouseExternalTable> tables,
                                               Map<String,String> headers)
                                        throws IOException

Posts query and data to server.

Parameters:

query - non-blank query

data - optionally input stream for batch updating

tables - optionally external tables for query

headers - optionally request headers

Returns:

response

Throws:

IOException - when error occured posting request and/or server failed to respond

isReusable

protected boolean isReusable()

Checks whether the connection is reusable or not. This method will be called in ClickHouseHttpClient.checkConnection(ClickHouseHttpConnection, ClickHouseNode, ClickHouseNode, ClickHouseRequest) for making a decision of whether to create a new connection. In addition to that, if a connection is NOT reusable, it will be closed right after corresponding ClickHouseResponse is closed.

Returns:

true if it's reusable; false otherwise

ping

public abstract boolean ping(int timeout)

Sends a request to <baseUrl>/ping for liveness detection.

Parameters:

timeout - timeout in millisecond

Returns:

true if server responded Ok.; false otherwise

update

public ClickHouseHttpResponse update(String query)
                              throws IOException

Throws:

IOException

update

public ClickHouseHttpResponse update(String query,
                                     Map<String,String> headers)
                              throws IOException

Throws:

IOException

update

public ClickHouseHttpResponse update(String query,
                                     InputStream data)
                              throws IOException

Throws:

IOException

update

public ClickHouseHttpResponse update(String query,
                                     InputStream data,
                                     Map<String,String> headers)
                              throws IOException

Throws:

IOException

query

public ClickHouseHttpResponse query(String query)
                             throws IOException

Throws:

IOException

query

public ClickHouseHttpResponse query(String query,
                                    Map<String,String> headers)
                             throws IOException

Throws:

IOException

query

public ClickHouseHttpResponse query(String query,
                                    List<ClickHouseExternalTable> tables)
                             throws IOException

Throws:

IOException

query

public ClickHouseHttpResponse query(String query,
                                    List<ClickHouseExternalTable> tables,
                                    Map<String,String> headers)
                             throws IOException

Throws:

IOException