com.google.gerrit.server.plugins

Class JarScanner

java.lang.Object

com.google.gerrit.server.plugins.JarScanner

All Implemented Interfaces:

PluginContentScanner, java.lang.AutoCloseable

public class JarScanner
extends java.lang.Object
implements PluginContentScanner, java.lang.AutoCloseable

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JarScanner.ClassData

Nested classes/interfaces inherited from interface com.google.gerrit.server.plugins.PluginContentScanner

PluginContentScanner.ExtensionMetaData

Field Summary

Fields inherited from interface com.google.gerrit.server.plugins.PluginContentScanner

EMPTY

Constructor Summary

Constructors

Constructor and Description
JarScanner(java.nio.file.Path src)

Method Summary

Modifier and Type	Method and Description
void	close()
java.util.Enumeration<PluginEntry>	entries() Return all the resources inside a plugin
java.util.List<java.lang.String>	findSubClassesOf(java.lang.Class<?> superClass)
java.util.Optional<PluginEntry>	getEntry(java.lang.String resourcePath) Return the plugin resource associated to a path
java.io.InputStream	getInputStream(PluginEntry entry) Return the InputStream of the resource entry
java.util.jar.Manifest	getManifest() Return the plugin meta-data manifest
java.util.Map<java.lang.Class<? extends java.lang.annotation.Annotation>,java.lang.Iterable<PluginContentScanner.ExtensionMetaData>>	scan(java.lang.String pluginName, java.lang.Iterable<java.lang.Class<? extends java.lang.annotation.Annotation>> annotations) Scans the plugin for declared public annotated classes

Methods inherited from class java.lang.Object

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

Constructor Detail

JarScanner

public JarScanner(java.nio.file.Path src)
           throws java.io.IOException

Throws:

java.io.IOException

Method Detail

scan

public java.util.Map<java.lang.Class<? extends java.lang.annotation.Annotation>,java.lang.Iterable<PluginContentScanner.ExtensionMetaData>> scan(java.lang.String pluginName,
                                                                                                                                                 java.lang.Iterable<java.lang.Class<? extends java.lang.annotation.Annotation>> annotations)
                                                                                                                                          throws InvalidPluginException

Description copied from interface: PluginContentScanner

Scans the plugin for declared public annotated classes

Specified by:

scan in interface PluginContentScanner

Parameters:

pluginName - the plugin name

annotations - annotations declared by the plugin classes

Returns:

map of annotations and associated plugin classes found

Throws:

InvalidPluginException - if the plugin is not valid or corrupted

findSubClassesOf

public java.util.List<java.lang.String> findSubClassesOf(java.lang.Class<?> superClass)
                                                  throws java.io.IOException

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException

getEntry

public java.util.Optional<PluginEntry> getEntry(java.lang.String resourcePath)
                                         throws java.io.IOException

Description copied from interface: PluginContentScanner

Return the plugin resource associated to a path

Specified by:

getEntry in interface PluginContentScanner

Parameters:

resourcePath - full path of the resource inside the plugin package

Returns:

the resource object or Optional.absent() if the resource was not found

Throws:

java.io.IOException - if there was a problem retrieving the resource

entries

public java.util.Enumeration<PluginEntry> entries()

Description copied from interface: PluginContentScanner

Return all the resources inside a plugin

Specified by:

entries in interface PluginContentScanner

Returns:

the enumeration of all resources found

getInputStream

public java.io.InputStream getInputStream(PluginEntry entry)
                                   throws java.io.IOException

Description copied from interface: PluginContentScanner

Return the InputStream of the resource entry

Specified by:

getInputStream in interface PluginContentScanner

Parameters:

entry - resource entry inside the plugin package

Returns:

the resource input stream

Throws:

java.io.IOException - if there was an I/O problem accessing the resource

getManifest

public java.util.jar.Manifest getManifest()
                                   throws java.io.IOException

Description copied from interface: PluginContentScanner

Return the plugin meta-data manifest

Specified by:

getManifest in interface PluginContentScanner

Returns:

Manifest of the plugin or null if plugin has no meta-data

Throws:

java.io.IOException - if an I/O problem occurred whilst accessing the Manifest