VIVO-120 improve the error messages from OperationUtils.cloneBean()

Add unit tests for the method and restructure the logic so a failure to create the clone is treated as seriously as a failure to load it with values. Previously  a failure to create resulted in a null return (with a log message) while a failure to load resulted in an exception (with a log message).
This commit is contained in:
j2blake 2013-06-05 15:37:05 -04:00
parent 9ec06f224e
commit a19227188b
2 changed files with 574 additions and 137 deletions

View file

@ -10,138 +10,144 @@ import org.apache.commons.logging.LogFactory;
import edu.cornell.mannlib.vedit.beans.EditProcessObject; import edu.cornell.mannlib.vedit.beans.EditProcessObject;
public class OperationUtils {
public class OperationUtils{ private static final Log log = LogFactory.getLog(OperationUtils.class
.getName());
private static final Log log = LogFactory.getLog(OperationUtils.class.getName()); public static void beanSetAndValidate(Object newObj, String field,
String value, EditProcessObject epo) {
Class<?> cls = (epo.getBeanClass() != null) ? epo.getBeanClass() : newObj
.getClass();
Class<?>[] paramList = new Class[1];
paramList[0] = String.class;
boolean isInt = false;
boolean isBoolean = false;
Method setterMethod = null;
try {
setterMethod = cls.getMethod("set" + field, paramList);
} catch (NoSuchMethodException e) {
// let's try int
paramList[0] = int.class;
try {
setterMethod = cls.getMethod("set" + field, paramList);
isInt = true;
} catch (NoSuchMethodException f) {
// let's try boolean
paramList[0] = boolean.class;
try {
setterMethod = cls.getMethod("set" + field, paramList);
isBoolean = true;
log.debug("found boolean field " + field);
} catch (NoSuchMethodException g) {
log.error("beanSet could not find an appropriate String, int, or boolean setter method for "
+ field);
}
public static void beanSetAndValidate(Object newObj, String field, String value, EditProcessObject epo){ }
Class cls = (epo.getBeanClass() != null) ? epo.getBeanClass() : newObj.getClass(); }
Class[] paramList = new Class[1]; Object[] arglist = new Object[1];
paramList[0] = String.class; if (isInt)
boolean isInt = false; arglist[0] = Integer.decode(value);
boolean isBoolean = false; else if (isBoolean)
Method setterMethod = null; arglist[0] = (value.equalsIgnoreCase("TRUE"));
try { else
setterMethod = cls.getMethod("set"+field,paramList); arglist[0] = value;
} catch (NoSuchMethodException e) { try {
//let's try int setterMethod.invoke(newObj, arglist);
paramList[0] = int.class; } catch (Exception e) {
try { log.error("Couldn't invoke method");
setterMethod = cls.getMethod("set"+field,paramList); log.error(e.getMessage());
isInt = true; log.error(field + " " + arglist[0]);
} catch (NoSuchMethodException f) { }
//let's try boolean }
paramList[0]=boolean.class;
try {
setterMethod = cls.getMethod("set"+field,paramList);
isBoolean = true;
log.debug("found boolean field "+field);
} catch (NoSuchMethodException g) {
log.error("beanSet could not find an appropriate String, int, or boolean setter method for "+field);
}
} /**
} * Takes a bean and clones it using reflection. Any fields without standard
Object[] arglist = new Object[1]; * getter/setter methods will not be copied.
if (isInt) */
arglist[0] = Integer.decode(value); public static Object cloneBean(Object bean) {
else if (isBoolean) if (bean == null) {
arglist[0] = (value.equalsIgnoreCase("TRUE")); throw new NullPointerException("bean may not be null.");
else }
arglist[0] = value; return cloneBean(bean, bean.getClass(), bean.getClass());
try { }
setterMethod.invoke(newObj,arglist);
} catch (Exception e) {
log.error("Couldn't invoke method");
log.error(e.getMessage());
log.error(field+" "+arglist[0]);
}
}
/** /**
* Takes a bean and clones it using reflection. * Takes a bean and clones it using reflection. Any fields without standard
* Any fields without standard getter/setter methods will not be copied. * getter/setter methods will not be copied.
* @param bean */
* @return public static Object cloneBean(final Object bean, final Class<?> beanClass,
*/ final Class<?> iface) {
public static Object cloneBean (Object bean) { if (bean == null) {
return cloneBean(bean, bean.getClass(), bean.getClass()); throw new NullPointerException("bean may not be null.");
} }
if (beanClass == null) {
throw new NullPointerException("beanClass may not be null.");
}
if (iface == null) {
throw new NullPointerException("iface may not be null.");
}
/** class CloneBeanException extends RuntimeException {
* Takes a bean and clones it using reflection. public CloneBeanException(String message, Throwable cause) {
* Any fields without standard getter/setter methods will not be copied. super(message + " <" + cause.getClass().getSimpleName()
* @param bean + ">: bean=" + bean + ", beanClass="
* @return + beanClass.getName() + ", iface=" + iface.getName(),
*/ cause);
public static Object cloneBean (Object bean, Class beanClass, Class iface){ }
Object newBean = null; }
try {
newBean = beanClass.newInstance(); Object newBean;
Method[] beanMeths = iface.getMethods(); try {
for (int i=0; i<beanMeths.length ; ++i) { newBean = beanClass.getConstructor().newInstance();
Method beanMeth = beanMeths[i]; } catch (NoSuchMethodException e) {
String methName = beanMeth.getName(); throw new CloneBeanException("bean has no 'nullary' constructor.", e);
if (methName.startsWith("get") } catch (InstantiationException e) {
&& beanMeth.getParameterTypes().length == 0 ) { throw new CloneBeanException("tried to create instance of an abstract class.", e);
String fieldName = methName.substring(3,methName.length()); } catch (IllegalAccessException e) {
Class returnType = beanMeth.getReturnType(); throw new CloneBeanException("bean constructor is not accessible.", e);
try { } catch (InvocationTargetException e) {
Class[] args = new Class[1]; throw new CloneBeanException("bean constructor threw an exception.", e);
args[0] = returnType; } catch (Exception e) {
Method setterMethod = iface.getMethod("set"+fieldName,args); throw new CloneBeanException("failed to instantiate a new bean.", e);
try { }
Object fieldVal = beanMeth.invoke(bean,(Object[])null);
try { for (Method beanMeth : iface.getMethods()) {
Object[] setArgs = new Object[1]; String methName = beanMeth.getName();
setArgs[0] = fieldVal; if (!methName.startsWith("get")) {
setterMethod.invoke(newBean,setArgs); continue;
} catch (IllegalAccessException iae) { }
log.error(OperationUtils.class.getName() + if (beanMeth.getParameterTypes().length != 0) {
".cloneBean() " + continue;
" encountered IllegalAccessException " + }
" invoking " + String fieldName = methName.substring(3, methName.length());
setterMethod.getName(), iae); Class<?> returnType = beanMeth.getReturnType();
throw new RuntimeException(iae);
} catch (InvocationTargetException ite) { Method setterMethod;
log.error(OperationUtils.class.getName() + try {
".cloneBean() " + setterMethod = iface.getMethod("set" + fieldName, returnType);
" encountered InvocationTargetException" } catch (NoSuchMethodException nsme) {
+ " invoking " continue;
+ setterMethod.getName(), ite); }
throw new RuntimeException(ite);
} Object fieldVal;
} catch (IllegalAccessException iae) { try {
log.error(OperationUtils.class.getName() + fieldVal = beanMeth.invoke(bean, (Object[]) null);
".cloneBean() encountered " + } catch (Exception e) {
" IllegalAccessException invoking " + throw new CloneBeanException("failed to invoke " + beanMeth, e);
beanMeths[i].getName(), iae); }
throw new RuntimeException(iae);
} catch (InvocationTargetException ite) { try {
log.error(OperationUtils.class.getName() + Object[] setArgs = new Object[1];
".cloneBean() encountered " + setArgs[0] = fieldVal;
" InvocationTargetException invoking " + setterMethod.invoke(newBean, setArgs);
beanMeths[i].getName(), ite); } catch (Exception e) {
throw new RuntimeException(ite); throw new CloneBeanException(
} catch (IllegalArgumentException iae) { "failed to invoke " + setterMethod, e);
log.error(OperationUtils.class.getName() + }
".cloneBean() encountered " + }
" IllegalArgumentException invoking " + return newBean;
beanMeths[i].getName(), iae); }
throw new RuntimeException(iae);
}
} catch (NoSuchMethodException nsme){
// ignore this field because there is no setter method
}
}
}
} catch (InstantiationException ie){
log.error("edu.cornell.mannlib.vitro.edit.utils.OperationUtils.cloneBean("+bean.getClass().toString()+") could not instantiate new instance of bean.", ie);
} catch (IllegalAccessException iae){
log.error("edu.cornell.mannlib.vitro.edit.utils.OperationUtils.cloneBean("+bean.getClass().toString()+") encountered illegal access exception instantiating new bean.", iae);
}
return newBean;
}
} }

