Client

java.lang.Object
- org.drinkless.td.libcore.telegram.Client

All Implemented Interfaces:

java.lang.Runnable
```
public final class Client
extends java.lang.Object
implements java.lang.Runnable
```
Main class for interaction with the TDLib.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`Client.ExceptionHandler` Interface for handler of exceptions thrown while invoking ResultHandler.
`static interface`	`Client.ResultHandler` Interface for handler for results of queries to TDLib and incoming updates from TDLib.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`bench(TdApi.Function query, Client.ResultHandler handler, int count)` Function for benchmarking number of queries per second which can handle the TDLib, ignore it.
`void`	`close()` Closes Client.
`static Client`	`create(Client.ResultHandler updatesHandler, Client.ExceptionHandler updatesExceptionHandler, Client.ExceptionHandler defaultExceptionHandler)` Creates new Client.
`static TdApi.Object`	`execute(TdApi.Function query)` Synchronously executes a TDLib request.
`protected void`	`finalize()`
`void`	`run()` Overridden method from Runnable, do not call it directly.
`void`	`send(TdApi.Function query, Client.ResultHandler resultHandler)` Sends a request to the TDLib with an empty ExceptionHandler.
`void`	`send(TdApi.Function query, Client.ResultHandler resultHandler, Client.ExceptionHandler exceptionHandler)` Sends a request to the TDLib.
`void`	`setDefaultExceptionHandler(Client.ExceptionHandler defaultExceptionHandler)` Replaces default exception handler to be invoked on exceptions thrown from updatesHandler and all other ResultHandler.
`static boolean`	`setLogFilePath(java.lang.String filePath)` Deprecated. As of TDLib 1.4.0 in favor of `TdApi.SetLogStream`, to be removed in the future.
`static void`	`setLogMaxFileSize(long maxFileSize)` Deprecated. As of TDLib 1.4.0 in favor of `TdApi.SetLogStream`, to be removed in the future.
`static void`	`setLogVerbosityLevel(int newLogVerbosity)` Deprecated. As of TDLib 1.4.0 in favor of `TdApi.SetLogVerbosityLevel`, to be removed in the future.
`void`	`setUpdatesHandler(Client.ResultHandler updatesHandler)` Replaces handler for incoming updates from the TDLib.
`void`	`setUpdatesHandler(Client.ResultHandler updatesHandler, Client.ExceptionHandler exceptionHandler)` Replaces handler for incoming updates from the TDLib.

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

- Method Detail
  - send
```
public void send(TdApi.Function query,
                 Client.ResultHandler resultHandler,
                 Client.ExceptionHandler exceptionHandler)
```
    Sends a request to the TDLib.
    
    Parameters:
    
    query - Object representing a query to the TDLib.
    
    resultHandler - Result handler with onResult method which will be called with result of the query or with TdApi.Error as parameter. If it is null, nothing will be called.
    
    exceptionHandler - Exception handler with onException method which will be called on exception thrown from resultHandler. If it is null, then defaultExceptionHandler will be called.
    
    Throws:
    
    java.lang.NullPointerException - if query is null.
  - send
```
public void send(TdApi.Function query,
                 Client.ResultHandler resultHandler)
```
    Sends a request to the TDLib with an empty ExceptionHandler.
    
    Parameters:
    
    query - Object representing a query to the TDLib.
    
    resultHandler - Result handler with onResult method which will be called with result of the query or with TdApi.Error as parameter. If it is null, then defaultExceptionHandler will be called.
    
    Throws:
    
    java.lang.NullPointerException - if query is null.
  - execute
```
public static TdApi.Object execute(TdApi.Function query)
```
    Synchronously executes a TDLib request. Only a few marked accordingly requests can be executed synchronously.
    
    Parameters:
    
    query - Object representing a query to the TDLib.
    
    Returns:
    
    request result.
    
    Throws:
    
    java.lang.NullPointerException - if query is null.
  - setUpdatesHandler
```
public void setUpdatesHandler(Client.ResultHandler updatesHandler,
                              Client.ExceptionHandler exceptionHandler)
```
    Replaces handler for incoming updates from the TDLib.
    
    Parameters:
    
    updatesHandler - Handler with onResult method which will be called for every incoming update from the TDLib.
    
    exceptionHandler - Exception handler with onException method which will be called on exception thrown from updatesHandler, if it is null, defaultExceptionHandler will be invoked.
  - setUpdatesHandler
