view system-backend/src/main/java/com/redhat/thermostat/backend/system/VmStatusChangeNotifier.java @ 910:421d8a954893

Generic agent-side API for VM start/stop Introduce an API that all backends can use to find out when a VM starts up or shuts down. Currently, all backends re-implement this functionality using jvmstat explicitly. With an explicit API for this, we will have less duplicated code for each plugin and we can change/improve the implementation that detects when VMs start or stop without having to change each plugin. All classes implementing VmStatusChangeListener registered as OSGi services now get notified about the VM's pid when a vm starts or stops. The GC backend now obtains the pid from this new API but still uses the MonitoredVm class form jvmstat connect to the VM and gather data. Reviewed-by: ebaron, vanaltj Review-thread: http://icedtea.classpath.org/pipermail/thermostat/2013-January/005122.html PR1258
author Omair Majid <omajid@redhat.com>
date Tue, 15 Jan 2013 11:38:58 -0500
parents
children ccac9bcabaa0
line wrap: on
line source

/*
 * Copyright 2013 Red Hat, Inc.
 *
 * This file is part of Thermostat.
 *
 * Thermostat is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published
 * by the Free Software Foundation; either version 2, or (at your
 * option) any later version.
 *
 * Thermostat 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
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with Thermostat; see the file COPYING.  If not see
 * <http://www.gnu.org/licenses/>.
 *
 * Linking this code with other modules is making a combined work
 * based on this code.  Thus, the terms and conditions of the GNU
 * General Public License cover the whole combination.
 *
 * As a special exception, the copyright holders of this code give
 * you permission to link this code with independent modules to
 * produce an executable, regardless of the license terms of these
 * independent modules, and to copy and distribute the resulting
 * executable under terms of your choice, provided that you also
 * meet, for each linked independent module, the terms and conditions
 * of the license of that module.  An independent module is a module
 * which is not derived from or based on this code.  If you modify
 * this code, you may extend this exception to your version of the
 * library, but you are not obligated to do so.  If you do not wish
 * to do so, delete this exception statement from your version.
 */

package com.redhat.thermostat.backend.system;

import java.util.HashMap;
import java.util.Map;
import java.util.Map.Entry;
import java.util.Set;
import java.util.TreeSet;

import org.osgi.framework.BundleContext;
import org.osgi.framework.ServiceReference;
import org.osgi.util.tracker.ServiceTracker;

import com.redhat.thermostat.agent.VmStatusListener;
import com.redhat.thermostat.agent.VmStatusListener.Status;

/**
 * Notifies any and all {@link VmStatusListener} registered as OSGi Services
 * about VM status changes: {@link VmStatusListener.Status#VM_STARTED} and
 * {@link VmStatusListener.Status#VM_STOPPED}.
 * <p>
 * Any listeners registered after a {@link VmStatusListener.Status#VM_STARTED}
 * was delivered receive a {@link VmStatusListener.Status#VM_ACTIVE} event
 * instead as an indication that a VM was started at some unknown point
 * previously.
 */
public class VmStatusChangeNotifier {

    private final Object listenerLock = new Object();
    private final Set<Integer> activePids;
    private final Map<VmStatusListener, Set<Integer>> listeners = new HashMap<>();

    private final ServiceTracker tracker;

    public VmStatusChangeNotifier(BundleContext bundleContext) {
        this.activePids = new TreeSet<>();

        tracker = new ServiceTracker(bundleContext, VmStatusListener.class, null) {
            @Override
            public VmStatusListener addingService(ServiceReference reference) {
                VmStatusListener listener = (VmStatusListener) super.addingService(reference);

                synchronized (listenerLock) {
                    Set<Integer> notifiedAbout = new TreeSet<>();
                    for (Integer pid : activePids) {
                        listener.vmStatusChanged(Status.VM_ACTIVE, pid);
                        notifiedAbout.add(pid);
                    }

                    listeners.put(listener, notifiedAbout);
                }

                return listener;
            }

            @Override
            public void removedService(ServiceReference reference,
                    Object service) {
                VmStatusListener listener = (VmStatusListener) service;
                listeners.remove(listener);
                super.removedService(reference, service);
            }
        };
    }

    public void start() {
        tracker.open();
    }

    public void stop() {
        tracker.close();
    }

    /**
     * Notify all registered listeners about a Vm status change.
     *
     * @param newStatus either {@link VmStatusListener.Status#VM_STARTED} or
     * {@link VmStatusListener.Status#VM_STOPPED}
     * @param pid
     */
    public void notifyVmStatusChange(VmStatusListener.Status newStatus, int pid) {
        if (newStatus == Status.VM_ACTIVE) {
            throw new IllegalArgumentException("Dont pass in " + Status.VM_ACTIVE + ", that will be handled automatically");
        }

        synchronized (listenerLock) {
            for (Entry<VmStatusListener, Set<Integer>> entry : listeners.entrySet()) {
                entry.getKey().vmStatusChanged(newStatus, pid);
                entry.getValue().add(pid);
            }

            if (newStatus == Status.VM_STARTED) {
                activePids.add(pid);
            } else {
                activePids.remove(pid);
            }
        }
    }

}