com.zenoss.zenpacks.zenjmx.call.Utility.java Source code

Introduction

Here is the source code for com.zenoss.zenpacks.zenjmx.call.Utility.java

Source

/*****************************************************************************
 * 
 * Copyright (C) Zenoss, Inc. 2008, all rights reserved.
 * 
 * This content is made available according to terms specified in
 * License.zenoss under the directory where your Zenoss product is installed.
 * 
 ****************************************************************************/

package com.zenoss.zenpacks.zenjmx.call;

import java.io.ByteArrayOutputStream;
import java.io.PrintStream;
import java.util.ArrayList;
import java.util.List;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

import com.zenoss.jmx.JmxException;
import com.zenoss.zenpacks.zenjmx.ConfigAdapter;

/**
 * <p> Commonly used methods.  </p>
 *
 * <p>$Author: chris $</p>
 *
 * @author Christopher Blunck
 * @version $Revision: 1.6 $
 */
public class Utility {

    private static final Log _logger = LogFactory.getLog(Utility.class);

    /**
     * Creates a URL based on the configuration provided.
     * @returns a jmx connection url
     * @throws ConfigurationException if the url is invalid (if the hostname 
     *         or port cannot be found in the configuration)
     */
    public static String getUrl(ConfigAdapter config) throws ConfigurationException {

        String jmxRawService = config.getJmxRawService();
        String url = null;

        // allow users to specify a raw JMX url
        if (jmxRawService != null && !jmxRawService.equals("")) {
            _logger.debug("using JMX Raw URL option");
            url = jmxRawService;
        }
        // old fashioned JMX url building
        else {
            String port = config.getJmxPort();
            String rmiContext = config.getRmiContext();

            if (rmiContext == null || "".equals(rmiContext)) {
                rmiContext = "jmxrmi"; //default context for mbean server
            }

            String protocol = config.getJmxProtocol();
            if ("".equals(port)) {
                String message = " jmxPort or zJmxManagementPort not specified";
                throw new ConfigurationException("Datasource " + config.getDatasourceId() + message);
            }

            String hostAddr = config.getManageIp();

            if ((hostAddr == null) || ("".equals(hostAddr.trim()))) {
                String message = " manageIp or device properties not specified";
                throw new ConfigurationException("Datasource " + config.getDatasourceId() + message);
            }
            if (hostAddr.indexOf(':') != -1) {
                // IPv6 literal address
                hostAddr = '[' + hostAddr + ']';
            }

            url = "service:jmx:";
            if (protocol.equals("JMXMP"))
                url += "jmxmp://" + hostAddr + ":" + port;
            else if (protocol.equals("REMOTING-JMX"))
                url += "remoting-jmx://" + hostAddr + ":" + port;
            else
                url += "rmi:///jndi/rmi://" + hostAddr + ":" + port + "/" + rmiContext;
        }

        _logger.debug("JMX URL is: " + url);
        return url;
    }

    /**
     * Downcasts the Object[] to a List<String>
     * @param source the Objects to downcast to their String representation
     * @return a List<String> that is the result of calling toString()
     * on each Object in the source
     */
    public static List<String> downcast(Object[] source) {
        List<String> dest = new ArrayList<String>();
        if (source != null) {
            for (Object obj : source) {
                dest.add(obj.toString());
            }
        }

        return dest;
    }

    /**
     * Returns true if the two objects are both null or are equal to
     * each other
     */
    public static boolean equals(Object obj1, Object obj2) {
        if ((obj1 == null) && (obj2 == null)) {
            return true;
        }

        if ((obj1 == null) && (obj2 != null)) {
            return false;
        }

        if ((obj1 != null) && (obj2 == null)) {
            return false;
        }

        return obj1.equals(obj2);
    }

    /**
     * Returns true the object arrays are both null or are equal to each
     * other
     */
    public static boolean equals(Object[] obj1, Object[] obj2) {
        if ((obj1 == null) && (obj2 == null)) {
            return true;
        }

        if ((obj1 == null) && (obj2 != null)) {
            return false;
        }

        if ((obj1 != null) && (obj2 == null)) {
            return false;
        }

        if (obj1.length != obj2.length) {
            return false;
        }

        boolean toReturn = true;
        for (int i = 0; i < obj1.length; i++) {
            toReturn &= equals(obj1[i], obj2[i]);
        }

        return toReturn;
    }

    public static void debugStack(Throwable e) {
        if (!_logger.isDebugEnabled())
            return;
        ByteArrayOutputStream baos = new ByteArrayOutputStream();
        PrintStream ps = new PrintStream(baos);
        e.printStackTrace(ps);
        ps.flush();
        String stackTrace = baos.toString();
        _logger.debug(e.getMessage() + "\n" + stackTrace);
    }

}