```
public void setUpdatesHandler(Client.ResultHandler updatesHandler)
```
    Replaces handler for incoming updates from the TDLib. Sets empty ExceptionHandler.
    
    Parameters:
    
    updatesHandler - Handler with onResult method which will be called for every incoming update from the TDLib.
  - setDefaultExceptionHandler
```
public void setDefaultExceptionHandler(Client.ExceptionHandler defaultExceptionHandler)
```
    Replaces default exception handler to be invoked on exceptions thrown from updatesHandler and all other ResultHandler.
    
    Parameters:
    
    defaultExceptionHandler - Default exception handler. If null Exceptions are ignored.
  - bench
```
public void bench(TdApi.Function query,
                  Client.ResultHandler handler,
                  int count)
```
    Function for benchmarking number of queries per second which can handle the TDLib, ignore it.
    
    Parameters:
    
    query - Object representing a query to the TDLib.
    
    handler - Result handler with onResult method which will be called with result of the query or with TdApi.Error as parameter.
    
    count - Number of times to repeat the query.
    
    Throws:
    
    java.lang.NullPointerException - if query is null.
  - run
```
public void run()
```
    Overridden method from Runnable, do not call it directly.
    
    Specified by:
    
    run in interface java.lang.Runnable
  - create
```
public static Client create(Client.ResultHandler updatesHandler,
                            Client.ExceptionHandler updatesExceptionHandler,
                            Client.ExceptionHandler defaultExceptionHandler)
```
    Creates new Client.
    
    Parameters:
    
    updatesHandler - Handler for incoming updates.
    
    updatesExceptionHandler - Handler for exceptions thrown from updatesHandler. If it is null, exceptions will be iggnored.
    
    defaultExceptionHandler - Default handler for exceptions thrown from all ResultHandler. If it is null, exceptions will be iggnored.
    
    Returns:
    
    created Client
  - setLogVerbosityLevel
```
@Deprecated
public static void setLogVerbosityLevel(int newLogVerbosity)
```
    Deprecated. As of TDLib 1.4.0 in favor of TdApi.SetLogVerbosityLevel, to be removed in the future.
    
    Changes TDLib log verbosity.
    
    Parameters:
    
    newLogVerbosity - New value of log verbosity. Must be non-negative. Value 0 corresponds to android.util.Log.ASSERT, value 1 corresponds to android.util.Log.ERROR, value 2 corresponds to android.util.Log.WARNING, value 3 corresponds to android.util.Log.INFO, value 4 corresponds to android.util.Log.DEBUG, value 5 corresponds to android.util.Log.VERBOSE, value greater than 5 can be used to enable even more logging. Default value of the log verbosity is 5.
    
    Throws:
    
    java.lang.IllegalArgumentException - if newLogVerbosity is negative.
  - setLogFilePath
```
@Deprecated
public static boolean setLogFilePath(java.lang.String filePath)
```
    Deprecated. As of TDLib 1.4.0 in favor of TdApi.SetLogStream, to be removed in the future.
    
    Sets file path for writing TDLib internal log. By default TDLib writes logs to the Android Log. Use this method to write the log to a file instead.
    
    Parameters:
    
    filePath - Path to a file for writing TDLib internal log. Use an empty path to switch back to logging to the Android Log.
    
    Returns:
    
    whether opening the log file succeeded
  - setLogMaxFileSize
```
@Deprecated
public static void setLogMaxFileSize(long maxFileSize)
```
    Deprecated. As of TDLib 1.4.0 in favor of TdApi.SetLogStream, to be removed in the future.
    
    Changes maximum size of TDLib log file.
    
    Parameters:
    
    maxFileSize - Maximum size of the file to where the internal TDLib log is written before the file will be auto-rotated. Must be positive. Defaults to 10 MB.
    
    Throws:
    
    java.lang.IllegalArgumentException - if max_file_size is non-positive.
  - close
```
public void close()
```
    Closes Client.
  - finalize
```
protected void finalize()
                 throws java.lang.Throwable
```
    Overrides:
    
    finalize in class java.lang.Object
    
    Throws:
    
    java.lang.Throwable

Class Client

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

send

send

execute

setUpdatesHandler

setUpdatesHandler

setDefaultExceptionHandler

bench

run

create

setLogVerbosityLevel

setLogFilePath

setLogMaxFileSize

close

finalize