Deprecated API

Contents

• Terminally Deprecated
• Methods
• Constructors

Terminally Deprecated Elements

Element	Description
com.ultikits.ultitools.interfaces.DataStore.getOperator(UltiToolsPlugin, Class<T>)	Carries no ownership check of its own (D-14/D-18) -- a DataStore implementation that overrides this method directly must call DataStore.checkOwnership(UltiToolsPlugin, Class) as its own first statement to get the refusal; the three backends shipped by this framework all do (02-12). Framework- internal callers (UltiToolsPlugin.getDataOperator) already check ownership themselves before calling this. Use DataStore.getOperator(DataScope, Class).
com.ultikits.ultitools.interfaces.DataStore.getOperator(File, Class<T>)	Enforces D-18's ownership check via DataStore.checkOwnership(java.io.File, Class) as its own first statement -- a DataStore implementation that overrides this method directly must call the same helper to get the refusal; the three backends shipped by this framework all do (02-12). Framework-internal callers (UltiToolsAPI.getDataOperator) already check ownership themselves before calling this. Use DataStore.getOperator(DataScope, Class).
com.ultikits.ultitools.interfaces.impl.SimpleTempListener()	Use the four-argument (Class, EventPriority, TempEventHandler, Function) constructor (Lombok-generated via @AllArgsConstructor, so it has no source declaration to link to) or TempListener.common(Class). Scheduled for removal in 6.4.0.
com.ultikits.ultitools.interfaces.impl.SimpleTempListener(Class<E>, TempEventHandler<E>)	Use the four-argument (Class, EventPriority, TempEventHandler, Function) constructor (Lombok-generated via @AllArgsConstructor, so it has no source declaration to link to) or TempListener.common(Class). Scheduled for removal in 6.4.0.
com.ultikits.ultitools.interfaces.impl.SimpleTempListener(Class<E>, TempEventHandler<E>, Function<E, Boolean>)	Use the four-argument (Class, EventPriority, TempEventHandler, Function) constructor (Lombok-generated via @AllArgsConstructor, so it has no source declaration to link to) or TempListener.common(Class). Scheduled for removal in 6.4.0.
com.ultikits.ultitools.interfaces.impl.SimpleTempListener(Class<E>, TempEventHandler<E>, EventPriority)	Use the four-argument (Class, EventPriority, TempEventHandler, Function) constructor (Lombok-generated via @AllArgsConstructor, so it has no source declaration to link to) or TempListener.common(Class). Scheduled for removal in 6.4.0.
com.ultikits.ultitools.interfaces.TransactionManager.getConnection()	JDBC-specific; not every TransactionManager backs a DataSource. Program against JdbcTransactionManager.getConnection() instead. This default throws UnsupportedOperationException for any backend that only implements the base interface.
com.ultikits.ultitools.interfaces.TransactionManager.setIsolationLevel(int)	JDBC-specific; program against JdbcTransactionManager.setIsolationLevel(int) instead. This default throws UnsupportedOperationException for any backend that only implements the base interface.
com.ultikits.ultitools.interfaces.TransactionManager.setReadOnly(boolean)	JDBC-specific; program against JdbcTransactionManager.setReadOnly(boolean) instead. This default throws UnsupportedOperationException for any backend that only implements the base interface.
com.ultikits.ultitools.manager.PluginDependencyResolver.PluginNode.getAllDependencies(Set<String>)	use PluginDependencyResolver.PluginNode.getAllDependencies(Set, Map), which resolves each entry through the plugin.yml-name alias map (D-12) before checking availability
com.ultikits.ultitools.utils.AnnotationUtils.findAnnotation(Class<?>, Class<T>)	This legacy lookup only walks one meta-annotation level and never merges @AliasFor overrides. Use MergedAnnotationResolver.find(java.lang.Class<?>, java.lang.Class<A>) instead, which walks the whole annotation tree and applies any @AliasFor override found along the way.

Deprecated Methods

