配置

实现
配置
安装

作业

加载项

UNO 可执行文件

调用对话框

协议处理器需要配置条目，这些条目可以向框架提供必要信息以查找处理器。配置分支 org.openoffice.Office.ProtocolHandler 的模式定义如何将处理器实例绑定到它们的 URL 模式：

  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE oor:component-schema SYSTEM "../../../../component-schema.dtd">
  <oor:component-schema xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" oor:name="ProtocolHandler" oor:package="org.openoffice.Office" xml:lang="en-US">
      <templates>
          <group oor:name="Handler">
              <prop oor:name="Protocols" oor:type="oor:string-list"/>
          </group>
      </templates>
          <component>
              <set oor:name="HandlerSet" oor:node-type="Handler"/>
          </component>
  </oor:component-schema>

每个 set 节点条目使用协议处理器的 UNO 实现名称指定一个协议处理器。它拥有的唯一属性是 Protocols 项。它的类型必须是 [string-list]，并包含绑定到处理器的 URL 模式的列表。允许使用占位符，如果不使用，则整个字符串必须匹配分发的 URL。

vnd.sun.star.framework.ExampleHandler 的配置

以下示例 ProtocolHandler.xcu 包含用于示例的 Java 协议处理器的协议处理器配置：

  <?xml version='1.0' encoding='UTF-8'?>
  <oor:component-data oor:name="ProtocolHandler" oor:package="org.openoffice.Office" xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <node oor:name="HandlerSet">
          <node oor:name="vnd.sun.star.framework.ExampleHandler" oor:op="replace">
              <prop oor:name="Protocols">
                  <value>myProtocol_1://* myProtocol_2://*</value>
              </prop>
          </node>
      </node>
  </oor:component-data>

示例使用占位符加入了两个新的 URL 协议：

 myProtocol_1://*
 myProtocol_2://*

这两个协议都绑定到处理器实现 vnd.sun.star.framework.ExampleHandler。请注意，这必须是处理器的实现名称，而不是它实现的 com.sun.star.frame.ProtocolHandler 服务的名称。com.sun.star.frame.ProtocolHandler 服务的所有实现都共享同一个 UNO 服务名称，因此不能在配置文件中使用此名称。

为防止出现模糊的实现名称，经常使用以下命名模式来命名实现名称：

 vnd.<namespace_of_company>.<namespace_of_implementation>.<class_name>

例如：vnd.sun.star.framework.ExampleHandler

 <namespace_of_company>= sun.star<
 namespace_of_implementation>= framework
 <class_name>= ExampleHandler

或者也可以使用编写 UNO 组件 - 可实现的核心接口 - XServiceInfo 中建议的命名约定：

 <namespace_of_creator>.comp.<namespace_of_implementation>.<class_name>

例如：org.openoffice.comp.framework.OProtocolHandler

所有这些约定都是建议性的；重要的是：

在配置文件中使用实现的名称，而不是常规服务的名称 "com.sun.star.frame.ProtocolHandler"

请尽量使您选择的实现名称是唯一的，并请留意当其他开发者添加具有相同名称的处理器时，您的处理器将停止运行。

org.openoffice.Office.addon.example 的配置

以下 ProtocolHandler.xcu 文件将使用实现名称 org.openoffice.Office.addon.example 在使用相同模式的配置分支 org.openoffice.Office.ProtocolHandler 中配置示例的 C++ 协议处理器。

  <?xml version="1.0" encoding="UTF-8"?>
  <oor:component-data xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" oor:name="ProtocolHandler" oor:package="org.openoffice.Office"> 
      <node oor:name="HandlerSet"> 
          <node oor:name="org.openoffice.Office.addon.example" oor:op="replace"> 
              <prop oor:name="Protocols" oor:type="oor:string-list">
                  <value>org.openoffice.Office.addon.example:*</value> 
              </prop> 
          </node> 
      </node>
  </oor:component-data>

配置使用占位符加入了一个新的 URL 协议：

 org.openoffice.Office.addon.example:*

根据此 URL 协议，C++ 协议处理器可以将一个已分发的 URL，如

 org.openoffice.Office.addon.example:Function1

路由到相应的目标例行程序。请参阅上述 C++ 源代码片断的 XDispatch 接口中的 dispatch() 方法的实现。

Content on this page is licensed under the Public Documentation License (PDL).

配置

vnd.sun.star.framework.ExampleHandler 的配置

org.openoffice.Office.addon.example 的配置

Views

Personal tools

Navigation

Search

Tools

In other languages