Can I do it with reflection or something like that?
11 Answers
I have been searching for a while and there seems to be different approaches, here is a summary:
reflections library is pretty popular if u don't mind adding the dependency. It would look like this:
Reflections reflections = new Reflections("firstdeveloper.examples.reflections"); Set<Class<? extends Pet>> classes = reflections.getSubTypesOf(Pet.class);
ServiceLoader (as per erickson answer) and it would look like this:
ServiceLoader<Pet> loader = ServiceLoader.load(Pet.class); for (Pet implClass : loader) { System.out.println(implClass.getClass().getSimpleName()); // prints Dog, Cat }
Note that for this to work you need to define
Pet
as a ServiceProviderInterface (SPI) and declare its implementations. you do that by creating a file inresources/META-INF/services
with the nameexamples.reflections.Pet
and declare all implementations ofPet
in itexamples.reflections.Dog examples.reflections.Cat
package-level annotation. here is an example:
Package[] packages = Package.getPackages(); for (Package p : packages) { MyPackageAnnotation annotation = p.getAnnotation(MyPackageAnnotation.class); if (annotation != null) { Class<?>[] implementations = annotation.implementationsOfPet(); for (Class<?> impl : implementations) { System.out.println(impl.getSimpleName()); } } }
and the annotation definition:
@Retention(RetentionPolicy.RUNTIME) @Target(ElementType.PACKAGE) public @interface MyPackageAnnotation { Class<?>[] implementationsOfPet() default {}; }
and you must declare the package-level annotation in a file named
package-info.java
inside that package. here are sample contents:@MyPackageAnnotation(implementationsOfPet = {Dog.class, Cat.class}) package examples.reflections;
Note that only packages that are known to the ClassLoader at that time will be loaded by a call to
Package.getPackages()
.
In addition, there are other approaches based on URLClassLoader that will always be limited to classes that have been already loaded, Unless you do a directory-based search.
-
-
@carlspring I can not make an absolute statement about their relative efficiency but the first alternative (reflections library) worked pretty well for me. May 30, 2016 at 19:45
-
How does DriverManager of JDBC work? Isn't it doing the similar thing (searching all implementations of Driver interface in classpath)? Feb 16, 2019 at 22:00
-
1@AlexSemeniuk I think they now support the Service Loader/Provider mechanism (approach #2 above) according to their docs "The DriverManager methods getConnection and getDrivers have been enhanced to support the Java Standard Edition Service Provider mechanism." See docs.oracle.com/javase/8/docs/api/java/sql/DriverManager.html Feb 18, 2019 at 15:13
-
1It’s worth noting that the service provider mechanism has been integrated into the module system with Java 9, which makes it even more convenient than package level annotations, i.e. you don’t need to create your own annotation type, can declare the implementations in the module-info you’ll create anyway when writing modular software and get compile-time feedback regarding the validity of the implementation.– HolgerMar 4, 2020 at 10:52
What erickson said, but if you still want to do it then take a look at Reflections. From their page:
Using Reflections you can query your metadata for:
- get all subtypes of some type
- get all types annotated with some annotation
- get all types annotated with some annotation, including annotation parameters matching
- get all methods annotated with some
-
14more specific:
new Reflections("my.package").getSubTypesOf(MyInterface.class)
– zappMar 16, 2013 at 13:12 -
@zapp What do you pass to
Reflections()
when you a) don't know the name of any package, and b) need it to scan all packages? (i don't know what packages the developers may have chosen to place any and all implementations in).– Ian BoydJul 22, 2022 at 4:50
In general, it's expensive to do this. To use reflection, the class has to be loaded. If you want to load every class available on the classpath, that will take time and memory, and isn't recommended.
If you want to avoid this, you'd need to implement your own class file parser that operated more efficiently, instead of reflection. A byte code engineering library may help with this approach.
The Service Provider mechanism is the conventional means to enumerate implementations of a pluggable service, and has become more established with the introduction of Project Jigsaw (modules) in Java 9. Use the ServiceLoader
in Java 6, or implement your own in earlier versions. I provided an example in another answer.
-
6Unfortunately, the Service Provider mechanism requires you to list the classes that might be in the list of interest in a separate file which is often unfeasible.– averaskoMay 31, 2015 at 15:41
-
5It's feasible to write source code implementing an interface, compile it, and deploy it, but infeasible to include a text file with the implementation's FQN? That's seldom, if ever, the case. Hardly "often."– ericksonMar 12, 2017 at 16:45
-
How does DriverManager of JDBC work? Isn't it doing the similar thing (searching all implementations of Driver interface in classpath)? Feb 16, 2019 at 22:01
-
1@AlexSemeniuk No. it uses the Service Loader mechanism I describe above; A JDBC 4.0+ driver must list its name in
META-INF/services/java.sql.Driver
– ericksonFeb 16, 2019 at 22:06 -
Making a developer edit an unrelated file is a non-starter. It has to work as good as .NET/CLR reflection: where we can find all implementations and it just works.– Ian BoydJul 22, 2022 at 4:19
Spring has a pretty simple way to acheive this:
public interface ITask {
void doStuff();
}
@Component
public class MyTask implements ITask {
public void doStuff(){}
}
Then you can autowire a list of type ITask
and Spring will populate it with all implementations:
@Service
public class TaskService {
@Autowired
private List<ITask> tasks;
}
-
8Not exactly, Spring will populate it will all beans of type ITask, which is not quite the same. Nov 6, 2018 at 7:32
The most robust mechanism for listing all classes that implement a given interface is currently ClassGraph, because it handles the widest possible array of classpath specification mechanisms, including the new JPMS module system. (I am the author.)
try (ScanResult scanResult = new ClassGraph().whitelistPackages("x.y.z")
.enableClassInfo().scan()) {
for (ClassInfo ci : scanResult.getClassesImplementing("x.y.z.SomeInterface")) {
foundImplementingClass(ci); // Do something with the ClassInfo object
}
}
-
2The ClassGraph library works like a sharm, thank you @Luke Hutchison Jan 1, 2020 at 8:33
With ClassGraph it's pretty simple:
Groovy code to find implementations of my.package.MyInterface
:
@Grab('io.github.classgraph:classgraph:4.6.18')
import io.github.classgraph.*
new ClassGraph().enableClassInfo().scan().withCloseable { scanResult ->
scanResult.getClassesImplementing('my.package.MyInterface').findAll{!it.abstract}*.name
}
-
You need to call
scan().withCloseable { ... }
in Groovy, or use try-with-resources in Java: github.com/classgraph/classgraph/wiki/… Also, the last part should be.name
, not.className
, since.getName()
is the right method to get the name of a class from aClassInfo
object. Oct 5, 2019 at 11:03
What erikson said is best. Here's a related question and answer thread - http://www.velocityreviews.com/forums/t137693-find-all-implementing-classes-in-classpath.html
The Apache BCEL library allows you to read classes without loading them. I believe it will be faster because you should be able to skip the verification step. The other problem with loading all classes using the classloader is that you will suffer a huge memory impact as well as inadvertently run any static code blocks which you probably do not want to do.
The Apache BCEL library link - http://jakarta.apache.org/bcel/
Yes, the first step is to identify "all" the classes that you cared about. If you already have this information, you can enumerate through each of them and use instanceof to validate the relationship. A related article is here: https://web.archive.org/web/20100226233915/www.javaworld.com/javaworld/javatips/jw-javatip113.html
Also, if you are writing an IDE plugin (where what you are trying to do is relatively common), then the IDE typically offers you more efficient ways to access the class hierarchy of the current state of the user code.
I ran into the same issue. My solution was to use reflection to examine all of the methods in an ObjectFactory class, eliminating those that were not createXXX() methods returning an instance of one of my bound POJOs. Each class so discovered is added to a Class[] array, which was then passed to the JAXBContext instantiation call. This performs well, needing only to load the ObjectFactory class, which was about to be needed anyway. I only need to maintain the ObjectFactory class, a task either performed by hand (in my case, because I started with POJOs and used schemagen), or can be generated as needed by xjc. Either way, it is performant, simple, and effective.
A new version of @kaybee99's answer, but now returning what the user asks: the implementations...
Spring has a pretty simple way to acheive this:
public interface ITask {
void doStuff();
default ITask getImplementation() {
return this;
}
}
@Component
public class MyTask implements ITask {
public void doStuff(){}
}
Then you can autowire a list of type ITask
and Spring will populate it with all implementations:
@Service
public class TaskService {
@Autowired(required = false)
private List<ITask> tasks;
if ( tasks != null)
for (ITask<?> taskImpl: tasks) {
taskImpl.doStuff();
}
}