The page http://docs.basex.org/wiki/Java_Examples is very detailed. However, I wonder in which cases one should use the BaseX XQJ API and not the standard client. e.g., which client offers a better performance?

In short: Our internal APIs are the fastest on. If you possibly want to use other XML databases as well, XQJ will give you the benefits from a standardized API.