de.ruedigermoeller.fastcast.remoting

Class FastCast

java.lang.Object

de.ruedigermoeller.fastcast.remoting.FastCast

All Implemented Interfaces:

FCRemoting, de.ruedigermoeller.serialization.FSTObjectInput.ConditionalCallback

public class FastCast
extends Object
implements de.ruedigermoeller.serialization.FSTObjectInput.ConditionalCallback, FCRemoting

Created with IntelliJ IDEA. User: moelrue Date: 8/6/13 Time: 3:00 PM To change this template use File | Settings | File Templates.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FastCast.ConfigurationAlreadyDefinedException

Field Summary

Fields

Modifier and Type	Field and Description
protected HashMap<String,FCTopicConf>	channelConf
protected static de.ruedigermoeller.serialization.FSTConfiguration	conf
protected FCClusterConfig	config
protected HashMap<String,FCTransportDispatcher>	dispatcher
static int	HEARTBEAT
protected HashMap<String,TopicEntry>	topics
protected HashMap<String,Transport>	transports

Constructor Summary

Constructors

Constructor and Description
FastCast()

Method Summary

Methods

Modifier and Type	Method and Description
void	callRemoteMethod(TopicEntry topicEntry, PacketSendBuffer sender, int methodIndex, Object[] args, boolean loopback, boolean unreliable)
void	finishFastCall(PacketSendBuffer sender, de.ruedigermoeller.serialization.FSTObjectOutput fstObjectOutput)
List<String>	getActiveTopics()
FCMembership	getMemberShipLocal()
FCMembership	getMemberShipRemoteProxy() returns remote FCMemberShip instance, null if none installed
String	getNodeId()
FCRemoteServiceProxy	getRemoteService(String topic) return the remote service proxy object.
static FCRemoting	getRemoting()
FCRemotingListener	getRemotingListener()
static de.ruedigermoeller.serialization.FSTConfiguration	getSerializationConfig()
FCTopicService	getService(String topic) return the local instance of a service with given name.
FCRemoteServiceProxy	getServiceProxy(String topic)
TopicStats	getStats(String name)
FCTopicConf	getTopicConfiguration(String name)
Transport	getTransport(String name)
FCTransportDispatcher	getTransportDispatcher(String transName)
boolean	hasRemoteResult(Object[] args)
protected void	initTopics(FCTopicConf[] channelConfs)
protected void	initTransports(FCSocketConf[] tconfs, String nodeName)
protected void	installService(TopicEntry topic) setup proxy classes, instantiate service and setup internal hashmaps.
void	joinCluster(FCClusterConfig conf, String nodeId, String clusterName)
void	joinCluster(String configFile, String nodeId, String clusterName) joins the cluster defined by the given config.
de.ruedigermoeller.serialization.FSTObjectOutput	prepareFastCall(int methodIndex, int args)
void	sendBinaryContent(TopicEntry topicEntry, PacketSendBuffer sender, de.ruedigermoeller.heapoff.bytez.Bytez bytes, int offset, int length, boolean loopback)
void	setNodeId(String nodeName)
void	setRemotingListener(FCRemotingListener listener)
boolean	shouldSkip(Object o, int i, Field field)
void	start(FCClusterConfig config, String nodeName)
void	start(String topicName)
void	startReceiving(String topicName, FCBinaryMessageListener binaryListener) starts listening on the given topic
void	startReceiving(String topicName, FCTopicService service)
<T extends FCTopicService> T	startSending(String topic, Class<T> fcBinaryTopicServiceClass) starts sending on the given topic use this for ConfigBuilder based configs.
void	stopReceiving(String topicName)

Methods inherited from class java.lang.Object

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

Field Detail

HEARTBEAT

public static final int HEARTBEAT

See Also:

Constant Field Values

config

protected FCClusterConfig config

conf

protected static de.ruedigermoeller.serialization.FSTConfiguration conf

transports

protected HashMap<String,Transport> transports

dispatcher

protected HashMap<String,FCTransportDispatcher> dispatcher

channelConf

protected HashMap<String,FCTopicConf> channelConf

topics

protected HashMap<String,TopicEntry> topics

Constructor Detail

FastCast

public FastCast()

Method Detail

getSerializationConfig

public static de.ruedigermoeller.serialization.FSTConfiguration getSerializationConfig()

getRemoting

public static FCRemoting getRemoting()

joinCluster

public void joinCluster(String configFile,
               String nodeId,
               String clusterName)
                 throws IOException

Description copied from interface: FCRemoting

joins the cluster defined by the given config. Note that listening/sending must be explicitely enabled after joining. clustername is a Development convenience feature. One can start several clusters with different name without having to reconfigure ports/adresses etc. . However since those clusters share the same network queues/ports, this will slow down communication. DON'T USE FOR PRODUCTION SYSTEMS. In a production system one would run more than one clsuter at a time by using different ports and multicast adresses, so packet filtering is done by the network hardware/kernel.

Specified by:

joinCluster in interface FCRemoting

