OperationContainer (Auto Update Services)

java.lang.Object
- org.netbeans.api.autoupdate.OperationContainer<Support>

Type Parameters:

Support - the type of support for performing chosen operation like OperationSupport or InstallSupport
```
public final class OperationContainer<Support>
extends Object
```
An object that keeps requests for operations upon instances of UpdateEelement (like install, uninstall, update, enable, disable), provides checks whether chosen operation is allowed (e.g. already installed plugin cannot be scheduled for install again), provides information which additional plugins are required and so on.
Typical scenario how to use:
- use one of factory methods for creating instance of OperationContainer for chosen operation: OperationContainer.createForInstall(), OperationContainer.createForUninstall(), OperationContainer.createForUpdate(), OperationContainer.createForEnable(),OperationContainer.createForDisable()
- add instances of UpdateElement (see OperationContainer.add(java.util.Collection<org.netbeans.api.autoupdate.UpdateElement>))
- check if additional required instances of UpdateElement are needed (OperationContainer.OperationInfo.getRequiredElements()), if so then these required instances should be also added
- next can be tested for broken dependencies (OperationContainer.OperationInfo.getBrokenDependencies())
- call method OperationContainer.getSupport() to get either InstallSupport or OperationSupport that can be used for performing operation
Code example:
```
 
 UpdateElement element = ...;
 OperationContainer<OperationSupport> container = createForDirectInstall();
 OperationInfo<Support> info = container.add(element);
 Set<UpdateElement> required = info.getRequiredElements();
 container.add(required);
 OperationSupport support = container.getSupport();
 support.doOperation(null);
 
```

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class OperationContainer.OperationInfo<Support>
Provides additional information

Nested Classes
Modifier and Type	Class and Description
`static class`	`OperationContainer.OperationInfo<Support>` Provides additional information

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`add(Collection<UpdateElement> elems)` Adds all `elems`
`void`	`add(Map<UpdateUnit,UpdateElement> elems)` Adds all `elems`
`OperationContainer.OperationInfo<Support>`	`add(UpdateElement updateElement)` Adds `updateElement`
`OperationContainer.OperationInfo<Support>`	`add(UpdateUnit updateUnit, UpdateElement updateElement)` Adds `updateElement`
`boolean`	`canBeAdded(UpdateUnit updateUnit, UpdateElement updateElement)` Check if `updateElement` can be added (`OperationContainer.add(java.util.Collection<org.netbeans.api.autoupdate.UpdateElement>)`)
`boolean`	`contains(UpdateElement updateElement)`
`static OperationContainer<OperationSupport>`	`createForCustomInstallComponent()` The factory method to construct instance of `OperationContainer` for installation of custom component
`static OperationContainer<OperationSupport>`	`createForCustomUninstallComponent()` The factory method to construct instance of `OperationContainer` for uninstallation of custom component
`static OperationContainer<OperationSupport>`	`createForDirectDisable()` The factory method to construct instance of `OperationContainer` for disable operation
`static OperationContainer<OperationSupport>`	`createForDirectInstall()` The factory method to construct instance of `OperationContainer` for install operation
`static OperationContainer<OperationSupport>`	`createForDirectUninstall()` The factory method to construct instance of `OperationContainer` for uninstall operation
`static OperationContainer<OperationSupport>`	`createForDirectUpdate()` The factory method to construct instance of `OperationContainer` for update operation
`static OperationContainer<OperationSupport>`	`createForDisable()` The factory method to construct instance of `OperationContainer` for disable operation
`static OperationContainer<OperationSupport>`	`createForEnable()` The factory method to construct instance of `OperationContainer` for enable operation
`static OperationContainer<InstallSupport>`	`createForInstall()` The factory method to construct instance of `OperationContainer` for install operation
`static OperationContainer<InstallSupport>`	`createForInternalUpdate()` The factory method to construct instance of `OperationContainer` for internal update operation
`static OperationContainer<OperationSupport>`	`createForUninstall()` The factory method to construct instance of `OperationContainer` for uninstall operation
`static OperationContainer<InstallSupport>`	`createForUpdate()` The factory method to construct instance of `OperationContainer` for update operation
`Support`	`getSupport()`
`List<OperationContainer.OperationInfo<Support>>`	`listAll()`
`List<OperationContainer.OperationInfo<Support>>`	`listInvalid()`
`void`	`remove(Collection<UpdateElement> elems)` Removes all `elems`
`void`	`remove(OperationContainer.OperationInfo<Support> op)` Removes `op`
`boolean`	`remove(UpdateElement updateElement)` Removes `updateElement`
`void`	`removeAll()` Removes all content
`void`	`setUnpack200(File executable)` Specifies location of unpack200 executable.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Method Detail
  - createForInstall
```
public static OperationContainer<InstallSupport> createForInstall()
```
    The factory method to construct instance of OperationContainer for install operation
    
    Returns:
    
    newly constructed instance of OperationContainer for install operation
  - createForInternalUpdate
```
public static OperationContainer<InstallSupport> createForInternalUpdate()
```
    The factory method to construct instance of OperationContainer for internal update operation
    
    Returns:
    
    newly constructed instance of OperationContainer for internal update operation
    
    Since:
    
    1.11
  - createForDirectInstall
```
public static OperationContainer<OperationSupport> createForDirectInstall()
```
    The factory method to construct instance of OperationContainer for install operation
    
    Returns:
    
    newly constructed instance of OperationContainer for install operation
  - createForUpdate
```
public static OperationContainer<InstallSupport> createForUpdate()
```
    The factory method to construct instance of OperationContainer for update operation
    
    Returns:
    
    newly constructed instance of OperationContainer for update operation
  - createForDirectUpdate
