public static class OfficialPlugins.OfficialPluginDescription
extends java.lang.Object
Modifier and Type | Field and Description |
---|---|
boolean |
advanced
If true, the plugin is geeky - it should not be shown except in advanced
mode even though it's not deprecated nor is it experimental.
|
boolean |
alwaysFetchLatestVersion
If true, if during startup we already have a copy of the plugin JAR on disk, the
PluginManager will ignore it and redownload the JAR instead so the user gets a
recent version if there is one.This is for being used together with plugins which are fetched from a USK uri ,
and which are not included in the official main Freenet update USK which
PluginJarUpdater watches.For plugins which are in the main Freenet update USK, setting this to true is usually not necessary: The PluginJarUpdater will update the plugin if there is a new
version.In other words: Plugins which are NOT in the official USK but have their own USK will not have the PluginJarUpdater monitor their USK, it only monitors the main
USK. |
boolean |
deprecated
If true, the plugin is obsolete.
|
boolean |
essential
If true, we will download it, blocking, over HTTP, during startup (unless
explicitly forbidden to use HTTP).
|
boolean |
experimental
If true, the plugin is experimental.
|
java.lang.String |
group
The group of the plugin.
|
long |
minimumVersion
Minimum getRealVersion().
|
java.lang.String |
name
The name of the plugin
|
long |
recommendedVersion
Recommended getRealVersion().
|
boolean |
unsupported
If true, the plugin used to be official, but is no longer supported.
|
FreenetURI |
uri
FreenetURI to get the latest version from.
Typically a CHK, not USK, since updates are deployed using the main Freenet USK of NodeUpdater 's subclass PluginJarUpdater .To allow people to insert plugin updates without giving them write access to the main USK, this *can* be an USK, but updating when a new version is inserted to the USK will only happen at certain points in time: - if the plugin is manually unloaded and loaded again. - at restart of Freenet if alwaysFetchLatestVersion is true. |
boolean |
usesXML
Does it use XML? If so, if the JVM is vulnerable, then don't load it
|
Modifier and Type | Method and Description |
---|---|
java.lang.String |
getLocalisedPluginDescription() |
java.lang.String |
getLocalisedPluginName() |
public final java.lang.String name
public final java.lang.String group
public final boolean essential
public final long minimumVersion
public final long recommendedVersion
public final boolean alwaysFetchLatestVersion
PluginManager
will ignore it and redownload the JAR instead so the user gets a
recent version if there is one.uri
,
and which are not included in the official main Freenet update USK which
PluginJarUpdater
watches.PluginJarUpdater
will update the plugin if there is a new
version.PluginJarUpdater
monitor their USK, it only monitors the main
USK. Thus, the only chance to update them is during startup by ignoring the JAR and
causing a re-download of it.public final boolean usesXML
public final FreenetURI uri
NodeUpdater
's subclass PluginJarUpdater
.alwaysFetchLatestVersion
is true. If it is false, the
cached local JAR file on disk will prevent updating!alwaysFetchLatestVersion
so we check
for updates when the node is restarted.NodeUpdater
. A typical usecase for
nevertheless using an USK here is to allow individual plugin developers to push testing
versions of their plugin on their own without giving them write-access to the main
Freenet update USK.public final boolean deprecated
public final boolean experimental
public final boolean advanced
public final boolean unsupported