de.alpharogroup.lang.object.CloneObjectExtensions Maven / Gradle / Ivy
/**
* The MIT License
*
* Copyright (C) 2015 Asterios Raptis
*
* Permission is hereby granted, free of charge, to any person obtaining
* a copy of this software and associated documentation files (the
* "Software"), to deal in the Software without restriction, including
* without limitation the rights to use, copy, modify, merge, publish,
* distribute, sublicense, and/or sell copies of the Software, and to
* permit persons to whom the Software is furnished to do so, subject to
* the following conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
* LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
* OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
* WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
package de.alpharogroup.lang.object;
import java.io.IOException;
import java.io.Serializable;
import java.lang.reflect.Array;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import org.apache.commons.beanutils.BeanUtils;
import org.apache.log4j.Logger;
import de.alpharogroup.io.SerializedObjectExtensions;
import de.alpharogroup.reflection.ReflectionExtensions;
import lombok.experimental.UtilityClass;
/**
* The class {@link CloneObjectExtensions} provide methods for clone an object.
*/
@UtilityClass
public final class CloneObjectExtensions
{
/** The logger constant. */
private static final Logger LOG = Logger.getLogger(CloneObjectExtensions.class.getName());
/**
* Try to clone the given generic object.
*
* @param
* the generic type
* @param object
* the object to clone
* @return The cloned object or null if the clone process failed.
* @throws NoSuchMethodException
* Thrown if a matching method is not found or if the name is "<init>"or
* "<clinit>".
* @throws SecurityException
* Thrown if the security manager indicates a security violation.
* @throws IllegalAccessException
* Thrown if this {@code Method} object is enforcing Java language access control
* and the underlying method is inaccessible.
* @throws IllegalArgumentException
* Thrown if an illegal argument is given
* @throws InvocationTargetException
* Thrown if the property accessor method throws an exception
* @throws ClassNotFoundException
* occurs if a given class cannot be located by the specified class loader
* @throws InstantiationException
* Thrown if one of the following reasons: the class object
*
* - represents an abstract class
* - represents an interface
* - represents an array class
* - represents a primitive type
* - represents {@code void}
* - has no nullary constructor
*
* @throws IOException
* Signals that an I/O exception has occurred.
*/
@SuppressWarnings("unchecked")
public static T clone(final T object)
throws NoSuchMethodException, IllegalAccessException, IllegalArgumentException,
InvocationTargetException, ClassNotFoundException, InstantiationException, IOException
{
return (T)cloneObject(object);
}
/**
* Try to clone the given generic object.
*
* @param
* the generic type
* @param object
* the object to clone
* @return The cloned object or null if the clone process failed.
*/
@SuppressWarnings("unchecked")
public static T cloneQuietly(final T object)
{
return (T)cloneObjectQuietly(object);
}
/**
* Try to clone the given object.
*
* @param object
* The object to clone.
* @return The cloned object or null if the clone process failed.
* @throws NoSuchMethodException
* Thrown if a matching method is not found or if the name is "<init>"or
* "<clinit>".
* @throws SecurityException
* Thrown if the security manager indicates a security violation.
* @throws IllegalAccessException
* Thrown if this {@code Method} object is enforcing Java language access control
* and the underlying method is inaccessible.
* @throws IllegalArgumentException
* Thrown if an illegal argument is given
* @throws InvocationTargetException
* Thrown if the property accessor method throws an exception
* @throws ClassNotFoundException
* occurs if a given class cannot be located by the specified class loader
* @throws InstantiationException
* Thrown if one of the following reasons: the class object
*
* - represents an abstract class
* - represents an interface
* - represents an array class
* - represents a primitive type
* - represents {@code void}
* - has no nullary constructor
*
* @throws IOException
* Signals that an I/O exception has occurred.
*/
public static Object cloneObject(final Object object)
throws NoSuchMethodException, IllegalAccessException, IllegalArgumentException,
InvocationTargetException, ClassNotFoundException, InstantiationException, IOException
{
Object clone = null;
// Try to clone the object if it implements Serializable.
if (object instanceof Serializable)
{
clone = SerializedObjectExtensions.copySerializedObject((Serializable)object);
if (clone != null)
{
return clone;
}
}
// Try to clone the object if it is Cloneble.
if (clone == null && object instanceof Cloneable)
{
if (object.getClass().isArray())
{
final Class componentType = object.getClass().getComponentType();
if (componentType.isPrimitive())
{
int length = Array.getLength(object);
clone = Array.newInstance(componentType, length);
while (length-- > 0)
{
Array.set(clone, length, Array.get(object, length));
}
}
else
{
clone = ((Object[])object).clone();
}
if (clone != null)
{
return clone;
}
}
final Class clazz = object.getClass();
final Method cloneMethod = clazz.getMethod("clone", (Class[])null);
clone = cloneMethod.invoke(object, (Object[])null);
if (clone != null)
{
return clone;
}
}
// Try to clone the object by copying all his properties with
// the BeanUtils.copyProperties() method.
if (clone == null)
{
clone = ReflectionExtensions.getNewInstance(object);
BeanUtils.copyProperties(clone, object);
}
return clone;
}
/**
* Try to clone the given object quietly.
*
* @param object
* The object to clone.
* @return The cloned object or null if the clone process failed.
*/
public static Object cloneObjectQuietly(final Object object)
{
Object clone = null;
try
{
clone = cloneObject(object);
}
catch (final NoSuchMethodException e)
{
LOG.error("Try to clone the object with " + "reflection and call the clone method. "
+ "Thrown exception: NoSuchMethodException", e);
}
catch (final SecurityException e)
{
LOG.error("Try to clone the object with " + "reflection and call the clone method. "
+ "Thrown exception: SecurityException", e);
}
catch (final IllegalAccessException e)
{
LOG.error(
"Try to clone the object with " + "org.apache.commons.beanutils.BeanUtils failed "
+ "cause of IllegalAccessException. Could not found from ReflectionExtensions.",
e);
}
catch (final IllegalArgumentException e)
{
LOG.error("Try to clone the object with " + "reflection and call the clone method. "
+ "Thrown exception: IllegalArgumentException", e);
}
catch (final InvocationTargetException e)
{
LOG.error(
"Try to clone the object with " + "org.apache.commons.beanutils.BeanUtils failed "
+ "cause of InvocationTargetException. Could not found from ReflectionExtensions.",
e);
}
catch (final ClassNotFoundException e)
{
LOG.error(
"Try to clone the object with " + "org.apache.commons.beanutils.BeanUtils failed "
+ "cause of ClassNotFoundException. Could not found from ReflectionExtensions.",
e);
}
catch (final InstantiationException e)
{
LOG.error(
"Try to clone the object with " + "org.apache.commons.beanutils.BeanUtils failed "
+ "cause of InstantiationException. Could not found from ReflectionExtensions.",
e);
}
catch (final IOException e)
{
LOG.error("Try to clone the object with "
+ "SerializedObjectUtils.copySerializedObject((Serializable)object) "
+ "cause of IOException.", e);
}
return clone;
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy