AbstractRemoteTransport.java

/*
 * IronJacamar, a Java EE Connector Architecture implementation
 * Copyright 2014, Red Hat Inc, 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 Eclipse Public License 1.0 as
 * published by the Free Software Foundation.
 *
 * 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 Eclipse
 * Public License for more details.
 *
 * You should have received a copy of the Eclipse 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.ironjacamar.core.workmanager.transport.remote;

import org.ironjacamar.core.CoreLogger;
import org.ironjacamar.core.api.workmanager.DistributedWorkManager;
import org.ironjacamar.core.api.workmanager.DistributedWorkManagerStatisticsValues;
import org.ironjacamar.core.api.workmanager.StatisticsExecutor;
import org.ironjacamar.core.api.workmanager.WorkManager;
import org.ironjacamar.core.spi.workmanager.Address;
import org.ironjacamar.core.spi.workmanager.notification.NotificationListener;
import org.ironjacamar.core.spi.workmanager.transport.Transport;
import org.ironjacamar.core.workmanager.ClassBundle;
import org.ironjacamar.core.workmanager.ClassBundleFactory;
import org.ironjacamar.core.workmanager.WorkManagerCoordinator;
import org.ironjacamar.core.workmanager.WorkManagerEvent;
import org.ironjacamar.core.workmanager.WorkManagerEventQueue;
import org.ironjacamar.core.workmanager.transport.remote.ProtocolMessages.Request;

import java.io.Serializable;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.Map.Entry;
import java.util.Set;
import java.util.concurrent.ExecutorService;

import javax.resource.spi.work.DistributableWork;
import javax.resource.spi.work.WorkException;

import org.jboss.logging.Logger;

/**
 * An abstract transport for remote communication
 *
 * @author <a href="stefano.maestri@ironjacamar.org">Stefano Maestri</a>
 * @author <a href="jesper.pedersen@ironjacamar.org">Jesper Pedersen</a>
 * @param <T> the type
 */
public abstract class AbstractRemoteTransport<T> implements Transport
{
   /** The logger */
   private static CoreLogger log = Logger.getMessageLogger(CoreLogger.class, AbstractRemoteTransport.class.getName());

   /** Whether trace is enabled */
   private static boolean trace = log.isTraceEnabled();

   /** The identifier of the transport */
   private String id;

   /** The kernel executorService*/
   protected ExecutorService executorService;

   /** The nodes */
   protected Map<Address, T> nodes;

   /** the WorkManagerCoordinator */
   protected WorkManagerCoordinator workManagerCoordinator;

   /**
    * Constructor
    */
   public AbstractRemoteTransport()
   {
      this.executorService = null;
      this.nodes = Collections.synchronizedMap(new HashMap<Address, T>());
   }

   /**
    * {@inheritDoc}
    */
   public String getId()
   {
      return id;
   }

   /**
    * Set the identifier
    * @param id The value
    */
   public void setId(String id)
   {
      this.id = id;
   }

