You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@aries.apache.org by gn...@apache.org on 2010/04/01 01:07:23 UTC
svn commit: r929743 - in
/incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem:
Subsystem.java SubsystemAdmin.java SubsystemConstants.java jmx/package.html
jmx/packageinfo package.html packageinfo
Author: gnodet
Date: Wed Mar 31 23:07:23 2010
New Revision: 929743
URL: http://svn.apache.org/viewvc?rev=929743&view=rev
Log:
[subsystem] add some javadoc, add exception to start() and stop() method on Subsystem
Added:
incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/jmx/package.html
incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/jmx/packageinfo
incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/package.html
incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/packageinfo
Modified:
incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/Subsystem.java
incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/SubsystemAdmin.java
incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/SubsystemConstants.java
Modified: incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/Subsystem.java
URL: http://svn.apache.org/viewvc/incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/Subsystem.java?rev=929743&r1=929742&r2=929743&view=diff
==============================================================================
--- incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/Subsystem.java (original)
+++ incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/Subsystem.java Wed Mar 31 23:07:23 2010
@@ -45,12 +45,12 @@ public interface Subsystem {
/**
* Start the subsystem (i.e. start all its constituent bundles according to their start level).
*/
- void start();
+ void start() throws SubsystemException;
/**
* Stop the subsystem (i.e. stop all its constituent bundles).
*/
- void stop();
+ void stop() throws SubsystemException;
/**
* The identifier of the subsystem. Must be unique in the framework.
Modified: incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/SubsystemAdmin.java
URL: http://svn.apache.org/viewvc/incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/SubsystemAdmin.java?rev=929743&r1=929742&r2=929743&view=diff
==============================================================================
--- incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/SubsystemAdmin.java (original)
+++ incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/SubsystemAdmin.java Wed Mar 31 23:07:23 2010
@@ -25,6 +25,9 @@ import java.util.Collection;
* they will be synchronized so that no two operations will be performed at the
* same time.
*
+ * This service will also be made available from managed subsystems, so that only subsystems
+ * from the current framework will be available, not nested frameworks.
+ *
*/
public interface SubsystemAdmin {
Modified: incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/SubsystemConstants.java
URL: http://svn.apache.org/viewvc/incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/SubsystemConstants.java?rev=929743&r1=929742&r2=929743&view=diff
==============================================================================
--- incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/SubsystemConstants.java (original)
+++ incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/SubsystemConstants.java Wed Mar 31 23:07:23 2010
@@ -22,19 +22,49 @@ public class SubsystemConstants {
// non-instantiable
}
+ /**
+ * The subsystem manifest version header must be present and equals to 1.0
+ * for this version of subsystems.
+ */
public static final String SUBSYSTEM_MANIFESTVERSION = "Subsystem-ManifestVersion";
+
+ /**
+ * Symbolic name for the subsystem. Must be present.
+ */
public static final String SUBSYSTEM_SYMBOLICNAME = "Subsystem-SymbolicName";
+
+ /**
+ * Version of the subsystem
+ */
public static final String SUBSYSTEM_VERSION = "Subsystem-Version";
+
+ /**
+ * Human readable name
+ */
public static final String SUBSYSTEM_NAME = "Subsystem-Name";
+
+ /**
+ * Human readable description
+ */
public static final String SUBSYSTEM_DESCRIPTION = "Subsystem-Description";
+
+
+ /**
+ * Name of the resource to use for localized headers
+ */
+ public static final String SUBSYSTEM_LOCALIZATION = "Subsystem-Localization";
+
+ /**
+ * Location to use when updating the subsystem
+ */
+ public static final String SUBSYSTEM_UPDATELOCATION = "Subsystem-UpdateLocation";
+
public static final String SUBSYSTEM_CONTENT = "Subsystem-Content";
public static final String SUBSYSTEM_IMPORTPACKAGE = "Subsystem-ImportPackage";
public static final String SUBSYSTEM_EXPORTPACKAGE = "Subsystem-ExportPackage";
public static final String SUBSYSTEM_IMPORTSERVICE = "Subsystem-ImportService";
public static final String SUBSYSTEM_EXPORTSERVICE = "Subsystem-ExportService";
public static final String SUBSYSTEM_REQUIREBUNDLE = "Subsystem-RequireBundle";
- public static final String SUBSYSTEM_LOCALIZATION = "Subsystem-Localization";
- public static final String SUBSYSTEM_UPDATELOCATION = "Subsystem-UpdateLocation";
/*
String APPLICATION_SYMBOLICNAME = "Application-SymbolicName";
Added: incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/jmx/package.html
URL: http://svn.apache.org/viewvc/incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/jmx/package.html?rev=929743&view=auto
==============================================================================
--- incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/jmx/package.html (added)
+++ incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/jmx/package.html Wed Mar 31 23:07:23 2010
@@ -0,0 +1,9 @@
+<BODY>
+<p>Subsystem JMX Package Version 1.0.
+<p>Bundles wishing to use this package must list the package
+in the Import-Package header of the bundle's manifest.
+For example:
+<pre>
+Import-Package: org.apache.aries.subsystem.jmx;version="[1.0,2.0)"
+</pre>
+</BODY>
Added: incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/jmx/packageinfo
URL: http://svn.apache.org/viewvc/incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/jmx/packageinfo?rev=929743&view=auto
==============================================================================
--- incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/jmx/packageinfo (added)
+++ incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/jmx/packageinfo Wed Mar 31 23:07:23 2010
@@ -0,0 +1 @@
+version 1.0
Added: incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/package.html
URL: http://svn.apache.org/viewvc/incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/package.html?rev=929743&view=auto
==============================================================================
--- incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/package.html (added)
+++ incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/package.html Wed Mar 31 23:07:23 2010
@@ -0,0 +1,9 @@
+<BODY>
+<p>Subsystem API Package Version 1.0.
+<p>Bundles wishing to use this package must list the package
+in the Import-Package header of the bundle's manifest.
+For example:
+<pre>
+Import-Package: org.apache.aries.subsystem;version="[1.0,2.0)"
+</pre>
+</BODY>
Added: incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/packageinfo
URL: http://svn.apache.org/viewvc/incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/packageinfo?rev=929743&view=auto
==============================================================================
--- incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/packageinfo (added)
+++ incubator/aries/trunk/subsystem/subsystem-api/src/main/java/org/apache/aries/subsystem/packageinfo Wed Mar 31 23:07:23 2010
@@ -0,0 +1 @@
+version 1.0