FileDocCategorySizeDatePackage
ObjectAnalyzer.javaAPI DocGlassfish v2 API13145Fri May 04 22:23:16 BST 2007com.sun.enterprise.config.backup.util

ObjectAnalyzer.java

/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 * 
 * Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
 * 
 * The contents of this file are subject to the terms of either the GNU
 * General Public License Version 2 only ("GPL") or the Common Development
 * and Distribution License("CDDL") (collectively, the "License").  You
 * may not use this file except in compliance with the License. You can obtain
 * a copy of the License at https://glassfish.dev.java.net/public/CDDL+GPL.html
 * or glassfish/bootstrap/legal/LICENSE.txt.  See the License for the specific
 * language governing permissions and limitations under the License.
 * 
 * When distributing the software, include this License Header Notice in each
 * file and include the License file at glassfish/bootstrap/legal/LICENSE.txt.
 * Sun designates this particular file as subject to the "Classpath" exception
 * as provided by Sun in the GPL Version 2 section of the License file that
 * accompanied this code.  If applicable, add the following below the License
 * Header, with the fields enclosed by brackets [] replaced by your own
 * identifying information: "Portions Copyrighted [year]
 * [name of copyright owner]"
 * 
 * Contributor(s):
 * 
 * If you wish your version of this file to be governed by only the CDDL or
 * only the GPL Version 2, indicate your decision by adding "[Contributor]
 * elects to include this software in this distribution under the [CDDL or GPL
 * Version 2] license."  If you don't indicate a single choice of license, a
 * recipient has the option to distribute your version of this file under
 * either the CDDL, the GPL Version 2 or to extend the choice of license to
 * its licensees as provided above.  However, if you add GPL Version 2 code
 * and therefore, elected the GPL Version 2 license, then the option applies
 * only if the new code is made subject to such option by the copyright
 * holder.
 */

/**
 * WBN -- generic mechanism for simulating toString() and equals() 
 * for any class
 */

package com.sun.enterprise.config.backup.util;

import java.lang.reflect.*;
import java.util.Vector;

public class ObjectAnalyzer
{
	/**
	 * @param className
	 * @return  */	
	public static String getMethods(String className)
	{
		try
		{
			Class clazz = Class.forName(className);
			return getMethods(clazz, false);
		}
		catch(Exception e)
		{
			return "Error loading class: " + e.getMessage();//NOI18N
		}
	}

	////////////////////////////////////////////////////////////////////////////

	/**
	 * @param obj
	 * @return  */	
	public static String getMethods(Object obj)
	{
		return getMethods(obj, false);
	}

	////////////////////////////////////////////////////////////////////////////

	/**
	 * @param obj
	 * @param settersOnly
	 * @return  */	
	public static String getMethods(Object obj, boolean settersOnly)
	{
		try
		{
			Class clazz = safeGetClass(obj);
			return getMethods(clazz, settersOnly);
		}
		catch(Exception e)
		{
			return e.getMessage();
		}
	}

	////////////////////////////////////////////////////////////////////////////

	/**
	 * @param clazz
	 * @param settersOnly
	 * @return  */	
	public static String getMethods(Class clazz, boolean settersOnly)
	{
		String s = new String();

		Method[] methods = clazz.getMethods();

		for(int i = 0; i < methods.length; i++)
		{
			Method m = methods[i];
			boolean isSetter = m.getName().startsWith("set");//NOI18N

			if(settersOnly && isSetter == false)
				continue;
			
			s = s + m.toString() + '\n';
		}
		return s;
	}

	////////////////////////////////////////////////////////////////////////////

	/**
	 * @param obj
	 * @return  */	
	public static String getSetters(Object obj)
	{
		return getMethods(obj, true);
	}

	////////////////////////////////////////////////////////////////////////////

	/**
	 * @param clazz
	 * @return  */	
	public static String getSetters(Class clazz)
	{
		return getMethods(clazz, true);
	}

	////////////////////////////////////////////////////////////////////////////

	/**
	 * @param obj
	 * @return  */	
	public static String toString(Object obj)
	{
		return toString(obj, false);
	}

	////////////////////////////////////////////////////////////////////////////

	/**
	 * @param obj
	 * @return  */	
	public static String toStringWithSuper(Object obj)
	{
		return toString(obj, true);
	}

	////////////////////////////////////////////////////////////////////////////

