io.sentry

Class HubAdapter

java.lang.Object

io.sentry.HubAdapter

All Implemented Interfaces:

IHub

public final class HubAdapter
extends java.lang.Object
implements IHub

Method Summary

Modifier and Type	Method and Description
void	addBreadcrumb(Breadcrumb breadcrumb, @Nullable java.lang.Object hint) Adds a breadcrumb to the current Scope
void	bindClient(ISentryClient client) Binds a different client to the hub
SentryId	captureEnvelope(SentryEnvelope envelope, @Nullable java.lang.Object hint) Captures an envelope.
SentryId	captureEvent(SentryEvent event, @Nullable java.lang.Object hint) Captures the event.
SentryId	captureException(java.lang.Throwable throwable, @Nullable java.lang.Object hint) Captures the exception.
SentryId	captureMessage(java.lang.String message, SentryLevel level) Captures the message.
void	clearBreadcrumbs() Deletes current breadcrumbs from the current scope.
IHub	clone() Clones the Hub
void	close() Flushes out the queue for up to timeout seconds and disable the Hub.
void	configureScope(ScopeCallback callback) Configures the scope through the callback.
void	endSession() Ends the current session
void	flush(long timeoutMillis) Flushes events queued up, but keeps the Hub enabled.
static HubAdapter	getInstance()
SentryId	getLastEventId() Last event id recorded in the current scope
boolean	isEnabled() Check if the Hub is enabled/active.
void	popScope() Removes the first scope
void	pushScope() Pushes a new scope while inheriting the current scope's data.
void	removeExtra(java.lang.String key) Removes the extra key to an arbitrary value to the current Scope
void	removeTag(java.lang.String key) Removes the tag to a string value to the current Scope
void	setExtra(java.lang.String key, java.lang.String value) Sets the extra key to an arbitrary value to the current Scope, overwriting a potential previous value
void	setFingerprint(java.util.List<java.lang.String> fingerprint) Sets the fingerprint to group specific events together to the current Scope.
void	setLevel(SentryLevel level) Sets the level of all events sent within current Scope
void	setTag(java.lang.String key, java.lang.String value) Sets the tag to a string value to the current Scope, overwriting a potential previous value
void	setTransaction(java.lang.String transaction) Sets the name of the current transaction to the current Scope.
void	setUser(User user) Shallow merges user configuration (email, username, etc) to the current Scope.
void	startSession() Starts a new session.
void	withScope(ScopeCallback callback) Runs the callback with a new scope which gets dropped at the end

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.sentry.IHub

addBreadcrumb, addBreadcrumb, addBreadcrumb, captureEnvelope, captureEvent, captureException, captureMessage

Method Detail

getInstance

public static HubAdapter getInstance()

isEnabled

public boolean isEnabled()

Description copied from interface: IHub

Check if the Hub is enabled/active.

Specified by:

isEnabled in interface IHub

Returns:

true if its enabled or false otherwise.

captureEvent

public SentryId captureEvent(SentryEvent event,
                             @Nullable
                             @Nullable java.lang.Object hint)

Description copied from interface: IHub

Captures the event.

Specified by:

captureEvent in interface IHub

Parameters:

event - the event

hint - SDK specific but provides high level information about the origin of the event

Returns:

The Id (SentryId object) of the event

captureMessage

public SentryId captureMessage(java.lang.String message,
                               SentryLevel level)

Description copied from interface: IHub

Captures the message.

Specified by:

captureMessage in interface IHub

Parameters:

message - The message to send.

level - The message level.

Returns:

The Id (SentryId object) of the event

captureEnvelope

@ApiStatus.Internal
public SentryId captureEnvelope(SentryEnvelope envelope,
                                                    @Nullable
                                                    @Nullable java.lang.Object hint)

Description copied from interface: IHub

Captures an envelope.

Specified by:

captureEnvelope in interface IHub

Parameters:

envelope - the SentryEnvelope to send.

hint - SDK specific but provides high level information about the origin of the event

Returns:

The Id (SentryId object) of the event

captureException

public SentryId captureException(java.lang.Throwable throwable,
                                 @Nullable
                                 @Nullable java.lang.Object hint)

Description copied from interface: IHub

Captures the exception.

Specified by:

captureException in interface IHub

Parameters:

throwable - The exception.

hint - SDK specific but provides high level information about the origin of the event

Returns:

The Id (SentryId object) of the event

