oxf.xforms.renderer.context
parameter specifies the context into which you have deployed Orbeon Forms. By default, Orbeon forms deploys to /orbeon
so this value is usually safe. If you deploy Orbeon Forms to another context, you need to change this value accordingly.<url-pattern>
defined under the first <filter-mapping>
has the value /xforms-jsp/*
. This means that all the data generated by URLs starting with /xforms-jsp/
is post-processed by Orbeon Forms. You can change this value as desired.<url-pattern>
defined under the second <filter-mapping>
has the value /orbeon/*
. This is necessary to allow for all Orbeon Forms resources, such as JavaScript, CSS, and Ajax server, to be accessible. This /orbeon/*
value is related to the default context into which you deploy Orbeon Forms: if you change you context, you change this value as well.oxf.xforms.renderer.default-encoding
allows you to specify a default character encoding when the content provided by the servlet or JSP page doesn't specify one. Previously, the default character encoding was hardcoded to ISO-8859-1
. Since 4.6.1 the hardcoded default remains this, but you can change it with oxf.xforms.renderer.default-encoding
. The default Orbeon Forms web.xml overrides this default to UTF-8
, which is what most modern HTML uses.xforms-jsp
in your WAR are processed by the XForms engine. However, it is likely that you will prefer another location. In that case, you just change the url-mapping
configuration./orbeon/
directory, as that directory is reserved for Orbeon Forms resources.web.xml
kicks in for those resources and that you produce well-formed XML as output. For this to happen, you modify the <filter-mapping>
accordingly to enable the filter for the URLs handled by your framework.web.xml
. It is not possible to access your application's XForms pages by accessing Orbeon Forms URLs directly: your application controls the generation of XForms content, not Orbeon Forms.web.xml
./orbeon
context. Follow the installation instructions and the Orbeon Forms Tutorial if needed.WEB-INF/lib/orbeon-xforms-filter.jar
from the Orbeon Forms WAR into your application's WEB-INF/lib/
directory.web.xml
as described in the previous section to setup the Orbeon Forms XForms filter.orbeon``.war
, you can remove:WEB-INF/resources
, except the directory WEB-INF/resources``/config
and its content. (This directory contains configuration files which you might want to change, in particular the properties files.)WEB-INF
; namely: jboss-web.xml
, jonas-web.xml
, liferay-display.xml
, liferay-portlet.xml
, portlet.xml
, sun-web.xml
, weblogic.xml
. (The application-server specific files contain an example of how to declare a data source, so you can safely remove those files even if they are for the application server you are using.)WEB-INF/classes
directory.WEB-INF/commons-cli-1_0.jar
file.<sharing-enabled>
to true
in weblogic-application.xml
.request.getSession()
, even if you're not going to store anything in that session.HttpServletRequest
object which is passed to servlets (and also accessible in JSP through the request
variable):"oxf.xforms.renderer.document"
. It may contain XHTML and XForms as an XML Document Object Model (DOM), as a dom4j Document
, or as a String containing XML.<xf:instance src="oxf:/path/file.xml">
. You can also use XInclude to include arbitrary parts of your form with: <xi:include href="``oxf:/path/file.xml">
. The oxf:
scheme tells Orbeon Forms that the file is loaded from the resource directory, typically from WEB-INF/resources
inside the Orbeon Forms war file.<xf:instance src="http://wiki.orbeon.com/file.xml">
. If the URL for your form is http://localhost/myapp/forms/registration.jsp
, then Orbeon Forms will load the file to include from http://localhost/myapp/forms/file.xml
. Most likely this will work, but you will incur the cost of an additional HTTP request every time the page is loaded.xxf:get-request-parameter()
xxf:get-session-attribute()
input:instance
URI to access XML data submitted to the current page:POST
or PUT
methodPOST
or PUT
input:instance
URIinput:instance
only if your JSP or servlet has not attempted to read the request body first!<xf:submission>
. Most of the time, XML is being POST
ed to the service and XML is returned by the service. Since services take XML as input and generate XML, XML pipelines are an ideal tool to implement services.<xf:submission>
:web.xml
, the Orbeon Forms XForms filter kicks in and intercepts the output of your JSP or servlet (whether produced the regular way or passed as a request attribute)./xforms-renderer
./xforms-renderer
by extracting the XHTML and XForms document from the forwarded request./config/epilogue-servlet.xpl
. The epilogue performs several tasks, including transforming XHTML and XForms into HTML that the browser can understand. The default configuration of this pipeline should be fine for most use cases, which means you usually don't need to worry about it./config/theme-plain.xsl
. However, it does not perform further URL rewriting by default.OrbeonXFormsFilter
sets the following request attributes:oxf.xforms.renderer.deployment
separate
oxf.xforms.renderer.base-uri
/xforms-jsp/guess-the-number/test.jsp
- used for xml:base
resolution by XFormsoxf.xforms.renderer.document
oxf.xforms.renderer.content-type
oxf.xforms.renderer.has-session
true
/ false