io.sentry.connection

Class HttpConnection

java.lang.Object

io.sentry.connection.AbstractConnection

io.sentry.connection.HttpConnection

All Implemented Interfaces:

Connection, Closeable, AutoCloseable

public class HttpConnection
extends AbstractConnection

Basic connection to a Sentry server, using HTTP and HTTPS.

It is possible to enable the "naive mode" to allow a connection over SSL using a certificate with a wildcard.

Field Summary

Fields

Modifier and Type	Field and Description
static int	HTTP_TOO_MANY_REQUESTS HTTP code `429 Too Many Requests`, which is not included in HttpURLConnection.

Fields inherited from class io.sentry.connection.AbstractConnection

SENTRY_PROTOCOL_VERSION

Constructor Summary

Constructors

Constructor and Description
HttpConnection(URL sentryUrl, String publicKey, String secretKey, Proxy proxy, EventSampler eventSampler) Creates an HTTP connection to a Sentry server.

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
protected void	doSend(Event event) Sends an event to the Sentry server.
protected HttpURLConnection	getConnection() Opens a connection to the Sentry API allowing to send new events.
static URL	getSentryApiUrl(URI sentryUri, String projectId) Automatically determines the URL to the HTTP API of Sentry.
void	setBypassSecurity(boolean bypassSecurity)
void	setConnectionTimeout(int timeout) This will set the timeout that is used in establishing a connection to the url.
void	setMarshaller(Marshaller marshaller)
void	setReadTimeout(int timeout) This will set the timeout that is used in reading data on an already established connection.
void	setTimeout(int timeout) Deprecated. Use setConnectionTimeout instead.

Methods inherited from class io.sentry.connection.AbstractConnection

addEventSendCallback, getAuthHeader, send

Methods inherited from class java.lang.Object

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

Field Detail

HTTP_TOO_MANY_REQUESTS

public static final int HTTP_TOO_MANY_REQUESTS

HTTP code `429 Too Many Requests`, which is not included in HttpURLConnection.

See Also:

Constant Field Values

Constructor Detail

HttpConnection

public HttpConnection(URL sentryUrl,
              String publicKey,
              String secretKey,
              Proxy proxy,
              EventSampler eventSampler)

Creates an HTTP connection to a Sentry server.

Parameters:

sentryUrl - URL to the Sentry API.

publicKey - public key of the current project.

secretKey - private key of the current project.

proxy - address of HTTP proxy or null if using direct connections.

eventSampler - EventSampler instance to use, or null to not sample events.

Method Detail

getSentryApiUrl

public static URL getSentryApiUrl(URI sentryUri,
                  String projectId)

Automatically determines the URL to the HTTP API of Sentry.

Parameters:

sentryUri - URI of the Sentry server.

projectId - unique identifier of the current project.

Returns:

an URL to the HTTP API of Sentry.

getConnection

protected HttpURLConnection getConnection()

Opens a connection to the Sentry API allowing to send new events.

Returns:

an HTTP connection to Sentry.

doSend

protected void doSend(Event event)
               throws ConnectionException

Description copied from class: AbstractConnection

Sends an event to the Sentry server.

Specified by:

doSend in class AbstractConnection

Parameters:

event - captured event to add in Sentry.

Throws:

ConnectionException - whenever a temporary exception due to the connection happened.

setTimeout

@Deprecated
public void setTimeout(int timeout)

Deprecated. Use setConnectionTimeout instead.

This will set the timeout that is used in establishing a connection to the url. By default this is set to 1 second.

Parameters:

timeout - New timeout to set. If 0 is used (java default) wait forever.

setConnectionTimeout

public void setConnectionTimeout(int timeout)

This will set the timeout that is used in establishing a connection to the url. By default this is set to 5 second.

Parameters:

timeout - New timeout to set. If 0 is used (java default) wait forever.

setReadTimeout

public void setReadTimeout(int timeout)

This will set the timeout that is used in reading data on an already established connection. By default this is set to 1 seconds.

Parameters:

timeout - New timeout to set. If 0 is used (java default) wait forever.

setMarshaller

public void setMarshaller(Marshaller marshaller)

setBypassSecurity

public void setBypassSecurity(boolean bypassSecurity)

close

public void close()
           throws IOException

Throws:

IOException