March 2026 - BaseX-Talk - mailman.uni-konstanz.de

Updated C++ client libBasexCpp
by Ben Engbers 30 Mar '26

30 Mar '26

I have uploaded a new version from my C++ libBasexCpp shared library, together with libBasexTest. At least on my testmachines, everything is working fine. Feedback is appreciated! Cheers, Ben

1 0

[XQST0045] Annotation %method is in reserved namespace.
by Eliúd Santiago Meza y Rivera 26 Mar '26

26 Mar '26

Hello, I was testing the feature https://docs.basex.org/main/XQuery_4.0#methods, but the examples raise the error XQST0045 let $vector := { 'x': 5, 'y': 6, 'sum': %method fn() { ?x + ?y } } return $vector =?> sum() let $number := { 'value': 1, 'inc': %method fn() { map:put(., 'value', ?value + 1) } } return $number?inc() -- LSC Eliud Santiago Meza y Rivera

5 8

Re: Help adding "bulk" txt files
by ykhabins＠bellsouth.net 24 Mar '26

24 Mar '26

Hello, You can reduce: file:list($path, false(), '*.txt')[starts-with(., 'retrospect-')] to the following: file:list($path, false(), 'retrospect-*.txt') It is up to you to test and compare both approaches: #1 vs. #2. Regards, Yitzhak Khabinsky

2 1

Help adding "bulk" txt files
by Bridger Dyson-Smith 23 Mar '26

23 Mar '26

Hi all - I'm wondering if you all would share better ways to approach the following problem: I have a directory of files but I only want to put a subset of the files into a BaseX database. After some fumbling around, I have these two approaches, but... what are your thoughts? Can I simplify this somehow? I struggled initially with filtering the files down - while I know I could have thrown everything in the directory into a db, there are some fairly large binaries and disk space is precious :) - so I couldn't get a way forward through using commands, but maybe I overlooked something. Thanks for your time! Best, Bridger #1 (: relies on running 'CREATE DATABASE cco' as a first step :) declare variable $path := "/home/bridger/Downloads/cco/"; for $m in file:list($path, false(), '*.txt')[starts-with(., 'retrospect-')] let $n := substring-after(substring-before($m, '.txt'), 'cob-') let $t := element text { file:read-text($path || $m, 'UTF-8', true()) return updating db:add(?, ?, ?)('cco', $t, $n) #2 declare variable $path := "/home/bridger/Downloads/cco/"; declare variable $filepaths := file:list($path, false(), '*.txt')[starts-with(., 'retrospect-')]; declare variable $files := ( for $f in $filepaths let $t := element text { file:read-text($path || $f, 'UTF-8', true()) } return $t ); declare variable $names := ( for $f in $filepaths let $n := substring-after(substring-before($f, '.txt'), 'cob-') return $n ); db:create( 'nothertest', $files, $names, { 'ftindex': true(), 'textindex': true() } )

1 0

NullPointer when job is running
by Darryl Pretto 18 Mar '26

18 Mar '26

