ObjectUtils (utils4j)

java.lang.Object
- com.varra.util.ObjectUtils

```
public class ObjectUtils
extends Object
```
Various object utilities.

Version:

1.0

Author:

Rajakrishna V. Reddy

Constructor Summary

Constructors
Constructor and Description

ObjectUtils()

Constructors
Constructor and Description
`ObjectUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static Object`	`byteArrayToObject(byte[] data)` De-serialize an object from byte array.
`static Object`	`clone(Object source)` Clone an object by invoking it's `clone()` method, even if it is not overridden.
`static Object`	`cloneViaSerialization(Serializable obj)` Create object copy using serialization mechanism.
`static boolean`	`containsElement(Object obj, Object element)` Returns true if first argument contains provided element.
`static boolean`	`equals(Object obj1, Object obj2)` Safely compares two objects just like `equals()` would, except it allows any of the 2 objects to be `null`.
`static boolean`	`equalsEx(Object obj1, Object obj2)` Compares two objects or two object arrays.
`static boolean`	`equalsType(Object object, Object thiz)` Non-symmetric utility for comparing the types of two objects.
`static boolean`	`isInstanceOf(Object object, Class<?> klass)` Checks if an Object is an instance of the given class.
`static boolean`	`isNotInstanceOf(Object object, Class<?> klass)` Checks if an Object is not an instance of the given class.
`static boolean`	`isNotNull(Object object)` Checks if an Object is not null.
`static boolean`	`isNull(Object object)` Checks if an Object is null.
`static int`	`length(Object obj)` Returns length of the object.
`static byte[]`	`objectToByteArray(Object obj)` Serialize an object to byte array.
`static Object`	`readObject(File source)` Reads serialized object from the file.
`static Object`	`readObject(String source)` Read object.
`static Object`	`readObjectAsXml(File source)` Reads serialized object from the XML file.
`static Object`	`readObjectAsXml(String source)` Read object as xml.
`static void`	`writeObject(File dest, Object object)` Writes serializable object to a file.
`static void`	`writeObject(String dest, Object object)` Write object.
`static void`	`writeObjectAsXml(File dest, Object object)` Writes serializable object to a XML file.
`static void`	`writeObjectAsXml(String dest, Object object)` Write object as xml.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ObjectUtils
```
public ObjectUtils()
```
- Method Detail
  - equals
```
public static boolean equals(Object obj1,
                             Object obj2)
```
    Safely compares two objects just like equals() would, except it allows any of the 2 objects to be null.
    
    Parameters:
    
    obj1 - the obj1
    
    obj2 - the obj2
    
    Returns:
    
    true if arguments are equal, otherwise false
  - equalsEx
```
public static boolean equalsEx(Object obj1,
                               Object obj2)
```
    Compares two objects or two object arrays. Useful for Object.equals(Object).
    
    Parameters:
    
    obj1 - the obj1
    
    obj2 - the obj2
    
    Returns:
    
    true, if successful
    
    See Also:
    
    equals(Object, Object)
  - equalsType
```
public static boolean equalsType(Object object,
                                 Object thiz)
```
    Non-symmetric utility for comparing the types of two objects. Might be useful for Object.equals(Object) if instanceOf is not used.
    
    Parameters:
    
    object - equals() argument
    
    thiz - current class that overrides equals()
    
    Returns:
    
    true, if successful
  - clone
```
public static Object clone(Object source)
                    throws CloneNotSupportedException
```
    Clone an object by invoking it's clone() method, even if it is not overridden.
    
    Parameters:
    
    source - the source
    
    Returns:
    
    the object
    
    Throws:
    
    CloneNotSupportedException - the clone not supported exception
  - cloneViaSerialization
```
public static Object cloneViaSerialization(Serializable obj)
                                    throws IOException,
                                           ClassNotFoundException
```
    Create object copy using serialization mechanism.
    
    Parameters:
    
    obj - the obj
    
    Returns:
    
    the object
    
    Throws:
    
    IOException - Signals that an I/O exception has occurred.
    
    ClassNotFoundException - the class not found exception
  - writeObject
```
public static void writeObject(String dest,
                               Object object)
                        throws IOException
```
    Write object.
    
    Parameters:
    
    dest - the dest
    
    object - the object
    
    Throws:
    
    IOException - Signals that an I/O exception has occurred.
    
    See Also:
    
    writeObject(java.io.File, Object)
  - writeObject
```
public static void writeObject(File dest,
                               Object object)
                        throws IOException
```
    Writes serializable object to a file. Existing file will be overwritten.
    
    Parameters:
    
    dest - the dest
    
    object - the object
    
    Throws:
    
    IOException - Signals that an I/O exception has occurred.
  - writeObjectAsXml
