org.nustaq.kontraktor.remoting.http

Class UndertowHttpServerConnector

java.lang.Object

org.nustaq.kontraktor.remoting.http.UndertowHttpServerConnector

All Implemented Interfaces:

io.undertow.server.HttpHandler, org.nustaq.kontraktor.remoting.base.ActorServerConnector

public class UndertowHttpServerConnector
extends Object
implements org.nustaq.kontraktor.remoting.base.ActorServerConnector, io.undertow.server.HttpHandler

Created by ruedi on 12.05.2015. A longpoll+shortpoll+nopoll based connector. Binary/MinBin/Json coding using POST requests is supported Algorithm/Expected client behaviour: Longpoll request is held until an event occurs or timeout. An incoming lp request reports last seen sequence in its url ../sessionId/sequence such that in case of network failure messages can be delivered more than once from a short (outgoing) message history. Regular requests are expected to come in ordered (so next request is done only if first one was replied). This is necessary due to http 1.1 limitations (multiple connections+reordering would be required otherwise). Responses to regular requests (actor messages) are piggy backed with long-poll-data if avaiable. This may lead to out of sequence long polls (network race). So a client has to implement sequence checking in order to prevent double processing of incoming messages. For shortpoll, a client sends "{ 'SP', sequence }" to indicate the poll request should return immediately. With many clients and connection limited clients (browser,mobiles) a short poll with larger intervals (>3s) might scale better at cost of latency. When used no-poll, streaming results to a callback is not supported. Only 'tell' (void methods) and 'ask' (IPromise-returning) messages can be used. TODO: support temporary/discardable websocket connections as a LP optimization. TODO: investigate http 2.0

Field Summary

Fields

Modifier and Type	Field and Description
static int	REQUEST_RESULTING_FUTURE_TIMEOUT
static long	SESSION_TIMEOUT_MS

Constructor Summary

Constructors

Constructor and Description
UndertowHttpServerConnector(org.nustaq.kontraktor.Actor facade)

Method Summary

Modifier and Type	Method and Description
org.nustaq.kontraktor.IPromise	closeServer()
protected HttpObjectSocket	closeSession(String sessionId)
void	connect(org.nustaq.kontraktor.Actor facade, Function<org.nustaq.kontraktor.remoting.base.ObjectSocket,org.nustaq.kontraktor.remoting.base.ObjectSink> factory)
protected org.nustaq.kontraktor.util.Pair<Runnable,io.undertow.server.HttpServerExchange>	createLongPollTask(io.undertow.server.HttpServerExchange exchange, HttpObjectSocket httpObjectSocket, org.xnio.channels.StreamSinkChannel sinkchannel)
org.nustaq.kontraktor.remoting.base.ActorServer	getActorServer()
long	getSessionTimeout()
void	handleClientRequest(io.undertow.server.HttpServerExchange exchange, HttpObjectSocket httpObjectSocket, byte[] postData, String lastSeenSequence)
protected void	handleRegularRequest(io.undertow.server.HttpServerExchange exchange, HttpObjectSocket httpObjectSocket, Object[] received, org.xnio.channels.StreamSinkChannel sinkchannel)
void	handleRequest(io.undertow.server.HttpServerExchange exchange) if relpath is empty, this is considered as a connect/open and a session id is sent back.
void	houseKeeping()
protected void	replyFromHistory(io.undertow.server.HttpServerExchange exchange, org.xnio.channels.StreamSinkChannel sinkchannel, byte[] msg)
protected void	requestReceived(io.undertow.server.HttpServerExchange exchange, byte[] postData, String path)
void	setActorServer(org.nustaq.kontraktor.remoting.base.ActorServer actorServer)
void	setSessionTimeout(long sessionTimeout)

Methods inherited from class java.lang.Object

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

Field Detail

REQUEST_RESULTING_FUTURE_TIMEOUT

public static int REQUEST_RESULTING_FUTURE_TIMEOUT

SESSION_TIMEOUT_MS

public static long SESSION_TIMEOUT_MS

Constructor Detail

UndertowHttpServerConnector

public UndertowHttpServerConnector(org.nustaq.kontraktor.Actor facade)

Method Detail

houseKeeping

public void houseKeeping()

setSessionTimeout

public void setSessionTimeout(long sessionTimeout)

getSessionTimeout

public long getSessionTimeout()

handleRequest

public void handleRequest(io.undertow.server.HttpServerExchange exchange)
                   throws Exception

if relpath is empty, this is considered as a connect/open and a session id is sent back. Else /sessionId/sequ or just /sessionId is expected posted content might contain an authentication information related object

Specified by:

handleRequest in interface io.undertow.server.HttpHandler

Parameters:

exchange -

Throws:

Exception

requestReceived

protected void requestReceived(io.undertow.server.HttpServerExchange exchange,
                               byte[] postData,
                               String path)

closeSession

protected HttpObjectSocket closeSession(String sessionId)

handleClientRequest

public void handleClientRequest(io.undertow.server.HttpServerExchange exchange,
                                HttpObjectSocket httpObjectSocket,
                                byte[] postData,
                                String lastSeenSequence)

createLongPollTask

protected org.nustaq.kontraktor.util.Pair<Runnable,io.undertow.server.HttpServerExchange> createLongPollTask(io.undertow.server.HttpServerExchange exchange,
                                                                                                             HttpObjectSocket httpObjectSocket,
                                                                                                             org.xnio.channels.StreamSinkChannel sinkchannel)

replyFromHistory

protected void replyFromHistory(io.undertow.server.HttpServerExchange exchange,
                                org.xnio.channels.StreamSinkChannel sinkchannel,
                                byte[] msg)

handleRegularRequest

protected void handleRegularRequest(io.undertow.server.HttpServerExchange exchange,
                                    HttpObjectSocket httpObjectSocket,
                                    Object[] received,
                                    org.xnio.channels.StreamSinkChannel sinkchannel)

connect

public void connect(org.nustaq.kontraktor.Actor facade,
                    Function<org.nustaq.kontraktor.remoting.base.ObjectSocket,org.nustaq.kontraktor.remoting.base.ObjectSink> factory)
             throws Exception

Specified by:

connect in interface org.nustaq.kontraktor.remoting.base.ActorServerConnector

Throws:

Exception

closeServer

public org.nustaq.kontraktor.IPromise closeServer()

Specified by:

closeServer in interface org.nustaq.kontraktor.remoting.base.ActorServerConnector

setActorServer

public void setActorServer(org.nustaq.kontraktor.remoting.base.ActorServer actorServer)

getActorServer

public org.nustaq.kontraktor.remoting.base.ActorServer getActorServer()