Package com.logicaldoc.core.automation
Class ClassTool
java.lang.Object
com.logicaldoc.core.automation.ClassTool
Utility functions for manipulating classes and resources and for other
programming language aspects
- Since:
- 7.5.1
- Author:
- Marco Meschieri - LogicalDOC
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionMakes a copy(clone) of a given object instance.Class<?>
Retrieves the class specificationboolean
Checks if a given string is null or emptyboolean
Checks if a given instance is nullnewInstance
(String className) Creates a new instance of a class whose constructor does not have parameters
-
Constructor Details
-
ClassTool
public ClassTool()
-
-
Method Details
-
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 parametersIllegalAccessException
- the class or the constructor is private or not visibleClassNotFoundException
- you specified an unexisting classSecurityException
- the specified class cannot be instantiated due to security constraintsNoSuchMethodException
- no public constructor without parametersInvocationTargetException
- the constructor raised an exceptionIllegalArgumentException
- no public constructor without parameters
-
forName
Retrieves the class specification- 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 class object
- Throws:
ClassNotFoundException
- you specified an unexisting class
-
isNull
Checks if a given instance is null- Parameters:
instance
- the object to evaluate- Returns:
- true only if the passed instance is null
-
isEmpty
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
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
-