Package io.microsphere.classloading

Interface URLClassPathHandle

All Superinterfaces:

java.lang.Comparable<Prioritized>, Prioritized

All Known Implementing Classes:

AbstractURLClassPathHandle, ClassicURLClassPathHandle, ModernURLClassPathHandle, NoOpURLClassPathHandle, ServiceLoadingURLClassPathHandle

public interface URLClassPathHandle
extends Prioritized

A strategy interface for handling URL Class-Path entries in a ClassLoader. Implementations of this interface can provide custom logic for interacting with URLs related to class loading, such as retrieving or removing URLs from a class loader.

This interface extends Prioritized, allowing implementations to define their priority order. The default implementation of getPriority() returns Prioritized.MIN_PRIORITY, making it the lowest priority unless overridden.

Example Implementation

 public class ClassicURLClassPathHandle implements URLClassPathHandle {

     private final int priority;

     public ClassicURLClassPathHandle(int priority) {
         this.priority = priority;
     }

     public boolean supports() {
         return true; // Always support classic handling
     }

     public boolean removeURL(ClassLoader classLoader, URL url) {
         // Custom logic to remove a URL from the class loader
         return false; // Placeholder implementation
     }

     public int getPriority() {
         return priority; // Custom priority
     }
 }
 

Since:

1.0.0

Author:

Mercy

See Also:

ClassicURLClassPathHandle, ModernURLClassPathHandle, Prioritized

Field Summary

Fields inherited from interface io.microsphere.lang.Prioritized

COMPARATOR, MAX_PRIORITY, MIN_PRIORITY, NORMAL_PRIORITY

Method Summary

Modifier and Type	Method	Description
default int	getPriority()	Get the priority
default java.net.URL[]	getURLs(java.lang.ClassLoader classLoader)	Get the Class-Path URLs from the specified ClassLoader
default boolean	initializeLoaders(java.lang.ClassLoader classLoader)	Initialize the loaders of URL Class-Path from URLClassLoader
boolean	removeURL(java.lang.ClassLoader classLoader, java.net.URL url)	Remove the Class-Path URL from the specified ClassLoader
boolean	supports()	Supports or not

Methods inherited from interface io.microsphere.lang.Prioritized

compareTo

Method Detail

supports

boolean supports()

Supports or not

Returns:

if supports, return true, otherwise false

getURLs

@Nonnull
default java.net.URL[] getURLs(@Nullable
                               java.lang.ClassLoader classLoader)

Get the Class-Path URLs from the specified ClassLoader

Parameters:

classLoader - the specified ClassLoader

Returns:

the non-null array of URLs

initializeLoaders

default boolean initializeLoaders(@Nullable
                                  java.lang.ClassLoader classLoader)

Initialize the loaders of URL Class-Path from URLClassLoader

Parameters:

classLoader - ClassLoader

Returns:

true if initialized, otherwise false

removeURL

boolean removeURL(@Nullable
                  java.lang.ClassLoader classLoader,
                  @Nullable
                  java.net.URL url)

Remove the Class-Path URL from the specified ClassLoader

Parameters:

classLoader - the specified ClassLoader

url - the Class-Path URL

Returns:

if removed, return true, otherwise false

getPriority

default int getPriority()

Get the priority

Specified by:

getPriority in interface Prioritized

Returns:

the default value is Prioritized.MIN_PRIORITY