Hi, I am running the BaseX webapp deployed on a Jetty server. I’m trying to upgrade to BaseX 12.2, running with Jetty 12.1.7. When I run a job using job:eval I find that the Jobs tab in the web UI displays the below error/stack trace while the job is running. The job itself is running a proc:system command that runs a script that makes a REST call to a web service and then uploads the data into a BaseX db. It takes 2-3 minutes to complete. The error doesn’t occur every single time the job is run, but often. I have reproduced it both on my local Mac and on a server running Amazon Linux. It doesn’t seem to happen when I use BaseX 12.2 with Jetty 11.0.24. It may not be a significant problem. Despite the error the job still completes, so it doesn’t affect anything other than the jobs tab display in the Web UI. But it is odd and I wonder if anyone has any idea what the issue might be. Also, is there any drawback to using Jetty 11 (other than it being deprecated)? Thanks, Darryl Unexpected error: Improper use? Potential bug? Your feedback is welcome: Contact: basex-talk(a)mailman.uni-konstanz.de Version: BaseX 12.2 Java: Azul Systems, Inc., 21.0.10 OS: Linux, amd64 Stack Trace: java.lang.NullPointerException: Cannot invoke "org.eclipse.jetty.server.Request.getAttribute(String)" because the return value of "org.eclipse.jetty.ee11.servlet.ServletApiRequest.getRequest()" is null at org.eclipse.jetty.ee11.servlet.ServletApiRequest.getAttribute(ServletApiRequest.java:915) at org.basex.http.HTTPConnection.getAttribute(HTTPConnection.java:448) at org.basex.http.HTTPConnection.clientName(HTTPConnection.java:272) at org.basex.core.Context.clientName(Context.java:283) at org.basex.query.func.job.JobListDetails.value(JobListDetails.java:53) at org.basex.query.expr.ParseExpr.iter(ParseExpr.java:64) at org.basex.query.expr.gflwor.For$1.next(For.java:113) at org.basex.query.expr.gflwor.Let$LetEval.next(Let.java:145) at org.basex.query.expr.gflwor.OrderBy$1.sort(OrderBy.java:73) at org.basex.query.expr.gflwor.OrderBy$1.next(OrderBy.java:54) at org.basex.query.expr.gflwor.GFLWOR.value(GFLWOR.java:93) at org.basex.query.expr.Pipeline.value(Pipeline.java:82) at org.basex.query.expr.gflwor.Let$LetEval.next(Let.java:147) at org.basex.query.expr.gflwor.GFLWOR$1.next(GFLWOR.java:79) at org.basex.query.QueryContext.next(QueryContext.java:403) at org.basex.query.expr.constr.Constr.add(Constr.java:73) at org.basex.query.expr.constr.CElem.item(CElem.java:139) at org.basex.query.expr.constr.CElem.item(CElem.java:32) at org.basex.query.expr.ParseExpr.value(ParseExpr.java:69) at org.basex.query.expr.ParseExpr.iter(ParseExpr.java:64) at org.basex.query.expr.constr.Constr.add(Constr.java:72) at org.basex.query.expr.constr.CElem.item(CElem.java:139) at org.basex.query.expr.constr.CElem.item(CElem.java:32) at org.basex.query.expr.ParseExpr.value(ParseExpr.java:69) at org.basex.query.expr.ParseExpr.iter(ParseExpr.java:64) at org.basex.query.expr.constr.Constr.add(Constr.java:72) at org.basex.query.expr.constr.CElem.item(CElem.java:139) at org.basex.query.expr.constr.CElem.item(CElem.java:32) at org.basex.query.expr.ParseExpr.value(ParseExpr.java:69) at org.basex.query.func.FuncCall.evalFunc(FuncCall.java:38) at org.basex.query.func.StaticFuncCall.value(StaticFuncCall.java:121) at org.basex.query.expr.ParseExpr.iter(ParseExpr.java:64) at org.basex.query.scope.MainModule.iter(MainModule.java:53) at org.basex.query.QueryContext.lambda$iter$4(QueryContext.java:382) at org.basex.query.QueryContext.run(QueryContext.java:779) at org.basex.query.QueryContext.iter(QueryContext.java:382) at org.basex.http.restxq.RestXqResponse.serialize(RestXqResponse.java:85) at org.basex.http.web.WebResponse.create(WebResponse.java:58) at org.basex.http.restxq.RestXqServlet.run(RestXqServlet.java:70) at org.basex.http.BaseXServlet.service(BaseXServlet.java:68) at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:723) at org.eclipse.jetty.ee11.servlet.ServletHolder$NotAsync.service(ServletHolder.java:1384) at org.eclipse.jetty.ee11.servlet.ServletHolder.handle(ServletHolder.java:750) at org.eclipse.jetty.ee11.servlet.ServletHandler$ChainEnd.doFilter(ServletHandler.java:1668) at org.eclipse.jetty.ee11.servlet.ServletHandler$MappedServlet.handle(ServletHandler.java:1602) at org.eclipse.jetty.ee11.servlet.ServletChannel.dispatch(ServletChannel.java:868) at org.eclipse.jetty.ee11.servlet.ServletChannel.handle(ServletChannel.java:449) at org.eclipse.jetty.ee11.servlet.ServletHandler.handle(ServletHandler.java:470) at org.eclipse.jetty.security.SecurityHandler.handle(SecurityHandler.java:546) at org.eclipse.jetty.ee11.servlet.SessionHandler.handle(SessionHandler.java:763) at org.eclipse.jetty.server.handler.ContextHandler.handle(ContextHandler.java:1224) at org.eclipse.jetty.server.handler.ContextHandlerCollection.handle(ContextHandlerCollection.java:148) at org.eclipse.jetty.server.Server.handle(Server.java:197) at org.eclipse.jetty.server.internal.HttpChannelState$HandlerInvoker.run(HttpChannelState.java:787) at org.eclipse.jetty.server.internal.HttpConnection.onFillable(HttpConnection.java:420) at org.eclipse.jetty.server.internal.HttpConnection$FillableCallback.succeeded(HttpConnection.java:1809) at org.eclipse.jetty.io.FillInterest.fillable(FillInterest.java:105) at org.eclipse.jetty.io.SelectableChannelEndPoint$1.run(SelectableChannelEndPoint.java:54) at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.runTask(AdaptiveExecutionStrategy.java:492) at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.epcRunTask(AdaptiveExecutionStrategy.java:428) at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.consumeTask(AdaptiveExecutionStrategy.java:401) at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.tryProduce(AdaptiveExecutionStrategy.java:255) at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.run(AdaptiveExecutionStrategy.java:204) at org.eclipse.jetty.util.thread.ReservedThreadExecutor$ReservedThread.run(ReservedThreadExecutor.java:317) at org.eclipse.jetty.util.thread.QueuedThreadPool.runJob(QueuedThreadPool.java:1009) at org.eclipse.jetty.util.thread.QueuedThreadPool$Runner.doRunJob(QueuedThreadPool.java:1239) at org.eclipse.jetty.util.thread.QueuedThreadPool$Runner.run(QueuedThreadPool.java:1194) at java.base/java.lang.Thread.run(Thread.java:1583)

