java.lang.Object
- org.freedesktop.dbus.connections.config.ReceivingServiceConfigBuilder<R>

Type Parameters:

R - BaseConnectionBuilder type
```
public final class ReceivingServiceConfigBuilder<R extends BaseConnectionBuilder<?,?>>
extends java.lang.Object
```
Configuration builder to configure ReceivingService. Only intended to be used in combination with BaseConnectionBuilder

Since:

4.2.0 - 2022-07-14

Field Summary

Fields
Modifier and Type	Field	Description
`private ReceivingServiceConfig`	`config`
`private java.util.function.Supplier<R>`	`connectionBuilder`
`private static ReceivingServiceConfig`	`DEFAULT_CFG`
`static int`	`DEFAULT_HANDLER_RETRIES`
`private static ReceivingService.IThreadPoolRetryHandler`	`DEFAULT_RETRYHANDLER`

Constructor Summary

Constructors
Constructor Description

ReceivingServiceConfigBuilder(java.util.function.Supplier<R> _bldr)

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`ReceivingServiceConfig`	`build()`	Returns the configured `ReceivingServiceConfig` instance.
`R`	`connectionConfig()`	Returns the used ConnectionBuilder for the connection for further configuration.
`static ReceivingServiceConfig`	`getDefaultConfig()`	Returns the default configuration used for `ReceivingService`.
`static ReceivingService.IThreadPoolRetryHandler`	`getDefaultRetryHandler()`	Returns the default retry handler used for `ReceivingService`.
`ReceivingServiceConfigBuilder<R>`	`withErrorHandlerThreadCount(int _threads)`	Set the size of the thread-pool used to handle error messages received on the bus.
`ReceivingServiceConfigBuilder<R>`	`withErrorThreadPriority(int _priority)`	Sets the thread priority of the created signal thread(s).
`ReceivingServiceConfigBuilder<R>`	`withMethedCallThreadPriority(int _priority)`	Sets the thread priority of the created signal thread(s).
`ReceivingServiceConfigBuilder<R>`	`withMethodCallThreadCount(int _threads)`	Set the size of the thread-pool used to handle methods calls previously sent to the bus.
`ReceivingServiceConfigBuilder<R>`	`withMethodReturnThreadCount(int _threads)`	Set the size of the thread-pool used to handle method return values received on the bus.
`ReceivingServiceConfigBuilder<R>`	`withMethodReturnThreadPriority(int _priority)`	Sets the thread priority of the created signal thread(s).
`ReceivingServiceConfigBuilder<R>`	`withRetryHandler(ReceivingService.IThreadPoolRetryHandler _handler)`	Sets the retry handler which should be called when executing a runnable in `ReceivingService` thread pools fail.
`ReceivingServiceConfigBuilder<R>`	`withSignalThreadCount(int _threads)`	Set the size of the thread-pool used to handle signals from the bus.
`ReceivingServiceConfigBuilder<R>`	`withSignalThreadPriority(int _priority)`	Sets the thread priority of the created signal thread(s).

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

- Field Detail
  - DEFAULT_HANDLER_RETRIES
```
public static final int DEFAULT_HANDLER_RETRIES
```
    See Also:
    
    Constant Field Values
  - DEFAULT_CFG
```
private static final ReceivingServiceConfig DEFAULT_CFG
```
  - DEFAULT_RETRYHANDLER
```
private static final ReceivingService.IThreadPoolRetryHandler DEFAULT_RETRYHANDLER
```
  - connectionBuilder
```
private final java.util.function.Supplier<R extends BaseConnectionBuilder<?,?>> connectionBuilder
```
  - config
```
private final ReceivingServiceConfig config
```
- Constructor Detail
  - ReceivingServiceConfigBuilder
```
public ReceivingServiceConfigBuilder(java.util.function.Supplier<R> _bldr)
```
- Method Detail
  - withSignalThreadCount
```
public ReceivingServiceConfigBuilder<R> withSignalThreadCount(int _threads)
```
    Set the size of the thread-pool used to handle signals from the bus. Caution: Using thread-pool size > 1 may cause signals to be handled out-of-order
    Default: 1
    
    Parameters:
    
    _threads - int >= 1
    
    Returns:
    
    this
  - withErrorHandlerThreadCount
```
public ReceivingServiceConfigBuilder<R> withErrorHandlerThreadCount(int _threads)
```
    Set the size of the thread-pool used to handle error messages received on the bus.
    Default: 1
    
    Parameters:
    
    _threads - int >= 1
    
    Returns:
    
    this
  - withMethodCallThreadCount