Method	Description
com.ultikits.ultitools.interfaces.DataStore.getOperator(UltiToolsPlugin, Class<T>)	Carries no ownership check of its own (D-14/D-18) -- a DataStore implementation that overrides this method directly must call DataStore.checkOwnership(UltiToolsPlugin, Class) as its own first statement to get the refusal; the three backends shipped by this framework all do (02-12). Framework- internal callers (UltiToolsPlugin.getDataOperator) already check ownership themselves before calling this. Use DataStore.getOperator(DataScope, Class).
com.ultikits.ultitools.interfaces.DataStore.getOperator(File, Class<T>)	Enforces D-18's ownership check via DataStore.checkOwnership(java.io.File, Class) as its own first statement -- a DataStore implementation that overrides this method directly must call the same helper to get the refusal; the three backends shipped by this framework all do (02-12). Framework-internal callers (UltiToolsAPI.getDataOperator) already check ownership themselves before calling this. Use DataStore.getOperator(DataScope, Class).
com.ultikits.ultitools.interfaces.TransactionManager.getConnection()	JDBC-specific; not every TransactionManager backs a DataSource. Program against JdbcTransactionManager.getConnection() instead. This default throws UnsupportedOperationException for any backend that only implements the base interface.
com.ultikits.ultitools.interfaces.TransactionManager.setIsolationLevel(int)	JDBC-specific; program against JdbcTransactionManager.setIsolationLevel(int) instead. This default throws UnsupportedOperationException for any backend that only implements the base interface.
com.ultikits.ultitools.interfaces.TransactionManager.setReadOnly(boolean)	JDBC-specific; program against JdbcTransactionManager.setReadOnly(boolean) instead. This default throws UnsupportedOperationException for any backend that only implements the base interface.
com.ultikits.ultitools.manager.PluginDependencyResolver.PluginNode.getAllDependencies(Set<String>)	use PluginDependencyResolver.PluginNode.getAllDependencies(Set, Map), which resolves each entry through the plugin.yml-name alias map (D-12) before checking availability
com.ultikits.ultitools.utils.AnnotationUtils.findAnnotation(Class<?>, Class<T>)	This legacy lookup only walks one meta-annotation level and never merges @AliasFor overrides. Use MergedAnnotationResolver.find(java.lang.Class<?>, java.lang.Class<A>) instead, which walks the whole annotation tree and applies any @AliasFor override found along the way.
com.ultikits.ultitools.utils.SecurityPolicy.addDangerousClass(String)	Since 6.3.0 (GEN-07): this method no longer mutates ClassloadFilterAudit.SYSTEM_DANGEROUS_CLASSES or anything else. The signature is retained because it is public static on a published class.
com.ultikits.ultitools.utils.SecurityPolicy.addTrustedPackage(String)	Since 6.3.0 (GEN-07): this method no longer mutates ClassloadFilterAudit.TRUSTED_PACKAGE_PREFIXES or anything else. The signature is retained because it is public static on a published class.
com.ultikits.ultitools.utils.SecurityPolicy.isSafeClassName(String)	Since 6.3.0 (GEN-07) this method is an unconditional no-op -- the three name-based classload filter layers it enforced never protected anything (they evaluated already-trusted, already-loaded classes, not arbitrary untrusted input), and the trusted-package whitelist alone would have refused nearly every third-party module class. The signature is retained because it is public static on a published class and cannot be removed without breaking a downstream caller's compile. See the package-private ClassloadFilterAudit for what these removed layers would have refused, now recorded as telemetry.
com.ultikits.ultitools.utils.SecurityPolicy.isSafeParameterType(Class<?>)	Since 6.3.0 (GEN-07), for the same reason as SecurityPolicy.isSafeClassName(String) -- its only in-tree caller (the seven-argument PluginManager.register/with-args reflective-construction path) was deleted by GEN-04, which is what dissolved this method's former "shared-field, can't safely delete the whitelist" objection.

Deprecated Constructors

Constructor	Description
com.ultikits.ultitools.interfaces.impl.SimpleTempListener()	Use the four-argument (Class, EventPriority, TempEventHandler, Function) constructor (Lombok-generated via @AllArgsConstructor, so it has no source declaration to link to) or TempListener.common(Class). Scheduled for removal in 6.4.0.
com.ultikits.ultitools.interfaces.impl.SimpleTempListener(Class<E>, TempEventHandler<E>)	Use the four-argument (Class, EventPriority, TempEventHandler, Function) constructor (Lombok-generated via @AllArgsConstructor, so it has no source declaration to link to) or TempListener.common(Class). Scheduled for removal in 6.4.0.
com.ultikits.ultitools.interfaces.impl.SimpleTempListener(Class<E>, TempEventHandler<E>, Function<E, Boolean>)	Use the four-argument (Class, EventPriority, TempEventHandler, Function) constructor (Lombok-generated via @AllArgsConstructor, so it has no source declaration to link to) or TempListener.common(Class). Scheduled for removal in 6.4.0.
com.ultikits.ultitools.interfaces.impl.SimpleTempListener(Class<E>, TempEventHandler<E>, EventPriority)	Use the four-argument (Class, EventPriority, TempEventHandler, Function) constructor (Lombok-generated via @AllArgsConstructor, so it has no source declaration to link to) or TempListener.common(Class). Scheduled for removal in 6.4.0.