OSGI 生命周期

1 生命周期管理

对于非模块化应用，生命周期将应用作为一个整体来操作；

而对于模块化应用，则可以以细粒度的方式来管理应用的某一个独立部分。

OSGi生命周期管理

OSGi生命周期层有两种不同的作用：

• 在应用程序外部，定义了对bundle生命周期的相关操作。OSGi生命周期层允许在执行时，从外部安装、启动、更新、停止、卸载不同的bundle，进而定制应用的配置。
• 在应用程序内部，定义了bundle访问其执行上下文的方式，为bundle提供了一种与OSGi框架交互的途径以及一些执行时的便利条件。

标准Java生命周期管理

安装：jar下载时被安装；

执行：用户启动JVM时被执行；（双击）

更新：替换jar文件；

移除：删除jar文件。

Servlet生命周期管理

生命周期由servlet容器管理

安装：通过容器的特定进程被安装；

执行：servlet容器调用各种生命周期API，如Servlet.init()、Servlet.destroy()；

更新：替换WAR文件；

移除：通过容器的特定进程被移除。

2 生命周期层的三个接口

BundleActivator

如果要对一个bundle进行生命周期管理，必须要在这个bundle中声明一个bundle激活器类，实现org.osgi.framework.BundleActivator接口。这个接口为bundle提供了挂接到生命周期层的钩子，同时自定义bundle在启动或停止时执行的操作。

还必须在MANIFEST.MF中描述该bundle激活器：

Bundle-Activator: org.alpha.MyActivator  

 

注意：并非所有bundle都需要一个激活器。只有当明确需要与OSGI API进行交互，或者需要执行自定义的初始化/销毁动作时，才必须要激活器。

• 当bundle被安装并启动以后，框架将构建相应的BundleActivator的一个实例，触发BundleActivator.start()；
• 当bundle停止后，框架会调用BundleActivator.stop()；stop()方法应该取消start()中执行过的所有操作。

public   interface  BundleActivator {  
   public   void  start(BundleContext context)  throws  Exception;  
   public   void  stop(BundleContext context)  throws  Exception;  
}  

BundleContext

BundleActivator的两个方法都接受一个BundleContext对象作为参数。BundleContext是bundle与OSGi framework通信的桥梁。BundleContext可以做的事有：

• Look up system-wide configuration properties;
  ——获取系统properties
• Find another installed bundle by its ID;
  ——通过ID查询已安装的其他bundle
• Obtain a list of all installed bundles;
  ——获取已安装的bundle列表
• Introspect and manipulate other bundles programmatically: start them, stop them, un-install them, update them, etc;
  ——在程序中操作其他bundle（启动、停止、卸载、更新）
• Install new bundles programmatically; 
  ——在程序中安装新bundle
• Store or retrieve a file in a persistent storage area managed by the framework; 
  ——往框架管理的持久化存储区中存储或查询文件
• Register and unregister bundle listeners, which tell us when the state of any bundle in the framework changes; 
  ——注册bundle listener，监听bundle状态的改变
• Register and unregister service listeners, which tell us when the state of any service in the framework changes 
  ——注册service listener，监听service状态的改变
• Register and unregister framework listeners, which tell us about general framework events.
  ——注册framework listener，监听一般框架事件

每个已激活的bundle都会接收到属于自己的BundleContext对象，该对象不能在bundle直接自由传递！

只有当bundle处于激活状态（从start()开始，到stop()结束），BundleContext对象才是有效的。其他状态下调用该对象，会抛出异常。

public  interface  BundleContext {  
  String getProperty(String key);  
  Bundle getBundle();  
  Bundle getBundle( long  id);  
  Bundle[] getBundles();  
  
  Bundle installBundle(String location)  throws  BundleException;  
  Bundle installBundle(String location, InputStream input)  throws  BundleException;  
  
   void  addBundleListener(BundleListener listener);  
   void  removeBundleListener(BundleListener listener);  
   void  addFrameworkListener(FrameworkListener listener);  
   void  removeFrameworkListener(FrameworkListener listener);  
}  

Bundle

对于每个已安装的bundle，框架都会相应地创建一个逻辑上代表他的Bundle对象。Bundle接口定义了一系列API，用于管理已安装bundle的生命周期。

public interface Bundle {  
   BundleContext getBundleContext();  
   long  getBundleId();  
   Dictionary getHeaders();  
   int  getState();  
   String getSymbolicName();  
   Version getVersion();  
  
   void  start( int  options)  throws  BundleException;  
   void  start()  throws  BundleException;  
   void  stop( int  options)  throws  BundleException;  
   void  stop()  throws  BundleException;  
   void  update(InputStream input)  throws  BundleException;  
   void  update()  throws  BundleException;  
   void  uninstall()  throws  BundleException;  
}  

注意：BundleId=0的bundle表示OSGi框架本身，称为系统bundle。
当停止系统bundle时，它会首先停止其他bundle，然后才将自身完全关闭；以友好的方式关闭框架。

3 生命周期状态

INSTALLED

调用BundleContext.installBundle()后，会创建一个INSTALLED状态的bundle

RESOLVED

如果其所依赖的所有bundle都存在，即解析成功，转到RESOLVED状态

注意：不能直接从INSTALLED --> STARTING

STARTING

当开始执行BundleActivator.start()，则处于STARTING状态；

注意：这是一个瞬时状态

ACTIVE

当执行BundleActivator.start()成功，则转到ACTIVE状态；

如果抛出异常，则回到RESOLVED状态。

STOPPING

当开始执行BundleActivator.stop()，则处于STOPPING状态；

如果执行成功，则转到RESOLVED状态。

注意：这是一个瞬时状态

UNINSTALLED

INSTALLED状态的bundle可以被卸载，转到UNINSTALLED状态；

如果卸载一个ACTIVE状态的bundle，则框架会首先自动停止该bundle，使其转到RESOLVED状态；然后再卸载之前，将其状态转为INSTALLED。

Although the UNINSTALLED state is shown here, we can never see a bundle in that state, and an UNINSTALLED bundle cannot

transition to any other state. Even if we reinstall the same bundle JAR file, it will be considered a different bundle by the framework, and assigned a new bundle ID. 

刷新/更新

刷新或更新一个bundle，将使其状态退回INSTALLED状态！