com.rollbar.notifier

Class RollbarBase<RESULT,C extends CommonConfig>

java.lang.Object

com.rollbar.notifier.RollbarBase<RESULT,C>

Type Parameters:

RESULT - The result type of a send operation. Sync methods can use Void

C - The configuration class for the notifier

Direct Known Subclasses:

Rollbar

@Unstable
public abstract class RollbarBase<RESULT,C extends CommonConfig>
extends java.lang.Object

Common logic for synchronous and non-blocking async notifiers.

Field Summary

Fields

Modifier and Type	Field and Description
protected BodyFactory	bodyFactory
protected C	config
protected java.util.concurrent.locks.Lock	configReadLock
protected java.util.concurrent.locks.ReadWriteLock	configReadWriteLock
protected java.util.concurrent.locks.Lock	configWriteLock
protected PayloadTruncator	payloadTruncator

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RollbarBase(C config, BodyFactory bodyFactory, RESULT emptyResult)

Method Summary

Modifier and Type	Method and Description
protected com.rollbar.api.payload.data.Data	buildData(CommonConfig config, ThrowableWrapper error, java.util.Map<java.lang.String,java.lang.Object> custom, java.lang.String description, com.rollbar.api.payload.data.Level level, boolean isUncaught)
protected void	configure(C config) Replace the configuration of this instance directly.
protected com.rollbar.api.payload.data.Level	level(CommonConfig config, java.lang.Throwable error) Get the level of the error or message.
protected RESULT	process(ThrowableWrapper error, java.util.Map<java.lang.String,java.lang.Object> custom, java.lang.String description, com.rollbar.api.payload.data.Level level, boolean isUncaught)
protected void	processAppPackages(CommonConfig config)
void	recordLogEventFor(com.rollbar.api.payload.data.Level level, java.lang.String message) Record log telemetry event.
void	recordManualEventFor(com.rollbar.api.payload.data.Level level, java.lang.String message) Record manual telemetry event.
void	recordNavigationEventFor(com.rollbar.api.payload.data.Level level, java.lang.String from, java.lang.String to) Record navigation telemetry event with from (origin) and to (destination).
void	recordNetworkEventFor(com.rollbar.api.payload.data.Level level, java.lang.String method, java.lang.String url, java.lang.String statusCode) Record network telemetry event with method, url, and status code.
protected abstract RESULT	sendPayload(C config, com.rollbar.api.payload.Payload payload)
protected RollbarThrowableWrapper	wrapThrowable(java.lang.Throwable error)

Methods inherited from class java.lang.Object

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

Field Detail

bodyFactory

protected BodyFactory bodyFactory

payloadTruncator

protected PayloadTruncator payloadTruncator

config

protected C extends CommonConfig config

configReadWriteLock

protected final java.util.concurrent.locks.ReadWriteLock configReadWriteLock

configReadLock

protected final java.util.concurrent.locks.Lock configReadLock

configWriteLock

protected final java.util.concurrent.locks.Lock configWriteLock

Constructor Detail

RollbarBase

protected RollbarBase(C config,
                      BodyFactory bodyFactory,
                      RESULT emptyResult)

Method Detail

recordLogEventFor

public void recordLogEventFor(com.rollbar.api.payload.data.Level level,
                              java.lang.String message)

Record log telemetry event. (TelemetryType.LOG).

Parameters:

level - the TelemetryEvent severity (e.g. Level.DEBUG).

message - the message sent for this event (e.g. "hello world").

recordManualEventFor

public void recordManualEventFor(com.rollbar.api.payload.data.Level level,
                                 java.lang.String message)

Record manual telemetry event. (TelemetryType.MANUAL)

Parameters:

level - the TelemetryEvent severity (e.g. Level.DEBUG).

message - the message sent for this event (e.g. "hello world").

recordNavigationEventFor

public void recordNavigationEventFor(com.rollbar.api.payload.data.Level level,
                                     java.lang.String from,
                                     java.lang.String to)

Record navigation telemetry event with from (origin) and to (destination). (TelemetryType.NAVIGATION).

Parameters:

level - the TelemetryEvent severity (e.g. Level.DEBUG).

from - the starting point (e.g. "SettingView").

to - the destination point (e.g. "HomeView").

recordNetworkEventFor

public void recordNetworkEventFor(com.rollbar.api.payload.data.Level level,
                                  java.lang.String method,
                                  java.lang.String url,
                                  java.lang.String statusCode)

Record network telemetry event with method, url, and status code. (TelemetryType.NETWORK).

Parameters:

level - the TelemetryEvent severity (e.g. Level.DEBUG).

method - the verb used (e.g. "POST").

url - the api url (e.g. " http://rollbar.com/test/api").

statusCode - the response status code (e.g. "404").

configure

protected void configure(C config)

Replace the configuration of this instance directly.

Parameters:

config - the new configuration.

processAppPackages

protected void processAppPackages(CommonConfig config)

level

protected com.rollbar.api.payload.data.Level level(CommonConfig config,
                                                   java.lang.Throwable error)

Get the level of the error or message.

Parameters:

config - the current Config.

error - the error.

Returns:

the level.

buildData

protected com.rollbar.api.payload.data.Data buildData(CommonConfig config,
                                                      ThrowableWrapper error,
                                                      java.util.Map<java.lang.String,java.lang.Object> custom,
                                                      java.lang.String description,
                                                      com.rollbar.api.payload.data.Level level,
                                                      boolean isUncaught)

process

protected RESULT process(ThrowableWrapper error,
                         java.util.Map<java.lang.String,java.lang.Object> custom,
                         java.lang.String description,
                         com.rollbar.api.payload.data.Level level,
                         boolean isUncaught)

wrapThrowable

protected RollbarThrowableWrapper wrapThrowable(java.lang.Throwable error)

sendPayload

protected abstract RESULT sendPayload(C config,
                                      com.rollbar.api.payload.Payload payload)