com.google.gerrit.server.plugincontext

Class PluginSetContext<T>

java.lang.Object

com.google.gerrit.server.plugincontext.PluginSetContext<T>

All Implemented Interfaces:

java.lang.Iterable<PluginSetEntryContext<T>>

public class PluginSetContext<T>
extends java.lang.Object
implements java.lang.Iterable<PluginSetEntryContext<T>>

Context to invoke extensions from a DynamicSet.

When a plugin extension is invoked a logging tag with the plugin name is set. This way any errors that are triggered by the plugin extension (even if they happen in Gerrit code which is called by the plugin extension) can be easily attributed to the plugin.

Example if all exceptions should be caught and logged:

 fooPluginSetContext.runEach(foo -> foo.doFoo());
 

Example if all exceptions, but one, should be caught and logged:

 try {
   fooPluginSetContext.runEach(foo -> foo.doFoo(), MyException.class);
 } catch (MyException e) {
   // handle the exception
 }
 

Example if return values should be handled:

 for (PluginSetEntryContext c : fooPluginSetContext) {
   if (c.call(foo -> foo.handles(x))) {
     c.run(foo -> foo.doFoo());
   }
 }
 

Example if return values and a single exception should be handled:

 try {
   for (PluginSetEntryContext c : fooPluginSetContext) {
     if (c.call(foo -> foo.handles(x), MyException.class)) {
       c.run(foo -> foo.doFoo(), MyException.class);
     }
   }
 } catch (MyException e) {
   // handle the exception
 }
 

Example if several exceptions should be handled:

 for (Extension fooExtension : fooDynamicSet.entries()) {
   try (TraceContext traceContext = PluginContext.newTrace(fooExtension)) {
     fooExtension.get().doFoo();
   } catch (MyException1 | MyException2 | MyException3 e) {
     // handle the exception
   }
 }
 

Constructor Summary

Constructors

Constructor and Description
PluginSetContext(DynamicSet<T> dynamicSet, PluginContext.PluginMetrics pluginMetrics)

Method Summary

Modifier and Type	Method and Description
boolean	isEmpty() Checks if no implementations for this extension point have been registered.
java.util.Iterator<PluginSetEntryContext<T>>	iterator() Iterator that provides contexts for invoking the extensions in this set.
java.util.SortedSet<java.lang.String>	plugins() Returns a sorted list of the plugins that have registered implementations for this extension point.
void	runEach(PluginContext.ExtensionImplConsumer<T> extensionImplConsumer) Invokes each extension in the set.
<X extends java.lang.Exception> void	runEach(PluginContext.ExtensionImplConsumer<T> extensionImplConsumer, java.lang.Class<X> exceptionClass) Invokes each extension in the set.
java.util.stream.Stream<T>	stream()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

PluginSetContext

@Inject
public PluginSetContext(DynamicSet<T> dynamicSet,
                                PluginContext.PluginMetrics pluginMetrics)

Method Detail

iterator

public java.util.Iterator<PluginSetEntryContext<T>> iterator()

Iterator that provides contexts for invoking the extensions in this set.

This is useful if:

• invoking of each extension returns a result that should be handled
• a sequence of invocations should be done on each extension

Specified by:

iterator in interface java.lang.Iterable<PluginSetEntryContext<T>>

isEmpty

public boolean isEmpty()

Checks if no implementations for this extension point have been registered.

Returns:

true if no implementations for this extension point have been registered, otherwise false

plugins

public java.util.SortedSet<java.lang.String> plugins()

Returns a sorted list of the plugins that have registered implementations for this extension point.

Returns:

sorted list of the plugins that have registered implementations for this extension point

runEach

public void runEach(PluginContext.ExtensionImplConsumer<T> extensionImplConsumer)

Invokes each extension in the set. All exceptions from the plugin extensions are caught and logged.

The consumer gets the extension implementation provided that should be invoked.

All extension in the set are invoked, even if invoking some of the extensions failed.

Parameters:

extensionImplConsumer - consumer that invokes the extension

stream

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

runEach

public <X extends java.lang.Exception> void runEach(PluginContext.ExtensionImplConsumer<T> extensionImplConsumer,
                                                    java.lang.Class<X> exceptionClass)
                                             throws X extends java.lang.Exception

Invokes each extension in the set. All exceptions from the plugin extensions except exceptions of the specified type are caught and logged.

The consumer gets the extension implementation provided that should be invoked.

All extension in the set are invoked, even if invoking some of the extensions failed.

Parameters:

extensionImplConsumer - consumer that invokes the extension

exceptionClass - type of the exceptions that should be thrown

Throws:

X - expected exception from the plugin extension

X extends java.lang.Exception