TypedService: add a way to find the best plugin

ctrueden · ctrueden · commit 2c50d024bba0 · 2016-08-18T14:26:30.000-05:00
diff --git a/src/main/java/org/scijava/plugin/TypedService.java b/src/main/java/org/scijava/plugin/TypedService.java
@@ -52,5 +52,24 @@
 public interface TypedService<DT, PT extends TypedPlugin<DT>> extends
 	PTService<PT>, Typed<DT>
 {
-	// NB: Marker interface.
+
+	/**
+	 * Gets a new instance of the highest priority plugin managed by this service
+	 * which supports the given data object according to the {@link Typed}
+	 * interface.
+	 * <p>
+	 * Note that this newly created plugin instance will <em>not</em> actually be
+	 * injected with the given data object!
+	 * </p>
+	 * 
+	 * @see HandlerService#getHandler(Object)
+	 * @see WrapperService#create(Object)
+	 */
+	default PT find(final DT data) {
+		for (final PluginInfo<PT> plugin : getPlugins()) {
+			final PT instance = pluginService().createInstance(plugin);
+			if (instance != null && instance.supports(data)) return instance;
+		}
+		return null;
+	}
 }