View file

@ -0,0 +1,431 @@
/* $This file is distributed under the terms of the license in /doc/license.txt$ */
package edu.cornell.mannlib.vedit.util;
import static org.junit.Assert.assertEquals;
import java.lang.reflect.InvocationTargetException;
import java.util.HashMap;
import java.util.Map;
import org.hamcrest.BaseMatcher;
import org.hamcrest.Description;
import org.hamcrest.Matcher;
import org.junit.Ignore;
import org.junit.Rule;
import org.junit.Test;
import org.junit.rules.ExpectedException;
import edu.cornell.mannlib.vitro.testing.AbstractTestClass;
/**
* All of these tests are for OperationUtils.cloneBean()
*/
public class OperationUtils_CloneBeanTest extends AbstractTestClass {
// ----------------------------------------------------------------------
// Allow the tests to expect a RuntimeException with a particular cause.
// ----------------------------------------------------------------------
@Rule
public ExpectedException thrown = ExpectedException.none();
Matcher<?> causedBy(Class<? extends Throwable> causeClass) {
return new CausedByMatcher(causeClass);
}
class CausedByMatcher extends BaseMatcher<Throwable> {
private final Class<? extends Throwable> causeClass;
public CausedByMatcher(Class<? extends Throwable> causeClass) {
this.causeClass = causeClass;
}
@Override
public boolean matches(Object actualThrowable) {
if (!(actualThrowable instanceof RuntimeException)) {
return false;
}
Throwable cause = ((RuntimeException) actualThrowable).getCause();
return causeClass.isInstance(cause);
}
@Override
public void describeTo(Description d) {
d.appendText("RuntimeException caused by " + causeClass.getName());
}
}
// ----------------------------------------------------------------------
// Test for invalid classes
// ----------------------------------------------------------------------
@Test(expected = NullPointerException.class)
public void nullArgument() {
OperationUtils.cloneBean(null);
}
@Test(expected = NullPointerException.class)
public void nullBean() {
OperationUtils
.cloneBean(null, SimpleSuccess.class, SimpleSuccess.class);
}
@Test(expected = NullPointerException.class)
public void nullBeanClass() {
OperationUtils
.cloneBean(new SimpleSuccess(), null, SimpleSuccess.class);
}
@Test(expected = NullPointerException.class)
public void nullInterfaceClass() {
OperationUtils
.cloneBean(new SimpleSuccess(), SimpleSuccess.class, null);
}
@Test(expected = IllegalAccessException.class)
@Ignore("Why doesn't this throw an exception?")
public void privateClass() {
OperationUtils.cloneBean(new PrivateClass());
}
@Test
public void privateConstructor() {
thrown.expect(causedBy(NoSuchMethodException.class));
OperationUtils.cloneBean(new PrivateConstructor());
}
@Test
public void abstractClass() {
thrown.expect(causedBy(InstantiationException.class));
OperationUtils.cloneBean(new ConcreteOfAbstractClass(),
AbstractClass.class, AbstractClass.class);
}
@Test
public void interfaceClass() {
thrown.expect(causedBy(InstantiationException.class));
OperationUtils.cloneBean(new ConcreteOfInterfaceClass(),
InterfaceClass.class, InterfaceClass.class);
}
@Test
public void arrayClass() {
thrown.expect(causedBy(NoSuchMethodException.class));
OperationUtils.cloneBean(new String[0]);
}
@Test
public void primitiveTypeClass() {
thrown.expect(causedBy(NoSuchMethodException.class));
OperationUtils.cloneBean(1, Integer.TYPE, Integer.TYPE);
}
@Test
public void voidClass() {
thrown.expect(causedBy(NoSuchMethodException.class));
OperationUtils.cloneBean(new Object(), Void.TYPE, Void.TYPE);
}
@Test
public void noNullaryConstructor() {
thrown.expect(causedBy(NoSuchMethodException.class));
OperationUtils.cloneBean(new NoNullaryConstructor(1));
}
@Test(expected = ExceptionInInitializerError.class)
public void classThrowsExceptionWhenLoaded() {
OperationUtils.cloneBean(new ThrowsExceptionWhenLoaded());
}
@Test
public void initializerThrowsException() {
thrown.expect(causedBy(InvocationTargetException.class));
OperationUtils.cloneBean("random object",
InitializerThrowsException.class,
InitializerThrowsException.class);
}
@Test
public void wrongInterfaceClass() {
thrown.expect(causedBy(IllegalArgumentException.class));
OperationUtils.cloneBean(new WrongConcreteClass(),
WrongConcreteClass.class, WrongInterface.class);
}
@Test
public void getThrowsException() {
thrown.expect(causedBy(InvocationTargetException.class));
OperationUtils.cloneBean(new GetMethodThrowsException());
}
@Test
public void setThrowsException() {
thrown.expect(causedBy(InvocationTargetException.class));
OperationUtils.cloneBean(new SetMethodThrowsException());
}
private static class PrivateClass {
public PrivateClass() {
}
}
private static class PrivateConstructor {
private PrivateConstructor() {
}
}
public abstract static class AbstractClass {
public AbstractClass() {
}
}
public static class ConcreteOfAbstractClass extends AbstractClass {
public ConcreteOfAbstractClass() {
}
}
public abstract static class InterfaceClass {
public InterfaceClass() {
}
}
public static class ConcreteOfInterfaceClass extends InterfaceClass {
public ConcreteOfInterfaceClass() {
}
}
public static class NoNullaryConstructor {
@SuppressWarnings("unused")
public NoNullaryConstructor(int i) {
// nothing to do
}
}
public static class ThrowsExceptionWhenLoaded {
static {
if (true)
throw new IllegalArgumentException();
}
}
public static class InitializerThrowsException {
{
if (true)
throw new IllegalStateException("Initializer throws exception");
}
}
public static class WrongConcreteClass {
private String junk = "junk";
public String getJunk() {
return this.junk;
}
@SuppressWarnings("unused")
private void setJunk(String junk) {
this.junk = junk;
}
}
public static interface WrongInterface {
String getJunk();
void setJunk(String junk);
}
public static class GetMethodThrowsException {
@SuppressWarnings("unused")
private String junk = "junk";
public String getJunk() {
throw new UnsupportedOperationException();
}
public void setJunk(String junk) {
this.junk = junk;
}
}
public static class SetMethodThrowsException {
private String junk = "junk";
public String getJunk() {
return this.junk;
}
@SuppressWarnings("unused")
public void setJunk(String junk) {
throw new UnsupportedOperationException();
}
}
// ----------------------------------------------------------------------
// Test simple success and innocuous variations
// ----------------------------------------------------------------------
@Test
public void simpleSuccess() {
expectSuccess(new SimpleSuccess().insertField("label", "a prize"));
}
@Test
public void getButNoSet() {
expectSuccess(new GetButNoSet().insertField("label", "shouldBeEqual"));
}
@Test
public void getTakesParameters() {
expectSuccess(new GetTakesParameters().insertField("label", "fine"));
}
@Test
public void getReturnsVoid() {
expectSuccess(new GetReturnsVoid().insertField("label", "fine"));
}
@Test
public void getAndSetDontMatch() {
expectSuccess(new GetAndSetDontMatch().insertField("label", "fine"));
}
@Test
public void getIsStatic() {
expectSuccess(new GetIsStatic().insertField("label", "fine")
.insertField("instanceJunk", "the junk"));
}
@Test
public void getMethodIsPrivate() {
expectSuccess(new GetMethodIsPrivate().insertField("label", "fine"));
}
@Test
public void setMethodIsPrivate() {
expectSuccess(new SetMethodIsPrivate().insertField("label", "fine"));
}
private void expectSuccess(BeanBase original) {
BeanBase cloned = (BeanBase) OperationUtils.cloneBean(original);
assertEquals("Simple success", original, cloned);
}
public static abstract class BeanBase {
protected final Map<String, Object> fields = new HashMap<>();
public BeanBase insertField(String key, Object value) {
if (value != null) {
fields.put(key, value);
}
return this;
}
@Override
public int hashCode() {
return fields.hashCode();
}
@Override
public boolean equals(Object o) {
if (o == this) {
return true;
}
if (o == null) {
return false;
}
if (!this.getClass().equals(o.getClass())) {
return false;
}
return this.fields.equals(((BeanBase) o).fields);
}
@Override
public String toString() {
return this.getClass().getSimpleName() + fields;
}
}
public static class SimpleSuccess extends BeanBase {
public String getLabel() {
return (String) fields.get("label");
}
public void setLabel(String label) {
insertField("label", label);
}
}
public static class GetButNoSet extends SimpleSuccess {
public String getJunk() {
throw new UnsupportedOperationException();
}
}
public static class GetTakesParameters extends SimpleSuccess {
@SuppressWarnings("unused")
public String getJunk(String why) {
throw new UnsupportedOperationException();
}
@SuppressWarnings("unused")
public void setJunk(String junk) {
throw new UnsupportedOperationException();
}
}
public static class GetReturnsVoid extends SimpleSuccess {
public void getJunk() {
throw new UnsupportedOperationException();
}
@SuppressWarnings("unused")
public void setJunk(String junk) {
throw new UnsupportedOperationException();
}
}
public static class GetAndSetDontMatch extends SimpleSuccess {
public String getJunk() {
throw new UnsupportedOperationException();
}
@SuppressWarnings("unused")
public void setJunk(Integer junk) {
throw new UnsupportedOperationException();
}
}
public static class GetIsStatic extends SimpleSuccess {
public static String getJunk() {
return ("the junk");
}
public void setJunk(String junk) {
insertField("instanceJunk", junk);
}
}
public static class GetMethodIsPrivate extends SimpleSuccess {
@SuppressWarnings("unused")
private String getJunk() {
return ("the junk");
}
public void setJunk(String junk) {
insertField("instanceJunk", junk);
}
}
public static class SetMethodIsPrivate extends SimpleSuccess {
public String getJunk() {
return ("the junk");
}
@SuppressWarnings("unused")
private void setJunk(String junk) {
insertField("instanceJunk", junk);
}
}
}