er.jgroups
Class ERJGroupsSynchronizer

java.lang.Object
  er.extensions.remoteSynchronizer.ERXRemoteSynchronizer
      er.jgroups.ERJGroupsSynchronizer

public class ERJGroupsSynchronizer
extends ERXRemoteSynchronizer

A multicast synchronizer built on top of the JGroups library. This is a much more robust implementation than the default synchronizer used by ERXObjectStoreCoordinatorSynchronizer.

Author:

mschrag

Properties

er.extensions.ERXObjectStoreCoordinatorPool.maxCoordinators	you should set this property to at least "1" to trigger ERXObjectStoreCoordinatorSynchronizer to turn on
er.extensions.jgroupsSynchronizer.properties	an XML JGroups configuration file (defaults to jgroups-default.xml in this framework)
er.extensions.remoteSynchronizer.enabled	if true, remote synchronization is enabled
er.extensions.remoteSynchronizer	"er.jgroups.ERJGroupsSynchronizer" for this implementation
er.extensions.jgroupsSynchronizer.multicastAddress	the multicast address to use (defaults to 230.0.0.1, and only necessary if you are using multicast)
er.extensions.jgroupsSynchronizer.multicastPort	the multicast port to use (defaults to 9753, and only necessary if you are using multicast)
er.extensions.jgroupsSynchronizer.groupName	the JGroups group name to use (defaults to WOApplication.application.name)
er.extensions.remoteSynchronizer.includeEntities	the list of entities to synchronize (all by default)
er.extensions.remoteSynchronizer.excludeEntities	the list of entities to NOT synchronize (none by default)
er.extensions.jgroupsSynchronizer.autoReconnect	whether to auto reconnect when shunned (defaults to false)
er.extensions.jgroupsSynchronizer.applicationWillTerminateNotificationName	the name of the NSNotification that is sent when the application is terminating. Leave blank to disable this feature.
er.extensions.jgroupsSynchronizer.useShutdownHook	whether to register a JVM shutdown hook to clean up the JChannel (defaults to true)

Nested Class Summary

Nested classes/interfaces inherited from class er.extensions.remoteSynchronizer.ERXRemoteSynchronizer

ERXRemoteSynchronizer.RefByteArrayOutputStream

Field Summary

Fields inherited from class er.extensions.remoteSynchronizer.ERXRemoteSynchronizer

log

Constructor Summary

ERJGroupsSynchronizer(ERXObjectStoreCoordinatorSynchronizer.IChangeListener listener)

Method Summary

void	_applicationWillTerminateNotification(com.webobjects.foundation.NSNotification notification)
protected void	_writeCacheChanges(int transactionID, com.webobjects.foundation.NSArray cacheChanges)
void	join()
void	leave()
void	listen()

Methods inherited from class er.extensions.remoteSynchronizer.ERXRemoteSynchronizer

_readCacheChange, _readGID, _writeCacheChange, addChange, filteredCacheChanges, globalIDsGroupedByEntity, handleMessageType, newRemoteSynchronizer, readGID, readGIDs, readKey, remoteSynchronizerEnabled, shouldSynchronizeEntity, writeCacheChanges, writeGID, writeGIDKeys, writeGIDs, writeKey, writeSnapshotCacheChange

Methods inherited from class java.lang.Object

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

Constructor Detail

ERJGroupsSynchronizer

public ERJGroupsSynchronizer(ERXObjectStoreCoordinatorSynchronizer.IChangeListener listener)
                      throws org.jgroups.ChannelException

Throws:

org.jgroups.ChannelException

Method Detail

join

public void join()
          throws org.jgroups.ChannelException

Specified by:

join in class ERXRemoteSynchronizer

Throws:

org.jgroups.ChannelException

leave

public void leave()

Specified by:

leave in class ERXRemoteSynchronizer

listen

public void listen()

Specified by:

listen in class ERXRemoteSynchronizer

_writeCacheChanges

protected void _writeCacheChanges(int transactionID,
                                  com.webobjects.foundation.NSArray cacheChanges)
                           throws org.jgroups.ChannelNotConnectedException,
                                  org.jgroups.ChannelClosedException,
                                  java.io.IOException

Specified by:

_writeCacheChanges in class ERXRemoteSynchronizer

Throws:

org.jgroups.ChannelNotConnectedException

org.jgroups.ChannelClosedException

java.io.IOException

_applicationWillTerminateNotification

public void _applicationWillTerminateNotification(com.webobjects.foundation.NSNotification notification)