Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
* {{Version|7.5}}: Options can be locally set in XQuery via pragma expressions:
{{Mark|Introduced with Version 7.5:}}
{{Mark|Introduced with Version 7.5:}}
{{Mark|Introduced with Version 7.5}}
{{Mark|Introduced with Version 7.5}}
{{Mark|Introduced in Version 7.5:}} this value is replacing the [[#HTTPPATH|HTTPPATH]] option.
{{Mark|Introduced with Version 7.5:}}
{{Mark|Introduced with Version 7.5:}}
|}
===HTTPPATH===
{{Mark|Removed in Version 7.5:}} this value has been replaced with the [[#WEBPATH|WEBPATH]] and [[#RESTXQPATH|RESTXQPATH]] options.
{| width='100%'
|-
| width='90' | '''Signature'''
|{{Code|HTTPPATH [path]}}
|-
| '''Default'''
|<code>[[Configuration#Database Directory|{home}/BaseXHTTP]]</code> or <code>[[Configuration#Database Directory|{home}/http]]</code>
|-
| '''Summary'''
|Points to the HTTP root directory, in which HTML files may be stored, and query files that will be evaluated by REST. This option can also be changed when running the HTTP server on [[Startup Options#BaseX Server|command line]] via <code>-l</code>.
|}
===HTTPPORT===
{{Mark|Removed in Version 7.5:}} this value is now modified in the {{Code|jetty.xml}} config file.
{| width='100%'
|-
| width='90' | '''Signature'''
|{{Code|HTTPPORT [port]}}
|-
| '''Default'''
|{{Code|8984}}
|-
| '''Summary'''
|This is the port the [[Startup#BaseX HTTP Server|HTTP Server]] will be listening to.
|}
===CREATEONLY===
{{Mark|Introduced with Version 7.5:}}
{| width='100%'
|-
| width='90' | '''Signature'''
|{{Code|CREATEONLY [boolean]}}
|-
| '''Default'''
|{{Code|false}}
|-
| '''Summary'''
|By default, newly created databases will automatically be opened in order to be available for further processing steps. By setting the flag to {{Code|true}}, this will be prevented.
|}
===STRIPNS===
{{Mark|Introduced with Version 7.5:}}
{| width='100%'
|-
| width='90' | '''Signature'''
|{{Code|STRIPNS [boolean]}}
|-
| '''Default'''
|{{Code|false}}
|-
| '''Summary'''
|Strips all namespaces from an XML document before adding it to a database.
no edit summary
* The current value of an option can be requested with the [[Commands#GET|GET]] and changed with the [[Commands#SET|SET]] command. All values are ''static'': they stay valid until they are changed once again by another operation. If an option is of type ''boolean'', and if no value is specified, its existing value will be inverted.
* {{Version|7.5}}: Initial values for options can also be specified via system properties, which can e.g. be passed on with the [http://docs.oracle.com/javase/1.4.2/docs/tooldocs/windows/java.html#options -D flag] on command line, or using [http://docs.oracle.com/javase/6/docs/api/java/lang/System.html#setProperty(java.lang.String,%20java.lang.String) System.setProperty()] before creating a BaseX instance. The specified keys needs to be prefixed with {{Code|org.basex.}}. An example:
<pre class="brush:bash">
...
</pre>
<pre class="brush:xquery">
===USER===
{| width='100%'
|-
===PASSWORD===
{| width='100%'
|-
===LOG===
{| width='100%'
|-
===LOGMSGMAXLEN===
{| width='100%'
|-
===WEBPATH===
{| width='100%'
|-
===RESTXQPATH===
{| width='100%'
|-
===HTTPLOCAL===
{| width='100%'
|-
* The option is ignored if BaseX is used as a [[Web Application]] or started via [[Web Application#Maven|Maven]].
* This option can also be changed when running the HTTP server on [[Startup Options#BaseX Server|command line]] via <code>-s</code>.
|}
| '''Summary'''
|If this option is turned on, new databases will be exclusively created in main memory. Most queries will be evaluated faster in main memory mode, but all data is lost if BaseX is shut down. The value of this option will be assigned once to a new database, and cannot be changed after that.
|}
| '''Summary'''
|Uses the internal XML parser instead of the standard Java XML parser. The internal parser is faster, more fault tolerant and supports common HTML entities out-of-the-box, but it does not support all features needed for parsing DTDs.
|}