startSession

public void startSession()

Description copied from interface: IHub

Starts a new session. If there's a running session, it ends it before starting the new one.

Specified by:

startSession in interface IHub

endSession

public void endSession()

Description copied from interface: IHub

Ends the current session

Specified by:

endSession in interface IHub

close

public void close()

Description copied from interface: IHub

Flushes out the queue for up to timeout seconds and disable the Hub.

Specified by:

close in interface IHub

addBreadcrumb

public void addBreadcrumb(Breadcrumb breadcrumb,
                          @Nullable
                          @Nullable java.lang.Object hint)

Description copied from interface: IHub

Adds a breadcrumb to the current Scope

Specified by:

addBreadcrumb in interface IHub

Parameters:

breadcrumb - the breadcrumb

hint - SDK specific but provides high level information about the origin of the event

setLevel

public void setLevel(SentryLevel level)

Description copied from interface: IHub

Sets the level of all events sent within current Scope

Specified by:

setLevel in interface IHub

Parameters:

level - the Sentry level

setTransaction

public void setTransaction(java.lang.String transaction)

Description copied from interface: IHub

Sets the name of the current transaction to the current Scope.

Specified by:

setTransaction in interface IHub

Parameters:

transaction - the transaction

setUser

public void setUser(User user)

Description copied from interface: IHub

Shallow merges user configuration (email, username, etc) to the current Scope.

Specified by:

setUser in interface IHub

Parameters:

user - the user

setFingerprint

public void setFingerprint(java.util.List<java.lang.String> fingerprint)

Description copied from interface: IHub

Sets the fingerprint to group specific events together to the current Scope.

Specified by:

setFingerprint in interface IHub

Parameters:

fingerprint - the fingerprints

clearBreadcrumbs

public void clearBreadcrumbs()

Description copied from interface: IHub

Deletes current breadcrumbs from the current scope.

Specified by:

clearBreadcrumbs in interface IHub

setTag

public void setTag(java.lang.String key,
                   java.lang.String value)

Description copied from interface: IHub

Sets the tag to a string value to the current Scope, overwriting a potential previous value

Specified by:

setTag in interface IHub

Parameters:

key - the key

value - the value

removeTag

public void removeTag(java.lang.String key)

Description copied from interface: IHub

Removes the tag to a string value to the current Scope

Specified by:

removeTag in interface IHub

Parameters:

key - the key

setExtra

public void setExtra(java.lang.String key,
                     java.lang.String value)

Description copied from interface: IHub

Sets the extra key to an arbitrary value to the current Scope, overwriting a potential previous value

Specified by:

setExtra in interface IHub

Parameters:

key - the key

value - the value

removeExtra

public void removeExtra(java.lang.String key)

Description copied from interface: IHub

Removes the extra key to an arbitrary value to the current Scope

Specified by:

removeExtra in interface IHub

Parameters:

key - the key

getLastEventId

public SentryId getLastEventId()

Description copied from interface: IHub

Last event id recorded in the current scope

Specified by:

getLastEventId in interface IHub

Returns:

last SentryId

pushScope

public void pushScope()

Description copied from interface: IHub

Pushes a new scope while inheriting the current scope's data.

Specified by:

pushScope in interface IHub

popScope

public void popScope()

Description copied from interface: IHub

Removes the first scope

Specified by:

popScope in interface IHub

withScope

public void withScope(ScopeCallback callback)

Description copied from interface: IHub

Runs the callback with a new scope which gets dropped at the end

Specified by:

withScope in interface IHub

Parameters:

callback - the callback

configureScope

public void configureScope(ScopeCallback callback)

Description copied from interface: IHub

Configures the scope through the callback.

Specified by:

configureScope in interface IHub

Parameters:

callback - The configure scope callback.

bindClient

public void bindClient(ISentryClient client)

Description copied from interface: IHub

Binds a different client to the hub

Specified by:

bindClient in interface IHub

Parameters:

client - the client.

flush

public void flush(long timeoutMillis)

Description copied from interface: IHub

Flushes events queued up, but keeps the Hub enabled. Not implemented yet.

Specified by:

flush in interface IHub

Parameters:

timeoutMillis - time in milliseconds

clone

public IHub clone()

Description copied from interface: IHub

Clones the Hub

Specified by:

clone in interface IHub

Overrides:

clone in class java.lang.Object

Returns:

the cloned Hub