DetectorClientRpcModule (OpenNMS 30.0.0 API)

java.lang.Object
- org.opennms.core.rpc.xml.AbstractXmlRpcModule<DetectorRequestDTO,DetectorResponseDTO>
- - org.opennms.netmgt.provision.detector.client.rpc.DetectorClientRpcModule

All Implemented Interfaces:

RpcClient<DetectorRequestDTO,DetectorResponseDTO>, RpcModule<DetectorRequestDTO,DetectorResponseDTO>
```
public class DetectorClientRpcModule
extends AbstractXmlRpcModule<DetectorRequestDTO,DetectorResponseDTO>
```
RPC module used to execute both SyncServiceDetector and AsyncServiceDetector detectors. When running on OpenNMS, detectors are executed in provisiond's scanExecutor thread pool. When running on Minion, detectors are executed in a caching thread pool created by the blueprint.

Author:

jwhite

Field Summary

Fields
Modifier and Type Field Description

static String RPC_MODULE_ID
- Fields inherited from interface org.opennms.core.rpc.api.RpcModule
  MINION_HEADERS_MODULE

Constructor Summary

Constructors
Constructor Description

DetectorClientRpcModule()

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`DetectorResponseDTO`	`createResponseWithException(Throwable ex)`	Called when the `RpcModule` throws an exception while executing a request.
`CompletableFuture<DetectorResponseDTO>`	`execute(DetectorRequestDTO request)`
`String`	`getId()`	Used to route the request/responses to the appropriate module.
`void`	`setExecutor(Executor executor)`
`void`	`setServiceDetectorRegistry(ServiceDetectorRegistry serviceDetectorRegistry)`

Methods inherited from class org.opennms.core.rpc.xml.AbstractXmlRpcModule
marshalRequest, marshalResponse, unmarshalRequest, unmarshalResponse

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

- Field Detail
  - RPC_MODULE_ID
```
public static final String RPC_MODULE_ID
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - DetectorClientRpcModule
```
public DetectorClientRpcModule()
```
- Method Detail
  - execute
```
public CompletableFuture<DetectorResponseDTO> execute(DetectorRequestDTO request)
```
  - createResponseWithException
```
public DetectorResponseDTO createResponseWithException(Throwable ex)
```
    Description copied from interface: RpcModule
    
    Called when the RpcModule throws an exception while executing a request. This function should return a new RpcResponse that stores a string-based representation of the exception that occurred and make this available via RpcResponse.getErrorMessage() once un-marshaled.
    
    Parameters:
    
    ex - the exception that occurred
    
    Returns:
    
    a RpcResponse that stores the exception
  - getId
```
public String getId()
```
    Description copied from interface: RpcModule
    
    Used to route the request/responses to the appropriate module. This ID should be unique for every RpcModule implementation.
  - setServiceDetectorRegistry
```
public void setServiceDetectorRegistry(ServiceDetectorRegistry serviceDetectorRegistry)
```
  - setExecutor
```
public void setExecutor(Executor executor)
```