Package com.logicaldoc.core.automation

Class ClassTool

java.lang.Object

com.logicaldoc.core.automation.ClassTool

public class ClassTool
extends Object

Utility functions for manipulating classes and resources and for other programming language aspects

Since:

7.5.1

Author:

Marco Meschieri - LogicalDOC

Constructor Summary

Constructors

Constructor	Description
ClassTool()

Method Summary

Modifier and Type	Method	Description
Object	copy(Object instance)	Makes a copy(clone) of a given object instance.
boolean	isEmpty(String str)	Checks if a given string is null or empty
boolean	isNull(Object instance)	Checks if a given instance is null
Object	newInstance(String className)	Creates a new instance of a class whose constructor does not have parameters

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ClassTool

public ClassTool()

Method Detail

newInstance

public Object newInstance(String className)
                   throws InstantiationException,
                          IllegalAccessException,
                          ClassNotFoundException,
                          IllegalArgumentException,
                          InvocationTargetException,
                          NoSuchMethodException,
                          SecurityException

Creates a new instance of a class whose constructor does not have parameters

Parameters:

className - name of the class, if the class is inside the package com.logicaldoc you can just avoid the prefix, e.g.: for com.logicaldoc.stamp.automation.StampTool you can simply use stamp.automation.StampTool)

Returns:

the instantiated object

Throws:

InstantiationException - the class does not have a constructor without parameters

IllegalAccessException - the class or the constructor is private or not visible

ClassNotFoundException - you specified an unexisting class

SecurityException - the specified class cannot be instantiated due to security constraints

NoSuchMethodException - no public constructor without parameters

InvocationTargetException - the constructor raised an exception

IllegalArgumentException - no public constructor without parameters

isNull

public boolean isNull(Object instance)

Checks if a given instance is null

Parameters:

instance - the object to evaluate

Returns:

true only if the passed instance is null

isEmpty

public boolean isEmpty(String str)

Checks if a given string is null or empty

Parameters:

str - the string to evaluate

Returns:

true only if the passed string is null or empty

copy

public Object copy(Object instance)

Makes a copy(clone) of a given object instance.

Attention: for security reasons it will not be used the cloned() method of the given objet but a new instance of the given object's class is invoked by passing the same instance. As a result they may be copied only those objects that define a public construction that accepts the same class as single argument.

Parameters:

instance - the object to clone

Returns:

the cloned object