[关闭]
@liyuj 2017-02-04T03:52:32.000000Z 字数 5515 阅读 2595

Apache-Ignite-1.8.0-中文开发手册

4.OSGi支持

4.1.在Apache Karaf中安装

4.1.1.摘要

Apache Karaf是一个轻量级、功能强大的企业级OSGi容器,他支持Eclipse Equinox和Apache Felix运行时。

支持Apache Karaf4.0.0版本系列
Ignite在Karaf4.0.0版本系列上进行了测试,可能也可以工作于更老的版本上,但是未经过明确的测试。

为了方便不同Ignite模块的部署(包括他们的依赖),Ignite提供了一套打包进特性库的Karaf特性,这使得借助于Karaf Shell的一个命令就可以快速地将Ignite部署进OSGi环境。

4.1.2.准备步骤

首先,Ignite使用了Oracle/Sun JRE的底层包sun.nio.ch(OpenJDK也有效)。
因为这是一个专有的包(并不是Java标准规范的一部分),Apache Kafka默认并没有从System Bundle(bundle 0)中导出它,因此必须通过修改${KARAF_BASE}/etc/jre.properties文件通知Kafka导出它。
定位到使用的JRE版本的jre-1.x属性,然后在最后追加包名,比如:

  1. jre-1.8= \
  2. javax.accessibility, \
  3. javax.activation;version="1.1", \
  4. ...
  5. org.xml.sax.helpers, \
  6. sun.nio.ch

4.1.3.安装Ignite特性库

使用Apache Karaf Shell中的如下命令来安装Ignite特性库,确保容器可以连接到互联网或者一个包含Ignite组件的备用Maven仓库。
将Ignite特性库加入Karaf:

  1. karaf@root()> feature:repo-add mvn:org.apache.ignite/ignite-osgi-karaf/${ignite.version}/xml/features
  2. Adding feature url mvn:org.apache.ignite/ignite-osgi-karaf/${ignite.version}/xml/features
  3. karaf@root()>

${ignite.version}替换为实际使用的版本号。
这时可以列出Ignite支持的所有特性:

  1. karaf@root()> feature:list | grep ignite
  2. ignite-all | 1.5.0.SNAPSHOT | | Uninstalled | ignite | Apache Ignite :: All
  3. ignite-core | 1.5.0.SNAPSHOT | | Uninstalled | ignite | Apache Ignite :: Core
  4. ignite-aop | 1.5.0.SNAPSHOT | | Uninstalled | ignite | Apache Ignite :: AOP
  5. ignite-aws | 1.5.0.SNAPSHOT | | Uninstalled | ignite | Apache Ignite :: AWS
  6. ignite-indexing | 1.5.0.SNAPSHOT | | Uninstalled | ignite | Apache Ignite :: Indexing
  7. ignite-hibernate | 1.5.0.SNAPSHOT | | Uninstalled | ignite | Apache Ignite :: Hibernate
  8. ignite-jcl | 1.5.0.SNAPSHOT | | Uninstalled | ignite | Apache Ignite :: JCL
  9. ignite-jms11 | 1.5.0.SNAPSHOT | | Uninstalled | ignite | Apache Ignite :: JMS 1.1
  10. ignite-jta | 1.5.0.SNAPSHOT | | Uninstalled | ignite | Apache Ignite :: JTA
  11. ignite-kafka | 1.5.0.SNAPSHOT | | Uninstalled | ignite | Apache Ignite :: Kafka
  12. [...]
  13. karaf@root()>

4.1.4.安装合适的Ignite特性

下面的特性是有点特别的:

所有其他的特性包括对应的Ignite模块+依赖,可以通过如下方式安装他们:

  1. karaf@root()> feature:install ignite-core
  2. karaf@root()> feature:install ignite-kafka
  3. karaf@root()> feature:install ignite-aop ignite-urideploy
  4. karaf@root()>

一些模块是OSGi片段而不是组件,当安装他们时,可能会注意到,Karaf Shell以及/或者ignite-core,其中一个或者两者,重新启动。

4.1.5.ignite-log4j和Pax Logging

当Karaf版本<=4.0.3时如果使用Pax Logging请仔细阅读这个注释
安装ignite-log4j这个特性时,Karaf Shell可能显示下面的消息:
Error executing command: Resource has no uri
这不是一个严重的错误,已经汇报给Karaf社区,问题号是KARAF-4129
按照如下的说明可以忽略这个错误。

