Name
soap_call_new, soap_receive, soap_find_xml_attribute, soap_print_box_validating, soap_box_xml_entity_validating, soap_boolean, json_boolean, dv_to_soap_type, soap_print_types_hash — low-level SOAP encoder/decoder primitives
Synopsis
any soap_call_new(
|
in url varchar, |
| in method varchar, | |
| in params any, | |
in options any); |
any soap_receive(
|
in message any, |
in options any); |
varchar soap_find_xml_attribute(
|
in entity XML, |
in attr_name varchar); |
varchar soap_print_box_validating(
|
in value any, |
in schema any); |
any soap_box_xml_entity_validating(
|
in entity XML, |
in schema any); |
any soap_boolean(
|
in value any); |
varchar dv_to_soap_type(
|
in dv_type integer); |
any soap_print_types_hash(
|
); |
Description
These BIFs implement low-level building blocks behind Virtuoso's SOAP
server and SOAP client. Most application code uses the higher-level
soap_call wrapper
instead.
soap_call_new issues a SOAP RPC call to
url, invoking method with
the serialized params vector. Returns the decoded
response. soap_call_new exposes the latest SOAP
encoding/protocol settings, where the older
soap_call retains
the original behaviour for compatibility.
soap_receive decodes a raw SOAP message body and
returns a Virtuoso value tree representing the SOAP envelope.
soap_find_xml_attribute looks up an attribute on a
SOAP-aware XML entity, treating the entity's XSD-defined namespace
bindings as in scope.
soap_print_box_validating and
soap_box_xml_entity_validating serialize and parse
SOAP/XML payloads while validating against an XSD schema. The first emits
a SOAP-encoded string from a SQL value; the second produces a typed parse
tree from an XML entity.
soap_boolean coerces its argument to a SOAP boolean
value (true/false/null). It is also registered under the alias
json_boolean because JSON shares the same coercion
rules.
dv_to_soap_type maps an internal Virtuoso DV type
code (e.g. DV_LONG_INT, DV_STRING)
to the corresponding XSD-style SOAP type name (xsd:int,
xsd:string, ...).
soap_print_types_hash dumps the server's in-memory
SOAP type registry as a vector. Useful for debugging schema-aware SOAP
code.