UTIL_System

Class · Group: Utilities

global inherited sharing class UTIL_System

Namespace, type resolution, and platform utility methods. Provides runtime introspection for managed package namespace detection, class type resolution, API version retrieval, and session management.

Example

String namespace = UTIL_System.getManagedPackageNamespace();
Type handlerType = UTIL_System.getTypeForClassName('TRG_SetFoobarDefaults');
Type validated = UTIL_System.getTypeForClassName('TRG_SetFoobarDefaults', IF_Trigger.BeforeInsert.class);

---

Methods

Method	Description
global static Type findTypeForClassName(String className)	Resolves a class name to a Type via the UTIL_TypeResolver chain without throwing an exception.
global static Type findTypeForClassName(String className, Type expectedType)	Resolves a class name to a Type via the UTIL_TypeResolver chain and verifies it is assignable to the expected type.
global static String getApiEnabledSessionId()	Will render a VF page to retrieve an API Enabled Session Id for current user To improve performance, session will be cached
global static String getClassNamespace(String className)	Will extract the namespace out of a class name, expects the class to be a top level class
global static String getManagedPackageNamespace()	Will determine the namespace for the current execution context; ie.
global static String getManagedPackageNamespacePrefix(String delimiter)	Will determine the namespace for the current execution context; ie.
global static String getNamespacePrefix(String namespace, String delimiter)	Will calculate namespace prefix as follows: if the namespace exists - namespace + delimiter else Empty String
global static String getOrgApiVersion()	Will determine the current Salesforce Org Api Version
global static String getRuntimeTypeName(Object anObject)	This method serves to retrieve the type name of the provided object
global static Type getTypeForClassName(String className)	Will return the Type for a given object class name
global static Type getTypeForClassName(String className, Type expectedType)	Will return the Type for a given object class name

findTypeForClassName

global static Type findTypeForClassName(String className)

Resolves a class name to a Type via the UTIL_TypeResolver chain without throwing an exception. Returns null when the class cannot be found or has compilation errors.

Parameters

Parameter	Type	Description
className	String	The class name to resolve.

Returns Type — The resolved Type, or null if not found.

Example

Type classType = UTIL_System.findTypeForClassName('SCHED_DeactivateUsers');

global static Type findTypeForClassName(String className, Type expectedType)

Resolves a class name to a Type via the UTIL_TypeResolver chain and verifies it is assignable to the expected type. Returns null when the class cannot be found or does not implement the expected type.

Parameters

Parameter	Type	Description
className	String	The class name to resolve.
expectedType	Type	The type the resolved class must be assignable to.

Returns Type — The resolved Type, or null if not found or not assignable.

Example

Type classType = UTIL_System.findTypeForClassName('SCHED_DeactivateUsers', Schedulable.class);

getApiEnabledSessionId

global static String getApiEnabledSessionId()

Will render a VF page to retrieve an API Enabled Session Id for current user To improve performance, session will be cached

Returns String — API enabled Session Id

Example

String sessionId = UTIL_System.getApiEnabledSessionId();

getClassNamespace

global static String getClassNamespace(String className)

Will extract the namespace out of a class name, expects the class to be a top level class

Parameters

Parameter	Type	Description
className	String	The name of the class

Returns String — Empty String or the namespace

Example

String namespace = UTIL_System.getClassNamespace('kern.UTIL_System'); // 'kern'
String empty = UTIL_System.getClassNamespace('MyClass'); // ''

getManagedPackageNamespace

global static String getManagedPackageNamespace()

Will determine the namespace for the current execution context; ie. Is code currently running sitting in a package and the namespace of the package

Returns String — Empty String or the package namespace

Example

String namespace = UTIL_System.getManagedPackageNamespace(); // e.g. 'kern' or ''

getManagedPackageNamespacePrefix

global static String getManagedPackageNamespacePrefix(String delimiter)

Will determine the namespace for the current execution context; ie. Is code currently running sitting in a package and the namespace of the package and add the provided delimiter (if a namespace exists)

Parameters

Parameter	Type	Description
delimiter	String	The delimiter for the item

Returns String — Empty String or the namespace with prefix

Example

// Returns 'Sfdc_Surveys.' when namespace exists with '.' delimiter
String namespaceWithDot = UTIL_System.getManagedPackageNamespacePrefix('.');
// Returns 'Sfdc_Surveys__' when namespace exists with '__' delimiter
String namespaceWithUnderscores = UTIL_System.getManagedPackageNamespacePrefix('__');
// Returns '' when namespace does not exist

getNamespacePrefix

global static String getNamespacePrefix(String namespace, String delimiter)

Will calculate namespace prefix as follows: if the namespace exists - namespace + delimiter else Empty String

Parameters

Parameter	Type	Description
namespace	String	The provided namespace
delimiter	String	The delimiter for the item

Returns String — Empty String or the namespace with prefix

Example

String prefix = UTIL_System.getNamespacePrefix('kern', '.'); // 'kern.'

getOrgApiVersion

global static String getOrgApiVersion()

Will determine the current Salesforce Org Api Version

Returns String — the version in the form of "59.0"

Example

String version = UTIL_System.getOrgApiVersion(); // e.g. '65.0'

getRuntimeTypeName

global static String getRuntimeTypeName(Object anObject)

This method serves to retrieve the type name of the provided object

Parameters

Parameter	Type	Description
anObject	Object	The object to evaluate

Returns String — Name of Class of the Object provided

Example

String typeName = UTIL_System.getRuntimeTypeName((Object)'Hello'); // 'String'

getTypeForClassName

global static Type getTypeForClassName(String className)

Will return the Type for a given object class name

Parameters

Parameter	Type	Description
className	String	The class name to find a type for (please ensure that you prefix namespace if required)

Returns Type — The type of the object

Throws

Exception	Description
IllegalArgumentException	If no type if found for the given class name

Example

Type classType = UTIL_System.getTypeForClassName('UTIL_System');

global static Type getTypeForClassName(String className, Type expectedType)

Will return the Type for a given object class name

Parameters

Parameter	Type	Description
className	String	The class name to find a type for (please ensure that you prefix namespace if required)
expectedType	Type	The expected type that the type for the class is assignable from

Returns Type — The type of the object

Throws

Exception	Description
IllegalArgumentException	If no type if found for the given class name
TypeException	if the type is not compatible with the expected type

Example

Type classType = UTIL_System.getTypeForClassName('UTIL_System', Object.class);