   /**
    * Set the workManagerCoordinator
    * @param wcc The workManagerCoordinator
    */
   public void setWorkManagerCoordinator(WorkManagerCoordinator wcc)
   {
      if (trace)
         log.tracef("WorkManagerCoordinator: %s", wcc);

      this.workManagerCoordinator = wcc;
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public long ping(Address address)
   {
      if (trace)
         log.tracef("PING(%s)", address);

      if (address.getTransportId() == null || getId().equals(address.getTransportId()))
         return localPing();

      long start = System.currentTimeMillis();
      try
      {
         T addr = nodes.get(address);
         sendMessage(addr, Request.PING);
      }
      catch (WorkException e1)
      {
         if (log.isDebugEnabled())
         {
            log.debug("Error", e1);
         }
         return Long.MAX_VALUE;
      }

      return System.currentTimeMillis() - start;
   }

   @Override
   public long getShortRunningFree(Address address)
   {
      if (trace)
         log.tracef("GET_SHORT_RUNNING_FREE(%s)", address);

      if (address.getTransportId() == null || getId().equals(address.getTransportId()))
         return localGetShortRunningFree(address);

      try
      {
         T addr = nodes.get(address);
         return (long)sendMessage(addr, Request.GET_SHORTRUNNING_FREE, address);
      }
      catch (WorkException e1)
      {
         if (log.isDebugEnabled())
         {
            log.debug("Error", e1);
         }
         return 0L;
      }
   }

   @Override
   public long getLongRunningFree(Address address)
   {
      if (trace)
         log.tracef("GET_LONGRUNNING_FREE(%s)", address);

      if (address.getTransportId() == null || getId().equals(address.getTransportId()))
         return localGetLongRunningFree(address);

      try
      {
         T addr = nodes.get(address);
         return (long)sendMessage(addr, Request.GET_LONGRUNNING_FREE, address);
      }
      catch (WorkException e1)
      {
         if (log.isDebugEnabled())
         {
            log.debug("Error", e1);
         }
         return 0L;
      }
   }

   @Override
   public void updateShortRunningFree(Address address, long freeCount)
   {
      if (trace)
         log.tracef("UPDATE_SHORT_RUNNING_FREE(%s, %d)", address, freeCount);

      localUpdateShortRunningFree(address, freeCount);

      if (address.getTransportId() != null && getId().equals(address.getTransportId()))
      {
         for (Entry<Address, T> entry : nodes.entrySet())
         {
            Address a = entry.getKey();
            if (!getId().equals(a.getTransportId()))
            {
               try
               {
                  sendMessage(entry.getValue(), Request.UPDATE_SHORTRUNNING_FREE, address, freeCount);
               }
               catch (WorkException e1)
               {
                  if (log.isDebugEnabled())
                  {
                     log.debug("Error", e1);
                  }
               }
            }
         }
      }
   }

   @Override
   public void updateLongRunningFree(Address address, long freeCount)
   {
      if (trace)
         log.tracef("UPDATE_LONG_RUNNING_FREE(%s, %d)", address, freeCount);

      localUpdateLongRunningFree(address, freeCount);

      if (address.getTransportId() != null && getId().equals(address.getTransportId()))
      {
         for (Entry<Address, T> entry : nodes.entrySet())
         {
            Address a = entry.getKey();
            if (!getId().equals(a.getTransportId()))
            {
               try
               {
                  sendMessage(entry.getValue(), Request.UPDATE_LONGRUNNING_FREE, address, freeCount);
               }
               catch (WorkException e1)
               {
                  if (log.isDebugEnabled())
                  {
                     log.debug("Error", e1);
                  }
               }
            }
         }
      }
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public DistributedWorkManagerStatisticsValues getDistributedStatistics(Address address)
   {
      if (trace)
         log.tracef("GET_DISTRIBUTED_STATISTICS(%s)", address);

      if (address.getTransportId() == null || getId().equals(address.getTransportId()))
         return localGetDistributedStatistics(address);

      try
      {
         T addr = nodes.get(address);
         return (DistributedWorkManagerStatisticsValues)sendMessage(addr, Request.GET_DISTRIBUTED_STATISTICS, address);
      }
      catch (WorkException e1)
      {
         if (log.isDebugEnabled())
         {
            log.debug("Error", e1);
         }
         return null;
      }
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public void clearDistributedStatistics(Address address)
   {
      if (trace)
         log.tracef("CLEAR_DISTRIBUTED_STATISTICS(%s)", address);

      if (!getId().equals(address.getTransportId()))
         localClearDistributedStatistics(address);

      if (address.getTransportId() != null && getId().equals(address.getTransportId()))
      {
         for (Entry<Address, T> entry : nodes.entrySet())
         {
            Address a = entry.getKey();
            if (!getId().equals(a.getTransportId()))
            {
               try
               {
                  sendMessage(entry.getValue(), Request.CLEAR_DISTRIBUTED_STATISTICS, address);
               }
               catch (WorkException e1)
               {
                  if (log.isDebugEnabled())
                  {
                     log.debug("Error", e1);
                  }
               }
            }
         }
      }
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public void deltaDoWorkAccepted(Address address)
   {
      if (trace)
         log.tracef("DELTA_DOWORK_ACCEPTED(%s)", address);

      if (address.getTransportId() != null && !getId().equals(address.getTransportId()))
      {
         try
         {
            T addr = nodes.get(address);
            sendMessage(addr, Request.DELTA_DOWORK_ACCEPTED, address);
         }
         catch (WorkException e1)
         {
            if (log.isDebugEnabled())
            {
               log.debug("Error", e1);
            }
         }
      }
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public void deltaDoWorkRejected(Address address)
   {
      if (trace)
         log.tracef("DELTA_DOWORK_REJECTED(%s)", address);

      if (address.getTransportId() != null && !getId().equals(address.getTransportId()))
      {
         try
         {
            T addr = nodes.get(address);
            sendMessage(addr, Request.DELTA_DOWORK_REJECTED, address);
         }
         catch (WorkException e1)
         {
            if (log.isDebugEnabled())
            {
               log.debug("Error", e1);
            }
         }
      }
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public void deltaStartWorkAccepted(Address address)
   {
      if (trace)
         log.tracef("DELTA_STARTWORK_ACCEPTED(%s)", address);

      if (address.getTransportId() != null && !getId().equals(address.getTransportId()))
      {
         try
         {
            T addr = nodes.get(address);
            sendMessage(addr, Request.DELTA_STARTWORK_ACCEPTED, address);
         }
         catch (WorkException e1)
         {
            if (log.isDebugEnabled())
            {
               log.debug("Error", e1);
            }
         }
      }
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public void deltaStartWorkRejected(Address address)
   {
      if (trace)
         log.tracef("DELTA_STARTWORK_REJECTED(%s)", address);

      if (address.getTransportId() != null && !getId().equals(address.getTransportId()))
      {
         try
         {
            T addr = nodes.get(address);
            sendMessage(addr, Request.DELTA_STARTWORK_REJECTED, address);
         }
         catch (WorkException e1)
         {
            if (log.isDebugEnabled())
            {
               log.debug("Error", e1);
            }
         }
      }
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public void deltaScheduleWorkAccepted(Address address)
   {
      if (trace)
         log.tracef("DELTA_SCHEDULEWORK_ACCEPTED(%s)", address);

      if (address.getTransportId() != null && !getId().equals(address.getTransportId()))
      {
         try
         {
            T addr = nodes.get(address);
            sendMessage(addr, Request.DELTA_SCHEDULEWORK_ACCEPTED, address);
         }
         catch (WorkException e1)
         {
            if (log.isDebugEnabled())
            {
               log.debug("Error", e1);
            }
         }
      }
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public void deltaScheduleWorkRejected(Address address)
   {
      if (trace)
         log.tracef("DELTA_SCHEDULEWORK_REJECTED(%s)", address);

      if (address.getTransportId() != null && !getId().equals(address.getTransportId()))
      {
         try
         {
            T addr = nodes.get(address);
            sendMessage(addr, Request.DELTA_SCHEDULEWORK_REJECTED, address);
         }
         catch (WorkException e1)
         {
            if (log.isDebugEnabled())
            {
               log.debug("Error", e1);
            }
         }
      }
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public void deltaWorkSuccessful(Address address)
   {
      if (trace)
         log.tracef("DELTA_WORK_SUCCESSFUL(%s)", address);

      if (address.getTransportId() != null && !getId().equals(address.getTransportId()))
      {
         try
         {
            T addr = nodes.get(address);
            sendMessage(addr, Request.DELTA_WORK_SUCCESSFUL, address);
         }
         catch (WorkException e1)
         {
            if (log.isDebugEnabled())
            {
               log.debug("Error", e1);
            }
         }
      }
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public void deltaWorkFailed(Address address)
   {
      if (trace)
         log.tracef("DELTA_WORK_FAILED(%s)", address);

      if (address.getTransportId() != null && !getId().equals(address.getTransportId()))
      {
         try
         {
            T addr = nodes.get(address);
            sendMessage(addr, Request.DELTA_WORK_FAILED, address);
         }
         catch (WorkException e1)
         {
            if (log.isDebugEnabled())
            {
               log.debug("Error", e1);
            }
         }
      }
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public void doWork(Address address, DistributableWork work) throws WorkException
   {
      if (trace)
         log.tracef("DO_WORK(%s, %s)", address, work);

      ClassBundle cb = ClassBundleFactory.createClassBundle(work);

      T addr = nodes.get(address);
      sendMessage(addr, Request.DO_WORK, address, cb, work);
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public void scheduleWork(Address address, DistributableWork work) throws WorkException
   {
      if (trace)
         log.tracef("SCHEDULE_WORK(%s, %s)", address, work);

      ClassBundle cb = ClassBundleFactory.createClassBundle(work);

      T addr = nodes.get(address);
      sendMessage(addr, Request.SCHEDULE_WORK, address, cb, work);
   }

   /**
    * {@inheritDoc}
    */
   @Override
   public long startWork(Address address, DistributableWork work) throws WorkException
   {
      if (trace)
         log.tracef("START_WORK(%s, %s)", address, work);

      ClassBundle cb = ClassBundleFactory.createClassBundle(work);

      T addr = nodes.get(address);
      return (long)sendMessage(addr, Request.START_WORK, address, cb, work);
   }

   /**
    * Get the executorService.
    *
    * @return the executorService.
    */
   public ExecutorService getExecutorService()
   {
      return executorService;
   }

   /**
    * Set the executorService.
    *
    * @param executorService The executorService to set.
    */
   public void setExecutorService(ExecutorService executorService)
   {
      this.executorService = executorService;
   }

   /**
    * {@inheritDoc}
    */
   public void register(Address address)
   {
      nodes.put(address, null);

      if (address.getTransportId() == null || address.getTransportId().equals(getId()))
      {
         Set<T> sent = new HashSet<T>();
         for (T addr : nodes.values())
         {
            if (addr != null && !sent.contains(addr))
            {
               sent.add(addr);
               try
               {
                  sendMessage(addr, Request.WORKMANAGER_ADD, address, (Serializable)getOwnAddress());
               }
               catch (Throwable t)
               {
                  log.error("Register " + t.getMessage(), t);
               }
            }
         }
      }
   }

   /**
    * {@inheritDoc}
    */
   public void unregister(Address address)
   {
      nodes.remove(address);

      if (address.getTransportId() == null || address.getTransportId().equals(getId()))
      {
         Set<T> sent = new HashSet<T>();
         for (T addr : nodes.values())
         {
            if (addr != null && !sent.contains(addr))
            {
               sent.add(addr);
               try
               {
                  sendMessage(addr, Request.WORKMANAGER_REMOVE, address);
               }
               catch (Throwable t)
               {
                  log.error("Unregister: " + t.getMessage(), t);
               }
            }
         }
      }
   }

   /**
    * Get the addresses
    * @param physicalAddress the physical address
    * @return The logical addresses associated
    */
   public Set<Address> getAddresses(T physicalAddress)
   {
      Set<Address> result = new HashSet<Address>();

      for (Entry<Address, T> entry : nodes.entrySet())
      {
         if (entry.getValue() == null || entry.getValue().equals(physicalAddress))
         {
            result.add(entry.getKey());
         }
      }

      if (trace)
         log.tracef("Addresses: %s", result);

      return Collections.unmodifiableSet(result);
   }

   /**
    * join
    * @param logicalAddress the logical address
    * @param physicalAddress the physical address
    */
   public void join(Address logicalAddress, T physicalAddress)
   {
      if (trace)
         log.tracef("JOIN(%s, %s)", logicalAddress, physicalAddress);

      if (!nodes.containsKey(logicalAddress))
      {
         nodes.put(logicalAddress, physicalAddress);

         DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(logicalAddress);

         if (dwm != null)
         {
            Collection<NotificationListener> copy =
               new ArrayList<NotificationListener>(dwm.getNotificationListeners());
            for (NotificationListener nl : copy)
            {
               nl.join(logicalAddress);
            }
         }
         else
         {
            WorkManagerEventQueue wmeq = WorkManagerEventQueue.getInstance();
            wmeq.addEvent(new WorkManagerEvent(WorkManagerEvent.TYPE_JOIN, logicalAddress));
         }
      }
   }

   /**
    * leave
    * @param physicalAddress the physical address
    */
   public void leave(T physicalAddress)
   {
      if (trace)
         log.tracef("LEAVE(%s)", physicalAddress);

      Set<Address> remove = new HashSet<Address>();

      for (Entry<Address, T> entry : nodes.entrySet())
      {
         if (physicalAddress.equals(entry.getValue()))
         {
            remove.add(entry.getKey());
         }
      }

      if (!remove.isEmpty())
      {

         for (Address logicalAddress : remove)
         {
            nodes.remove(logicalAddress);

            DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(logicalAddress);

            if (dwm != null)
            {
               Collection<NotificationListener> copy =
                  new ArrayList<NotificationListener>(dwm.getNotificationListeners());
               for (NotificationListener nl : copy)
               {
                  nl.leave(logicalAddress);
               }
            }
            else
            {
               WorkManagerEventQueue wmeq = WorkManagerEventQueue.getInstance();
               wmeq.addEvent(new WorkManagerEvent(WorkManagerEvent.TYPE_LEAVE, logicalAddress));
            }
         }
      }
   }

   /**
    * localPing
    * @return the ping value
    */
   public long localPing()
   {
      if (trace)
         log.tracef("LOCAL_PING()");

      return 0L;
   }

   /**
    * localWorkManagerAdd
    *
    * @param address the logical address
    * @param physicalAddress the physical address
    */
   public void localWorkManagerAdd(Address address, T physicalAddress)
   {
      if (trace)
         log.tracef("LOCAL_WORKMANAGER_ADD(%s, %s)", address, physicalAddress);

      join(address, physicalAddress);
   }

   /**
    * localWorkManagerRemove
    *
    * @param address the logical address
    */
   public void localWorkManagerRemove(Address address)
   {
      if (trace)
         log.tracef("LOCAL_WORKMANAGER_REMOVE(%s)", address);

      nodes.remove(address);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      if (dwm != null)
      {
         Collection<NotificationListener> copy =
            new ArrayList<NotificationListener>(dwm.getNotificationListeners());
         for (NotificationListener nl : copy)
         {
            nl.leave(address);
         }
      }
      else
      {
         WorkManagerEventQueue wmeq = WorkManagerEventQueue.getInstance();
         wmeq.addEvent(new WorkManagerEvent(WorkManagerEvent.TYPE_LEAVE, address));
      }
   }

   /**
    * localDoWork
    *
    * @param address the logical address
    * @param work the work
    * @throws WorkException in case of error
    */
   public void localDoWork(Address address, DistributableWork work) throws WorkException
   {
      if (trace)
         log.tracef("LOCAL_DO_WORK(%s, %s)", address, work);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      dwm.localDoWork(work);
   }

   /**
    * localStartWork
    *
    * @param address the logical address
    * @param work the work
    * @return the start value
    * @throws WorkException in case of error
    */
   public long localStartWork(Address address, DistributableWork work) throws WorkException
   {
      if (trace)
         log.tracef("LOCAL_START_WORK(%s, %s)", address, work);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      return dwm.localStartWork(work);
   }

   /**
    * localScheduleWork
    *
    * @param address the logical address
    * @param work the work
    * @throws WorkException in case of error
    */
   public void localScheduleWork(Address address, DistributableWork work) throws WorkException
   {
      if (trace)
         log.tracef("LOCAL_SCHEDULE_WORK(%s, %s)", address, work);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      dwm.localScheduleWork(work);
   }

   /**
    * localGetShortRunningFree
    *
    * @param address the logical address
    * @return the free count
    */
   public long localGetShortRunningFree(Address address)
   {
      if (trace)
         log.tracef("LOCAL_GET_SHORTRUNNING_FREE(%s)", address);

      WorkManager wm = workManagerCoordinator.resolveWorkManager(address);

      if (wm != null)
      {
         StatisticsExecutor executor = wm.getShortRunningThreadPool();
         if (executor != null)
            return executor.getNumberOfFreeThreads();
      }

      return 0L;
   }

   /**
    * localGetLongRunningFree
    *
    * @param address the logical address
    * @return the free count
    */
   public long localGetLongRunningFree(Address address)
   {
      if (trace)
         log.tracef("LOCAL_GET_LONGRUNNING_FREE(%s)", address);

      WorkManager wm = workManagerCoordinator.resolveWorkManager(address);

      if (wm != null)
      {
         StatisticsExecutor executor = wm.getLongRunningThreadPool();
         if (executor != null)
            return executor.getNumberOfFreeThreads();
      }

      return 0L;
   }

   /**
    * localUpdateShortRunningFree
    *
    * @param logicalAddress the logical address
    * @param freeCount the free count
    */
   public void localUpdateShortRunningFree(Address logicalAddress, Long freeCount)
   {
      if (trace)
         log.tracef("LOCAL_UPDATE_SHORTRUNNING_FREE(%s, %d)", logicalAddress, freeCount);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(logicalAddress);

      if (dwm != null)
      {
         Collection<NotificationListener> copy =
            new ArrayList<NotificationListener>(dwm.getNotificationListeners());
         for (NotificationListener nl : copy)
         {
            nl.updateShortRunningFree(logicalAddress, freeCount);
         }
      }
      else
      {
         WorkManagerEventQueue wmeq = WorkManagerEventQueue.getInstance();
         wmeq.addEvent(new WorkManagerEvent(WorkManagerEvent.TYPE_UPDATE_SHORT_RUNNING, logicalAddress, freeCount));
      }
   }

   /**
    * localUpdateLongRunningFree
    *
    * @param logicalAddress the logical address
    * @param freeCount the free count
    */
   public void localUpdateLongRunningFree(Address logicalAddress, Long freeCount)
   {
      if (trace)
         log.tracef("LOCAL_UPDATE_LONGRUNNING_FREE(%s, %d)", logicalAddress, freeCount);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(logicalAddress);

      if (dwm != null)
      {
         Collection<NotificationListener> copy =
            new ArrayList<NotificationListener>(dwm.getNotificationListeners());
         for (NotificationListener nl : copy)
         {
            nl.updateLongRunningFree(logicalAddress, freeCount);
         }
      }
      else
      {
         WorkManagerEventQueue wmeq = WorkManagerEventQueue.getInstance();
         wmeq.addEvent(new WorkManagerEvent(WorkManagerEvent.TYPE_UPDATE_LONG_RUNNING, logicalAddress, freeCount));
      }
   }

   /**
    * localGetDistributedStatistics
    *
    * @param address the logical address
    * @return The value
    */
   public DistributedWorkManagerStatisticsValues localGetDistributedStatistics(Address address)
   {
      if (trace)
         log.tracef("LOCAL_GET_DISTRIBUTED_STATISTICS(%s)", address);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      if (dwm != null)
      {
         DistributedWorkManagerStatisticsValues values =
            new DistributedWorkManagerStatisticsValues(dwm.getDistributedStatistics().getWorkSuccessful(),
                                                       dwm.getDistributedStatistics().getWorkFailed(),
                                                       dwm.getDistributedStatistics().getDoWorkAccepted(),
                                                       dwm.getDistributedStatistics().getDoWorkRejected(),
                                                       dwm.getDistributedStatistics().getScheduleWorkAccepted(),
                                                       dwm.getDistributedStatistics().getScheduleWorkRejected(),
                                                       dwm.getDistributedStatistics().getStartWorkAccepted(),
                                                       dwm.getDistributedStatistics().getStartWorkRejected());

         return values;
      }

      return null;
   }

   /**
    * localClearDistributedStatistics
    *
    * @param logicalAddress the logical address
    */
   public void localClearDistributedStatistics(Address logicalAddress)
   {
      if (trace)
         log.tracef("LOCAL_CLEAR_DISTRIBUTED_STATISTICS(%s)", logicalAddress);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(logicalAddress);

      if (dwm != null && dwm.isDistributedStatisticsEnabled())
      {
         DistributedWorkManagerStatisticsValues v =
            new DistributedWorkManagerStatisticsValues(0, 0, 0, 0, 0, 0, 0, 0);
         dwm.getDistributedStatistics().initialize(v);
      }
   }

   /**
    * Local delta doWork accepted
    * @param address the logical address
    */
   public void localDeltaDoWorkAccepted(Address address)
   {
      if (trace)
         log.tracef("LOCAL_DELTA_DOWORK_ACCEPTED(%s)", address);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      if (dwm != null)
      {
         Collection<NotificationListener> copy =
            new ArrayList<NotificationListener>(dwm.getNotificationListeners());
         for (NotificationListener nl : copy)
         {
            nl.deltaDoWorkAccepted();
         }
      }
   }

   /**
    * Local delta doWork rejected
    * @param address the logical address
    */
   public void localDeltaDoWorkRejected(Address address)
   {
      if (trace)
         log.tracef("LOCAL_DELTA_DOWORK_REJECTED(%s)", address);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      if (dwm != null)
      {
         Collection<NotificationListener> copy =
            new ArrayList<NotificationListener>(dwm.getNotificationListeners());
         for (NotificationListener nl : copy)
         {
            nl.deltaDoWorkRejected();
         }
      }
   }

   /**
    * Local delta startWork accepted
    * @param address the logical address
    */
   public void localDeltaStartWorkAccepted(Address address)
   {
      if (trace)
         log.tracef("LOCAL_DELTA_STARTWORK_ACCEPTED(%s)", address);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      if (dwm != null)
      {
         Collection<NotificationListener> copy =
            new ArrayList<NotificationListener>(dwm.getNotificationListeners());
         for (NotificationListener nl : copy)
         {
            nl.deltaStartWorkAccepted();
         }
      }
   }

   /**
    * Local delta startWork rejected
    * @param address the logical address
    */
   public void localDeltaStartWorkRejected(Address address)
   {
      if (trace)
         log.tracef("LOCAL_DELTA_STARTWORK_REJECTED(%s)", address);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      if (dwm != null)
      {
         Collection<NotificationListener> copy =
            new ArrayList<NotificationListener>(dwm.getNotificationListeners());
         for (NotificationListener nl : copy)
         {
            nl.deltaStartWorkRejected();
         }
      }
   }

   /**
    * Local delta scheduleWork accepted
    * @param address the logical address
    */
   public void localDeltaScheduleWorkAccepted(Address address)
   {
      if (trace)
         log.tracef("LOCAL_DELTA_SCHEDULEWORK_ACCEPTED(%s)", address);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      if (dwm != null)
      {
         Collection<NotificationListener> copy =
            new ArrayList<NotificationListener>(dwm.getNotificationListeners());
         for (NotificationListener nl : copy)
         {
            nl.deltaScheduleWorkAccepted();
         }
      }
   }

   /**
    * Local delta scheduleWork rejected
    * @param address the logical address
    */
   public void localDeltaScheduleWorkRejected(Address address)
   {
      if (trace)
         log.tracef("LOCAL_DELTA_SCHEDULEWORK_REJECTED(%s)", address);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      if (dwm != null)
      {
         Collection<NotificationListener> copy =
            new ArrayList<NotificationListener>(dwm.getNotificationListeners());
         for (NotificationListener nl : copy)
         {
            nl.deltaScheduleWorkRejected();
         }
      }
   }

   /**
    * Local delta work successful
    * @param address the logical address
    */
   public void localDeltaWorkSuccessful(Address address)
   {
      if (trace)
         log.tracef("LOCAL_DELTA_WORK_SUCCESSFUL(%s)", address);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      if (dwm != null)
      {
         Collection<NotificationListener> copy =
            new ArrayList<NotificationListener>(dwm.getNotificationListeners());
         for (NotificationListener nl : copy)
         {
            nl.deltaWorkSuccessful();
         }
      }
   }

   /**
    * Local delta work failed
    * @param address the logical address
    */
   public void localDeltaWorkFailed(Address address)
   {
      if (trace)
         log.tracef("LOCAL_DELTA_WORK_FAILED(%s)", address);

      DistributedWorkManager dwm = workManagerCoordinator.resolveDistributedWorkManager(address);

      if (dwm != null)
      {
         Collection<NotificationListener> copy =
            new ArrayList<NotificationListener>(dwm.getNotificationListeners());
         for (NotificationListener nl : copy)
         {
            nl.deltaWorkFailed();
         }
      }
   }

   /**
    * Get the own address
    * @return The value
    */
   protected abstract T getOwnAddress();

   /**
    * send a messagge using specific protocol. Method overridden in specific protocol implementation classes
    *
    * @param physicalAddress the physical address
    * @param request the request
    * @param parameters the parameters
    * @return the returned value. Can be null if requested operation return a void
    * @throws WorkException in case of problem with the work
    */
   protected abstract Serializable sendMessage(T physicalAddress, Request request, Serializable... parameters)
      throws WorkException;
}