Experiments with XQuery, RESTXQ, and MVC in BaseX

100%

Experiments with XQuery, RESTXQ, and MVC in BaseX

✓ Published0🌍 Public

Last edited May 15, 2015

Created on May 15, 2015

This example demonstrates a model-view-controller (MVC) architecture for serving a web-based corpus of Charles Baudelaire’s poems, with XQuery functions defining RESTful routes. It shows how BaseX’s RESTXQ annotations (`%rest:path`, `%rest:GET`) map URLs like `/`, `/about`, and `/contents` to controller functions, while a separate view module generates XHTML pages with Bootstrap styling. The model module queries the `fleurs-du-mal` collection to extract contributor names and poem titles for dynamic content. The code highlights XQuery’s role in both server-side logic and HTML templating, without any client-side JavaScript or charting libraries.

AI-generated description

Similar vizzes

Loading thumbnail…

BaseX Server

This example shows a minimal RESTful web application built with BaseX, a native XML database, that serves XHTML pages for a poetry corpus. The code defines four GET endpoints—root, `/about`, `/credits`, and `/poem/{name}`—each returning a simple HTML page via the `view:display-contents` function. The implementation uses BaseX’s RESTXQ annotations (`%rest:path`, `%rest:GET`) and XQuery modules (`api.xqm`, `model.xqm`, `view.xqm`). The `model:credits` function supplies static HTML content, while the view module constructs the page skeleton. Data is hardcoded in XQuery, with no external datasets or JavaScript libraries involved.

CCliffordAnderson

85% match

Loading thumbnail…

{$title}

This example demonstrates a minimal XQuery web application for the Corpus Baudelaire project, serving static XHTML pages and dynamic poem routes. It shows how RESTXQ annotations declare endpoints for the root path, an about page, a credits page, and a parameterized poem URL, with each route returning a simple HTML document via a shared display function. The code relies on the RESTXQ API for request routing and the XQuery standard library for string concatenation and element construction, though it renders no actual data visualization.

CCliffordAnderson

81% match

Loading thumbnail…

Error 404

This example demonstrates a RESTful API built with BaseX and XQuery, returning dynamic XML responses for various routes, including a custom 404 error page. It shows how URL path parameters and HTTP status codes are handled through the `%rest:path` and `%rest:GET` annotations, with a fallback error handler that issues a 404 status. The code uses the `rest` and `http` output serialization, while the model and view modules (model.xqm and view.xqm) separate data retrieval—querying ORCID person names—from presentation, rendering lists as HTML paragraphs. No client-side visualization libraries are involved; the focus is on server-side routing and structured data delivery.

CCliffordAnderson

75% match

Loading thumbnail…

Sample RestXQ

This example demonstrates how to route HTTP requests and return XML responses using the RESTXQ API in BaseX. It defines multiple endpoint paths, including dynamic segments like `hello/{$who}` and `post/{$post}`, alongside static routes for the root and about pages. A custom error handler returns a 404 status with an HTML page when a requested path does not match any defined route. The code imports a separate model module that provides a `say-hello` function, which is called by the hello endpoint to generate XML output.

CCliffordAnderson

74% match

Loading thumbnail…

Sample MVC for William

This example demonstrates a simple Model-View-Controller architecture for generating an HTML listing of the first 50 article titles from a TEI XML collection. It shows how an XQuery REST endpoint (`%rest:path`) routes requests to a controller function, which delegates rendering to a separate view module. The view uses standard XQuery functions like `fn:collection` and `element` to transform TEI-encoded text segments directly into HTML paragraphs.

CCliffordAnderson

73% match

Loading thumbnail…

Fleurs du Mal

This example displays the table of contents for Charles Baudelaire’s *Fleurs du Mal*, stored as a collection in BaseX. The page fetches document URLs from the `fleurs-du-mal` database and renders them as hyperlinks, using the RESTXQ module to map the `{$title}` path parameter to a specific document when the title starts with “FDM.” The code relies on BaseX’s `db:open`, `fn:collection`, and `fn:doc` functions to query XML files, and outputs XHTML via the `%rest:path` and `%output:method` annotations.

CCliffordAnderson

72% match

Loading thumbnail…

RESTXQ example using map:find with BaseX 6.0 beta

This example demonstrates a RESTXQ service that queries the Open Library API for book titles and returns matching results as XML. The code defines an XQuery function annotated with `%rest:path` and `%rest:GET`, which receives a book title and a key parameter. It constructs a URL to the Open Library search endpoint, retrieves the JSON response using `fn:json-doc`, then flattens and searches the resulting structure with `array:flatten` and `map:find` from BaseX 6.0. The matched items are wrapped in a custom `results` element.

CCliffordAnderson

71% match

Loading thumbnail…

Sample code for extracting, transforming, and loading IA metadata into BaseX

This example demonstrates an XQuery 3.1 pipeline for harvesting Open Library search results and persisting them as structured XML in a BaseX database. It first fetches JSON via `fetch:text` and parses it with `json:parse`, then converts each record into a canonical `book` element with attributes for key and full-text availability, and child elements for title, authors, dates, publishers, and subjects. Subsequent scripts extend the process to paginate through large result sets, and a final query retrieves full book texts from the Internet Archive, storing them alongside the metadata.

CCliffordAnderson

63% match