org.netbeans.spi.autoupdate.UpdateItem Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.netbeans.spi.autoupdate;
import java.net.URL;
import java.util.Locale;
import java.util.Set;
import java.util.jar.Manifest;
import org.netbeans.modules.autoupdate.services.Trampoline;
import org.netbeans.modules.autoupdate.updateprovider.FeatureItem;
import org.netbeans.modules.autoupdate.updateprovider.LocalizationItem;
import org.netbeans.modules.autoupdate.updateprovider.ModuleItem;
import org.netbeans.modules.autoupdate.updateprovider.NativeComponentItem;
import org.netbeans.modules.autoupdate.updateprovider.UpdateItemImpl;
/** Represents a item of content provider by UpdateProvider. These items are exposed to
* Autoupdate infrastructure what works on them.
*
* @author Jiri Rechtacek
*/
public final class UpdateItem {
static {
Trampoline.SPI = new TrampolineSPI ();
}
UpdateItemImpl impl;
UpdateItem original;
/** Creates a new instance of UpdateItem */
@SuppressWarnings("LeakingThisInConstructor")
UpdateItem (UpdateItemImpl item) {
impl = item;
item.setUpdateItem (this);
}
/** Creates UpdateItem which represents NetBeans Module in Autoupdate infrastructure.
* UpdateItem is identify by codeName and specificationVersion.
*
* @param codeName code name of module
* @param specificationVersion specification version of module
* @param distribution URL to NBM file
* @param author name of module author or null
* @param downloadSize size of NBM file in bytes
* @param homepage homepage of module or null
* @param publishDate date of publish of item, in date format "yyyy/MM/dd"
* @param category name of category
* @param manifest java.util.jar.Manifest describes the module in NetBeans module system
* @param isEager says if the module is eager or not
* @param isAutoload says if the module is autoload or not
* @param needsRestart if true then IDE must be restarted after module installation
* @param isGlobal control if the module will be installed into the installation directory or into user's dir
* @param targetCluster name of cluster where new module will be installed if installation isGlobal
* @param license UpdateLicense represents license name and text of license agreement
* @return UpdateItem
*/
public static UpdateItem createModule (
String codeName,
String specificationVersion,
URL distribution,
String author,
String downloadSize,
String homepage,
String publishDate,
String category,
Manifest manifest,
Boolean isEager,
Boolean isAutoload,
Boolean needsRestart,
Boolean isGlobal,
String targetCluster,
UpdateLicense license) {
ModuleItem item = new ModuleItem (codeName, specificationVersion, distribution,
author, publishDate, downloadSize, homepage, category,
manifest, isEager, isAutoload,
needsRestart, isGlobal, false, targetCluster, license.impl);
return new UpdateItem (item);
}
/** Creates UpdateItem which represents NetBeans Module in Autoupdate infrastructure.
* UpdateItem is identify by codeName and specificationVersion.
*
* @param codeName code name of module
* @param specificationVersion specification version of module
* @param distribution URL to NBM file
* @param author name of module author or null
* @param downloadSize size of NBM file in bytes
* @param homepage homepage of module or null
* @param publishDate date of publish of item, in date format "yyyy/MM/dd"
* @param category name of category
* @param manifest java.util.jar.Manifest describes the module in NetBeans module system
* @param isEager says if the module is eager or not
* @param isAutoload says if the module is autoload or not
* @param needsRestart if true then IDE must be restarted after module installation
* @param isGlobal control if the module will be installed into the installation directory or into user's dir
* @param isPreferedUpdate if true will be handled in exclusive mode before other updates
* @param targetCluster name of cluster where new module will be installed if installation isGlobal
* @param license UpdateLicense represents license name and text of license agreement
* @return UpdateItem
* @since 1.33
*/
public static UpdateItem createModule (
String codeName,
String specificationVersion,
URL distribution,
String author,
String downloadSize,
String homepage,
String publishDate,
String category,
Manifest manifest,
Boolean isEager,
Boolean isAutoload,
Boolean needsRestart,
Boolean isGlobal,
Boolean isPreferedUpdate,
String targetCluster,
UpdateLicense license) {
ModuleItem item = new ModuleItem (codeName, specificationVersion, distribution,
author, publishDate, downloadSize, homepage, category,
manifest, isEager, isAutoload,
needsRestart, isGlobal, isPreferedUpdate, targetCluster, license.impl);
return new UpdateItem (item);
}
/** Creates UpdateItem which represents Feature, it's means group
* of NetBeans Modules. This Feature is handled in UI as atomic item.
* UpdateItem is identify by codeName and specificationVersion.
*
* If some of the tokens in {@code dependencies} is not known, it will be reported
* as a missing dependency.
*
* @param codeName code name of feature
* @param specificationVersion specification version of feature
* @param dependencies dependencies to NetBeans modules on which is the feature based
* @param displayName display name
* @param description description
* @param category name of category
* @return UpdateItem
* @since 1.57 specified handling of unknown tokens
*/
public static UpdateItem createFeature (
String codeName,
String specificationVersion,
Set dependencies,
String displayName,
String description,
String category) {
FeatureItem item = new FeatureItem (codeName, specificationVersion, dependencies, displayName, description, category);
return new UpdateItem (item);
}
/** Creates UpdateItem which represents Native Component with own installer. This component
* can be visualized in UI as common item, when an user wants to install this component then
* own CustomInstaller is call back.
*
* @param codeName code name of the native component
* @param specificationVersion specification version of component
* @param dependencies dependencies to other UpdateItem
* @param downloadSize size of installation file in bytes
* @param displayName display name
* @param description description
* @param needsRestart if true then IDE must be restarted after component installation
* @param isGlobal control if the control will be installed into the installation directory or into user's dir
* @param targetCluster name of cluster where new module will be installed if installation isGlobal
* @param installer CustomInstaller call-back interface
* @param license UpdateLicense represents license name and text of license agreement
* @return UpdateItem
*/
public static UpdateItem createNativeComponent (
String codeName,
String specificationVersion,
String downloadSize,
Set dependencies,
String displayName,
String description,
Boolean needsRestart,
Boolean isGlobal,
String targetCluster,
CustomInstaller installer,
UpdateLicense license // XXX: useless now
) {
NativeComponentItem item = new NativeComponentItem (false, codeName, specificationVersion, downloadSize, dependencies,
displayName, description, needsRestart, isGlobal, targetCluster, installer, null, null);
return new UpdateItem (item);
}
/** Creates UpdateItem which represents Native Component with own installer. This component
* can be visualized in UI as common item, when an user wants to install this component then
* own CustomInstaller is called back.
*
* @param codeName code name of the native component
* @param specificationVersion specification version of component
* @param dependencies dependencies to other UpdateItem
* @param displayName display name
* @param description description
* @param uninstaller CustomUninstaller call-back interface
* @return UpdateItem
*/
public static UpdateItem createInstalledNativeComponent (
String codeName,
String specificationVersion,
Set dependencies,
String displayName,
String description,
CustomUninstaller uninstaller
) {
NativeComponentItem item = new NativeComponentItem (true, codeName, specificationVersion, null, dependencies,
displayName, description, null, null, null, null, uninstaller, null);
return new UpdateItem (item);
}
/** Creates UpdateItem which can localized NetBeans Module in given Locale.
*
* @param codeName code name of the module for localization
* @param specificationVersion specification version of localization
* @param moduleSpecificationVersion specification version of the module for localization
* @param locale locale
* @param branding branding
* @param localizedName localized name of module
* @param localizedDescription localized descripton of module
* @param category name of category
* @param distribution URL to NBM file
* @param needsRestart if true then IDE must be restarted after module installation
* @param isGlobal control if the module will be installed into the installation directory or into user's dir
* @param targetCluster name of cluster where new module will be installed if installation isGlobal
* @param license UpdateLicense represents license name and text of license agreement
* @return UpdateItem
*/
public static UpdateItem createLocalization (
String codeName,
String specificationVersion,
String moduleSpecificationVersion,
Locale locale,
String branding,
String localizedName,
String localizedDescription,
String category,
URL distribution,
Boolean needsRestart,
Boolean isGlobal,
String targetCluster,
UpdateLicense license) {
LocalizationItem item = new LocalizationItem (codeName, specificationVersion, distribution,
locale, branding, moduleSpecificationVersion, localizedName, localizedDescription, category,
needsRestart, isGlobal, targetCluster, license.impl);
return new UpdateItem (item);
}
}