Examples of org.osgi.service.subsystem.Subsystem

org.osgi.service.subsystem.Subsystem
kipedia.org/wiki/Directed_acyclic_graph">acyclic digraph with one and only one source vertex, which is the root subsystem. The edges have the child as the head and parent as the tail.
A subsystem has several identifiers.
- {@link #getLocation() Location} - An identifier specified by the clientas part of installation. It is guaranteed to be unique within the same framework.
- {@link #getSubsystemId() ID} - An identifier generated by theimplementation as part of installation. It is guaranteed to be unique within the same framework.
- {@link #getSymbolicName() Symbolic Name}/ {@link #getVersion() Version} -The combination of symbolic name and version is guaranteed to be unique within the same region. Although {@link #getType() type} is not formally partof the identity, two subsystems with the same symbolic names and versions but different types are not considered to be equal.
A subsystem has a well-defined {@link State life cycle}. Which stage a subsystem is in may be obtained from the subsystem's {@link #getState() state} and is dependent on which life cycle operation is currently active orwas last invoked.
A subsystem archive is a ZIP file having an {@code .esa} extension andcontaining metadata describing the subsystem. The form of the metadata may be a subsystem or deployment manifest, as well as any content resource files. The manifests are optional and will be computed if not present. The subsystem manifest headers may be {@link #getSubsystemHeaders(Locale) retrieved} in rawor localized forms. There are five standard {@link IdentityNamespace#CAPABILITY_TYPE_ATTRIBUTE types} of resources thatmay be included in a subsystem.
- {@link IdentityNamespace#TYPE_BUNDLE Bundle} - A bundle that is not afragment.
- {@link IdentityNamespace#TYPE_FRAGMENT Fragment} - A fragment bundle.
- {@link SubsystemConstants#SUBSYSTEM_TYPE_APPLICATION ApplicationSubsystem} - An application subsystem.
- {@link SubsystemConstants#SUBSYSTEM_TYPE_COMPOSITE Composite Subsystem} -A composite subsystem.
- {@link SubsystemConstants#SUBSYSTEM_TYPE_FEATURE Feature Subsystem} - Afeature subsystem.
Resources contained by a subsystem are called {@link #getConstituents() constituents}. There are several ways a resource may become a constituent of a subsystem:
- A resource is listed as part of the subsystem's content.
- A subsystem resource is a child of the subsystem.
- The subsystem has a provision policy of accept dependencies.
- A bundle resource is installed using the region bundle context.
- A bundle resource is installed using the bundle context of another resource contained by the subsystem.
In addition to invoking one of the install methods, a subsystem instance may be obtained through the service registry. Each installed subsystem has a corresponding service registration. A subsystem service has the following properties.
- {@link SubsystemConstants#SUBSYSTEM_ID_PROPERTY ID} - The ID of thesubsystem.
- {@link SubsystemConstants#SUBSYSTEM_SYMBOLICNAME_PROPERTY Symbolic Name}- The symbolic name of the subsystem.
- {@link SubsystemConstants#SUBSYSTEM_VERSION_PROPERTY Version} - Theversion of the subsystem.
- {@link SubsystemConstants#SUBSYSTEM_TYPE_PROPERTY Type} - The type of thesubsystem.
- {@link SubsystemConstants#SUBSYSTEM_STATE_PROPERTY State} - The state ofthe subsystem.
Because a subsystem must be used to install other subsystems, a root subsystem is provided as a starting point. The root subsystem may only be obtained as a service and has the following characteristics.
- The ID is {@code 0}.
- The symbolic name is {@link SubsystemConstants#ROOT_SUBSYSTEM_SYMBOLICNAME org.osgi.service.subsystem.root}.
- The version matches this specification's version.
- It has no parents.
- All existing bundles, including the system and subsystem implementation bundles, are constituents.
- The type is {@link SubsystemConstants#SUBSYSTEM_TYPE_APPLICATION osgi.subsystem.application} with no imports.
- The provision policy is {@link SubsystemConstants#PROVISION_POLICY_ACCEPT_DEPENDENCIES acceptDependencies}.
@ThreadSafe @noimplement @author $Id: 98c29e1bfd80828ab025a1aa0530019184185242 $

                result = new ChangeStateTask(toActivate, ResourceState.IGNORED);
            } else {
                // search a subsystem with the symbolic name
                final ServiceReference<Subsystem> ref = this.getSubsystemReference(info.symbolicName);


                final Subsystem currentSubsystem = (ref != null ? this.bundleContext.getService(ref) : null);
                try {
                    final Version newVersion = new Version(info.version);
                    final Version oldVersion = (ref == null ? null : (Version)ref.getProperty("subsystem.version"));


                    // Install
                    if ( rsrc.getState() == ResourceState.INSTALL ) {
                        if ( oldVersion != null ) {


                            final int compare = oldVersion.compareTo(newVersion);
                            if (compare < 0) {
                                // installed version is lower -> update
                                result = new UpdateSubsystemTask(toActivate, this.bundleContext, ref, this.rootSubsystem);
                            } else if ( compare == 0 && isSnapshot(newVersion) ) {
                                // same version but snapshot -> update
                                result = new UpdateSubsystemTask(toActivate, this.bundleContext, ref, this.rootSubsystem);
                            } else if ( compare == 0 && currentSubsystem != null && currentSubsystem.getState() != State.ACTIVE ) {
                                // try to start the version
                                result = new StartSubsystemTask(toActivate, currentSubsystem);
                            } else {
                                logger.info("{} is not installed, subsystem with same or higher version is already installed: {}", info, newVersion);
                                result = new ChangeStateTask(toActivate, ResourceState.IGNORED);

View Full Code Here

    @Override
    public void execute(final InstallationContext ctx) {
        final TaskResource tr = this.getResource();
        ctx.log("Uninstalling subsystem from {}", tr);


        Subsystem subsystem = null;
        try {
            subsystem = this.bundleContext.getService(this.subsystemReference);
            if ( subsystem != null ) {
                subsystem.uninstall();
                ctx.addTaskToCurrentCycle(new ChangeStateTask(this.getResourceGroup(), ResourceState.UNINSTALLED));
                ctx.log("Uninstalled subsystem {}", subsystem);
            } else {
                ctx.log("Unable to uninstall subsystem {}.", tr);
                ctx.addTaskToCurrentCycle(new ChangeStateTask(this.getResourceGroup(), ResourceState.IGNORED));

View Full Code Here

             "(" + SubsystemConstants.SUBSYSTEM_ID_PROPERTY + "=0))"),


             new ServiceTrackerCustomizer<Subsystem, Subsystem>() {


                public Subsystem addingService(final ServiceReference<Subsystem> reference) {
                    final Subsystem service = context.getService(reference);
                    if ( service != null ) {
                        registerInstaller(context, service);
                    }
                    return service;
                }

View Full Code Here

    @Override
    public void execute(final InstallationContext ctx) {
        final TaskResource tr = this.getResource();
        ctx.log("Updating subsystem from {}", tr);


        Subsystem subsystem = null;
        try {
            subsystem = this.bundleContext.getService(this.subsystemReference);
            if ( subsystem != null ) {
                subsystem.stop();
                subsystem.uninstall();
                ctx.addTaskToCurrentCycle(new InstallSubsystemTask(this.getResourceGroup(), this.rootSubsystem));
            } else {
                ctx.log("Unable to update subsystem {}.", tr);
                ctx.addTaskToCurrentCycle(new ChangeStateTask(this.getResourceGroup(), ResourceState.IGNORED));
            }

View Full Code Here

    public void execute(final InstallationContext ctx) {
        final TaskResource tr = this.getResource();
        ctx.log("Installing new subsystem from {}", tr);


        try {
            final Subsystem sub = this.rootSubsystem.install(tr.getURL(), tr.getInputStream());
            ctx.addTaskToCurrentCycle(new StartSubsystemTask(this.getResourceGroup(), sub));
            ctx.log("Installed new subsystem {}", sub);
        } catch (final IOException e) {
            ctx.log("Unable to install subsystem {} : {}", tr, e);
            ctx.addTaskToCurrentCycle(new ChangeStateTask(this.getResourceGroup(), ResourceState.IGNORED));

View Full Code Here


    @Reference
    Subsystem subsystem;


    protected Subsystem getRoot() {
        Subsystem ss = subsystem;
        while (!ss.getParents().isEmpty()) {
            ss = ss.getParents().iterator().next();
        }
        return ss;
    }

View Full Code Here

TOP

Related Classes of org.osgi.service.subsystem.Subsystem

org.apache.karaf.subsystem.commands.SubsystemSupport

org.apache.sling.installer.factories.subsystems.impl.Activator

org.apache.sling.installer.factories.subsystems.impl.InstallSubsystemTask

org.apache.sling.installer.factories.subsystems.impl.SubsystemInstaller

org.apache.sling.installer.factories.subsystems.impl.UninstallSubsystemTask

org.apache.sling.installer.factories.subsystems.impl.UpdateSubsystemTask

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.