```
public static OperationContainer<OperationSupport> createForDirectUpdate()
```
    The factory method to construct instance of OperationContainer for update operation
    
    Returns:
    
    newly constructed instance of OperationContainer for update operation
  - createForUninstall
```
public static OperationContainer<OperationSupport> createForUninstall()
```
    The factory method to construct instance of OperationContainer for uninstall operation
    
    Returns:
    
    newly constructed instance of OperationContainer for uninstall operation
  - createForDirectUninstall
```
public static OperationContainer<OperationSupport> createForDirectUninstall()
```
    The factory method to construct instance of OperationContainer for uninstall operation
    
    Returns:
    
    newly constructed instance of OperationContainer for uninstall operation
  - createForEnable
```
public static OperationContainer<OperationSupport> createForEnable()
```
    The factory method to construct instance of OperationContainer for enable operation
    
    Returns:
    
    newly constructed instance of OperationContainer for enable operation
  - createForDisable
```
public static OperationContainer<OperationSupport> createForDisable()
```
    The factory method to construct instance of OperationContainer for disable operation
    
    Returns:
    
    newly constructed instance of OperationContainer for disable operation
  - createForDirectDisable
```
public static OperationContainer<OperationSupport> createForDirectDisable()
```
    The factory method to construct instance of OperationContainer for disable operation
    
    Returns:
    
    newly constructed instance of OperationContainer for disable operation
  - createForCustomInstallComponent
```
public static OperationContainer<OperationSupport> createForCustomInstallComponent()
```
    The factory method to construct instance of OperationContainer for installation of custom component
    
    Returns:
    
    newly constructed instance of OperationContainer for installation of custom component
  - createForCustomUninstallComponent
```
public static OperationContainer<OperationSupport> createForCustomUninstallComponent()
```
    The factory method to construct instance of OperationContainer for uninstallation of custom component
    
    Returns:
    
    newly constructed instance of OperationContainer for uninstallation of custom component
  - getSupport
```
public Support getSupport()
```
    Returns:
    
    either OperationSupport or InstallSupport depending on type parameter of OperationContainer<Support> or null if the OperationContainer is empty or contains any invalid elements
    
    See Also:
    
    OperationContainer.listAll(), See the difference between {@link #createForInstall} and {@link #createForDirectInstall} for example
  - canBeAdded
```
public boolean canBeAdded(UpdateUnit updateUnit,
                          UpdateElement updateElement)
```
    Check if updateElement can be added (OperationContainer.add(java.util.Collection<org.netbeans.api.autoupdate.UpdateElement>))
    
    Parameters:
    
    updateUnit -
    
    updateElement - to be inserted.
    
    Returns:
    
    true if chosen operation upon updateElement is allowed
  - add
```
public void add(Collection<UpdateElement> elems)
```
    Adds all elems
    
    Parameters:
    
    elems - to be inserted.
  - add
```
public void add(Map<UpdateUnit,UpdateElement> elems)
```
    Adds all elems
    
    Parameters:
    
    elems - to be inserted.
  - add
```
public OperationContainer.OperationInfo<Support> add(UpdateUnit updateUnit,
                                                     UpdateElement updateElement)
```
    Adds updateElement
    
    Parameters:
    
    updateUnit -
    
    updateElement -
    
    Returns:
    
    instance of OperationContainer.OperationInfo<Support> or null if the UpdateElement is already present in the container
  - add
```
public OperationContainer.OperationInfo<Support> add(UpdateElement updateElement)
```
    Adds updateElement
    
    Parameters:
    
    updateElement -
    
    Returns:
    
    instance of OperationContainer.OperationInfo<Support> or null if the UpdateElement is already present in the container
  - remove
```
public void remove(Collection<UpdateElement> elems)
```
    Removes all elems
    
    Parameters:
    
    elems -
  - remove
```
public boolean remove(UpdateElement updateElement)
```
    Removes updateElement
    
    Parameters:
    
    updateElement -
    
    Returns:
    
    true if successfully added
  - contains
```
public boolean contains(UpdateElement updateElement)
```
    Parameters:
    
    updateElement -
    
    Returns:
    
    true if this instance of OperationContainer contains the specified updateElement.
  - listAll
```
public List<OperationContainer.OperationInfo<Support>> listAll()
```
    Returns:
    
    all instances of OperationContainer.OperationInfo<Support> from this instance of OperationContainer
  - listInvalid
```
public List<OperationContainer.OperationInfo<Support>> listInvalid()
```
    Returns:
    
    all invalid instances of OperationContainer.OperationInfo<Support> from this instance of OperationContainer
  - remove
```
public void remove(OperationContainer.OperationInfo<Support> op)
```
    Removes op
    
    Parameters:
    
    op -
  - removeAll
```
public void removeAll()
```
    Removes all content
  - setUnpack200
```
public final void setUnpack200(File executable)
```
    Specifies location of unpack200 executable. unpack200 has been removed from JDK 14. As such it is not possible to unpack older NBM files without providing alternative JDK implementation of this file.
    
    Parameters:
    
    executable - path to the executable
    
    Since:
    
    1.65
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class OperationContainer<Support>

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

createForInstall

createForInternalUpdate

createForDirectInstall

createForUpdate

createForDirectUpdate

createForUninstall

createForDirectUninstall

createForEnable

createForDisable

createForDirectDisable

createForCustomInstallComponent

createForCustomUninstallComponent

getSupport

canBeAdded

add

add

add

add

remove

remove

contains

listAll

listInvalid

remove

removeAll

setUnpack200

toString