```
public ReceivingServiceConfigBuilder<R> withMethodCallThreadCount(int _threads)
```
    Set the size of the thread-pool used to handle methods calls previously sent to the bus. The thread pool size has to be > 1 to handle recursive calls.
    Default: 4
    
    Parameters:
    
    _threads - int >= 1
    
    Returns:
    
    this
  - withMethodReturnThreadCount
```
public ReceivingServiceConfigBuilder<R> withMethodReturnThreadCount(int _threads)
```
    Set the size of the thread-pool used to handle method return values received on the bus.
    Default: 1
    
    Parameters:
    
    _threads - int >= 1
    
    Returns:
    
    this
  - withSignalThreadPriority
```
public ReceivingServiceConfigBuilder<R> withSignalThreadPriority(int _priority)
```
    Sets the thread priority of the created signal thread(s).
    Default: Thread.NORM_PRIORITY (5);
    
    Parameters:
    
    _priority - int >=1 and <= 10
    
    Returns:
    
    this
    
    Throws:
    
    java.lang.IllegalArgumentException - when value is out ouf range (value < 1 && > 10)
  - withErrorThreadPriority
```
public ReceivingServiceConfigBuilder<R> withErrorThreadPriority(int _priority)
```
    Sets the thread priority of the created signal thread(s).
    Default: Thread.NORM_PRIORITY (5);
    
    Parameters:
    
    _priority - int >=1 and <= 10
    
    Returns:
    
    this
    
    Throws:
    
    java.lang.IllegalArgumentException - when value is out ouf range (value < 1 && > 10)
  - withMethedCallThreadPriority
```
public ReceivingServiceConfigBuilder<R> withMethedCallThreadPriority(int _priority)
```
    Sets the thread priority of the created signal thread(s).
    Default: Thread.NORM_PRIORITY (5);
    
    Parameters:
    
    _priority - int >=1 and <= 10
    
    Returns:
    
    this
    
    Throws:
    
    java.lang.IllegalArgumentException - when value is out ouf range (value < 1 && > 10)
  - withMethodReturnThreadPriority
```
public ReceivingServiceConfigBuilder<R> withMethodReturnThreadPriority(int _priority)
```
    Sets the thread priority of the created signal thread(s).
    Default: Thread.NORM_PRIORITY (5);
    
    Parameters:
    
    _priority - int >=1 and <= 10
    
    Returns:
    
    this
    
    Throws:
    
    java.lang.IllegalArgumentException - when value is out ouf range (value < 1 && > 10)
  - withRetryHandler
```
public ReceivingServiceConfigBuilder<R> withRetryHandler(ReceivingService.IThreadPoolRetryHandler _handler)
```
    Sets the retry handler which should be called when executing a runnable in ReceivingService thread pools fail.
    Defaults to an implementation retrying executing the runnable up to ten times. If null is given, retrying will be disabled (but error will be logged).
    
    Parameters:
    
    _handler - handler to use
    
    Returns:
    
    this
  - build
```
public ReceivingServiceConfig build()
```
    Returns the configured ReceivingServiceConfig instance.
    
    Returns:
    
    config never null
  - connectionConfig
```
public R connectionConfig()
```
    Returns the used ConnectionBuilder for the connection for further configuration.
    
    Returns:
    
    connection builder
  - getDefaultConfig
```
public static ReceivingServiceConfig getDefaultConfig()
```
    Returns the default configuration used for ReceivingService.
    
    Returns:
    
    default config
  - getDefaultRetryHandler
```
public static ReceivingService.IThreadPoolRetryHandler getDefaultRetryHandler()
```
    Returns the default retry handler used for ReceivingService.
    
    Returns:
    
    default handler

Class ReceivingServiceConfigBuilder<R extends BaseConnectionBuilder<?,​?>>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_HANDLER_RETRIES

DEFAULT_CFG

DEFAULT_RETRYHANDLER

connectionBuilder

config

Constructor Detail

ReceivingServiceConfigBuilder

Method Detail

withSignalThreadCount

withErrorHandlerThreadCount

withMethodCallThreadCount

withMethodReturnThreadCount

withSignalThreadPriority

withErrorThreadPriority

withMethedCallThreadPriority

withMethodReturnThreadPriority

withRetryHandler

build

connectionConfig

getDefaultConfig

getDefaultRetryHandler

Class ReceivingServiceConfigBuilder<R extends BaseConnectionBuilder<?,?>>