org.swisspush.gateleen.core.event

Class EventBusHandler

java.lang.Object

org.swisspush.gateleen.core.event.EventBusHandler

public class EventBusHandler
extends java.lang.Object

Delivers a request on the event bus.

If the header "x-sync" is set to "true", then the handler waits for an event reply before returning the response. In this case, the response contains the replied JSON, if any.

Requests are forwarded in the form:

 {
     "uri": "http://...",
     "method": "PUT",
     "headers": [
          [ "name", "value" ],
          [ "name", "value" ]
     ],
     "payload": {
         "hello": "world"
     }
 }
 

Payload is a JsonObject in case of application/json content type, a string in case of text/* content type, a base64 binary string otherwise.

Replies from clients have the same structure, without the uri.1

Field Summary

Fields

Modifier and Type	Field and Description
static int	ACCEPTED
static java.lang.String	APPLICATION_JSON
static int	BAD_REQUEST
static java.lang.String	CONTENT_TYPE
static int	GATEWAY_TIMEOUT
static java.lang.String	HEADERS
static java.lang.String	METHOD
static java.lang.String	PAYLOAD
static java.lang.String	SYNC
static java.lang.String	TEXT
static int	TIMEOUT
static java.lang.String	URI

Constructor Summary

Constructors

Constructor and Description
EventBusHandler(io.vertx.core.Vertx vertx, java.lang.String apiPath, java.lang.String sockPath, java.lang.String addressPrefix, java.lang.String addressPathPattern) Constructs and configures the handler.

Method Summary

Modifier and Type	Method and Description
boolean	handle(io.vertx.core.http.HttpServerRequest request)
void	install(io.vertx.ext.web.Router router) Configures and binds the SockJS bridge to an HttpServer.
void	setEventbusBridgePingInterval(java.lang.Long eventbusBridgePingInterval) Sets the ping_interval passed to the eventbus bridge.

Methods inherited from class java.lang.Object

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

Field Detail

ACCEPTED

public static final int ACCEPTED

See Also:

Constant Field Values

SYNC

public static final java.lang.String SYNC

See Also:

Constant Field Values

TEXT

public static final java.lang.String TEXT

See Also:

Constant Field Values

METHOD

public static final java.lang.String METHOD

See Also:

Constant Field Values

BAD_REQUEST

public static final int BAD_REQUEST

See Also:

Constant Field Values

CONTENT_TYPE

public static final java.lang.String CONTENT_TYPE

See Also:

Constant Field Values

APPLICATION_JSON

public static final java.lang.String APPLICATION_JSON

See Also:

Constant Field Values

PAYLOAD

public static final java.lang.String PAYLOAD

See Also:

Constant Field Values

URI

public static final java.lang.String URI

See Also:

Constant Field Values

HEADERS

public static final java.lang.String HEADERS

See Also:

Constant Field Values

TIMEOUT

public static final int TIMEOUT

See Also:

Constant Field Values

GATEWAY_TIMEOUT

public static final int GATEWAY_TIMEOUT

See Also:

Constant Field Values

Constructor Detail

EventBusHandler

public EventBusHandler(io.vertx.core.Vertx vertx,
                       java.lang.String apiPath,
                       java.lang.String sockPath,
                       java.lang.String addressPrefix,
                       java.lang.String addressPathPattern)

Constructs and configures the handler.

Parameters:

vertx - vertx

apiPath - The full URI path where to access the event api. E.g. /context/server/event/v1/.

sockPath - The full URI path of the SockJS endpoint to configure.

addressPrefix - The prefix used for the event bus addresses the handlers sends requests to. E.g. event/

addressPathPattern - A pattern to extract the address from the URI. This pattern is appended to the apiPath and must have a group. For example, a pattern hello/(world/[^/]+)/.* will forward requests on /context/server/event/v1/hello/world/foo/bar to address event/world/foo.

Method Detail

handle

public boolean handle(io.vertx.core.http.HttpServerRequest request)

install

public void install(io.vertx.ext.web.Router router)

Configures and binds the SockJS bridge to an HttpServer.

Parameters:

router - router

setEventbusBridgePingInterval

public void setEventbusBridgePingInterval(java.lang.Long eventbusBridgePingInterval)

Sets the ping_interval passed to the eventbus bridge. Defines the interval before a websocket connection is closed if no interaction with client happens in the meantime. Set the interval before calling install(io.vertx.ext.web.Router)

Parameters:

eventbusBridgePingInterval - Interval in milliseconds or null to use the default interval of the eventbus bridge (10 seconds)