Apache Karaf捆绑了Pax Logging,他是一个从其他组件收集和汇总日志输出(通过不同的框架输出,比如slf4j,log4j,JULI,commons-logging等)然后用一个典型的log4j配置处理的框架。
ignite-log4j模块依赖于log4j,Pax Logging默认不输出它,因此我们开发了一个OSGi片段,SymbolicName为ignite-osgi-paxlogging,他加入了ignite-core然后输出了缺失的包。
ignite-log4j特性也安装了这个片段,但是需要用org.ops4j.pax.logging.pax-logging-api这个名字强制刷新:

  1. karaf@root()> feature:install ignite-log4j
  2. karaf@root()> refresh org.ops4j.pax.logging.pax-logging-api
  3. karaf@root()>
  4. __ __ ____
  5. / //_/____ __________ _/ __/
  6. / ,< / __ `/ ___/ __ `/ /_
  7. / /| |/ /_/ / / / /_/ / __/
  8. /_/ |_|\__,_/_/ \__,_/_/
  9. Apache Karaf (4.0.2)
  10. Hit '<tab>' for a list of available commands
  11. and '[cmd] --help' for help on a specific command.
  12. Hit '<ctrl-d>' or type 'system:shutdown' or 'logout' to shutdown Karaf.
  13. karaf@root()> la | grep ignite-osgi-paxlogging
  14. 75 | Resolved | 8 | 1.5.0.SNAPSHOT | ignite-osgi-paxlogging, Hosts: 1
  15. karaf@root()>

4.2.支持的模块

以下的模块已OSGi化:

下面的模块由于各种各样的原因目前还不支持OSGi:

4.3.在OSGi容器中启动

4.3.1.容器的配置

要在一个OSGi容器中启动Ignite,至少要安装如下的组件:

当在Karaf中部署时,可以通过使用Ignite特性库来快速地安装ignite-core特性,可以参照17.1.在Apache Karaf中安装章节来了解更多的信息。
可以随意地安装额外的Ignite模块来扩展平台的功能,就像在一个标准环境中将模块加入类路径一样。

4.3.2.实现Ignite组件Activator

要启动Ignite,通过继承抽象类org.apache.ignite.osgi.IgniteAbstractOsgiContextActivator来实现一个OSGi组件Activator:

  1. package org.apache.ignite.osgi.examples;
  2. import org.apache.ignite.configuration.IgniteConfiguration;
  3. import org.apache.ignite.osgi.IgniteAbstractOsgiContextActivator;
  4. import org.apache.ignite.osgi.classloaders.OsgiClassLoadingStrategyType;
  5. public class MyActivator extends IgniteAbstractOsgiContextActivator {
  6. /**
  7. * Configure your Ignite instance as you would normally do,
  8. * and return it.
  9. */
  10. @Override public IgniteConfiguration igniteConfiguration() {
  11. IgniteConfiguration config = new IgniteConfiguration();
  12. config.setGridName("testGrid");
  13. // ...
  14. return config;
  15. }
  16. /**
  17. * Choose the classloading strategy for Ignite to use.
  18. */
  19. @Override public OsgiClassLoadingStrategyType classLoadingStrategy() {
  20. return OsgiClassLoadingStrategyType.BUNDLE_DELEGATING;
  21. }
  22. }

在OSGi中支持两个不同的类加载策略:

未来的OSGi类加载策略
我们可能会考虑在以后的版本中增加其他的类加载策略,比如使用Service Locator机制来定位通过一个文件自发地希望向Ignite的编组器暴露包的组件,类似于JAXB规范中的jaxb.index。

确保将Bundle-ActivatorOSGi清单头加入组件,这样才能使OSGi容器在组件启动时调用Activator。

包括Bundle-Activator的OSGi头

  1. Bundle-SymbolicName: test-bundle
  2. Bundle-Activator: org.apache.ignite.osgi.examples.MyActivator
  3. Import-Package: ...
  4. [...]

要生成这个组件,需要包含Bundle-ActivatorOSGi头,建议在Maven构建中增加maven-bundle-plugin插件,下面是对应的配置:

  1. <plugin>
  2. <groupId>org.apache.felix</groupId>
  3. <artifactId>maven-bundle-plugin</artifactId>
  4. <version>${maven.bundle.plugin.version}</version>
  5. <configuration>
  6. <Bundle-SymbolicName>...</Bundle-SymbolicName>
  7. <Bundle-Activator>org.apache.ignite.osgi.examples.MyActivator</Bundle-Activator>
  8. [...]
  9. </configuration>
  10. </plugin>
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注