《Equinox OSGi系列之三 Equinox配置参数详解》由会员分享，可在线阅读，更多相关《Equinox OSGi系列之三 Equinox配置参数详解（7页珍藏版）》请在金锄头文库上搜索。
1、1、概述上文我们对 Equinox OSGi 运行环境的组成及搭建过程做了详细讲述。本文主要对 Equinox OSGi 运行环境的可配置参数及其作用加以介绍，从而使用户在实际使用过程中可以对 Equinox 运行环境更好地进行控制。 Equinox 项目沿袭 Eclipse 的特点，具有高度的可配置性。用户可以通过命令行参数或系统属性参数（JVM 属性参数）两种方式对 Equinox OSGi 运行环境进行设定。命令行参数可以看作是系统属性参数的简化方式，Equinox 中提供的很多系统属性参数可能不具有对应的命令行快捷设定。2、Equinox 配置参数详解Equinox 配置的参数在实际使
2、用中可以通过以下三种方式： 在命令行中，使用 Java 虚拟机参数-D 作为系统属性来设定，如：-Declipse.ignoreApp=true ； 在配置文件 config.ini 文件中进行配置，如：osgi.framework=plugins/org.eclipse.osgi_.jar 在 Eclipse Launcher 的配置文件.ini 文件中进行配置。在此配置文件中用户需要使用命令行参数而不是系统属性的格式。如：-console。用户在发布 Equinox 或 RCP 应用时可以设定启动程序（Eclipse Launcher）的名称和图标，如将启动程序改为：MyApp.exe，则
3、对应的启动配置文件应命名为：MyApp.ini。 下表列举了 Equinox3.3 版本主要的配置参数。该列表包括系统参数，用于 JVM 属性配置或 config.ini 文件配置；命令行参数（如果有）用于.ini 文件配置；参数的简要说明描述该参数的用途。说明： 表中所列参数来自于 Eclipse3.3 帮助文档，关于参数的解释可能不够准确，请用户参考 Eclipse 帮助获取详细信息。 表中所列参数严格说来仅部分用于 Equinox OSGi，全部适用于 Eclipse。在下述说明中将不区分 Equinox 和 Eclipse。 系统参数 命令行参数 参数说明eclipse.activat
4、eRuntimePlugins 用于控制运行时（Runtime）插件的激活。如果 RCP 应用程序不需要使用运行时插件提供的服务，可以将该属性值设定为 false，从而避免在系统启动时激活运行时插件。eclipse.allowAppRelaunch 如果值为 true，当当前运行的应用程序 Application 退出时，Equinox 系统主线程会一直等待该应用的另一个应用被启动。如果停止 system.bundle 即 Bundle ID 值为 0 的 Bundle，则会强制 Equinox 主线程停止等待另一个应用启动。该参数的默认值为 false。eclipse.application
5、 -application 该 Equinox 系统所启动的应用程序的标识符。该参数值会覆盖 eclipse.product 系统属性中定义的应用程序。eclipse.application.launchDefault 当系统启动时，该属性用于自动启动默认的 Application 应用。默认的应用通过 eclipse.application 或 eclipse.product 系统属性设定。该属性的默认值为true。如果该属性值设为 false，当系统启动时不会自动启动默认的 application，系统主线程会持续等待，直至一个 application 通过应用描述符服务（applicat
6、ion descriptor service）启动。eclipse.application.registerDescriptors 该属性控制所有安装的 application 是否注册相应的应用描述符服务。该属性的默认值为 false。如果设定为false，只有默认的 application 在服务注册表中具有相应的应用描述符服务；如果设定为 true，所有安装的application 在 OSGi 服务注册表中都具有相应的应用描述符服务注册。mands 在启动 Equinox 系统时，使用该属性参数将用回车换行方式分隔的命令行参数列表传递给系统。eclipse.consoleLog 如果该
7、属性参数设定且值为 true，则所有的日志输出都会传送到 Java 的 System.out。该属性参数可以和-debug参数结合用于调试。eclipse.debug.startupTime 该属性用于设定系统运行时 Java 虚拟机启动的时间（单位为毫秒）eclipse.ee.install.verify 如果该属性值设定为 true，在 Bundle 组件安装时，OSGi 框架会检查框架运行所需要的运行环境。该参数默认值为 false。eclipse.exitOnError 该参数设定为 true 时，如果系统在运行时遇到无法处理的错误，则系统会退出。该参数默认值为 true。eclips
8、e.ignoreApp 该参数设定为 true 时，系统主线程将不启动默认的 application，同时停止并退出系统进程。该属性参数的默认值为 false。 该参数不同于eclipse.application.launchDefault，系统主线程不会等待任何的应用描述符服务启动。eclipse.log.backup.max 该参数用于设定允许备份的日志文件的最大数。如果备份的日志文件的数量达到该参数的设定值，则最早的日志文件将被删除。该参数的默认值为 10，如果用户设定值小于或等于 0，则系统启用默认值。eclipse.log.size.max 每个日志文件的最大允许文件大小（单位：KB
9、），该参数的默认值为 “1000”。当日志文件达到允许的最大值时，日志文件会循环写入。如果该参数值被设定为 0 或负值，Equinox 系统会使用默认值。eclipse.noExtensionMunging 如果该参数值为 true，则遗留的注册扩展将会保留。默认情况下，这些扩展会更新为 Eclipse3.0 中的新的扩展点。eclipse.noLazyRegistryCacheLoading -noLazyRegistryCacheLoading 如果该参数值为true，平台的插件注册表缓存加载优化将不被激活。默认情况下，配置项在需要的时候会从注册表缓存（如果存在）中加载，以提升性能。该参数
10、如果值为 true，系统启动时会强制加载所有注册表缓存信息。eclipse.noRegistryCache -noRegistryCache 如果该参数值为true，将不使用内部扩展注册缓存。eclipse.pluginCustomization -pluginCustomization 保存默认插件配置的属性文件的文件路径。该属性文件中的配置项会覆盖主配置中的插件属性。如果该参数值为相对路径，则系统会认为路径相对于当前 eclipse 工作目录。eclipse.product -product 运行的产品标识。该参数控制各种产品定义信息和产品使用的 applicationeclipse.se
11、rvice.jobs 该参数控制 org.eclipse.core.jobs插件是否注册为 OSGi 服务，如果值为 false则不注册为 OSGi 服务eclipse.service.pref 该参数控制 org.eclipse.equinox.preferences插件是否注册为 OSGi 服务，如果值为 false则不注册为 OSGi 服务eclipse.startTime 该参数在 Equinox 启动时设定。该参数的值为 System.currentTimeMillis()方法返回值的字符串表示。用户不需要设定该参数eclipse.stateSaveDelayInterval 该参数
12、为系统状态变更请求的序列化延迟间隔，单位毫秒，默认值为 30000ms。该参数用于阻止系统管理操作（如安装 Bundle 组件）过程中产生的大量的磁盘写操作。eclipse.vm -vm该参数指向系统启动所需的 Java 执行程序(JRE)的路径。如果不指定此项，则 JRE 位于 jre（它与 Eclipse.exe 可执行文件位于同一目录）。此信息用于构造系统重启使用的命令行。eclipse.vmargs -vmargs 该参数用于配置系统启动所需的 Java 虚拟机参数。此信息用于构造系统重启使用的命令行。osgi.adaptor OSGi 框架启动使用的框架适配（framework ad
13、aptor）的类名称osgi.arch -arch定义 Eclipse 平台在其上运行的处理器体系结构。Eclipse 平台通常使用 Java os.arch属性的常用值来计算最佳设置。如果在此处指定该项，则这是 Eclipse 平台使用的值。此处指定的值可作为 BootLoader.getOSArch() 用于插件。示例值有： “x86”、“sparc”、“PA-RISC”和“ppc”。osgi.baseConfiguration.area 当 osgi.configuration.area 参数未指定时，该参数用于指定基本的配置信息。osgi.bundlefile.limit 该参数用于限
14、定框架保持打开的 Jar 文件的数量。该参数允许的最小值为 10，默认最大值不受限定。osgi.bundles 以逗号分隔的 bundle 列表。该列表中的 bundle 在系统启动运行时，会自动安装并根据设定启动（可选）。每一个 Bundle 配置形式遵循下面的规范： :start如果忽略 start-level (0 的整数)被忽略，则将该 Bundle 设定为默认的启动等级。如果start标记被设定，则该 Bundle 在安装后框架会启动该 Bundle。Simple bundle location被解释为相对于框架所作路径的上一级目录。start-level标明该 Bundle 应该在
15、哪一 OSGi 启动等级运行该 Bundle，如果。start-level 未被设定，则系统会自动为 Bundle 配置适当的默认启动级别。osgi.bundles.defaultStartLevel 系统安装的所有的 Bundle 的启动级别。用户可以在 osgi.bundles 配置中为某一 Bundle 指定特定的启动等级。如果未设定 Bundle 的启动等级，则 Bundle 的启动等级为该参数设定值。该参数默认值为 4。patibility.bootdelegation 如果该参数值为true，当一个类或资源查找不到时，类加载器会启动父类加载器进行最后的查找。该参数的默认值为pati
16、bility.errorOnFailedStart Bundle 组件可以通过 Bundle 清单属性Eclipse-LazyStart或Bundle-ActivationPolicy 标记自身的延迟激活策略。自 OSGi R4.1 规范开始，如果一个设定了延迟激活策略的 Bundle 启动失败，从该 Bundle 进行类加载必须仍然成功。在 OSGi R4.1 之前，Eclipse 定义的延迟激活策略允许启动失败的 Bundle 抛出类加载异常。如果该属性设定为true ，那么在启动失败的 Bundle 中加载类时将导致类加载错误；否则，仍然允许从启动失败的 Bundle中加载类。 该参数的默认值为patibility. eagerStart.LazyActivation OSGi R4.1 规范强制
