接上次讲到界面扩展的配置文件,这次说直接调用和脚本调用的配置文件。
之前我说过脚本调用的包的结构为:
脚本调用的包:
zip--|
|-jarName文件夹--|--jarName.jar
| |
| |--parcel-descriptor.xml
|
|-addons.xcu
|
|-META-INF--|--manifest.xml
META-INF文件夹中manifest.xml文件的内容可能为:
<?xml version="1.0" encoding="UTF-8"?>
<manifest:manifest>
<manifest:file-entry manifest:full-path="Addon.xcu" manifest:media-type="application/vnd.sun.star.configuration-data"/>
<manifest:file-entry manifest:full-path="LemmaDialog/" manifest:media-type="application/vnd.sun.star.basic-library"/>
</manifest:manifest>
上面两项分别是配置显示扩展所用的Addon.xcu配置文件,和你所要添加的业务组件的zip包内所在的文件夹名,后面的类型说明标明了其类型。
说到脚本调用,我们就应该了解OOo的脚本调用框架,ScriptingFramework 的目标在于使OOo支持地语言编写的宏可以:
*执行
*显示
*被管理
*被指定到 OOo 事件、组合键、菜单和工具栏项目
通过部署满足 com.sun.star.script.provider.LanguageScriptProvider 指定服务定义要求的UNO 组件,来添加新语言支持,即可实现上述目标。ScriptingFramework 通过找出满足服务规范并遵守命名约定 “com.sun.star.script.provider.ScriptProviderFor[Language]” 的可用组件来检测支持的语言。默认情况下,OOo 安装了许多参考 LanguageScriptProvider。下面是OOo现在支持的语言列表:
Java com.sun.star.script.provider.ScriptProviderForJava
JavaScript com.sun.star.script.provider.ScriptProviderForJavaScript
BeanShell com.sun.star.script.provider.ScriptProviderForBeanShell
Basic com.sun.star.script.provider.ScriptProviderForBasic
所有 BeanShell、JavaScript 与 Java 宏都附带一种类型变量
com.sun.star.script.provider.XScriptContext(可用它来访问 OOo API)。此类型有三
种方法:
* com.sun.star.frame.XModel getDocument( )
返回为其调用宏的文档的 XModel 接口
* com.sun.star.frame.XDesktop getDesktop( )
返回应用程序的 XDesktop 接口,用于访问打开的文档和加载文档
* com.sun.star.uno.XComponentContext getComponentContext( )
返回 XComponentContext 接口,用于创建服务实例
根据语言的不同,宏以不同的方式访问 XScriptContext 类型:
*Java:传递到宏方法的第一个参数总是属于类型 XScriptContext
Xmodel xDocModel = xScriptContext.getDocument();
因为 Java 是一种编译语言,所以不能直接在 OOo 中将 Java 源代码作为宏来执行。该代码必须
先编译,然后部署在 OOo 安装和文档内。
以下步骤介绍如何使用 HelloWorld 示例代码创建Java 宏:
- 为宏创建一个 LemmaDialog 目录
- 使用 LemmaDialog源代码创建一个 LemmaDialog.java 文件
- 编译 LemmaDialog.java 文件。下列来自于 OOo安装的 program/classes 目录的 jar 文件必须位于类路径中:ridl.jar、unoil.jar、sandbox.jar、jurt.jar
- 创建一个包含 LemmaDialog.class 文件的 LemmaDialog.jar 文件
- 为宏创建一个 parcel-descriptor.xml 文件
其parcel-descriptor.xml文件如下:
1 <?xml version="1.0" encoding="UTF-8"?>
2 <parcel language="Java" xmlns:parcel="scripting.dtd">
3 <script language="Java">
4 <locale lang="en">
5 <displayname value="cn.ac.cintcm.oo.plugin.lemma.LemmaDialog.lemmaDialog"/>
6 <description>
7 Prints "Lemma Dialog".
8 </description>
9 </locale>
10 <functionname value="cn.ac.cintcm.oo.plugin.lemma.LemmaDialog.lemmaDialog"/>
11 <logicalname value="cn.ac.cintcm.oo.plugin.lemma.LemmaDialog.lemmaDialog"/>
12 <languagedepprops>
13 <prop name="classpath" value="LemmaDialog.jar"/>
14 </languagedepprops>
15 </script>
16 </parcel>
第13行,说明了宏调用的具体业务代码是LemmaDialog.jar包中的类,而且是从第10行
cn.ac.cintcm.oo.plugin.lemma.LemmaDialog.lemmaDialog这个全路径所表示的类中的方法开始中注入XScriptContext这个参数开始的。接下来就可以调用XScriptContext的对象进行一系列的操作了。
com.sun.star.awt中有很多与awt、swing相类似的组件可以调用,com.sun.star.beans.XPropertySet是对这些组件进行参数设置的接口。
下次介绍有关于使用Java调用OOo具体类的业务代码,在OOo中调用其sdk的service与我们一般编写java代码有一定的区别,下回大家就可明白这其中的区别了。
本文依据《创作共用约定》之“署名-禁止派生-非商业用途”方式发布,即你可以免费拷贝、分发、呈现和表演当前作品,但是必须基于以下条款:
对于任何二次使用或分发,你必须让其他人明确当前作品的授权条款。
在得到作者的明确允许下,这里的某些条款可以放弃。