/*
* JBoss, Home of Professional Open Source.
* Copyright 2008, Red Hat Middleware LLC, and individual contributors
* as indicated by the @author tags. See the copyright.txt file in the
* distribution for a full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.cache.invalidation.bridges;
import java.io.Serializable;
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import java.util.Vector;
import org.jboss.cache.invalidation.BatchInvalidation;
import org.jboss.cache.invalidation.BridgeInvalidationSubscription;
import org.jboss.cache.invalidation.InvalidationBridgeListener;
import org.jboss.cache.invalidation.InvalidationGroup;
import org.jboss.cache.invalidation.InvalidationManagerMBean;
import org.jboss.ha.framework.interfaces.DistributedReplicantManager;
import org.jboss.ha.framework.interfaces.DistributedState;
import org.jboss.ha.framework.interfaces.HAPartition;
/**
* JGroups implementation of a cache invalidation bridge
*
* @see JGCacheInvalidationBridgeMBean
*
* @author <a href="mailto:sacha.labourey@cogito-info.ch">Sacha Labourey</a>.
* @version $Revision: 104447 $
*
* <p><b>Revisions:</b>
*
* <p><b>24 septembre 2002 Sacha Labourey:</b>
* <ul>
* <li> First implementation </li>
* </ul>
*/
@SuppressWarnings("deprecation")
public class JGCacheInvalidationBridge
extends org.jboss.system.ServiceMBeanSupport
implements JGCacheInvalidationBridgeMBean,
DistributedState.DSListenerEx,
InvalidationBridgeListener,
DistributedReplicantManager.ReplicantListener
{
// Constants -----------------------------------------------------
protected final static Class<?>[] rpc_invalidate_types = new Class[] { String.class, Serializable.class };
protected final static Class<?>[] rpc_invalidates_types = new Class[] { String.class, Serializable[].class };
protected final static Class<?>[] rpc_invalidate_all_types = new Class[] { String.class };
protected final static Class<?>[] rpc_batch_invalidate_types = new Class[] { BatchInvalidation[].class };
// Attributes ----------------------------------------------------
/**
* The ClusterPartition with which we are associated.
*/
protected volatile HAPartition partition;
protected volatile String bridgeName = "DefaultJGCacheIB";
protected volatile InvalidationManagerMBean invalMgr = null;
protected String RPC_HANDLER_NAME = null;
protected BridgeInvalidationSubscription invalidationSubscription = null;
protected Collection<InvalidationGroup> localGroups = null;
protected Vector<String> bridgedGroups = new Vector<String>();
// Public --------------------------------------------------------
// JGCacheInvalidationBridgeMBean implementation ----------------------------------------------
public HAPartition getHAPartition()
{
return this.partition;
}
public void setHAPartition(HAPartition clusterPartition)
{
this.partition = clusterPartition;
}
public String getPartitionName()
{
return this.partition.getPartitionName();
}
public String getBridgeName()
{
return this.bridgeName;
}
public void setBridgeName(String name)
{
this.bridgeName = name;
}
// DistributedReplicantManager.ReplicantListener implementation ---------------------------
/**
* @todo examine thread safety. synchronized keyword was added to method
* signature when internal behavior of DistributedReplicantManagerImpl was
* changed so that multiple threads could concurrently send replicantsChanged
* notifications. Need to examine in detail how this method interacts with
* DistributedState to see if we can remove/narrow the synchronization.
*/
public synchronized void replicantsChanged(String key, List<?> newReplicants, int newReplicantsViewId,
boolean merge)
{
DistributedReplicantManager drm = this.partition.getDistributedReplicantManager();
if (key.equals(this.RPC_HANDLER_NAME) && drm.isMasterReplica(this.RPC_HANDLER_NAME))
{
this.log.debug("The list of replicants for the JG bridge has changed, computing and updating local info...");
DistributedState ds = this.partition.getDistributedStateService();
// we remove any entry from the DS whose node is dead
//
Collection<?> coll = ds.getAllKeys(this.RPC_HANDLER_NAME);
if (coll == null)
{
this.log.debug("... No bridge info was associated with this node");
return;
}
// to avoid ConcurrentModificationException, we copy the list of keys in a new structure
//
ArrayList<?> collCopy = new ArrayList<Object>(coll);
List<String> newReplicantsNodeNames = drm.lookupReplicantsNodeNames(this.RPC_HANDLER_NAME);
for (int i = 0; i < collCopy.size(); i++)
{
String nodeEntry = (String) collCopy.get(i);
if (!newReplicantsNodeNames.contains(nodeEntry))
{
// the list of bridged topic contains a dead member: we remove it
//
try
{
this.log.debug("removing bridge information associated with this node from the DS");
ds.remove(this.RPC_HANDLER_NAME, nodeEntry, true);
}
catch (Exception e)
{
this.log.info("Unable to remove a node entry from the distributed cache", e);
}
}
}
}
}
// DistributedState.DSListener implementation ----------------------------------------------
public void valueHasChanged(String category, Serializable key, Serializable value, boolean locallyModified)
{
this.updatedBridgedInvalidationGroupsInfo();
}
public void keyHasBeenRemoved(String category, Serializable key, Serializable previousContent,
boolean locallyModified)
{
this.updatedBridgedInvalidationGroupsInfo();
}
// InvalidationBridgeListener implementation ----------------------------------------------
public void batchInvalidate(BatchInvalidation[] invalidations, boolean asynchronous)
{
if (invalidations == null) return;
// we need to sort which group other nodes accept or refuse and propagate through the net
//
List<BatchInvalidation> acceptedGroups = new ArrayList<BatchInvalidation>();
for (BatchInvalidation currBI : invalidations)
{
if (this.groupExistsRemotely(currBI.getInvalidationGroupName()))
{
acceptedGroups.add(currBI);
}
}
if (acceptedGroups.size() > 0)
{
BatchInvalidation[] result = new BatchInvalidation[acceptedGroups.size()];
result = (BatchInvalidation[]) acceptedGroups.toArray(result);
if (this.log.isTraceEnabled())
{
this.log.trace("Transmitting batch invalidation: " + result);
}
this._do_rpc_batchInvalidate(result, asynchronous);
}
}
public void invalidate(String invalidationGroupName, Serializable[] keys, boolean asynchronous)
{
// if the group exists on another node, we simply propagate to other nodes
//
if (this.log.isTraceEnabled())
{
this.log.trace("Transmitting invalidations for group: " + invalidationGroupName);
}
if (this.groupExistsRemotely(invalidationGroupName))
{
this._do_rpc_invalidates(invalidationGroupName, keys, asynchronous);
}
}
public void invalidate(String invalidationGroupName, Serializable key, boolean asynchronous)
{
// if the group exists on another node, we simply propagate to other nodes
//
if (this.log.isTraceEnabled())
{
this.log.trace("Transmitting invalidation for group: " + invalidationGroupName);
}
if (this.groupExistsRemotely(invalidationGroupName))
{
this._do_rpc_invalidate(invalidationGroupName, key, asynchronous);
}
}
public void invalidateAll(String groupName, boolean async)
{
if (this.log.isTraceEnabled())
{
this.log.trace("Transmitting for all entries for invalidation for group: " + groupName);
}
if (this.groupExistsRemotely(groupName))
{
this._do_rpc_invalidate_all(groupName, async);
}
}
public void newGroupCreated(String groupInvalidationName)
{
try
{
this.publishLocalInvalidationGroups();
//this.updatedBridgedInvalidationGroupsInfo ();
}
catch (Exception e)
{
this.log.info("Problem while registering a new invalidation group over the cluster", e);
}
}
public void groupIsDropped(String groupInvalidationName)
{
try
{
this.publishLocalInvalidationGroups();
//this.updatedBridgedInvalidationGroupsInfo ();
}
catch (Exception e)
{
this.log.info("Problem while un-registering a new invalidation group over the cluster", e);
}
}
// Bean configuration properties ---------------------------------------------------
public InvalidationManagerMBean getInvalidationManager()
{
return this.invalMgr;
}
public void setInvalidationManager(InvalidationManagerMBean manager)
{
this.invalMgr = manager;
}
// ServiceMBeanSupport overrides ---------------------------------------------------
@Override
public void startService() throws Exception
{
if (this.partition == null)
throw new IllegalStateException("HAPartition property must be set before starting InvalidationBridge service");
this.RPC_HANDLER_NAME = "DCacheBridge-" + this.bridgeName;
DistributedReplicantManager drm = this.partition.getDistributedReplicantManager();
DistributedState ds = this.partition.getDistributedStateService();
drm.add(this.RPC_HANDLER_NAME, "");
drm.registerListener(this.RPC_HANDLER_NAME, this);
ds.registerDSListenerEx(this.RPC_HANDLER_NAME, this);
this.partition.registerRPCHandler(this.RPC_HANDLER_NAME, this);
// we now publish the list of caches we have access to
if (this.invalMgr == null)
{
throw new IllegalStateException("Failed to find an InvalidationManagerMBean, ensure one is injected");
}
this.publishLocalInvalidationGroups();
this.updatedBridgedInvalidationGroupsInfo();
this.invalidationSubscription = this.invalMgr.registerBridgeListener(this);
}
@Override
public void stopService()
{
DistributedReplicantManager drm = this.partition.getDistributedReplicantManager();
DistributedState ds = this.partition.getDistributedStateService();
try
{
this.partition.unregisterRPCHandler(this.RPC_HANDLER_NAME, this);
ds.unregisterDSListenerEx(this.RPC_HANDLER_NAME, this);
drm.unregisterListener(this.RPC_HANDLER_NAME, this);
drm.remove(this.RPC_HANDLER_NAME);
this.invalidationSubscription.unregister();
ds.remove(this.RPC_HANDLER_NAME, this.partition.getNodeName(), true);
// this.invalMgr = null;
// partition = null;
this.invalidationSubscription = null;
this.RPC_HANDLER_NAME = null;
this.localGroups = null;
this.bridgedGroups = new Vector<String>();
}
catch (Exception e)
{
this.log.info("Problem while shuting down invalidation cache bridge", e);
}
}
// RPC calls ---------------------------------------------
public void _rpc_invalidate(String invalidationGroupName, Serializable key)
{
if (this.log.isTraceEnabled())
{
this.log.trace("Received remote invalidation for group: " + invalidationGroupName);
}
this.invalidationSubscription.invalidate(invalidationGroupName, key);
}
public void _rpc_invalidates(String invalidationGroupName, Serializable[] keys)
{
if (this.log.isTraceEnabled())
{
this.log.trace("Received remote invalidations for group: " + invalidationGroupName);
}
this.invalidationSubscription.invalidate(invalidationGroupName, keys);
}
public void _rpc_invalidate_all(String invalidationGroupName)
{
if (this.log.isTraceEnabled())
{
this.log.trace("Received remote invalidate_all for group: " + invalidationGroupName);
}
this.invalidationSubscription.invalidateAll(invalidationGroupName);
}
public void _rpc_batchInvalidate(BatchInvalidation[] invalidations)
{
if (this.log.isTraceEnabled() && invalidations != null)
{
this.log.trace("Received remote batch invalidation for this number of groups: " + invalidations.length);
}
this.invalidationSubscription.batchInvalidate(invalidations);
}
protected void _do_rpc_invalidate(String invalidationGroupName, Serializable key, boolean asynch)
{
Object[] params = new Object[] { invalidationGroupName, key };
try
{
if (asynch)
{
this.partition.callAsynchMethodOnCluster(this.RPC_HANDLER_NAME, "_rpc_invalidate", params,
rpc_invalidate_types, true);
}
else
{
this.partition.callMethodOnCluster(this.RPC_HANDLER_NAME, "_rpc_invalidate", params,
rpc_invalidate_types, true);
}
}
catch (Exception e)
{
this.log.debug("Distributed invalidation (1) has failed for group " + invalidationGroupName + " (Bridge: "
+ this.bridgeName + ")");
}
}
protected void _do_rpc_invalidates(String invalidationGroupName, Serializable[] keys, boolean asynch)
{
Object[] params = new Object[] { invalidationGroupName, keys };
try
{
if (asynch)
{
this.partition.callAsynchMethodOnCluster(this.RPC_HANDLER_NAME, "_rpc_invalidates", params,
rpc_invalidates_types, true);
}
else
{
this.partition.callMethodOnCluster(this.RPC_HANDLER_NAME, "_rpc_invalidates", params,
rpc_invalidates_types, true);
}
}
catch (Exception e)
{
this.log.debug("Distributed invalidation (2) has failed for group " + invalidationGroupName + " (Bridge: "
+ this.bridgeName + ")");
}
}
protected void _do_rpc_invalidate_all(String invalidationGroupName, boolean asynch)
{
Object[] params = new Object[] { invalidationGroupName };
try
{
if (asynch)
{
this.partition.callAsynchMethodOnCluster(this.RPC_HANDLER_NAME, "_rpc_invalidate_all", params,
rpc_invalidate_all_types, true);
}
else
{
this.partition.callMethodOnCluster(this.RPC_HANDLER_NAME, "_rpc_invalidate_all", params,
rpc_invalidate_all_types, true);
}
}
catch (Exception e)
{
this.log.debug("Distributed invalidation (2) has failed for group " + invalidationGroupName + " (Bridge: "
+ this.bridgeName + ")");
}
}
protected void _do_rpc_batchInvalidate(BatchInvalidation[] invalidations, boolean asynch)
{
Object[] params = new Object[] { invalidations };
try
{
if (asynch)
{
this.partition.callAsynchMethodOnCluster(this.RPC_HANDLER_NAME, "_rpc_batchInvalidate", params,
rpc_batch_invalidate_types, true);
}
else
{
this.partition.callMethodOnCluster(this.RPC_HANDLER_NAME, "_rpc_batchInvalidate", params,
rpc_batch_invalidate_types, true);
}
}
catch (Exception e)
{
this.log.debug("Distributed invalidation (3) has failed (Bridge: " + this.bridgeName + ")");
}
}
// Package protected ---------------------------------------------
// Protected -----------------------------------------------------
@SuppressWarnings("unchecked")
protected synchronized void publishLocalInvalidationGroups() throws Exception
{
this.localGroups = this.invalMgr.getInvalidationGroups();
this.log.debug("Publishing locally available invalidation groups: " + this.localGroups);
ArrayList<InvalidationGroup> content = new ArrayList<InvalidationGroup>(this.localGroups);
ArrayList<String> result = new ArrayList<String>(content.size());
for (int i = 0; i < content.size(); i++)
{
String aGroup = content.get(i).getGroupName();
result.add(aGroup);
}
String nodeName = this.partition.getNodeName();
DistributedState ds = this.partition.getDistributedStateService();
if (result.size() > 0)
{
NodeInfo info = new NodeInfo(result, nodeName);
ds.set(this.RPC_HANDLER_NAME, nodeName, info, true);
}
else
{
ds.remove(this.RPC_HANDLER_NAME, nodeName, true);
}
}
protected void updatedBridgedInvalidationGroupsInfo()
{
@SuppressWarnings("unchecked")
Collection<NodeInfo> bridgedByNode = (Collection<NodeInfo>) this.partition.getDistributedStateService().getAllValues(this.RPC_HANDLER_NAME);
this.log.debug("Updating list of invalidation groups that are bridged...");
if (bridgedByNode != null)
{
// Make a copy
//
List<NodeInfo> copy = new ArrayList<NodeInfo>(bridgedByNode);
Vector<String> result = new Vector<String>();
String nodeName = this.partition.getNodeName();
for (NodeInfo infoForNode : copy)
{
this.log.trace("InfoForNode: " + infoForNode);
if (infoForNode != null && !infoForNode.groupName.equals(nodeName))
{
ArrayList<String> groupsForNode = infoForNode.groups;
this.log.trace("Groups for node: " + groupsForNode);
for (String aGroup : groupsForNode)
{
if (!result.contains(aGroup))
{
this.log.trace("Adding: " + aGroup);
result.add(aGroup);
}
}
}
}
// atomic assignation of the result
//
this.bridgedGroups = result;
this.log.debug("... computed list of bridged groups: " + result);
}
else
{
this.log.debug("... nothing needs to be bridged.");
}
}
protected boolean groupExistsRemotely(String groupName)
{
return this.bridgedGroups.contains(groupName);
}
// Private -------------------------------------------------------
// Inner classes -------------------------------------------------
}
class NodeInfo implements java.io.Serializable
{
static final long serialVersionUID = -3215712955134929006L;
public ArrayList<String> groups = null;
public String groupName = null;
public NodeInfo()
{
}
public NodeInfo(ArrayList<String> groups, String groupName)
{
this.groups = groups;
this.groupName = groupName;
}
}