Difference between revisions of "Java Bindings"

From BaseX Documentation
Jump to navigation Jump to search
Line 24: Line 24:
 
Note: To call the <code>write</code> method of the filewriter class you have to pass a
 
Note: To call the <code>write</code> method of the filewriter class you have to pass a
 
instantiated filewriter-object as first parameter to the method.
 
instantiated filewriter-object as first parameter to the method.
 
==Try/Catch==
 
The well-known try/catch construct can be used in BaseX to intercept
 
run-time errors. This feature will also be part of the new
 
[http://www.w3.org/TR/xquery-11/#id-try-catch XQuery 1.1 Recommendation].
 
 
'''Example:'''
 
<pre class="brush:xquery"> try {
 
  1 + '2'
 
} catch *($code, $desc) {
 
  concat('Error [', $code, ']: ', $desc)
 
}</pre>
 
'''Result:''' <code>Error [XPTY0004]: '+' operator: number expected, string found.</code>
 
  
 
[[Category:XQuery]]
 
[[Category:XQuery]]

Revision as of 11:58, 4 January 2011

The Java Binding feature is an extensibility mechanism which allows direct calling of Java methods bound as XQuery functions and manipulation of wrapped Java objects. The following examples introduce the behavior. Please note that the namespace URI must be of the form java:fullyQualifiedClassName.

This example uses the java Math class and returns the cosine of an angle:

declare namespace math = "java:java.lang.Math";
math:cos(xs:double(0))

Note: To call a method directly it has to be set as static in you java code.

The next example writes 256 bytes to the file output.txt:

declare namespace fw = "java:java.io.FileWriter";
 
let $file := fw:new('output.txt')
return (
  for $i in 0 to 255
  return fw:write($file, xs:int($i)),
  fw:close($file)
 )

Note: To call the write method of the filewriter class you have to pass a instantiated filewriter-object as first parameter to the method.