Header containing initialization data like activation.
Get state.
Get current state of connection state with the remote client.
List of values are such like below:
REJECTING
: The reject
method is on running.NONE
: This instance is newly created, but did nothing yet.ACCEPTING
: The accept
method is on running.OPEN
: The connection is online.CLOSING
: The close
method is on running.CLOSED
: The connection is offline.Protected
destructorDestroy the communicator.
A destroy function must be called when the network communication has been closed.
It would destroy all function calls in the remote system (by Driver<Controller>
),
which are not returned yet.
The error instance would be thrown to those function calls. If the disconnection is abnormal, then write the detailed reason why into the error instance.
Optional
error: ErrorAn error instance to be thrown to the unreturned functions.
Get Driver for RFC (Remote Function Call).
The Controller
is an interface who defines provided functions from the remote
system. The Driver
is an object who makes to call remote functions, defined in
the Controller
and provided by Provider
in the remote system, possible.
In other words, calling a functions in the Driver<Controller>
, it means to call
a matched function in the remote system's Provider
object.
Controller
: Definition onlyDriver
: Remote Function CallAn interface for provided features (functions & objects) from the remote system (Provider
).
Whether to convert type of function parameters to be compatible with their primitive.
A Driver for the RFC.
Join connection.
Wait until the connection to be closed.
Join connection or timeout.
Wait until the connection to be closed until timeout.
The maximum milliseconds for joining.
Whether awaken by disconnection or timeout.
Join connection or time expiration.
Wait until the connection to be closed until time expiration.
The maximum time point to join.
Whether awaken by disconnection or time expiration.
Protected
replyData Reply Function.
A function should be called when data has come from the remote system.
When you receive a message from the remote system, then parse the message with your special protocol and covert it to be an Invoke object. After the conversion, call this method.
Structured data converted by your special protocol.
Set Provider
An object would be provided for remote system.
SharedWorker acceptor for client.
The
SharedWorkerAcceptor
is a communicator class interacting with the SharedWorkerConnector through RFC (Remote Function Call), created by the SharedWorkerServer class whenever a client connects to theSharedWorker
instance.When a remote client connects to the SharedWorkerServer, so that a new
SharedworkerAcceptor
instance being created, you can determine whether to accept the client's connection or not, reading the header property. If you've decided to accept the connection, call the accept method withProvider
instance. Otherwise, reject it thorugh the reject method.After accepting the connection, don't forget to closing the connection after your business has been completed to clean up the resources. Otherwise the closing must be performed by the remote client, you can wait the remote client's closing signal by the join method.
Also, when declaring this SharedworkerAcceptor type, you have to define three generic arguments;
Header
,Provider
andRemote
. Those generic arguments must be same with the ones defined in the SharedWorkerServer class.For reference, the first
Header
type represents an initial data from the remote client after the connection. I recommend utilize it as an activation tool for security enhancement. The second generic argumentProvider
represents a provider from server to client, and the otherRemote
means a provider from the remote client to server.Author
Jeongho Nam - https://github.com/samchon