public interface PluginInstallerImplementation
Modifier and Type | Method and Description |
---|---|
Object |
install(Set<String> codenamebases,
String displayName,
Lookup context,
Object... alternativeOptions)
Attempts to install one or more plugins.
|
Object install(@NonNull Set<String> codenamebases, String displayName, Lookup context, @NonNull Object... alternativeOptions) throws OperationException, UserCancelException
NotifyDescriptor.setOptions(java.lang.Object[])
.
After the network operations complete, the implementation should install the plugin(s). Any report from this
phase should be reported by throwing a OperationException
that describes the failure.
On successful completion, returns null
. In the case of a network error must return NotifyDescriptor.CANCEL_OPTION
if the user cancelled the operation, one of the `additionalOption` values if the user selected an alternative choice.
Retry (if offered) must be handled by the implementation.
If the user cancels the operation, the UserCancelException
should be thrown to avoid dependency on Dialogs API; modules that use Dialogs API may
return NotifyDescriptor.CANCEL_OPTION
.
codenamebases
- codenames of plugins to installdisplayName
- context for possible progress or error messagesalternativeOptions
- alternative network failure resolution choicesnull
if successful, NotifyDescriptor.CANCEL_OPTION
or one of `additionalOptions'.OperationException
- on a failed operation.UserCancelException
- if the user cancels the operation.