2 4

How do I determine which web protocol to use?
by Ben Engbers 18 Mar '26

18 Mar '26

Hi, I’ve been working on implementing the WebSocket protocol in my C++ client for just over a month now. I started with the assumption that the basexserver uses the WebSocket protocol by default. I can now finally send and receive WebSocket frames. But even when performing the opening handshake, I see that after sending a request, I don’t receive a WebSocket frame in return. Instead, I get the standard realm/nonce that I’m already using in my current client which is based on a raw web connection. The developers section of the Basex documentation discusses the WebSocket protocol. In web.xml, I see that the WebSocket service is enabled. Yet I’m not getting the expected response. My question is: where is my mistake? What do I need to do to use the WebSocket protocol as a client? While modifying the code, I did make a few improvements. I also updated the documentation. I’ll upload my code one of these days. Ben By the way, I’ve learned a lot about C++ programming ;-)

1 0

How can I mock a http response correctly
by Andreas Hengsbach | nexoma 17 Mar '26

17 Mar '26

Hello everybody, I'm currently trying to mock the HTTP client's response for unit tests. In both cases, I have a sequence, but I need to handle them differently. Why is that, and how can I correctly mock a response so that it behaves exactly like the real response? Here's my test script: # schnipp declare function local:httpMockResponse() { ( <http:response status="200"/>, <html> <foo>bar</foo> </html> ) }; <real>{http:send-request((),"https://nexoma.de")[2]/html/name()}</real>, <mock>{local:httpMockResponse()[2]/html/name()}</mock>, <mock2>{local:httpMockResponse()[2]/name()}</mock2> (: Why one level lower here? :) # schnapp I just don't get it. :( Best regards Andreas

3 2

Deadlock on a subset of RestXQs
by Marco Lettere 17 Mar '26

17 Mar '26

Dear all, I'm currently running into an issue that makes my service stop serving a set of RESTXQ calls indefinitely without any clearly visible cause. When this happens an inspection of the threads returns that there are more than 100 threads locked with the stack trace reported in [1]. The architecture comprises a RestXQ service (without any DB) that receives a POST request, let's call it API. In the implementation of the request handling it "xquery:fork-joins" about 12 operations which mainly consist of http requests to another service or reading of local files, in order to cache (or refresh) information that is kept in a BaseX store locally. During the all of the said operation it also performs some write oprations (mainly to log the outcome of the operation) on a BaseX DB which runs on a different BaseX server (say Persistence) process through db:query(). We notice that many calls to the API continue to be served. Mainly calls that remain on the API itself or access other DBs on Persistence. Only all the calls that access the same store or persistence DB somehow stop being served. In the logs we see the request is received but it never either succeeds nor fails. We have BaseX 11.9 here with FAIRLOCK = false and PARALLEL=8 (wonder if this can be a hint). Because we are rather clueless I ask whether anyone has a hint about where we should restrict our investigations? Thank you very much! Marco. [1] "qtp192881625-748" #748 prio=5 os_prio=0 cpu=11.89ms elapsed=240.61s tid=0x00007abe1a7c4330 nid=0x289f6 in Object.wait() [0x00007abe1a4b2000] java.lang.Thread.State: WAITING (on object monitor) at java.lang.Object.wait(java.base(a)17.0.12/Native Method) - waiting on <no object reference available> at java.lang.Object.wait(java.base@17.0.12/Object.java:338) at org.basex.core.locks.NonfairLockQueue.acquire(NonfairLockQueue.java:37) - locked <0x00000000802a93d8> (a org.basex.core.locks.NonfairLockQueue) at org.basex.core.locks.Locking.acquire(Locking.java:110) at org.basex.core.locks.Locking.acquire(Locking.java:89) at org.basex.core.jobs.Job.register(Job.java:48) at org.basex.http.restxq.RestXqResponse.serialize(RestXqResponse.java:81) at org.basex.http.web.WebResponse.create(WebResponse.java:58) at org.basex.http.restxq.RestXqServlet.run(RestXqServlet.java:70) at org.basex.http.BaseXServlet.service(BaseXServlet.java:68) at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:587) at org.eclipse.jetty.servlet.ServletHolder$NotAsync.service(ServletHolder.java:1410) at org.eclipse.jetty.servlet.ServletHolder.handle(ServletHolder.java:764) at org.eclipse.jetty.servlet.ServletHandler.doHandle(ServletHandler.java:529) at org.eclipse.jetty.server.handler.ScopedHandler.handle(ScopedHandler.java:131) at org.eclipse.jetty.security.SecurityHandler.handle(SecurityHandler.java:598) at org.eclipse.jetty.server.handler.HandlerWrapper.handle(HandlerWrapper.java:122) at org.eclipse.jetty.server.handler.ScopedHandler.nextHandle(ScopedHandler.java:223) at org.eclipse.jetty.server.session.SessionHandler.doHandle(SessionHandler.java:1580) at org.eclipse.jetty.server.handler.ScopedHandler.nextHandle(ScopedHandler.java:221) at org.eclipse.jetty.server.handler.ContextHandler.doHandle(ContextHandler.java:1381) at org.eclipse.jetty.server.handler.ScopedHandler.nextScope(ScopedHandler.java:176) at org.eclipse.jetty.servlet.ServletHandler.doScope(ServletHandler.java:484) at org.eclipse.jetty.server.session.SessionHandler.doScope(SessionHandler.java:1553) at org.eclipse.jetty.server.handler.ScopedHandler.nextScope(ScopedHandler.java:174) at org.eclipse.jetty.server.handler.ContextHandler.doScope(ContextHandler.java:1303) at org.eclipse.jetty.server.handler.ScopedHandler.handle(ScopedHandler.java:129) at org.eclipse.jetty.server.handler.HandlerWrapper.handle(HandlerWrapper.java:122) at org.eclipse.jetty.server.handler.gzip.GzipHandler.handle(GzipHandler.java:822) at org.eclipse.jetty.server.handler.HandlerWrapper.handle(HandlerWrapper.java:122) at org.eclipse.jetty.server.Server.handle(Server.java:563) at org.eclipse.jetty.server.HttpChannel$RequestDispatchable.dispatch(HttpChannel.java:1598) at org.eclipse.jetty.server.HttpChannel.dispatch(HttpChannel.java:753) at org.eclipse.jetty.server.HttpChannel.handle(HttpChannel.java:501) at org.eclipse.jetty.server.HttpConnection.onFillable(HttpConnection.java:287) at org.eclipse.jetty.io.AbstractConnection$ReadCallback.succeeded(AbstractConnection.java:314) at org.eclipse.jetty.io.FillInterest.fillable(FillInterest.java:100) at org.eclipse.jetty.io.SelectableChannelEndPoint$1.run(SelectableChannelEndPoint.java:53) at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.runTask(AdaptiveExecutionStrategy.java:421) at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.consumeTask(AdaptiveExecutionStrategy.java:390) at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.tryProduce(AdaptiveExecutionStrategy.java:277) at org.eclipse.jetty.util.thread.strategy.AdaptiveExecutionStrategy.run(AdaptiveExecutionStrategy.java:199) at org.eclipse.jetty.util.thread.ReservedThreadExecutor$ReservedThread.run(ReservedThreadExecutor.java:411) at org.eclipse.jetty.util.thread.QueuedThreadPool.runJob(QueuedThreadPool.java:969) at org.eclipse.jetty.util.thread.QueuedThreadPool$Runner.doRunJob(QueuedThreadPool.java:1194) at org.eclipse.jetty.util.thread.QueuedThreadPool$Runner.run(QueuedThreadPool.java:1149) at java.lang.Thread.run(java.base@17.0.12/Thread.java:840)

2 5

Inspection module permissions?
by Clark, Ash 11 Mar '26

11 Mar '26

Hi, I'm updating to BaseX 12.2 and I noticed that `inspect:xqdoc()` now requires admin permissions. That made sense to me, and I updated my RESTXQ API to fall back on cached data when describing its own documentation. Unusually, however, I couldn't find any reference to the change in the changelog or the Inspection wiki page. Was the change intentional? If so, it'd be helpful for the Inspection documentation to state that the functions need admin permissions. Warmly, Ash Clark

2 3