共计 1675 个字符,预计需要花费 5 分钟才能阅读完成。
Orbeon Forms 通过配置属性进行配置。它们通常设置在名为 properties-local.xml 的文件中,并存储在 Orbeon Forms WAR 文件中,如下所示:
WEB-INF/resources/config/properties-local.xml:
Orbeon Forms 能够做一些开箱即用的事件,而您无需在 properties-local.xml 中进行任何设置。然而,如果您想更改默认行为(并且很可能为了设置访问控制、数据库拜访、配置按钮等),您将须要对该文件进行更改。本文形容了该过程的基础知识。
您能够通过编辑 properties-local.xml 来更改属性。该文件位于 Orbeon Forms Web 应用程序内的目录 WEB-INF/resources/config 中。
如果该文件在您的 Orbeon Forms 装置中尚不存在,您能够通过将文件 properties-local.xml.template 重命名或复制到 properties-local.xml 中来创立它。此时,您的 properties-local.xml 将只蕴含一个开始 \<properties\> 标记和完结 \</properties\> 标记,您须要编辑它以在这两个标记之间增加属性,如下所示:
<properties xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:oxf="http://www.orbeon.com/oxf/processors">
<property as="xs:string"
name="oxf.fr.persistence.provider.*.*.*"
value="oracle"/>
</properties>
属性由以下组成:
- 一种类型,例如 xs:boolean
- 名称,例如 oxf.resources.versioned
- 一个值,例如 true
- 可选的,很少有处理器名称,例如 oxf:page-flow,它指的是 XPL 处理器名称
一个例子:
<property
as="xs:boolean"
name="oxf.resources.versioned"
value="true"/>
保留属性文件(例如 properties-local.xml)后,会立刻思考对大多数属性的更改,但仅在首次启动服务器时才思考对某些属性的更改。
Built-in property files
这些属性的默认值在以下文件中提供,这些文件存储在 orbeon-resources-private.jar 中:
- config/properties-dev.xml:root of dev mode properties
- config/properties-prod.xml:root of prod mode properties
- config/properties-base.xml:base Orbeon Forms properties
- config/properties-xforms.xml
- config/properties-form-runner.xml
- config/properties-form-builder.xml
通常,您不应批改这些文件。
通常,您能够在 properties-local.xml 中定义所有自定义属性。然而,如果 properties 的价值须要因环境而异,例如 dev 和 prod 的值不同,那么您能够在 properties-local-dev.xml 和 properties-local-prod.xml 中定义这些属性两次,并依据文件为属性定义不同的值。在这种状况下,您仍将保留不因 properties-local.xml 中的环境而不同的自定义属性。
您在 properties-local-dev.xml 中定义的属性仅实用于开发运行模式,并且在这种状况下笼罩 properties-local.xml 中的属性。
您在 properties-local-prod.xml 中定义的属性仅实用于 prod 运行模式,在这种状况下会笼罩 properties-local.xml 中的属性。