Package com.intellij.openapi.extensions

Class ExtensionPointName<T>

java.lang.Object

com.intellij.openapi.extensions.BaseExtensionPointName<T>

com.intellij.openapi.extensions.ExtensionPointName<T>

public final class ExtensionPointName<T>
extends BaseExtensionPointName<T>

For project level extension points please use ProjectExtensionPointName.

Constructor Summary

Constructors

Constructor and Description
ExtensionPointName(java.lang.String name)

Method Summary

Modifier and Type	Method and Description
void	addExtensionPointListener(ExtensionPointChangeListener listener, Disposable parentDisposable)
void	addExtensionPointListener(ExtensionPointListener<T> listener, Disposable parentDisposable)
<R> R	computeSafeIfAny(java.util.function.Function<T,R> processor)
static <T> ExtensionPointName<T>	create(java.lang.String name)
java.util.stream.Stream<T>	extensions()
java.util.stream.Stream<T>	extensions(AreaInstance areaInstance) Consider using ProjectExtensionPointName.extensions(AreaInstance)
<V extends T> V	findExtension(java.lang.Class<V> instanceOf)
<V extends T> V	findExtensionOrFail(java.lang.Class<V> exactClass)
<V extends T> V	findExtensionOrFail(java.lang.Class<V> instanceOf, AreaInstance areaInstance)
<V extends T> V	findFirstAssignableExtension(java.lang.Class<V> instanceOf)
T	findFirstSafe(java.util.function.Predicate<? super T> predicate)
void	forEachExtensionSafe(java.util.function.Consumer<? super T> consumer) Invokes the given consumer for each extension registered in this extension point.
java.util.List<T>	getExtensionList()
java.util.List<T>	getExtensionList(AreaInstance areaInstance) Consider using ProjectExtensionPointName.getExtensions(AreaInstance)
T []	getExtensions() Prefer to use getExtensionList().
T []	getExtensions(AreaInstance areaInstance) Consider using ProjectExtensionPointName.getExtensions(AreaInstance)
java.util.List<T>	getExtensionsIfPointIsRegistered()
java.util.List<T>	getExtensionsIfPointIsRegistered(AreaInstance areaInstance)
java.lang.Iterable<T>	getIterable() Do not use it if there is any extension point listener, because in this case behaviour is not predictable - events will be fired during iteration and probably it will be not expected.
ExtensionPoint<T>	getPoint(AreaInstance areaInstance)
boolean	hasAnyExtensions()
void	processWithPluginDescriptor(java.util.function.BiConsumer<? super T,? super PluginDescriptor> consumer)

Methods inherited from class com.intellij.openapi.extensions.BaseExtensionPointName

getName, getPointImpl, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ExtensionPointName

public ExtensionPointName(java.lang.String name)

Method Detail

create

public static <T> ExtensionPointName<T> create(java.lang.String name)

getExtensions

public T [] getExtensions()

Prefer to use getExtensionList().

getExtensionList

public java.util.List<T> getExtensionList()

forEachExtensionSafe

public void forEachExtensionSafe(java.util.function.Consumer<? super T> consumer)

Invokes the given consumer for each extension registered in this extension point. Logs exceptions thrown by the consumer.

findFirstSafe

public T findFirstSafe(java.util.function.Predicate<? super T> predicate)

computeSafeIfAny

public <R> R computeSafeIfAny(java.util.function.Function<T,R> processor)

getExtensionsIfPointIsRegistered

public java.util.List<T> getExtensionsIfPointIsRegistered()

getExtensionsIfPointIsRegistered

public java.util.List<T> getExtensionsIfPointIsRegistered(AreaInstance areaInstance)

extensions

public java.util.stream.Stream<T> extensions()

hasAnyExtensions

public boolean hasAnyExtensions()

getExtensionList

public java.util.List<T> getExtensionList(AreaInstance areaInstance)

Consider using ProjectExtensionPointName.getExtensions(AreaInstance)

getExtensions

public T [] getExtensions(AreaInstance areaInstance)

Consider using ProjectExtensionPointName.getExtensions(AreaInstance)

extensions

public java.util.stream.Stream<T> extensions(AreaInstance areaInstance)

Consider using ProjectExtensionPointName.extensions(AreaInstance)

getPoint

public ExtensionPoint<T> getPoint(AreaInstance areaInstance)

findExtension

public <V extends T> V findExtension(java.lang.Class<V> instanceOf)

findExtensionOrFail

public <V extends T> V findExtensionOrFail(java.lang.Class<V> exactClass)

findFirstAssignableExtension

public <V extends T> V findFirstAssignableExtension(java.lang.Class<V> instanceOf)

findExtensionOrFail

public <V extends T> V findExtensionOrFail(java.lang.Class<V> instanceOf,
                                           AreaInstance areaInstance)

getIterable

public final java.lang.Iterable<T> getIterable()

Do not use it if there is any extension point listener, because in this case behaviour is not predictable - events will be fired during iteration and probably it will be not expected.

Use only for interface extension points, not for bean.

Due to internal reasons, there is no easy way to implement hasNext in a reliable manner, so, `next` may return `null` (in this case stop iteration).

Possible use cases: 1. Conditional iteration (no need to create all extensions if iteration will be stopped due to some condition). 2. Iterated only once per application (no need to cache extension list internally).

processWithPluginDescriptor

public void processWithPluginDescriptor(java.util.function.BiConsumer<? super T,? super PluginDescriptor> consumer)

addExtensionPointListener

public void addExtensionPointListener(ExtensionPointListener<T> listener,
                                      Disposable parentDisposable)

addExtensionPointListener

public void addExtensionPointListener(ExtensionPointChangeListener listener,
                                      Disposable parentDisposable)