Changes

Jump to navigation Jump to search
288 bytes removed ,  17:49, 24 November 2017
no edit summary
* as web servlet, using [[#Maven|Maven]].
{{Mark|Updated with Version 8Authentication: * If a user is defined in the <code>web.xml</code> file via the key <code>org.basex.user</code>, no password must be specified.* If the <code>admin</code> user is specified for an API, all features will be available without restriction.* Predefined authentication methods and default users cannot be overwritten by client.6:}}
* Authentication was readded to RESTXQ. As a consequence, you need to specify the <code>admin</code> user in your <code>web.xml</code> file if you want to preserve the behavior of older versions of BaseX.
* In turn, if users are defined in the <code>web.xml</code> file, no passwords must be specified anymore.
* The server-side authentication method, and default users, are now enforced and cannot be overwritten by client.<br/><br/>
=Servlet Container=
In order to deploy BaseX HTTP Services in a servlet container, you can download the WAR distribution of BaseX from the [http://basex.org/download download site], or compile it by youroself via calling <code>mvn compile war:war</code> in the <code>basex-api</code> packagedirectory. The WAR file can then be deployed following the instructions of the corresponding servlet container ([http://www.eclipse.org/jetty/documentation/current/quickstart-deploying-webapps.html jetty], [http://tomcat.apache.org/tomcat-7.0-doc/deployer-howto.html tomcat], etc.).
You can configure the port, context path, etc. by following the instructions of the corresponding servlet container. This is needed if you want to replace the default URL path (e.g. http://localhost:8080/rest) with a custom one (e.g. http://localhost:80808984/BaseXbasex/rest).
With If you use Jetty (which is the default HTTP server in of BaseX), you can use a the server configuration is available via the {{Code|jetty.xml}} file for detailed server configuration. You can e.g. enable SSL connections or Jetty logging. Place , which is stored in the {{Code|jetty.xmlWEB-INF}} right directory next to the {{Code|web.xml}}. For detailed configuration refer to the [http://wikiwww.eclipse.org/Jetty/Reference/jetty.xml Jetty Documentation]. A basic [https:/documentation/github.comcurrent/BaseXdb/basex/blob/master/basexjetty-api/src/main/webapp/WEBxml-INF/jettyconfig.xml jetty.xmlhtml Jetty Documentation] file is placed in the basex-api package.
To run on [http://tomcat.apache.org/ Apache Tomcat], start the Tomcat server and add any <code>*.war</code> distribution to deploy via the Tomcat web interface. By default, the interface is accessible via http://localhost:8080/manager/html/.
Bureaucrats, editor, reviewer, Administrators
13,550

edits

Navigation menu