nodeId - - name of the process (will make up the adress of a node e.g. as reported in senderId). MUST NOT EXCEED 8 chars.

clusterName - - see above. If null, take clustername from config. MUST NOT EXCEED 8 chars.

Throws:

IOException

getRemotingListener

public FCRemotingListener getRemotingListener()

Specified by:

getRemotingListener in interface FCRemoting

setRemotingListener

public void setRemotingListener(FCRemotingListener listener)

Specified by:

setRemotingListener in interface FCRemoting

joinCluster

public void joinCluster(FCClusterConfig conf,
               String nodeId,
               String clusterName)

Specified by:

joinCluster in interface FCRemoting

start

public void start(FCClusterConfig config,
         String nodeName)

setNodeId

public void setNodeId(String nodeName)

getServiceProxy

public FCRemoteServiceProxy getServiceProxy(String topic)

getNodeId

public String getNodeId()

Specified by:

getNodeId in interface FCRemoting

Returns:

cluster-unique nodeid associated with this process. Avaiable after joinCluster !

getService

public FCTopicService getService(String topic)

Description copied from interface: FCRemoting

return the local instance of a service with given name. via getService(name).getProxy() the Remote Proxy can be obtained to send messages to remote instances. The service is present only if startReceiving has been called on the associated topic

Specified by:

getService in interface FCRemoting

Returns:

getTransport

public Transport getTransport(String name)

getStats

public TopicStats getStats(String name)

Specified by:

getStats in interface FCRemoting

getActiveTopics

public List<String> getActiveTopics()

Specified by:

getActiveTopics in interface FCRemoting

getTopicConfiguration

public FCTopicConf getTopicConfiguration(String name)

Specified by:

getTopicConfiguration in interface FCRemoting

startReceiving

public void startReceiving(String topicName,
                  FCBinaryMessageListener binaryListener)

Description copied from interface: FCRemoting

starts listening on the given topic

Specified by:

startReceiving in interface FCRemoting

startReceiving

public void startReceiving(String topicName,
                  FCTopicService service)

Specified by:

startReceiving in interface FCRemoting

start

public void start(String topicName)

Specified by:

start in interface FCRemoting

startSending

public <T extends FCTopicService> T startSending(String topic,
                                        Class<T> fcBinaryTopicServiceClass)
                                      throws Exception

Description copied from interface: FCRemoting

starts sending on the given topic use this for ConfigBuilder based configs. Directly returns topic

Specified by:

startSending in interface FCRemoting

Returns:

Throws:

Exception

stopReceiving

public void stopReceiving(String topicName)

Specified by:

stopReceiving in interface FCRemoting

getRemoteService

public FCRemoteServiceProxy getRemoteService(String topic)

Description copied from interface: FCRemoting

return the remote service proxy object. Calling @remote annotated methods on this will send to all receivers listening to the service in the cluster.

Specified by:

getRemoteService in interface FCRemoting

Returns:

hasRemoteResult

public boolean hasRemoteResult(Object[] args)

prepareFastCall

public de.ruedigermoeller.serialization.FSTObjectOutput prepareFastCall(int methodIndex,
                                                               int args)
                                                                 throws IOException

Throws:

IOException

finishFastCall

public void finishFastCall(PacketSendBuffer sender,
                  de.ruedigermoeller.serialization.FSTObjectOutput fstObjectOutput)

sendBinaryContent

public void sendBinaryContent(TopicEntry topicEntry,
                     PacketSendBuffer sender,
                     de.ruedigermoeller.heapoff.bytez.Bytez bytes,
                     int offset,
                     int length,
                     boolean loopback)
                       throws IOException

Throws:

IOException

callRemoteMethod

public void callRemoteMethod(TopicEntry topicEntry,
                    PacketSendBuffer sender,
                    int methodIndex,
                    Object[] args,
                    boolean loopback,
                    boolean unreliable)
                      throws IOException

Throws:

IOException

getTransportDispatcher

public FCTransportDispatcher getTransportDispatcher(String transName)

initTopics

protected void initTopics(FCTopicConf[] channelConfs)

installService

protected void installService(TopicEntry topic)
                       throws Exception

setup proxy classes, instantiate service and setup internal hashmaps. does not joinCluster listening/sending

Parameters:

topic -

Throws:

Exception

getMemberShipRemoteProxy

public FCMembership getMemberShipRemoteProxy()

Description copied from interface: FCRemoting

returns remote FCMemberShip instance, null if none installed

Specified by:

getMemberShipRemoteProxy in interface FCRemoting

Returns:

getMemberShipLocal

public FCMembership getMemberShipLocal()

Specified by:

getMemberShipLocal in interface FCRemoting

Returns:

the local membership instance if any

shouldSkip

public boolean shouldSkip(Object o,
                 int i,
                 Field field)

Specified by:

shouldSkip in interface de.ruedigermoeller.serialization.FSTObjectInput.ConditionalCallback

initTransports

protected void initTransports(FCSocketConf[] tconfs,
                  String nodeName)