```
public static void writeObjectAsXml(File dest,
                                    Object object)
                             throws IOException
```
    Writes serializable object to a XML file. Existing file will be overwritten.
    
    Parameters:
    
    dest - the dest
    
    object - the object
    
    Throws:
    
    IOException - Signals that an I/O exception has occurred.
  - writeObjectAsXml
```
public static void writeObjectAsXml(String dest,
                                    Object object)
                             throws IOException
```
    Write object as xml.
    
    Parameters:
    
    dest - the dest
    
    object - the object
    
    Throws:
    
    IOException - Signals that an I/O exception has occurred.
    
    See Also:
    
    writeObjectAsXml(java.io.File, Object)
  - readObject
```
public static Object readObject(String source)
                         throws IOException,
                                ClassNotFoundException
```
    Read object.
    
    Parameters:
    
    source - the source
    
    Returns:
    
    the object
    
    Throws:
    
    IOException - Signals that an I/O exception has occurred.
    
    ClassNotFoundException - the class not found exception
    
    See Also:
    
    readObject(java.io.File)
  - readObject
```
public static Object readObject(File source)
                         throws IOException,
                                ClassNotFoundException
```
    Reads serialized object from the file.
    
    Parameters:
    
    source - the source
    
    Returns:
    
    the object
    
    Throws:
    
    IOException - Signals that an I/O exception has occurred.
    
    ClassNotFoundException - the class not found exception
  - readObjectAsXml
```
public static Object readObjectAsXml(File source)
                              throws IOException
```
    Reads serialized object from the XML file.
    
    Parameters:
    
    source - the source
    
    Returns:
    
    the object
    
    Throws:
    
    IOException - Signals that an I/O exception has occurred.
  - readObjectAsXml
```
public static Object readObjectAsXml(String source)
                              throws IOException
```
    Read object as xml.
    
    Parameters:
    
    source - the source
    
    Returns:
    
    the object
    
    Throws:
    
    IOException - Signals that an I/O exception has occurred.
    
    See Also:
    
    readObjectAsXml(java.io.File)
  - objectToByteArray
```
public static byte[] objectToByteArray(Object obj)
                                throws IOException
```
    Serialize an object to byte array.
    
    Parameters:
    
    obj - the obj
    
    Returns:
    
    the byte[]
    
    Throws:
    
    IOException - Signals that an I/O exception has occurred.
  - byteArrayToObject
```
public static Object byteArrayToObject(byte[] data)
                                throws IOException,
                                       ClassNotFoundException
```
    De-serialize an object from byte array.
    
    Parameters:
    
    data - the data
    
    Returns:
    
    the object
    
    Throws:
    
    IOException - Signals that an I/O exception has occurred.
    
    ClassNotFoundException - the class not found exception
  - length
```
public static int length(Object obj)
```
    Returns length of the object.
    
    Parameters:
    
    obj - the obj
    
    Returns:
    
    the int
  - containsElement
```
public static boolean containsElement(Object obj,
                                      Object element)
```
    Returns true if first argument contains provided element. s
    
    Parameters:
    
    obj - the obj
    
    element - the element
    
    Returns:
    
    true, if successful
  - isNull
```
public static boolean isNull(Object object)
```
    Checks if an Object is null.
```
 ObjectUtils.isNull(null)      = true
 
```
    Parameters:
    
    object - the Object to check, may be null
    
    Returns:
    
    true if the object is null
  - isNotNull
```
public static boolean isNotNull(Object object)
```
    Checks if an Object is not null.
```
 ObjectUtils.isNotNull(null)      = false
 
```
    Parameters:
    
    object - the Object to check, may be null
    
    Returns:
    
    true if the object is not null.
  - isInstanceOf
```
public static boolean isInstanceOf(Object object,
                                   Class<?> klass)
```
    Checks if an Object is an instance of the given class.
```
 ObjectUtils.isInstanceOf(object, class)      = false
 
```
    Parameters:
    
    object - the Object to check, may be instance of class
    
    klass - the class
    
    Returns:
    
    true if the object is an instance of the given class.
  - isNotInstanceOf
```
public static boolean isNotInstanceOf(Object object,
                                      Class<?> klass)
```
    Checks if an Object is not an instance of the given class.
```
 ObjectUtils.isNotInstanceOf(object, class)      = false
 
```
    Parameters:
    
    object - the Object to check, may be not an instance of class
    
    klass - the class
    
    Returns:
    
    true if the object is an instance of the given class.

Class ObjectUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ObjectUtils

Method Detail

equals

equalsEx

equalsType

clone

cloneViaSerialization

writeObject

writeObject

writeObjectAsXml

writeObjectAsXml

readObject

readObject

readObjectAsXml

readObjectAsXml

objectToByteArray

byteArrayToObject

length

containsElement

isNull

isNotNull

isInstanceOf

isNotInstanceOf