	/**
	 * @param a
	 * @param b
	 * @return  */	
	public static boolean equals(Object a, Object b)
	{  
		Class cl = a.getClass();

		if (!cl.equals(b.getClass())) 
			return false;
		
		Field[] fields = cl.getDeclaredFields();
		setAccessible(fields);
		
		for (int i = 0; i < fields.length; i++)
		{  
			Field f = fields[i];
			try
			{  
				if (!f.get(a).equals(f.get(b)))
					return false;
			}
			catch(IllegalAccessException e)
			{  
				return false;
			}
		}
		
		return true;
	}

	////////////////////////////////////////////////////////////////////////////

	public static void useShortClassNames()
	{
		useShortClassNames_ = true;
	}

	////////////////////////////////////////////////////////////////////////////

	public static void useLongClassNames()
	{
		useShortClassNames_ = false;
	}

	////////////////////////////////////////////////////////////////////////////

	private static String toString(Object obj, boolean doSuperClasses)
	{
		try
		{
			return getFieldInfo(obj, doSuperClasses).toString();
		}
		catch(ObjectAnalyzerException e)
		{
			return e.getMessage();
		}
	}
	
	////////////////////////////////////////////////////////////////////////////

	private static Class safeGetClass(Object obj) throws ObjectAnalyzerException
	{
		if(obj == null)
			throw new ObjectAnalyzerException(fatal + "null Object parameter");//NOI18N

		if(! (obj instanceof Object))
			throw new ObjectAnalyzerException(fatal + "Object parameter is not really a java.lang.Object");//NOI18N

		Class cl = obj.getClass();

		if(cl == null)
			throw new ObjectAnalyzerException(fatal + "getClass() on parameter Object returned null");//NOI18N
		
		return cl;
	}
	
	////////////////////////////////////////////////////////////////////////////

	private static Class safeGetSuperclass(Class cl) throws ObjectAnalyzerException
	{
		Class sc = cl.getSuperclass();

		if(sc == null)
			throw new ObjectAnalyzerException("getSuperclass() on parameter Object returned null");//NOI18N
		
		return sc;
	}
	
	////////////////////////////////////////////////////////////////////////////

	private static FieldInfoVector getFieldInfo(Object obj, boolean doSuperClasses) throws ObjectAnalyzerException
	{
		FieldInfoVector fiv = new FieldInfoVector();
		Class			cl	= safeGetClass(obj);

		if(doSuperClasses == false)
		{
			getFieldInfo(cl, obj, fiv);
			return fiv;
		}

		for(Class theClass = cl; theClass != null && !theClass.equals(Object.class); theClass = safeGetSuperclass(theClass))
			getFieldInfo(theClass, obj, fiv);

		return fiv;
	}
	
	
	////////////////////////////////////////////////////////////////////////////

	private static void getFieldInfo(Class cl, Object obj, FieldInfoVector fiv) throws ObjectAnalyzerException
	{
		Field[] fields = null;

		try
		{
			fields = cl.getDeclaredFields();
		}
		catch(SecurityException e) 
		{
			throw new ObjectAnalyzerException("got a SecurityException when calling getDeclaredFields() on " + cl.getName());//NOI18N
		}

		if(fields == null)
			throw new ObjectAnalyzerException("calling getDeclaredFields() on " + cl.getName() + " returned null");//NOI18N
		
		setAccessible(fields);

		for(int i = 0; i < fields.length; i++)
		{
			Field f = fields[i];
			String sval;
			String modifiers = Modifier.toString(f.getModifiers());
			String className = cl.getName();

			if(useShortClassNames_)
				className = StringUtils.toShortClassName(className);

			if(modifiers.length() <= 0)
				modifiers = "(package)";//NOI18N

			try
			{  
				Object val = f.get(obj);
				
				if(val == null)
					sval = "<null>";//NOI18N
				else
					sval = val.toString();
			} 
			catch (IllegalAccessException e)
			{  
				sval = "<IllegalAccessException>";//NOI18N
			}
			
			fiv.addElement(new FieldInfo(className, f, sval, modifiers));
		}
	}
	
	////////////////////////////////////////////////////////////////////////////

	private static void setAccessible(Field[] fields)
	{
		if(setAccessibleMethod == null)
			return;	// Must be pre JDK 1.2.x

		try
		{  
			Boolean b = Boolean.valueOf(true);
			setAccessibleMethod.invoke(null, new Object[] { fields, b } );
		}
		catch(Exception e) 
		{
		}
	}

	////////////////////////////////////////////////////////////////////////////
	
	private static void setupSetAccessibleMethod()
	{
		// whoa!  what's this reflection crap doing here?
		// AccessibleObject is a JDK 1.2 class that lets you peek at
		// private variable values.  Since we need to support JDK 1.1 
		// for the VCafe plug-in -- it is now called via 100% reflection
		// techniques...

		setAccessibleMethod = null;

		Class AO;

		try
		{
			AO = Class.forName("java.lang.reflect.AccessibleObject");//NOI18N
		}
		catch(ClassNotFoundException e)
		{
			return;
		}

		Method[] methods = AO.getDeclaredMethods();

		for(int i = 0; i < methods.length; i++)
		{
			Method m = methods[i];

			if(m.getName().equals("setAccessible") && m.getParameterTypes().length == 2)//NOI18N
			{
				setAccessibleMethod = m;
				break;
			}
		}
	}
	
	
	////////////////////////////////////////////////////////////////////////////

	private static final	String		fatal				= "Fatal Error in ObjectAnalyzer.toString():  ";//NOI18N
	private static			boolean		useShortClassNames_	= true;
	private static			Method		setAccessibleMethod;

	static
	{
		setupSetAccessibleMethod();
	}
	
	////////////////////////////////////////////////////////////////////////////

	/**
	 * @param args  */	
	public static void main(String[] args)
	{
		String s = new String("Hello!");//NOI18N

		System.out.println("Regular: \n" + toString(s) + "\n\n");//NOI18N
		System.out.println("Super: \n" + toStringWithSuper(s) + "\n\n");//NOI18N
	}
	  
}

////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////

class ObjectAnalyzerException extends Exception
{
	ObjectAnalyzerException(String s)
	{
		super(s);
	}

}
	
////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////

class FieldInfo
{
	Field	field;
	String	value;
	//Class	clazz;
	String	className;
	String	modifiers;

	FieldInfo(String c, Field f, String v, String m)
	{
		className	= c;
		field		= f;
		value		= v;
		modifiers	= m;
	}
}
	
////////////////////////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////

class FieldInfoVector // { extends Vector
{
    Vector v = null;
    
	FieldInfoVector()
	{
	    v = new Vector();
	}
	
	////////////////////////////////////////////////////////////////////////////
	
	/**
	 * @param o  */	
	public void addElement(Object o) {
	    v.addElement(o);
	}
	
	////////////////////////////////////////////////////////////////////////////
	
	/**
	 * @return  */	
	public String toString()
	{
		int				veclen	= v.size();
		StringBuffer	s		= new StringBuffer();

		setLongestNames();

		//s.append("classNameLength: " + classNameLength + "fieldNameLength: " + fieldNameLength + "modifiersLength: " + modifiersLength + "\n\n");//NOI18N
		
		s.append(StringUtils.padRight("Class", classNameLength));//NOI18N
		s.append(StringUtils.padRight("Modifiers", modifiersLength));//NOI18N
		s.append(StringUtils.padRight("Field", fieldNameLength));//NOI18N
		s.append("Value");//NOI18N
		s.append("\n\n");//NOI18N

		for(int i = 0; i < veclen; i++)
		{
			FieldInfo fi = fetch(i);
	
			s.append(StringUtils.padRight(fi.className, classNameLength));
			s.append(StringUtils.padRight(fi.modifiers, modifiersLength));
			s.append(StringUtils.padRight(fi.field.getName(), fieldNameLength));
			s.append(fi.value);
			s.append('\n');
		}

		return s.toString();
	}

	////////////////////////////////////////////////////////////////////////////
	
	private FieldInfo fetch(int i)
	{
		return (FieldInfo)v.elementAt(i);
	}
	
	////////////////////////////////////////////////////////////////////////////
	
	private void setLongestNames()
	{
		int veclen = v.size();

		classNameLength	= 5;
		fieldNameLength	= 5;
		modifiersLength	= 5;

		for(int i = 0; i < veclen; i++)
		{
			FieldInfo fi = fetch(i);

			int clen = fi.className.length();
			int flen = fi.field.getName().length();
			int mlen = fi.modifiers.length();
			if(clen > classNameLength)	classNameLength = clen;
			if(flen > fieldNameLength)	fieldNameLength = flen;
			if(mlen > modifiersLength)	modifiersLength = mlen;
		}

		classNameLength	+= 2;
		fieldNameLength	+= 2;
		modifiersLength	+= 2;
	}

	////////////////////////////////////////////////////////////////////////////
	
	private int 					classNameLength	= 0;
	private int 					fieldNameLength	= 0;
	private int						modifiersLength	= 0;
}