PostgreSQL Source Code git master
Loading...
Searching...
No Matches
xml.c File Reference
#include "postgres.h"
#include "access/htup_details.h"
#include "access/table.h"
#include "catalog/namespace.h"
#include "catalog/pg_class.h"
#include "catalog/pg_type.h"
#include "executor/spi.h"
#include "executor/tablefunc.h"
#include "fmgr.h"
#include "lib/stringinfo.h"
#include "libpq/pqformat.h"
#include "mb/pg_wchar.h"
#include "miscadmin.h"
#include "nodes/execnodes.h"
#include "nodes/miscnodes.h"
#include "nodes/nodeFuncs.h"
#include "utils/array.h"
#include "utils/builtins.h"
#include "utils/date.h"
#include "utils/datetime.h"
#include "utils/lsyscache.h"
#include "utils/rel.h"
#include "utils/syscache.h"
#include "utils/xml.h"
Include dependency graph for xml.c:

Go to the source code of this file.

Macros

#define NO_XML_SUPPORT()
 
#define NAMESPACE_XSD   "http://www.w3.org/2001/XMLSchema"
 
#define NAMESPACE_XSI   "http://www.w3.org/2001/XMLSchema-instance"
 
#define NAMESPACE_SQLXML   "http://standards.iso.org/iso/9075/2003/sqlxml"
 
#define PG_XML_DEFAULT_VERSION   "1.0"
 
#define XML_VISIBLE_SCHEMAS_EXCLUDE   "(nspname ~ '^pg_' OR nspname = 'information_schema')"
 
#define XML_VISIBLE_SCHEMAS   "SELECT oid FROM pg_catalog.pg_namespace WHERE pg_catalog.has_schema_privilege (oid, 'USAGE') AND NOT " XML_VISIBLE_SCHEMAS_EXCLUDE
 

Functions

static void xmldata_root_element_start (StringInfo result, const char *eltname, const char *xmlschema, const char *targetns, bool top_level)
 
static void xmldata_root_element_end (StringInfo result, const char *eltname)
 
static StringInfo query_to_xml_internal (const char *query, char *tablename, const char *xmlschema, bool nulls, bool tableforest, const char *targetns, bool top_level)
 
static const charmap_sql_table_to_xmlschema (TupleDesc tupdesc, Oid relid, bool nulls, bool tableforest, const char *targetns)
 
static const charmap_sql_schema_to_xmlschema_types (Oid nspid, List *relid_list, bool nulls, bool tableforest, const char *targetns)
 
static const charmap_sql_catalog_to_xmlschema_types (List *nspid_list, bool nulls, bool tableforest, const char *targetns)
 
static const charmap_sql_type_to_xml_name (Oid typeoid, int typmod)
 
static const charmap_sql_typecoll_to_xmlschema_types (List *tupdesc_list)
 
static const charmap_sql_type_to_xmlschema_type (Oid typeoid, int typmod)
 
static void SPI_sql_row_to_xmlelement (uint64 rownum, StringInfo result, char *tablename, bool nulls, bool tableforest, const char *targetns, bool top_level)
 
static void XmlTableInitOpaque (struct TableFuncScanState *state, int natts)
 
static void XmlTableSetDocument (struct TableFuncScanState *state, Datum value)
 
static void XmlTableSetNamespace (struct TableFuncScanState *state, const char *name, const char *uri)
 
static void XmlTableSetRowFilter (struct TableFuncScanState *state, const char *path)
 
static void XmlTableSetColumnFilter (struct TableFuncScanState *state, const char *path, int colnum)
 
static bool XmlTableFetchRow (struct TableFuncScanState *state)
 
static Datum XmlTableGetValue (struct TableFuncScanState *state, int colnum, Oid typid, int32 typmod, bool *isnull)
 
static void XmlTableDestroyOpaque (struct TableFuncScanState *state)
 
Datum xml_in (PG_FUNCTION_ARGS)
 
static charxml_out_internal (xmltype *x, pg_enc target_encoding)
 
Datum xml_out (PG_FUNCTION_ARGS)
 
Datum xml_recv (PG_FUNCTION_ARGS)
 
Datum xml_send (PG_FUNCTION_ARGS)
 
static xmltypestringinfo_to_xmltype (StringInfo buf)
 
static xmltypecstring_to_xmltype (const char *string)
 
Datum xmlcomment (PG_FUNCTION_ARGS)
 
Datum xmltext (PG_FUNCTION_ARGS)
 
xmltypexmlconcat (List *args)
 
Datum xmlconcat2 (PG_FUNCTION_ARGS)
 
Datum texttoxml (PG_FUNCTION_ARGS)
 
Datum xmltotext (PG_FUNCTION_ARGS)
 
textxmltotext_with_options (xmltype *data, XmlOptionType xmloption_arg, bool indent)
 
xmltypexmlelement (XmlExpr *xexpr, const Datum *named_argvalue, const bool *named_argnull, const Datum *argvalue, const bool *argnull)
 
xmltypexmlparse (text *data, XmlOptionType xmloption_arg, bool preserve_whitespace)
 
xmltypexmlpi (const char *target, text *arg, bool arg_is_null, bool *result_is_null)
 
xmltypexmlroot (xmltype *data, text *version, int standalone)
 
Datum xmlvalidate (PG_FUNCTION_ARGS)
 
bool xml_is_document (xmltype *arg)
 
charmap_sql_identifier_to_xml_name (const char *ident, bool fully_escaped, bool escape_period)
 
charmap_xml_name_to_sql_identifier (const char *name)
 
charmap_sql_value_to_xml_value (Datum value, Oid type, bool xml_escape_strings)
 
charescape_xml (const char *str)
 
static char_SPI_strdup (const char *s)
 
static Listquery_to_oid_list (const char *query)
 
static Listschema_get_xml_visible_tables (Oid nspid)
 
static Listdatabase_get_xml_visible_schemas (void)
 
static Listdatabase_get_xml_visible_tables (void)
 
static StringInfo table_to_xml_internal (Oid relid, const char *xmlschema, bool nulls, bool tableforest, const char *targetns, bool top_level)
 
Datum table_to_xml (PG_FUNCTION_ARGS)
 
Datum query_to_xml (PG_FUNCTION_ARGS)
 
Datum cursor_to_xml (PG_FUNCTION_ARGS)
 
Datum table_to_xmlschema (PG_FUNCTION_ARGS)
 
Datum query_to_xmlschema (PG_FUNCTION_ARGS)
 
Datum cursor_to_xmlschema (PG_FUNCTION_ARGS)
 
Datum table_to_xml_and_xmlschema (PG_FUNCTION_ARGS)
 
Datum query_to_xml_and_xmlschema (PG_FUNCTION_ARGS)
 
static StringInfo schema_to_xml_internal (Oid nspid, const char *xmlschema, bool nulls, bool tableforest, const char *targetns, bool top_level)
 
Datum schema_to_xml (PG_FUNCTION_ARGS)
 
static void xsd_schema_element_start (StringInfo result, const char *targetns)
 
static void xsd_schema_element_end (StringInfo result)
 
static StringInfo schema_to_xmlschema_internal (const char *schemaname, bool nulls, bool tableforest, const char *targetns)
 
Datum schema_to_xmlschema (PG_FUNCTION_ARGS)
 
Datum schema_to_xml_and_xmlschema (PG_FUNCTION_ARGS)
 
static StringInfo database_to_xml_internal (const char *xmlschema, bool nulls, bool tableforest, const char *targetns)
 
Datum database_to_xml (PG_FUNCTION_ARGS)
 
static StringInfo database_to_xmlschema_internal (bool nulls, bool tableforest, const char *targetns)
 
Datum database_to_xmlschema (PG_FUNCTION_ARGS)
 
Datum database_to_xml_and_xmlschema (PG_FUNCTION_ARGS)
 
static charmap_multipart_sql_identifier_to_xml_name (const char *a, const char *b, const char *c, const char *d)
 
Datum xpath (PG_FUNCTION_ARGS)
 
Datum xmlexists (PG_FUNCTION_ARGS)
 
Datum xpath_exists (PG_FUNCTION_ARGS)
 
Datum xml_is_well_formed (PG_FUNCTION_ARGS)
 
Datum xml_is_well_formed_document (PG_FUNCTION_ARGS)
 
Datum xml_is_well_formed_content (PG_FUNCTION_ARGS)
 

Variables

int xmlbinary = XMLBINARY_BASE64
 
int xmloption = XMLOPTION_CONTENT
 
const TableFuncRoutine XmlTableRoutine
 

Macro Definition Documentation

◆ NAMESPACE_SQLXML

#define NAMESPACE_SQLXML   "http://standards.iso.org/iso/9075/2003/sqlxml"

Definition at line 244 of file xml.c.

◆ NAMESPACE_XSD

#define NAMESPACE_XSD   "http://www.w3.org/2001/XMLSchema"

Definition at line 242 of file xml.c.

◆ NAMESPACE_XSI

#define NAMESPACE_XSI   "http://www.w3.org/2001/XMLSchema-instance"

Definition at line 243 of file xml.c.

◆ NO_XML_SUPPORT

#define NO_XML_SUPPORT ( )
Value:
errmsg("unsupported XML feature"), \
errdetail("This functionality requires the server to be built with libxml support.")))
int errcode(int sqlerrcode)
Definition elog.c:874
int errmsg(const char *fmt,...)
Definition elog.c:1093
int errdetail(const char *fmt,...) pg_attribute_printf(1
#define ERROR
Definition elog.h:39
#define ereport(elevel,...)
Definition elog.h:150
static int fb(int x)

Definition at line 234 of file xml.c.

241 ://www.w3.org/2001/XMLSchema"
242#define NAMESPACE_XSI "http://www.w3.org/2001/XMLSchema-instance"
243#define NAMESPACE_SQLXML "http://standards.iso.org/iso/9075/2003/sqlxml"
244
245
246#ifdef USE_LIBXML
247
248static int
250{
251 int encoding = pg_char_to_encoding((const char *) encoding_name);
252
253 if (encoding < 0)
256 errmsg("invalid encoding name \"%s\"",
257 (const char *) encoding_name)));
258 return encoding;
259}
260#endif
261
262
263/*
264 * xml_in uses a plain C string to VARDATA conversion, so for the time being
265 * we use the conversion function for the text datatype.
266 *
267 * This is only acceptable so long as xmltype and text use the same
268 * representation.
269 */
270Datum
272{
273#ifdef USE_LIBXML
274 char *s = PG_GETARG_CSTRING(0);
277
278 /* Build the result object. */
280
281 /*
282 * Parse the data to check if it is well-formed XML data.
283 *
284 * Note: we don't need to worry about whether a soft error is detected.
285 */
287 NULL, NULL, fcinfo->context);
288 if (doc != NULL)
290
292#else
294 return 0;
295#endif
296}
297
298
299#define PG_XML_DEFAULT_VERSION "1.0"
300
301
302/*
303 * xml_out_internal uses a plain VARDATA to C string conversion, so for the
304 * time being we use the conversion function for the text datatype.
305 *
306 * This is only acceptable so long as xmltype and text use the same
307 * representation.
308 */
309static char *
311{
312 char *str = text_to_cstring((text *) x);
313
314#ifdef USE_LIBXML
315 size_t len = strlen(str);
316 xmlChar *version;
317 int standalone;
318 int res_code;
319
321 &len, &version, NULL, &standalone)) == 0)
322 {
324
326
328 {
329 /*
330 * If we are not going to produce an XML declaration, eat a single
331 * newline in the original string to prevent empty first lines in
332 * the output.
333 */
334 if (*(str + len) == '\n')
335 len += 1;
336 }
338
339 pfree(str);
340
341 return buf.data;
342 }
343
346 errmsg_internal("could not parse XML declaration in stored value"),
348#endif
349 return str;
350}
351
352
353Datum
355{
357
358 /*
359 * xml_out removes the encoding property in all cases. This is because we
360 * cannot control from here whether the datum will be converted to a
361 * different client encoding, so we'd do more harm than good by including
362 * it.
363 */
365}
366
367
368Datum
370{
371#ifdef USE_LIBXML
373 xmltype *result;
374 const char *input;
375 char *str;
376 char *newstr;
377 int nbytes;
380 int encoding;
381
382 /*
383 * Read the data in raw format. We don't know yet what the encoding is, as
384 * that information is embedded in the xml declaration; so we have to
385 * parse that before converting to server encoding.
386 */
387 nbytes = buf->len - buf->cursor;
388 input = pq_getmsgbytes(buf, nbytes);
389
390 /*
391 * We need a null-terminated string to pass to parse_xml_decl(). Rather
392 * than make a separate copy, make the temporary result one byte bigger
393 * than it needs to be.
394 */
395 result = palloc(nbytes + 1 + VARHDRSZ);
396 SET_VARSIZE(result, nbytes + VARHDRSZ);
397 memcpy(VARDATA(result), input, nbytes);
398 str = VARDATA(result);
399 str[nbytes] = '\0';
400
402
403 /*
404 * If encoding wasn't explicitly specified in the XML header, treat it as
405 * UTF-8, as that's the default in XML. This is different from xml_in(),
406 * where the input has to go through the normal client to server encoding
407 * conversion.
408 */
410
411 /*
412 * Parse the data to check if it is well-formed XML data. Assume that
413 * xml_parse will throw ERROR if not.
414 */
415 doc = xml_parse(result, xmloption, true, encoding, NULL, NULL, NULL);
417
418 /* Now that we know what we're dealing with, convert to server encoding */
420
421 if (newstr != str)
422 {
423 pfree(result);
424 result = (xmltype *) cstring_to_text(newstr);
425 pfree(newstr);
426 }
427
428 PG_RETURN_XML_P(result);
429#else
431 return 0;
432#endif
433}
434
435
436Datum
438{
440 char *outval;
442
443 /*
444 * xml_out_internal doesn't convert the encoding, it just prints the right
445 * declaration. pq_sendtext will do the conversion.
446 */
448
451 pfree(outval);
453}
454
455
456#ifdef USE_LIBXML
457static void
459{
461}
462#endif
463
464
465static xmltype *
467{
468 return (xmltype *) cstring_to_text_with_len(buf->data, buf->len);
469}
470
471
472static xmltype *
473cstring_to_xmltype(const char *string)
474{
475 return (xmltype *) cstring_to_text(string);
476}
477
478
479#ifdef USE_LIBXML
480static xmltype *
482{
483 return (xmltype *) cstring_to_text_with_len((const char *) xmlBufferContent(buf),
485}
486#endif
487
488
489Datum
491{
492#ifdef USE_LIBXML
494 char *argdata = VARDATA_ANY(arg);
497 int i;
498
499 /* check for "--" in string or "-" at the end */
500 for (i = 1; i < len; i++)
501 {
502 if (argdata[i] == '-' && argdata[i - 1] == '-')
505 errmsg("invalid XML comment")));
506 }
507 if (len > 0 && argdata[len - 1] == '-')
510 errmsg("invalid XML comment")));
511
513 appendStringInfoString(&buf, "<!--");
516
518#else
520 return 0;
521#endif
522}
523
524
525Datum
527{
528#ifdef USE_LIBXML
530 text *result;
531 volatile xmlChar *xmlbuf = NULL;
533
534 /* First we gotta spin up some error handling. */
536
537 PG_TRY();
538 {
540
541 if (xmlbuf == NULL || xmlerrcxt->err_occurred)
543 "could not allocate xmlChar");
544
545 result = cstring_to_text_with_len((const char *) xmlbuf,
546 xmlStrlen((const xmlChar *) xmlbuf));
547 }
548 PG_CATCH();
549 {
550 if (xmlbuf)
552
553 pg_xml_done(xmlerrcxt, true);
554 PG_RE_THROW();
555 }
556 PG_END_TRY();
557
559 pg_xml_done(xmlerrcxt, false);
560
561 PG_RETURN_XML_P(result);
562#else
564 return 0;
565#endif /* not USE_LIBXML */
566}
567
568
569/*
570 * TODO: xmlconcat needs to merge the notations and unparsed entities
571 * of the argument values. Not very important in practice, though.
572 */
573xmltype *
574xmlconcat(List *args)
575{
576#ifdef USE_LIBXML
577 int global_standalone = 1;
579 bool global_version_no_value = false;
581 ListCell *v;
582
584 foreach(v, args)
585 {
587 size_t len;
588 xmlChar *version;
589 int standalone;
590 char *str;
591
592 len = VARSIZE(x) - VARHDRSZ;
593 str = text_to_cstring((text *) x);
594
595 parse_xml_decl((xmlChar *) str, &len, &version, NULL, &standalone);
596
597 if (standalone == 0 && global_standalone == 1)
599 if (standalone < 0)
601
602 if (!version)
604 else if (!global_version)
605 global_version = version;
606 else if (xmlStrcmp(version, global_version) != 0)
608
610 pfree(str);
611 }
612
614 {
615 StringInfoData buf2;
616
617 initStringInfo(&buf2);
618
619 print_xml_decl(&buf2,
621 0,
623
624 appendBinaryStringInfo(&buf2, buf.data, buf.len);
625 buf = buf2;
626 }
627
628 return stringinfo_to_xmltype(&buf);
629#else
631 return NULL;
632#endif
633}
634
635
636/*
637 * XMLAGG support
638 */
639Datum
641{
642 if (PG_ARGISNULL(0))
643 {
644 if (PG_ARGISNULL(1))
646 else
648 }
649 else if (PG_ARGISNULL(1))
651 else
653 PG_GETARG_XML_P(1))));
654}
655
656
657Datum
659{
661
663}
664
665
666Datum
668{
670
671 /* It's actually binary compatible. */
673}
674
675
676text *
678{
679#ifdef USE_LIBXML
680 text *volatile result;
684 volatile xmlBufferPtr buf = NULL;
685 volatile xmlSaveCtxtPtr ctxt = NULL;
687 PgXmlErrorContext *volatile xmlerrcxt = NULL;
688#endif
689
690 if (xmloption_arg != XMLOPTION_DOCUMENT && !indent)
691 {
692 /*
693 * We don't actually need to do anything, so just return the
694 * binary-compatible input. For backwards-compatibility reasons,
695 * allow such cases to succeed even without USE_LIBXML.
696 */
697 return (text *) data;
698 }
699
700#ifdef USE_LIBXML
701
702 /*
703 * Parse the input according to the xmloption.
704 *
705 * preserve_whitespace is set to false in case we are indenting, otherwise
706 * libxml2 will fail to indent elements that have whitespace between them.
707 */
710 (Node *) &escontext);
711 if (doc == NULL || escontext.error_occurred)
712 {
713 if (doc)
715 /* A soft error must be failure to conform to XMLOPTION_DOCUMENT */
718 errmsg("not an XML document")));
719 }
720
721 /* If we weren't asked to indent, we're done. */
722 if (!indent)
723 {
725 return (text *) data;
726 }
727
728 /*
729 * Otherwise, we gotta spin up some error handling. Unlike most other
730 * routines in this module, we already have a libxml "doc" structure to
731 * free, so we need to call pg_xml_init() inside the PG_TRY and be
732 * prepared for it to fail (typically due to palloc OOM).
733 */
734 PG_TRY();
735 {
736 size_t decl_len = 0;
737
739
740 /* The serialized data will go into this buffer. */
742
743 if (buf == NULL || xmlerrcxt->err_occurred)
745 "could not allocate xmlBuffer");
746
747 /* Detect whether there's an XML declaration */
749
750 /*
751 * Emit declaration only if the input had one. Note: some versions of
752 * xmlSaveToBuffer leak memory if a non-null encoding argument is
753 * passed, so don't do that. We don't want any encoding conversion
754 * anyway.
755 */
756 if (decl_len == 0)
757 ctxt = xmlSaveToBuffer(buf, NULL,
759 else
760 ctxt = xmlSaveToBuffer(buf, NULL,
762
763 if (ctxt == NULL || xmlerrcxt->err_occurred)
765 "could not allocate xmlSaveCtxt");
766
768 {
769 /* If it's a document, saving is easy. */
770 if (xmlSaveDoc(ctxt, doc) == -1 || xmlerrcxt->err_occurred)
772 "could not save document to xmlBuffer");
773 }
774 else if (content_nodes != NULL)
775 {
776 /*
777 * Deal with the case where we have non-singly-rooted XML.
778 * libxml's dump functions don't work well for that without help.
779 * We build a fake root node that serves as a container for the
780 * content nodes, and then iterate over the nodes.
781 */
785
786 root = xmlNewNode(NULL, (const xmlChar *) "content-root");
787 if (root == NULL || xmlerrcxt->err_occurred)
789 "could not allocate xml node");
790
791 /*
792 * This attaches root to doc, so we need not free it separately...
793 * but instead, we have to free the old root if there was one.
794 */
796 if (oldroot != NULL)
798
800 xmlerrcxt->err_occurred)
802 "could not append xml node list");
803
804 /*
805 * We use this node to insert newlines in the dump. Note: in at
806 * least some libxml versions, xmlNewDocText would not attach the
807 * node to the document even if we passed it. Therefore, manage
808 * freeing of this node manually, and pass NULL here to make sure
809 * there's not a dangling link.
810 */
811 newline = xmlNewDocText(NULL, (const xmlChar *) "\n");
812 if (newline == NULL || xmlerrcxt->err_occurred)
814 "could not allocate xml node");
815
816 for (xmlNodePtr node = root->children; node; node = node->next)
817 {
818 /* insert newlines between nodes */
819 if (node->type != XML_TEXT_NODE && node->prev != NULL)
820 {
821 if (xmlSaveTree(ctxt, newline) == -1 || xmlerrcxt->err_occurred)
822 {
825 "could not save newline to xmlBuffer");
826 }
827 }
828
829 if (xmlSaveTree(ctxt, node) == -1 || xmlerrcxt->err_occurred)
830 {
833 "could not save content to xmlBuffer");
834 }
835 }
836
838 }
839
840 if (xmlSaveClose(ctxt) == -1 || xmlerrcxt->err_occurred)
841 {
842 ctxt = NULL; /* don't try to close it again */
844 "could not close xmlSaveCtxtPtr");
845 }
846
847 /*
848 * xmlDocContentDumpOutput may add a trailing newline, so remove that.
849 */
851 {
852 const char *str = (const char *) xmlBufferContent(buf);
853 int len = xmlBufferLength(buf);
854
855 while (len > 0 && (str[len - 1] == '\n' ||
856 str[len - 1] == '\r'))
857 len--;
858
860 }
861 else
862 result = (text *) xmlBuffer_to_xmltype(buf);
863 }
864 PG_CATCH();
865 {
866 if (ctxt)
867 xmlSaveClose(ctxt);
868 if (buf)
871
872 if (xmlerrcxt)
873 pg_xml_done(xmlerrcxt, true);
874
875 PG_RE_THROW();
876 }
877 PG_END_TRY();
878
881
882 pg_xml_done(xmlerrcxt, false);
883
884 return result;
885#else
887 return NULL;
888#endif
889}
890
891
892xmltype *
893xmlelement(XmlExpr *xexpr,
894 const Datum *named_argvalue, const bool *named_argnull,
895 const Datum *argvalue, const bool *argnull)
896{
897#ifdef USE_LIBXML
898 xmltype *result;
901 int i;
902 ListCell *arg;
903 ListCell *narg;
905 volatile xmlBufferPtr buf = NULL;
906 volatile xmlTextWriterPtr writer = NULL;
907
908 /*
909 * All arguments are already evaluated, and their values are passed in the
910 * named_argvalue/named_argnull or argvalue/argnull arrays. This avoids
911 * issues if one of the arguments involves a call to some other function
912 * or subsystem that wants to use libxml on its own terms. We examine the
913 * original XmlExpr to identify the numbers and types of the arguments.
914 */
916 i = 0;
917 foreach(arg, xexpr->named_args)
918 {
919 Expr *e = (Expr *) lfirst(arg);
920 char *str;
921
922 if (named_argnull[i])
923 str = NULL;
924 else
925 str = map_sql_value_to_xml_value(named_argvalue[i],
926 exprType((Node *) e),
927 false);
929 i++;
930 }
931
933 i = 0;
934 foreach(arg, xexpr->args)
935 {
936 Expr *e = (Expr *) lfirst(arg);
937 char *str;
938
939 /* here we can just forget NULL elements immediately */
940 if (!argnull[i])
941 {
942 str = map_sql_value_to_xml_value(argvalue[i],
943 exprType((Node *) e),
944 true);
946 }
947 i++;
948 }
949
951
952 PG_TRY();
953 {
955 if (buf == NULL || xmlerrcxt->err_occurred)
957 "could not allocate xmlBuffer");
959 if (writer == NULL || xmlerrcxt->err_occurred)
961 "could not allocate xmlTextWriter");
962
963 if (xmlTextWriterStartElement(writer, (xmlChar *) xexpr->name) < 0 ||
964 xmlerrcxt->err_occurred)
966 "could not start xml element");
967
968 forboth(arg, named_arg_strings, narg, xexpr->arg_names)
969 {
970 char *str = (char *) lfirst(arg);
971 char *argname = strVal(lfirst(narg));
972
973 if (str)
974 {
976 (xmlChar *) argname,
977 (xmlChar *) str) < 0 ||
978 xmlerrcxt->err_occurred)
980 "could not write xml attribute");
981 }
982 }
983
984 foreach(arg, arg_strings)
985 {
986 char *str = (char *) lfirst(arg);
987
988 if (xmlTextWriterWriteRaw(writer, (xmlChar *) str) < 0 ||
989 xmlerrcxt->err_occurred)
991 "could not write raw xml text");
992 }
993
995 xmlerrcxt->err_occurred)
997 "could not end xml element");
998
999 /* we MUST do this now to flush data out to the buffer ... */
1001 writer = NULL;
1002
1003 result = xmlBuffer_to_xmltype(buf);
1004 }
1005 PG_CATCH();
1006 {
1007 if (writer)
1009 if (buf)
1011
1012 pg_xml_done(xmlerrcxt, true);
1013
1014 PG_RE_THROW();
1015 }
1016 PG_END_TRY();
1017
1019
1020 pg_xml_done(xmlerrcxt, false);
1021
1022 return result;
1023#else
1025 return NULL;
1026#endif
1027}
1028
1029
1030xmltype *
1032{
1033#ifdef USE_LIBXML
1034 xmlDocPtr doc;
1035
1038 xmlFreeDoc(doc);
1039
1040 return (xmltype *) data;
1041#else
1043 return NULL;
1044#endif
1045}
1046
1047
1048xmltype *
1049xmlpi(const char *target, text *arg, bool arg_is_null, bool *result_is_null)
1050{
1051#ifdef USE_LIBXML
1052 xmltype *result;
1054
1055 if (pg_strcasecmp(target, "xml") == 0)
1056 ereport(ERROR,
1058 errmsg("invalid XML processing instruction"),
1059 errdetail("XML processing instruction target name cannot be \"%s\".", target)));
1060
1061 /*
1062 * Following the SQL standard, the null check comes after the syntax check
1063 * above.
1064 */
1066 if (*result_is_null)
1067 return NULL;
1068
1070
1071 appendStringInfo(&buf, "<?%s", target);
1072
1073 if (arg != NULL)
1074 {
1075 char *string;
1076
1077 string = text_to_cstring(arg);
1078 if (strstr(string, "?>") != NULL)
1079 ereport(ERROR,
1081 errmsg("invalid XML processing instruction"),
1082 errdetail("XML processing instruction cannot contain \"?>\".")));
1083
1085 appendStringInfoString(&buf, string + strspn(string, " "));
1086 pfree(string);
1087 }
1089
1090 result = stringinfo_to_xmltype(&buf);
1091 pfree(buf.data);
1092 return result;
1093#else
1095 return NULL;
1096#endif
1097}
1098
1099
1100xmltype *
1101xmlroot(xmltype *data, text *version, int standalone)
1102{
1103#ifdef USE_LIBXML
1104 char *str;
1105 size_t len;
1107 int orig_standalone;
1109
1110 len = VARSIZE(data) - VARHDRSZ;
1112
1114
1115 if (version)
1116 orig_version = xml_text2xmlChar(version);
1117 else
1119
1120 switch (standalone)
1121 {
1122 case XML_STANDALONE_YES:
1123 orig_standalone = 1;
1124 break;
1125 case XML_STANDALONE_NO:
1126 orig_standalone = 0;
1127 break;
1129 orig_standalone = -1;
1130 break;
1132 /* leave original value */
1133 break;
1134 }
1135
1139
1140 return stringinfo_to_xmltype(&buf);
1141#else
1143 return NULL;
1144#endif
1145}
1146
1147
1148/*
1149 * Validate document (given as string) against DTD (given as external link)
1150 *
1151 * This has been removed because it is a security hole: unprivileged users
1152 * should not be able to use Postgres to fetch arbitrary external files,
1153 * which unfortunately is exactly what libxml is willing to do with the DTD
1154 * parameter.
1155 */
1156Datum
1158{
1159 ereport(ERROR,
1161 errmsg("xmlvalidate is not implemented")));
1162 return 0;
1163}
1164
1165
1166bool
1168{
1169#ifdef USE_LIBXML
1170 xmlDocPtr doc;
1172
1173 /*
1174 * We'll report "true" if no soft error is reported by xml_parse().
1175 */
1177 GetDatabaseEncoding(), NULL, NULL, (Node *) &escontext);
1178 if (doc)
1179 xmlFreeDoc(doc);
1180
1181 return !escontext.error_occurred;
1182#else /* not USE_LIBXML */
1184 return false;
1185#endif /* not USE_LIBXML */
1186}
1187
1188
1189#ifdef USE_LIBXML
1190
1191/*
1192 * pg_xml_init_library --- set up for use of libxml
1193 *
1194 * This should be called by each function that is about to use libxml
1195 * facilities but doesn't require error handling. It initializes libxml
1196 * and verifies compatibility with the loaded libxml version. These are
1197 * once-per-session activities.
1198 *
1199 * TODO: xmlChar is utf8-char, make proper tuning (initdb with enc!=utf8 and
1200 * check)
1201 */
1202void
1204{
1205 static bool first_time = true;
1206
1207 if (first_time)
1208 {
1209 /* Stuff we need do only once per session */
1210
1211 /*
1212 * Currently, we have no pure UTF-8 support for internals -- check if
1213 * we can work.
1214 */
1215 if (sizeof(char) != sizeof(xmlChar))
1216 ereport(ERROR,
1217 (errmsg("could not initialize XML library"),
1218 errdetail("libxml2 has incompatible char type: sizeof(char)=%zu, sizeof(xmlChar)=%zu.",
1219 sizeof(char), sizeof(xmlChar))));
1220
1221#ifdef USE_LIBXMLCONTEXT
1222 /* Set up libxml's memory allocation our way */
1224#endif
1225
1226 /* Check library compatibility */
1228
1229 first_time = false;
1230 }
1231}
1232
1233/*
1234 * pg_xml_init --- set up for use of libxml and register an error handler
1235 *
1236 * This should be called by each function that is about to use libxml
1237 * facilities and requires error handling. It initializes libxml with
1238 * pg_xml_init_library() and establishes our libxml error handler.
1239 *
1240 * strictness determines which errors are reported and which are ignored.
1241 *
1242 * Calls to this function MUST be followed by a PG_TRY block that guarantees
1243 * that pg_xml_done() is called during either normal or error exit.
1244 *
1245 * This is exported for use by contrib/xml2, as well as other code that might
1246 * wish to share use of this module's libxml error handler.
1247 */
1250{
1252 void *new_errcxt;
1253
1254 /* Do one-time setup if needed */
1256
1257 /* Create error handling context structure */
1259 errcxt->magic = ERRCXT_MAGIC;
1260 errcxt->strictness = strictness;
1261 errcxt->err_occurred = false;
1262 initStringInfo(&errcxt->err_buf);
1263
1264 /*
1265 * Save original error handler and install ours. libxml originally didn't
1266 * distinguish between the contexts for generic and for structured error
1267 * handlers. If we're using an old libxml version, we must thus save the
1268 * generic error context, even though we're using a structured error
1269 * handler.
1270 */
1271 errcxt->saved_errfunc = xmlStructuredError;
1272
1273#ifdef HAVE_XMLSTRUCTUREDERRORCONTEXT
1274 errcxt->saved_errcxt = xmlStructuredErrorContext;
1275#else
1276 errcxt->saved_errcxt = xmlGenericErrorContext;
1277#endif
1278
1280
1281 /*
1282 * Verify that xmlSetStructuredErrorFunc set the context variable we
1283 * expected it to. If not, the error context pointer we just saved is not
1284 * the correct thing to restore, and since that leaves us without a way to
1285 * restore the context in pg_xml_done, we must fail.
1286 *
1287 * The only known situation in which this test fails is if we compile with
1288 * headers from a libxml2 that doesn't track the structured error context
1289 * separately (< 2.7.4), but at runtime use a version that does, or vice
1290 * versa. The libxml2 authors did not treat that change as constituting
1291 * an ABI break, so the LIBXML_TEST_VERSION test in pg_xml_init_library
1292 * fails to protect us from this.
1293 */
1294
1295#ifdef HAVE_XMLSTRUCTUREDERRORCONTEXT
1297#else
1299#endif
1300
1301 if (new_errcxt != errcxt)
1302 ereport(ERROR,
1304 errmsg("could not set up XML error handler"),
1305 errhint("This probably indicates that the version of libxml2"
1306 " being used is not compatible with the libxml2"
1307 " header files that PostgreSQL was built with.")));
1308
1309 /*
1310 * Also, install an entity loader to prevent unwanted fetches of external
1311 * files and URLs.
1312 */
1313 errcxt->saved_entityfunc = xmlGetExternalEntityLoader();
1315
1316 return errcxt;
1317}
1318
1319
1320/*
1321 * pg_xml_done --- restore previous libxml error handling
1322 *
1323 * Resets libxml's global error-handling state to what it was before
1324 * pg_xml_init() was called.
1325 *
1326 * This routine verifies that all pending errors have been dealt with
1327 * (in assert-enabled builds, anyway).
1328 */
1329void
1331{
1332 void *cur_errcxt;
1333
1334 /* An assert seems like enough protection here */
1335 Assert(errcxt->magic == ERRCXT_MAGIC);
1336
1337 /*
1338 * In a normal exit, there should be no un-handled libxml errors. But we
1339 * shouldn't try to enforce this during error recovery, since the longjmp
1340 * could have been thrown before xml_ereport had a chance to run.
1341 */
1342 Assert(!errcxt->err_occurred || isError);
1343
1344 /*
1345 * Check that libxml's global state is correct, warn if not. This is a
1346 * real test and not an Assert because it has a higher probability of
1347 * happening.
1348 */
1349#ifdef HAVE_XMLSTRUCTUREDERRORCONTEXT
1351#else
1353#endif
1354
1355 if (cur_errcxt != errcxt)
1356 elog(WARNING, "libxml error handling state is out of sync with xml.c");
1357
1358 /* Restore the saved handlers */
1359 xmlSetStructuredErrorFunc(errcxt->saved_errcxt, errcxt->saved_errfunc);
1360 xmlSetExternalEntityLoader(errcxt->saved_entityfunc);
1361
1362 /*
1363 * Mark the struct as invalid, just in case somebody somehow manages to
1364 * call xml_errorHandler or xml_ereport with it.
1365 */
1366 errcxt->magic = 0;
1367
1368 /* Release memory */
1369 pfree(errcxt->err_buf.data);
1370 pfree(errcxt);
1371}
1372
1373
1374/*
1375 * pg_xml_error_occurred() --- test the error flag
1376 */
1377bool
1379{
1380 return errcxt->err_occurred;
1381}
1382
1383
1384/*
1385 * SQL/XML allows storing "XML documents" or "XML content". "XML
1386 * documents" are specified by the XML specification and are parsed
1387 * easily by libxml. "XML content" is specified by SQL/XML as the
1388 * production "XMLDecl? content". But libxml can only parse the
1389 * "content" part, so we have to parse the XML declaration ourselves
1390 * to complete this.
1391 */
1392
1393#define CHECK_XML_SPACE(p) \
1394 do { \
1395 if (!xmlIsBlank_ch(*(p))) \
1396 return XML_ERR_SPACE_REQUIRED; \
1397 } while (0)
1398
1399#define SKIP_XML_SPACE(p) \
1400 while (xmlIsBlank_ch(*(p))) (p)++
1401
1402/* Letter | Digit | '.' | '-' | '_' | ':' | CombiningChar | Extender */
1403/* Beware of multiple evaluations of argument! */
1404#define PG_XMLISNAMECHAR(c) \
1405 (xmlIsBaseChar_ch(c) || xmlIsIdeographicQ(c) \
1406 || xmlIsDigit_ch(c) \
1407 || c == '.' || c == '-' || c == '_' || c == ':' \
1408 || xmlIsCombiningQ(c) \
1409 || xmlIsExtender_ch(c))
1410
1411/* pnstrdup, but deal with xmlChar not char; len is measured in xmlChars */
1412static xmlChar *
1413xml_pnstrdup(const xmlChar *str, size_t len)
1414{
1415 xmlChar *result;
1416
1417 result = (xmlChar *) palloc((len + 1) * sizeof(xmlChar));
1418 memcpy(result, str, len * sizeof(xmlChar));
1419 result[len] = 0;
1420 return result;
1421}
1422
1423/* Ditto, except input is char* */
1424static xmlChar *
1425pg_xmlCharStrndup(const char *str, size_t len)
1426{
1427 xmlChar *result;
1428
1429 result = (xmlChar *) palloc((len + 1) * sizeof(xmlChar));
1430 memcpy(result, str, len);
1431 result[len] = '\0';
1432
1433 return result;
1434}
1435
1436/*
1437 * Copy xmlChar string to PostgreSQL-owned memory, freeing the input.
1438 *
1439 * The input xmlChar is freed regardless of success of the copy.
1440 */
1441static char *
1443{
1444 char *result;
1445
1446 if (str)
1447 {
1448 PG_TRY();
1449 {
1450 result = pstrdup((char *) str);
1451 }
1452 PG_FINALLY();
1453 {
1454 xmlFree(str);
1455 }
1456 PG_END_TRY();
1457 }
1458 else
1459 result = NULL;
1460
1461 return result;
1462}
1463
1464/*
1465 * str is the null-terminated input string. Remaining arguments are
1466 * output arguments; each can be NULL if value is not wanted.
1467 * version and encoding are returned as locally-palloc'd strings.
1468 * Result is 0 if OK, an error code if not.
1469 */
1470static int
1471parse_xml_decl(const xmlChar *str, size_t *lenp,
1472 xmlChar **version, xmlChar **encoding, int *standalone)
1473{
1474 const xmlChar *p;
1475 const xmlChar *save_p;
1476 size_t len;
1477 int utf8char;
1478 int utf8len;
1479
1480 /*
1481 * Only initialize libxml. We don't need error handling here, but we do
1482 * need to make sure libxml is initialized before calling any of its
1483 * functions. Note that this is safe (and a no-op) if caller has already
1484 * done pg_xml_init().
1485 */
1487
1488 /* Initialize output arguments to "not present" */
1489 if (version)
1490 *version = NULL;
1491 if (encoding)
1492 *encoding = NULL;
1493 if (standalone)
1494 *standalone = -1;
1495
1496 p = str;
1497
1498 if (xmlStrncmp(p, (xmlChar *) "<?xml", 5) != 0)
1499 goto finished;
1500
1501 /*
1502 * If next char is a name char, it's a PI like <?xml-stylesheet ...?>
1503 * rather than an XMLDecl, so we have done what we came to do and found no
1504 * XMLDecl.
1505 *
1506 * We need an input length value for xmlGetUTF8Char, but there's no need
1507 * to count the whole document size, so use strnlen not strlen.
1508 */
1509 utf8len = strnlen((const char *) (p + 5), MAX_MULTIBYTE_CHAR_LEN);
1510 utf8char = xmlGetUTF8Char(p + 5, &utf8len);
1512 goto finished;
1513
1514 p += 5;
1515
1516 /* version */
1517 CHECK_XML_SPACE(p);
1518 SKIP_XML_SPACE(p);
1519 if (xmlStrncmp(p, (xmlChar *) "version", 7) != 0)
1521 p += 7;
1522 SKIP_XML_SPACE(p);
1523 if (*p != '=')
1525 p += 1;
1526 SKIP_XML_SPACE(p);
1527
1528 if (*p == '\'' || *p == '"')
1529 {
1530 const xmlChar *q;
1531
1532 q = xmlStrchr(p + 1, *p);
1533 if (!q)
1535
1536 if (version)
1537 *version = xml_pnstrdup(p + 1, q - p - 1);
1538 p = q + 1;
1539 }
1540 else
1542
1543 /* encoding */
1544 save_p = p;
1545 SKIP_XML_SPACE(p);
1546 if (xmlStrncmp(p, (xmlChar *) "encoding", 8) == 0)
1547 {
1549 p += 8;
1550 SKIP_XML_SPACE(p);
1551 if (*p != '=')
1553 p += 1;
1554 SKIP_XML_SPACE(p);
1555
1556 if (*p == '\'' || *p == '"')
1557 {
1558 const xmlChar *q;
1559
1560 q = xmlStrchr(p + 1, *p);
1561 if (!q)
1563
1564 if (encoding)
1565 *encoding = xml_pnstrdup(p + 1, q - p - 1);
1566 p = q + 1;
1567 }
1568 else
1570 }
1571 else
1572 {
1573 p = save_p;
1574 }
1575
1576 /* standalone */
1577 save_p = p;
1578 SKIP_XML_SPACE(p);
1579 if (xmlStrncmp(p, (xmlChar *) "standalone", 10) == 0)
1580 {
1582 p += 10;
1583 SKIP_XML_SPACE(p);
1584 if (*p != '=')
1586 p += 1;
1587 SKIP_XML_SPACE(p);
1588 if (xmlStrncmp(p, (xmlChar *) "'yes'", 5) == 0 ||
1589 xmlStrncmp(p, (xmlChar *) "\"yes\"", 5) == 0)
1590 {
1591 if (standalone)
1592 *standalone = 1;
1593 p += 5;
1594 }
1595 else if (xmlStrncmp(p, (xmlChar *) "'no'", 4) == 0 ||
1596 xmlStrncmp(p, (xmlChar *) "\"no\"", 4) == 0)
1597 {
1598 if (standalone)
1599 *standalone = 0;
1600 p += 4;
1601 }
1602 else
1604 }
1605 else
1606 {
1607 p = save_p;
1608 }
1609
1610 SKIP_XML_SPACE(p);
1611 if (xmlStrncmp(p, (xmlChar *) "?>", 2) != 0)
1613 p += 2;
1614
1615finished:
1616 len = p - str;
1617
1618 for (p = str; p < str + len; p++)
1619 if (*p > 127)
1620 return XML_ERR_INVALID_CHAR;
1621
1622 if (lenp)
1623 *lenp = len;
1624
1625 return XML_ERR_OK;
1626}
1627
1628
1629/*
1630 * Write an XML declaration. On output, we adjust the XML declaration
1631 * as follows. (These rules are the moral equivalent of the clause
1632 * "Serialization of an XML value" in the SQL standard.)
1633 *
1634 * We try to avoid generating an XML declaration if possible. This is
1635 * so that you don't get trivial things like xml '<foo/>' resulting in
1636 * '<?xml version="1.0"?><foo/>', which would surely be annoying. We
1637 * must provide a declaration if the standalone property is specified
1638 * or if we include an encoding declaration. If we have a
1639 * declaration, we must specify a version (XML requires this).
1640 * Otherwise we only make a declaration if the version is not "1.0",
1641 * which is the default version specified in SQL:2003.
1642 */
1643static bool
1644print_xml_decl(StringInfo buf, const xmlChar *version,
1646{
1647 if ((version && strcmp((const char *) version, PG_XML_DEFAULT_VERSION) != 0)
1648 || (encoding && encoding != PG_UTF8)
1649 || standalone != -1)
1650 {
1651 appendStringInfoString(buf, "<?xml");
1652
1653 if (version)
1654 appendStringInfo(buf, " version=\"%s\"", version);
1655 else
1656 appendStringInfo(buf, " version=\"%s\"", PG_XML_DEFAULT_VERSION);
1657
1658 if (encoding && encoding != PG_UTF8)
1659 {
1660 /*
1661 * XXX might be useful to convert this to IANA names (ISO-8859-1
1662 * instead of LATIN1 etc.); needs field experience
1663 */
1664 appendStringInfo(buf, " encoding=\"%s\"",
1666 }
1667
1668 if (standalone == 1)
1669 appendStringInfoString(buf, " standalone=\"yes\"");
1670 else if (standalone == 0)
1671 appendStringInfoString(buf, " standalone=\"no\"");
1673
1674 return true;
1675 }
1676 else
1677 return false;
1678}
1679
1680/*
1681 * Test whether an input that is to be parsed as CONTENT contains a DTD.
1682 *
1683 * The SQL/XML:2003 definition of CONTENT ("XMLDecl? content") is not
1684 * satisfied by a document with a DTD, which is a bit of a wart, as it means
1685 * the CONTENT type is not a proper superset of DOCUMENT. SQL/XML:2006 and
1686 * later fix that, by redefining content with reference to the "more
1687 * permissive" Document Node of the XQuery/XPath Data Model, such that any
1688 * DOCUMENT value is indeed also a CONTENT value. That definition is more
1689 * useful, as CONTENT becomes usable for parsing input of unknown form (think
1690 * pg_restore).
1691 *
1692 * As used below in parse_xml when parsing for CONTENT, libxml does not give
1693 * us the 2006+ behavior, but only the 2003; it will choke if the input has
1694 * a DTD. But we can provide the 2006+ definition of CONTENT easily enough,
1695 * by detecting this case first and simply doing the parse as DOCUMENT.
1696 *
1697 * A DTD can be found arbitrarily far in, but that would be a contrived case;
1698 * it will ordinarily start within a few dozen characters. The only things
1699 * that can precede it are an XMLDecl (here, the caller will have called
1700 * parse_xml_decl already), whitespace, comments, and processing instructions.
1701 * This function need only return true if it sees a valid sequence of such
1702 * things leading to <!DOCTYPE. It can simply return false in any other
1703 * cases, including malformed input; that will mean the input gets parsed as
1704 * CONTENT as originally planned, with libxml reporting any errors.
1705 *
1706 * This is only to be called from xml_parse, when pg_xml_init has already
1707 * been called. The input is already in UTF8 encoding.
1708 */
1709static bool
1711{
1712 const xmlChar *p = str;
1713
1714 for (;;)
1715 {
1716 const xmlChar *e;
1717
1718 SKIP_XML_SPACE(p);
1719 if (*p != '<')
1720 return false;
1721 p++;
1722
1723 if (*p == '!')
1724 {
1725 p++;
1726
1727 /* if we see <!DOCTYPE, we can return true */
1728 if (xmlStrncmp(p, (xmlChar *) "DOCTYPE", 7) == 0)
1729 return true;
1730
1731 /* otherwise, if it's not a comment, fail */
1732 if (xmlStrncmp(p, (xmlChar *) "--", 2) != 0)
1733 return false;
1734 /* find end of comment: find -- and a > must follow */
1735 p = xmlStrstr(p + 2, (xmlChar *) "--");
1736 if (!p || p[2] != '>')
1737 return false;
1738 /* advance over comment, and keep scanning */
1739 p += 3;
1740 continue;
1741 }
1742
1743 /* otherwise, if it's not a PI <?target something?>, fail */
1744 if (*p != '?')
1745 return false;
1746 p++;
1747
1748 /* find end of PI (the string ?> is forbidden within a PI) */
1749 e = xmlStrstr(p, (xmlChar *) "?>");
1750 if (!e)
1751 return false;
1752
1753 /* advance over PI, keep scanning */
1754 p = e + 2;
1755 }
1756}
1757
1758
1759/*
1760 * Convert a text object to XML internal representation
1761 *
1762 * data is the source data (must not be toasted!), encoding is its encoding,
1763 * and xmloption_arg and preserve_whitespace are options for the
1764 * transformation.
1765 *
1766 * If parsed_xmloptiontype isn't NULL, *parsed_xmloptiontype is set to the
1767 * XmlOptionType actually used to parse the input (typically the same as
1768 * xmloption_arg, but a DOCTYPE node in the input can force DOCUMENT mode).
1769 *
1770 * If parsed_nodes isn't NULL and we parse in CONTENT mode, the list
1771 * of parsed nodes from the xmlParseBalancedChunkMemory call will be returned
1772 * to *parsed_nodes. (It is caller's responsibility to free that.)
1773 *
1774 * Errors normally result in ereport(ERROR), but if escontext is an
1775 * ErrorSaveContext, then "safe" errors are reported there instead, and the
1776 * caller must check SOFT_ERROR_OCCURRED() to see whether that happened.
1777 *
1778 * Note: it is caller's responsibility to xmlFreeDoc() the result,
1779 * else a permanent memory leak will ensue! But note the result could
1780 * be NULL after a soft error.
1781 *
1782 * TODO maybe libxml2's xmlreader is better? (do not construct DOM,
1783 * yet do not use SAX - see xmlreader.c)
1784 */
1785static xmlDocPtr
1787 bool preserve_whitespace, int encoding,
1789 Node *escontext)
1790{
1791 int32 len;
1792 xmlChar *string;
1795 volatile xmlParserCtxtPtr ctxt = NULL;
1796 volatile xmlDocPtr doc = NULL;
1797 volatile int save_keep_blanks = -1;
1798
1799 /*
1800 * This step looks annoyingly redundant, but we must do it to have a
1801 * null-terminated string in case encoding conversion isn't required.
1802 */
1803 len = VARSIZE_ANY_EXHDR(data); /* will be useful later */
1804 string = xml_text2xmlChar(data);
1805
1806 /*
1807 * If the data isn't UTF8, we must translate before giving it to libxml.
1808 *
1809 * XXX ideally, we'd catch any encoding conversion failure and return a
1810 * soft error. However, failure to convert to UTF8 should be pretty darn
1811 * rare, so for now this is left undone.
1812 */
1814 len,
1815 encoding,
1816 PG_UTF8);
1817
1818 /* Start up libxml and its parser */
1820
1821 /* Use a TRY block to ensure we clean up correctly */
1822 PG_TRY();
1823 {
1824 bool parse_as_document = false;
1825 int res_code;
1826 size_t count = 0;
1827 xmlChar *version = NULL;
1828 int standalone = 0;
1829
1830 /* Any errors here are reported as hard ereport's */
1831 xmlInitParser();
1832
1833 /* Decide whether to parse as document or content */
1835 parse_as_document = true;
1836 else
1837 {
1838 /* Parse and skip over the XML declaration, if any */
1840 &count, &version, NULL, &standalone);
1841 if (res_code != 0)
1842 {
1843 errsave(escontext,
1845 errmsg_internal("invalid XML content: invalid XML declaration"),
1847 goto fail;
1848 }
1849
1850 /* Is there a DOCTYPE element? */
1852 parse_as_document = true;
1853 }
1854
1855 /* initialize output parameters */
1859 if (parsed_nodes != NULL)
1860 *parsed_nodes = NULL;
1861
1863 {
1864 int options;
1865
1866 /* set up parser context used by xmlCtxtReadDoc */
1867 ctxt = xmlNewParserCtxt();
1868 if (ctxt == NULL || xmlerrcxt->err_occurred)
1870 "could not allocate parser context");
1871
1872 /*
1873 * Select parse options.
1874 *
1875 * Note that here we try to apply DTD defaults (XML_PARSE_DTDATTR)
1876 * according to SQL/XML:2008 GR 10.16.7.d: 'Default values defined
1877 * by internal DTD are applied'. As for external DTDs, we try to
1878 * support them too (see SQL/XML:2008 GR 10.16.7.e), but that
1879 * doesn't really happen because xmlPgEntityLoader prevents it.
1880 */
1883
1885 NULL, /* no URL */
1886 "UTF-8",
1887 options);
1888
1889 if (doc == NULL || xmlerrcxt->err_occurred)
1890 {
1891 /* Use original option to decide which error code to report */
1893 xml_errsave(escontext, xmlerrcxt,
1895 "invalid XML document");
1896 else
1897 xml_errsave(escontext, xmlerrcxt,
1899 "invalid XML content");
1900 goto fail;
1901 }
1902 }
1903 else
1904 {
1905 /* set up document that xmlParseBalancedChunkMemory will add to */
1906 doc = xmlNewDoc(version);
1907 if (doc == NULL || xmlerrcxt->err_occurred)
1909 "could not allocate XML document");
1910
1911 Assert(doc->encoding == NULL);
1912 doc->encoding = xmlStrdup((const xmlChar *) "UTF-8");
1913 if (doc->encoding == NULL || xmlerrcxt->err_occurred)
1915 "could not allocate XML document");
1916 doc->standalone = standalone;
1917
1918 /* set parse options --- have to do this the ugly way */
1920
1921 /* allow empty content */
1922 if (*(utf8string + count))
1923 {
1925 utf8string + count,
1926 parsed_nodes);
1927 if (res_code != 0 || xmlerrcxt->err_occurred)
1928 {
1929 xml_errsave(escontext, xmlerrcxt,
1931 "invalid XML content");
1932 goto fail;
1933 }
1934 }
1935 }
1936
1937fail:
1938 ;
1939 }
1940 PG_CATCH();
1941 {
1942 if (save_keep_blanks != -1)
1944 if (doc != NULL)
1945 xmlFreeDoc(doc);
1946 if (ctxt != NULL)
1947 xmlFreeParserCtxt(ctxt);
1948
1949 pg_xml_done(xmlerrcxt, true);
1950
1951 PG_RE_THROW();
1952 }
1953 PG_END_TRY();
1954
1955 if (save_keep_blanks != -1)
1957
1958 if (ctxt != NULL)
1959 xmlFreeParserCtxt(ctxt);
1960
1961 pg_xml_done(xmlerrcxt, false);
1962
1963 return doc;
1964}
1965
1966
1967/*
1968 * xmlChar<->text conversions
1969 */
1970static xmlChar *
1972{
1973 return (xmlChar *) text_to_cstring(in);
1974}
1975
1976
1977#ifdef USE_LIBXMLCONTEXT
1978
1979/*
1980 * Manage the special context used for all libxml allocations (but only
1981 * in special debug builds; see notes at top of file)
1982 */
1983static void
1984xml_memory_init(void)
1985{
1986 /* Create memory context if not there already */
1987 if (LibxmlContext == NULL)
1989 "Libxml context",
1991
1992 /* Re-establish the callbacks even if already set */
1994}
1995
1996/*
1997 * Wrappers for memory management functions
1998 */
1999static void *
2000xml_palloc(size_t size)
2001{
2002 return MemoryContextAlloc(LibxmlContext, size);
2003}
2004
2005
2006static void *
2007xml_repalloc(void *ptr, size_t size)
2008{
2009 return repalloc(ptr, size);
2010}
2011
2012
2013static void
2014xml_pfree(void *ptr)
2015{
2016 /* At least some parts of libxml assume xmlFree(NULL) is allowed */
2017 if (ptr)
2018 pfree(ptr);
2019}
2020
2021
2022static char *
2023xml_pstrdup(const char *string)
2024{
2025 return MemoryContextStrdup(LibxmlContext, string);
2026}
2027#endif /* USE_LIBXMLCONTEXT */
2028
2029
2030/*
2031 * xmlPgEntityLoader --- entity loader callback function
2032 *
2033 * Silently prevent any external entity URL from being loaded. We don't want
2034 * to throw an error, so instead make the entity appear to expand to an empty
2035 * string.
2036 *
2037 * We would prefer to allow loading entities that exist in the system's
2038 * global XML catalog; but the available libxml2 APIs make that a complex
2039 * and fragile task. For now, just shut down all external access.
2040 */
2041static xmlParserInputPtr
2042xmlPgEntityLoader(const char *URL, const char *ID,
2043 xmlParserCtxtPtr ctxt)
2044{
2045 return xmlNewStringInputStream(ctxt, (const xmlChar *) "");
2046}
2047
2048
2049/*
2050 * xml_ereport --- report an XML-related error
2051 *
2052 * The "msg" is the SQL-level message; some can be adopted from the SQL/XML
2053 * standard. This function adds libxml's native error message, if any, as
2054 * detail.
2055 *
2056 * This is exported for modules that want to share the core libxml error
2057 * handler. Note that pg_xml_init() *must* have been called previously.
2058 */
2059void
2060xml_ereport(PgXmlErrorContext *errcxt, int level, int sqlcode, const char *msg)
2061{
2062 char *detail;
2063
2064 /* Defend against someone passing us a bogus context struct */
2065 if (errcxt->magic != ERRCXT_MAGIC)
2066 elog(ERROR, "xml_ereport called with invalid PgXmlErrorContext");
2067
2068 /* Flag that the current libxml error has been reported */
2069 errcxt->err_occurred = false;
2070
2071 /* Include detail only if we have some text from libxml */
2072 if (errcxt->err_buf.len > 0)
2073 detail = errcxt->err_buf.data;
2074 else
2075 detail = NULL;
2076
2077 ereport(level,
2078 (errcode(sqlcode),
2079 errmsg_internal("%s", msg),
2080 detail ? errdetail_internal("%s", detail) : 0));
2081}
2082
2083
2084/*
2085 * xml_errsave --- save an XML-related error
2086 *
2087 * If escontext is an ErrorSaveContext, error details are saved into it,
2088 * and control returns normally.
2089 *
2090 * Otherwise, the error is thrown, so that this is equivalent to
2091 * xml_ereport() with level == ERROR.
2092 *
2093 * This should be used only for errors that we're sure we do not need
2094 * a transaction abort to clean up after.
2095 */
2096static void
2098 int sqlcode, const char *msg)
2099{
2100 char *detail;
2101
2102 /* Defend against someone passing us a bogus context struct */
2103 if (errcxt->magic != ERRCXT_MAGIC)
2104 elog(ERROR, "xml_errsave called with invalid PgXmlErrorContext");
2105
2106 /* Flag that the current libxml error has been reported */
2107 errcxt->err_occurred = false;
2108
2109 /* Include detail only if we have some text from libxml */
2110 if (errcxt->err_buf.len > 0)
2111 detail = errcxt->err_buf.data;
2112 else
2113 detail = NULL;
2114
2115 errsave(escontext,
2116 (errcode(sqlcode),
2117 errmsg_internal("%s", msg),
2118 detail ? errdetail_internal("%s", detail) : 0));
2119}
2120
2121
2122/*
2123 * Error handler for libxml errors and warnings
2124 */
2125static void
2127{
2130 xmlParserInputPtr input = (ctxt != NULL) ? ctxt->input : NULL;
2131 xmlNodePtr node = error->node;
2132 const xmlChar *name = (node != NULL &&
2133 node->type == XML_ELEMENT_NODE) ? node->name : NULL;
2134 int domain = error->domain;
2135 int level = error->level;
2137
2138 /*
2139 * Defend against someone passing us a bogus context struct.
2140 *
2141 * We force a backend exit if this check fails because longjmp'ing out of
2142 * libxml would likely render it unsafe to use further.
2143 */
2144 if (xmlerrcxt->magic != ERRCXT_MAGIC)
2145 elog(FATAL, "xml_errorHandler called with invalid PgXmlErrorContext");
2146
2147 /*----------
2148 * Older libxml versions report some errors differently.
2149 * First, some errors were previously reported as coming from the parser
2150 * domain but are now reported as coming from the namespace domain.
2151 * Second, some warnings were upgraded to errors.
2152 * We attempt to compensate for that here.
2153 *----------
2154 */
2155 switch (error->code)
2156 {
2157 case XML_WAR_NS_URI:
2158 level = XML_ERR_ERROR;
2159 domain = XML_FROM_NAMESPACE;
2160 break;
2161
2164 case XML_WAR_NS_COLUMN:
2167 case XML_NS_ERR_QNAME:
2169 case XML_NS_ERR_EMPTY:
2170 domain = XML_FROM_NAMESPACE;
2171 break;
2172 }
2173
2174 /* Decide whether to act on the error or not */
2175 switch (domain)
2176 {
2177 case XML_FROM_PARSER:
2178
2179 /*
2180 * XML_ERR_NOT_WELL_BALANCED is typically reported after some
2181 * other, more on-point error. Furthermore, libxml2 2.13 reports
2182 * it under a completely different set of rules than prior
2183 * versions. To avoid cross-version behavioral differences,
2184 * suppress it so long as we already logged some error.
2185 */
2186 if (error->code == XML_ERR_NOT_WELL_BALANCED &&
2187 xmlerrcxt->err_occurred)
2188 return;
2190
2191 case XML_FROM_NONE:
2192 case XML_FROM_MEMORY:
2193 case XML_FROM_IO:
2194
2195 /*
2196 * Suppress warnings about undeclared entities. We need to do
2197 * this to avoid problems due to not loading DTD definitions.
2198 */
2199 if (error->code == XML_WAR_UNDECLARED_ENTITY)
2200 return;
2201
2202 /* Otherwise, accept error regardless of the parsing purpose */
2203 break;
2204
2205 default:
2206 /* Ignore error if only doing well-formedness check */
2207 if (xmlerrcxt->strictness == PG_XML_STRICTNESS_WELLFORMED)
2208 return;
2209 break;
2210 }
2211
2212 /* Prepare error message in errorBuf */
2214
2215 if (error->line > 0)
2216 appendStringInfo(&errorBuf, "line %d: ", error->line);
2217 if (name != NULL)
2218 appendStringInfo(&errorBuf, "element %s: ", name);
2219 if (error->message != NULL)
2221 else
2222 appendStringInfoString(&errorBuf, "(no message provided)");
2223
2224 /*
2225 * Append context information to errorBuf.
2226 *
2227 * xmlParserPrintFileContext() uses libxml's "generic" error handler to
2228 * write the context. Since we don't want to duplicate libxml
2229 * functionality here, we set up a generic error handler temporarily.
2230 *
2231 * We use appendStringInfo() directly as libxml's generic error handler.
2232 * This should work because it has essentially the same signature as
2233 * libxml expects, namely (void *ptr, const char *msg, ...).
2234 */
2235 if (input != NULL)
2236 {
2239
2242
2243 /* Add context information to errorBuf */
2245
2247
2248 /* Restore generic error func */
2250 }
2251
2252 /* Get rid of any trailing newlines in errorBuf */
2254
2255 /*
2256 * Legacy error handling mode. err_occurred is never set, we just add the
2257 * message to err_buf. This mode exists because the xml2 contrib module
2258 * uses our error-handling infrastructure, but we don't want to change its
2259 * behaviour since it's deprecated anyway. This is also why we don't
2260 * distinguish between notices, warnings and errors here --- the old-style
2261 * generic error handler wouldn't have done that either.
2262 */
2263 if (xmlerrcxt->strictness == PG_XML_STRICTNESS_LEGACY)
2264 {
2267 errorBuf.len);
2268
2269 pfree(errorBuf.data);
2270 return;
2271 }
2272
2273 /*
2274 * We don't want to ereport() here because that'd probably leave libxml in
2275 * an inconsistent state. Instead, we remember the error and ereport()
2276 * from xml_ereport().
2277 *
2278 * Warnings and notices can be reported immediately since they won't cause
2279 * a longjmp() out of libxml.
2280 */
2281 if (level >= XML_ERR_ERROR)
2282 {
2285 errorBuf.len);
2286
2287 xmlerrcxt->err_occurred = true;
2288 }
2289 else if (level >= XML_ERR_WARNING)
2290 {
2292 (errmsg_internal("%s", errorBuf.data)));
2293 }
2294 else
2295 {
2297 (errmsg_internal("%s", errorBuf.data)));
2298 }
2299
2300 pfree(errorBuf.data);
2301}
2302
2303
2304/*
2305 * Convert libxml error codes into textual errdetail messages.
2306 *
2307 * This should be called within an ereport or errsave invocation,
2308 * just as errdetail would be.
2309 *
2310 * At the moment, we only need to cover those codes that we
2311 * may raise in this file.
2312 */
2313static int
2314errdetail_for_xml_code(int code)
2315{
2316 const char *det;
2317
2318 switch (code)
2319 {
2321 det = gettext_noop("Invalid character value.");
2322 break;
2324 det = gettext_noop("Space required.");
2325 break;
2327 det = gettext_noop("standalone accepts only 'yes' or 'no'.");
2328 break;
2330 det = gettext_noop("Malformed declaration: missing version.");
2331 break;
2333 det = gettext_noop("Missing encoding in text declaration.");
2334 break;
2336 det = gettext_noop("Parsing XML declaration: '?>' expected.");
2337 break;
2338 default:
2339 det = gettext_noop("Unrecognized libxml error code: %d.");
2340 break;
2341 }
2342
2343 return errdetail(det, code);
2344}
2345
2346
2347/*
2348 * Remove all trailing newlines from a StringInfo string
2349 */
2350static void
2352{
2353 while (str->len > 0 && str->data[str->len - 1] == '\n')
2354 str->data[--str->len] = '\0';
2355}
2356
2357
2358/*
2359 * Append a newline after removing any existing trailing newlines
2360 */
2361static void
2363{
2365 if (str->len > 0)
2367}
2368
2369
2370/*
2371 * Convert one char in the current server encoding to a Unicode codepoint.
2372 */
2373static pg_wchar
2374sqlchar_to_unicode(const char *s)
2375{
2376 char *utf8string;
2377 pg_wchar ret[2]; /* need space for trailing zero */
2378
2380
2383
2384 if (utf8string != s)
2386
2387 return ret[0];
2388}
2389
2390
2391static bool
2393{
2394 /* (Letter | '_' | ':') */
2395 return (xmlIsBaseCharQ(c) || xmlIsIdeographicQ(c)
2396 || c == '_' || c == ':');
2397}
2398
2399
2400static bool
2402{
2403 /* Letter | Digit | '.' | '-' | '_' | ':' | CombiningChar | Extender */
2404 return (xmlIsBaseCharQ(c) || xmlIsIdeographicQ(c)
2405 || xmlIsDigitQ(c)
2406 || c == '.' || c == '-' || c == '_' || c == ':'
2407 || xmlIsCombiningQ(c)
2408 || xmlIsExtenderQ(c));
2409}
2410#endif /* USE_LIBXML */
2411
2412
2413/*
2414 * Map SQL identifier to XML name; see SQL/XML:2008 section 9.1.
2415 */
2416char *
2418 bool escape_period)
2419{
2420#ifdef USE_LIBXML
2422 const char *p;
2423
2424 /*
2425 * SQL/XML doesn't make use of this case anywhere, so it's probably a
2426 * mistake.
2427 */
2429
2431
2432 for (p = ident; *p; p += pg_mblen_cstr(p))
2433 {
2434 if (*p == ':' && (p == ident || fully_escaped))
2435 appendStringInfoString(&buf, "_x003A_");
2436 else if (*p == '_' && *(p + 1) == 'x')
2437 appendStringInfoString(&buf, "_x005F_");
2438 else if (fully_escaped && p == ident &&
2439 pg_strncasecmp(p, "xml", 3) == 0)
2440 {
2441 if (*p == 'x')
2442 appendStringInfoString(&buf, "_x0078_");
2443 else
2444 appendStringInfoString(&buf, "_x0058_");
2445 }
2446 else if (escape_period && *p == '.')
2447 appendStringInfoString(&buf, "_x002E_");
2448 else
2449 {
2451
2452 if ((p == ident)
2455 appendStringInfo(&buf, "_x%04X_", (unsigned int) u);
2456 else
2458 }
2459 }
2460
2461 return buf.data;
2462#else /* not USE_LIBXML */
2464 return NULL;
2465#endif /* not USE_LIBXML */
2466}
2467
2468
2469/*
2470 * Map XML name to SQL identifier; see SQL/XML:2008 section 9.3.
2471 */
2472char *
2474{
2476 const char *p;
2477
2479
2480 for (p = name; *p; p += pg_mblen_cstr(p))
2481 {
2482 if (*p == '_' && *(p + 1) == 'x'
2483 && isxdigit((unsigned char) *(p + 2))
2484 && isxdigit((unsigned char) *(p + 3))
2485 && isxdigit((unsigned char) *(p + 4))
2486 && isxdigit((unsigned char) *(p + 5))
2487 && *(p + 6) == '_')
2488 {
2490 unsigned int u;
2491
2492 sscanf(p + 2, "%X", &u);
2493 pg_unicode_to_server(u, (unsigned char *) cbuf);
2495 p += 6;
2496 }
2497 else
2499 }
2500
2501 return buf.data;
2502}
2503
2504/*
2505 * Map SQL value to XML value; see SQL/XML:2008 section 9.8.
2506 *
2507 * When xml_escape_strings is true, then certain characters in string
2508 * values are replaced by entity references (&lt; etc.), as specified
2509 * in SQL/XML:2008 section 9.8 GR 9) a) iii). This is normally what is
2510 * wanted. The false case is mainly useful when the resulting value
2511 * is used with xmlTextWriterWriteAttribute() to write out an
2512 * attribute, because that function does the escaping itself.
2513 */
2514char *
2516{
2518 {
2519 ArrayType *array;
2520 Oid elmtype;
2521 int16 elmlen;
2522 bool elmbyval;
2523 char elmalign;
2524 int num_elems;
2525 Datum *elem_values;
2526 bool *elem_nulls;
2528 int i;
2529
2530 array = DatumGetArrayTypeP(value);
2531 elmtype = ARR_ELEMTYPE(array);
2532 get_typlenbyvalalign(elmtype, &elmlen, &elmbyval, &elmalign);
2533
2535 elmlen, elmbyval, elmalign,
2536 &elem_values, &elem_nulls,
2537 &num_elems);
2538
2540
2541 for (i = 0; i < num_elems; i++)
2542 {
2543 if (elem_nulls[i])
2544 continue;
2545 appendStringInfoString(&buf, "<element>");
2547 map_sql_value_to_xml_value(elem_values[i],
2548 elmtype, true));
2549 appendStringInfoString(&buf, "</element>");
2550 }
2551
2552 pfree(elem_values);
2553 pfree(elem_nulls);
2554
2555 return buf.data;
2556 }
2557 else
2558 {
2559 Oid typeOut;
2560 bool isvarlena;
2561 char *str;
2562
2563 /*
2564 * Flatten domains; the special-case treatments below should apply to,
2565 * eg, domains over boolean not just boolean.
2566 */
2568
2569 /*
2570 * Special XSD formatting for some data types
2571 */
2572 switch (type)
2573 {
2574 case BOOLOID:
2575 if (DatumGetBool(value))
2576 return "true";
2577 else
2578 return "false";
2579
2580 case DATEOID:
2581 {
2582 DateADT date;
2583 struct pg_tm tm;
2584 char buf[MAXDATELEN + 1];
2585
2587 /* XSD doesn't support infinite values */
2588 if (DATE_NOT_FINITE(date))
2589 ereport(ERROR,
2591 errmsg("date out of range"),
2592 errdetail("XML does not support infinite date values.")));
2594 &(tm.tm_year), &(tm.tm_mon), &(tm.tm_mday));
2596
2597 return pstrdup(buf);
2598 }
2599
2600 case TIMESTAMPOID:
2601 {
2603 struct pg_tm tm;
2604 fsec_t fsec;
2605 char buf[MAXDATELEN + 1];
2606
2608
2609 /* XSD doesn't support infinite values */
2611 ereport(ERROR,
2613 errmsg("timestamp out of range"),
2614 errdetail("XML does not support infinite timestamp values.")));
2615 else if (timestamp2tm(timestamp, NULL, &tm, &fsec, NULL, NULL) == 0)
2616 EncodeDateTime(&tm, fsec, false, 0, NULL, USE_XSD_DATES, buf);
2617 else
2618 ereport(ERROR,
2620 errmsg("timestamp out of range")));
2621
2622 return pstrdup(buf);
2623 }
2624
2625 case TIMESTAMPTZOID:
2626 {
2628 struct pg_tm tm;
2629 int tz;
2630 fsec_t fsec;
2631 const char *tzn = NULL;
2632 char buf[MAXDATELEN + 1];
2633
2635
2636 /* XSD doesn't support infinite values */
2638 ereport(ERROR,
2640 errmsg("timestamp out of range"),
2641 errdetail("XML does not support infinite timestamp values.")));
2642 else if (timestamp2tm(timestamp, &tz, &tm, &fsec, &tzn, NULL) == 0)
2643 EncodeDateTime(&tm, fsec, true, tz, tzn, USE_XSD_DATES, buf);
2644 else
2645 ereport(ERROR,
2647 errmsg("timestamp out of range")));
2648
2649 return pstrdup(buf);
2650 }
2651
2652#ifdef USE_LIBXML
2653 case BYTEAOID:
2654 {
2657 volatile xmlBufferPtr buf = NULL;
2658 volatile xmlTextWriterPtr writer = NULL;
2659 char *result;
2660
2662
2663 PG_TRY();
2664 {
2665 buf = xmlBufferCreate();
2666 if (buf == NULL || xmlerrcxt->err_occurred)
2668 "could not allocate xmlBuffer");
2670 if (writer == NULL || xmlerrcxt->err_occurred)
2672 "could not allocate xmlTextWriter");
2673
2677 else
2680
2681 /* we MUST do this now to flush data out to the buffer */
2683 writer = NULL;
2684
2685 result = pstrdup((const char *) xmlBufferContent(buf));
2686 }
2687 PG_CATCH();
2688 {
2689 if (writer)
2691 if (buf)
2693
2694 pg_xml_done(xmlerrcxt, true);
2695
2696 PG_RE_THROW();
2697 }
2698 PG_END_TRY();
2699
2701
2702 pg_xml_done(xmlerrcxt, false);
2703
2704 return result;
2705 }
2706#endif /* USE_LIBXML */
2707
2708 }
2709
2710 /*
2711 * otherwise, just use the type's native text representation
2712 */
2715
2716 /* ... exactly as-is for XML, and when escaping is not wanted */
2717 if (type == XMLOID || !xml_escape_strings)
2718 return str;
2719
2720 /* otherwise, translate special characters as needed */
2721 return escape_xml(str);
2722 }
2723}
2724
2725
2726/*
2727 * Escape characters in text that have special meanings in XML.
2728 *
2729 * Returns a palloc'd string.
2730 *
2731 * NB: this is intentionally not dependent on libxml.
2732 */
2733char *
2734escape_xml(const char *str)
2735{
2737 const char *p;
2738
2740 for (p = str; *p; p++)
2741 {
2742 switch (*p)
2743 {
2744 case '&':
2745 appendStringInfoString(&buf, "&amp;");
2746 break;
2747 case '<':
2748 appendStringInfoString(&buf, "&lt;");
2749 break;
2750 case '>':
2751 appendStringInfoString(&buf, "&gt;");
2752 break;
2753 case '\r':
2754 appendStringInfoString(&buf, "&#x0d;");
2755 break;
2756 default:
2758 break;
2759 }
2760 }
2761 return buf.data;
2762}
2763
2764
2765static char *
2766_SPI_strdup(const char *s)
2767{
2768 size_t len = strlen(s) + 1;
2769 char *ret = SPI_palloc(len);
2770
2771 memcpy(ret, s, len);
2772 return ret;
2773}
2774
2775
2776/*
2777 * SQL to XML mapping functions
2778 *
2779 * What follows below was at one point intentionally organized so that
2780 * you can read along in the SQL/XML standard. The functions are
2781 * mostly split up the way the clauses lay out in the standards
2782 * document, and the identifiers are also aligned with the standard
2783 * text. Unfortunately, SQL/XML:2006 reordered the clauses
2784 * differently than SQL/XML:2003, so the order below doesn't make much
2785 * sense anymore.
2786 *
2787 * There are many things going on there:
2788 *
2789 * There are two kinds of mappings: Mapping SQL data (table contents)
2790 * to XML documents, and mapping SQL structure (the "schema") to XML
2791 * Schema. And there are functions that do both at the same time.
2792 *
2793 * Then you can map a database, a schema, or a table, each in both
2794 * ways. This breaks down recursively: Mapping a database invokes
2795 * mapping schemas, which invokes mapping tables, which invokes
2796 * mapping rows, which invokes mapping columns, although you can't
2797 * call the last two from the outside. Because of this, there are a
2798 * number of xyz_internal() functions which are to be called both from
2799 * the function manager wrapper and from some upper layer in a
2800 * recursive call.
2801 *
2802 * See the documentation about what the common function arguments
2803 * nulls, tableforest, and targetns mean.
2804 *
2805 * Some style guidelines for XML output: Use double quotes for quoting
2806 * XML attributes. Indent XML elements by two spaces, but remember
2807 * that a lot of code is called recursively at different levels, so
2808 * it's better not to indent rather than create output that indents
2809 * and outdents weirdly. Add newlines to make the output look nice.
2810 */
2811
2812
2813/*
2814 * Visibility of objects for XML mappings; see SQL/XML:2008 section
2815 * 4.10.8.
2816 */
2817
2818/*
2819 * Given a query, which must return type oid as first column, produce
2820 * a list of Oids with the query results.
2821 */
2822static List *
2823query_to_oid_list(const char *query)
2824{
2825 uint64 i;
2826 List *list = NIL;
2827 int spi_result;
2828
2829 spi_result = SPI_execute(query, true, 0);
2831 elog(ERROR, "SPI_execute returned %s for %s",
2833
2834 for (i = 0; i < SPI_processed; i++)
2835 {
2836 Datum oid;
2837 bool isnull;
2838
2841 1,
2842 &isnull);
2843 if (!isnull)
2844 list = lappend_oid(list, DatumGetObjectId(oid));
2845 }
2846
2847 return list;
2848}
2849
2850
2851static List *
2853{
2854 StringInfoData query;
2855
2856 initStringInfo(&query);
2857 appendStringInfo(&query, "SELECT oid FROM pg_catalog.pg_class"
2858 " WHERE relnamespace = %u AND relkind IN ("
2862 " AND pg_catalog.has_table_privilege (oid, 'SELECT')"
2863 " ORDER BY relname;", nspid);
2864
2865 return query_to_oid_list(query.data);
2866}
2867
2868
2869/*
2870 * Including the system schemas is probably not useful for a database
2871 * mapping.
2872 */
2873#define XML_VISIBLE_SCHEMAS_EXCLUDE "(nspname ~ '^pg_' OR nspname = 'information_schema')"
2874
2875#define XML_VISIBLE_SCHEMAS "SELECT oid FROM pg_catalog.pg_namespace WHERE pg_catalog.has_schema_privilege (oid, 'USAGE') AND NOT " XML_VISIBLE_SCHEMAS_EXCLUDE
2876
2877
2878static List *
2880{
2881 return query_to_oid_list(XML_VISIBLE_SCHEMAS " ORDER BY nspname;");
2882}
2883
2884
2885static List *
2887{
2888 /* At the moment there is no order required here. */
2889 return query_to_oid_list("SELECT oid FROM pg_catalog.pg_class"
2890 " WHERE relkind IN ("
2894 " AND pg_catalog.has_table_privilege(pg_class.oid, 'SELECT')"
2895 " AND relnamespace IN (" XML_VISIBLE_SCHEMAS ");");
2896}
2897
2898
2899/*
2900 * Map SQL table to XML and/or XML Schema document; see SQL/XML:2008
2901 * section 9.11.
2902 */
2903
2904static StringInfo
2906 const char *xmlschema, bool nulls, bool tableforest,
2907 const char *targetns, bool top_level)
2908{
2909 StringInfoData query;
2910
2911 initStringInfo(&query);
2912 appendStringInfo(&query, "SELECT * FROM %s",
2914 ObjectIdGetDatum(relid))));
2915 return query_to_xml_internal(query.data, get_rel_name(relid),
2916 xmlschema, nulls, tableforest,
2917 targetns, top_level);
2918}
2919
2920
2921Datum
2923{
2924 Oid relid = PG_GETARG_OID(0);
2925 bool nulls = PG_GETARG_BOOL(1);
2926 bool tableforest = PG_GETARG_BOOL(2);
2927 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
2928
2930 nulls, tableforest,
2931 targetns, true)));
2932}
2933
2934
2935Datum
2937{
2938 char *query = text_to_cstring(PG_GETARG_TEXT_PP(0));
2939 bool nulls = PG_GETARG_BOOL(1);
2940 bool tableforest = PG_GETARG_BOOL(2);
2941 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
2942
2944 NULL, nulls, tableforest,
2945 targetns, true)));
2946}
2947
2948
2949Datum
2951{
2953 int32 count = PG_GETARG_INT32(1);
2954 bool nulls = PG_GETARG_BOOL(2);
2955 bool tableforest = PG_GETARG_BOOL(3);
2956 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(4));
2957
2958 StringInfoData result;
2959 Portal portal;
2960 uint64 i;
2961
2962 initStringInfo(&result);
2963
2964 if (!tableforest)
2965 {
2966 xmldata_root_element_start(&result, "table", NULL, targetns, true);
2967 appendStringInfoChar(&result, '\n');
2968 }
2969
2970 SPI_connect();
2971 portal = SPI_cursor_find(name);
2972 if (portal == NULL)
2973 ereport(ERROR,
2975 errmsg("cursor \"%s\" does not exist", name)));
2976
2977 SPI_cursor_fetch(portal, true, count);
2978 for (i = 0; i < SPI_processed; i++)
2979 SPI_sql_row_to_xmlelement(i, &result, NULL, nulls,
2980 tableforest, targetns, true);
2981
2982 SPI_finish();
2983
2984 if (!tableforest)
2985 xmldata_root_element_end(&result, "table");
2986
2988}
2989
2990
2991/*
2992 * Write the start tag of the root element of a data mapping.
2993 *
2994 * top_level means that this is the very top level of the eventual
2995 * output. For example, when the user calls table_to_xml, then a call
2996 * with a table name to this function is the top level. When the user
2997 * calls database_to_xml, then a call with a schema name to this
2998 * function is not the top level. If top_level is false, then the XML
2999 * namespace declarations are omitted, because they supposedly already
3000 * appeared earlier in the output. Repeating them is not wrong, but
3001 * it looks ugly.
3002 */
3003static void
3005 const char *xmlschema, const char *targetns,
3006 bool top_level)
3007{
3008 /* This isn't really wrong but currently makes no sense. */
3009 Assert(top_level || !xmlschema);
3010
3011 appendStringInfo(result, "<%s", eltname);
3012 if (top_level)
3013 {
3014 appendStringInfoString(result, " xmlns:xsi=\"" NAMESPACE_XSI "\"");
3015 if (strlen(targetns) > 0)
3016 appendStringInfo(result, " xmlns=\"%s\"", targetns);
3017 }
3018 if (xmlschema)
3019 {
3020 /* FIXME: better targets */
3021 if (strlen(targetns) > 0)
3022 appendStringInfo(result, " xsi:schemaLocation=\"%s #\"", targetns);
3023 else
3024 appendStringInfoString(result, " xsi:noNamespaceSchemaLocation=\"#\"");
3025 }
3026 appendStringInfoString(result, ">\n");
3027}
3028
3029
3030static void
3031xmldata_root_element_end(StringInfo result, const char *eltname)
3032{
3033 appendStringInfo(result, "</%s>\n", eltname);
3034}
3035
3036
3037static StringInfo
3038query_to_xml_internal(const char *query, char *tablename,
3039 const char *xmlschema, bool nulls, bool tableforest,
3040 const char *targetns, bool top_level)
3041{
3042 StringInfo result;
3043 char *xmltn;
3044 uint64 i;
3045
3046 if (tablename)
3047 xmltn = map_sql_identifier_to_xml_name(tablename, true, false);
3048 else
3049 xmltn = "table";
3050
3051 result = makeStringInfo();
3052
3053 SPI_connect();
3054 if (SPI_execute(query, true, 0) != SPI_OK_SELECT)
3055 ereport(ERROR,
3057 errmsg("invalid query")));
3058
3059 if (!tableforest)
3060 {
3062 targetns, top_level);
3063 appendStringInfoChar(result, '\n');
3064 }
3065
3066 if (xmlschema)
3067 appendStringInfo(result, "%s\n\n", xmlschema);
3068
3069 for (i = 0; i < SPI_processed; i++)
3070 SPI_sql_row_to_xmlelement(i, result, tablename, nulls,
3071 tableforest, targetns, top_level);
3072
3073 if (!tableforest)
3075
3076 SPI_finish();
3077
3078 return result;
3079}
3080
3081
3082Datum
3084{
3085 Oid relid = PG_GETARG_OID(0);
3086 bool nulls = PG_GETARG_BOOL(1);
3087 bool tableforest = PG_GETARG_BOOL(2);
3088 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3089 const char *result;
3090 Relation rel;
3091
3092 rel = table_open(relid, AccessShareLock);
3093 result = map_sql_table_to_xmlschema(rel->rd_att, relid, nulls,
3095 table_close(rel, NoLock);
3096
3098}
3099
3100
3101Datum
3103{
3104 char *query = text_to_cstring(PG_GETARG_TEXT_PP(0));
3105 bool nulls = PG_GETARG_BOOL(1);
3106 bool tableforest = PG_GETARG_BOOL(2);
3107 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3108 const char *result;
3110 Portal portal;
3111
3112 SPI_connect();
3113
3114 if ((plan = SPI_prepare(query, 0, NULL)) == NULL)
3115 elog(ERROR, "SPI_prepare(\"%s\") failed", query);
3116
3117 if ((portal = SPI_cursor_open(NULL, plan, NULL, NULL, true)) == NULL)
3118 elog(ERROR, "SPI_cursor_open(\"%s\") failed", query);
3119
3121 InvalidOid, nulls,
3123 SPI_cursor_close(portal);
3124 SPI_finish();
3125
3127}
3128
3129
3130Datum
3132{
3134 bool nulls = PG_GETARG_BOOL(1);
3135 bool tableforest = PG_GETARG_BOOL(2);
3136 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3137 const char *xmlschema;
3138 Portal portal;
3139
3140 SPI_connect();
3141 portal = SPI_cursor_find(name);
3142 if (portal == NULL)
3143 ereport(ERROR,
3145 errmsg("cursor \"%s\" does not exist", name)));
3146 if (portal->tupDesc == NULL)
3147 ereport(ERROR,
3149 errmsg("portal \"%s\" does not return tuples", name)));
3150
3152 InvalidOid, nulls,
3154 SPI_finish();
3155
3157}
3158
3159
3160Datum
3162{
3163 Oid relid = PG_GETARG_OID(0);
3164 bool nulls = PG_GETARG_BOOL(1);
3165 bool tableforest = PG_GETARG_BOOL(2);
3166 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3167 Relation rel;
3168 const char *xmlschema;
3169
3170 rel = table_open(relid, AccessShareLock);
3171 xmlschema = map_sql_table_to_xmlschema(rel->rd_att, relid, nulls,
3173 table_close(rel, NoLock);
3174
3176 xmlschema, nulls, tableforest,
3177 targetns, true)));
3178}
3179
3180
3181Datum
3183{
3184 char *query = text_to_cstring(PG_GETARG_TEXT_PP(0));
3185 bool nulls = PG_GETARG_BOOL(1);
3186 bool tableforest = PG_GETARG_BOOL(2);
3187 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3188
3189 const char *xmlschema;
3191 Portal portal;
3192
3193 SPI_connect();
3194
3195 if ((plan = SPI_prepare(query, 0, NULL)) == NULL)
3196 elog(ERROR, "SPI_prepare(\"%s\") failed", query);
3197
3198 if ((portal = SPI_cursor_open(NULL, plan, NULL, NULL, true)) == NULL)
3199 elog(ERROR, "SPI_cursor_open(\"%s\") failed", query);
3200
3202 InvalidOid, nulls, tableforest, targetns));
3203 SPI_cursor_close(portal);
3204 SPI_finish();
3205
3207 xmlschema, nulls, tableforest,
3208 targetns, true)));
3209}
3210
3211
3212/*
3213 * Map SQL schema to XML and/or XML Schema document; see SQL/XML:2008
3214 * sections 9.13, 9.14.
3215 */
3216
3217static StringInfo
3218schema_to_xml_internal(Oid nspid, const char *xmlschema, bool nulls,
3219 bool tableforest, const char *targetns, bool top_level)
3220{
3221 StringInfo result;
3222 char *xmlsn;
3224 ListCell *cell;
3225
3227 true, false);
3228 result = makeStringInfo();
3229
3230 xmldata_root_element_start(result, xmlsn, xmlschema, targetns, top_level);
3231 appendStringInfoChar(result, '\n');
3232
3233 if (xmlschema)
3234 appendStringInfo(result, "%s\n\n", xmlschema);
3235
3236 SPI_connect();
3237
3239
3240 foreach(cell, relid_list)
3241 {
3242 Oid relid = lfirst_oid(cell);
3244
3246 targetns, false);
3247
3248 appendBinaryStringInfo(result, subres->data, subres->len);
3249 appendStringInfoChar(result, '\n');
3250 }
3251
3252 SPI_finish();
3253
3255
3256 return result;
3257}
3258
3259
3260Datum
3262{
3264 bool nulls = PG_GETARG_BOOL(1);
3265 bool tableforest = PG_GETARG_BOOL(2);
3266 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3267
3268 char *schemaname;
3269 Oid nspid;
3270
3271 schemaname = NameStr(*name);
3272 nspid = LookupExplicitNamespace(schemaname, false);
3273
3275 nulls, tableforest, targetns, true)));
3276}
3277
3278
3279/*
3280 * Write the start element of the root element of an XML Schema mapping.
3281 */
3282static void
3283xsd_schema_element_start(StringInfo result, const char *targetns)
3284{
3286 "<xsd:schema\n"
3287 " xmlns:xsd=\"" NAMESPACE_XSD "\"");
3288 if (strlen(targetns) > 0)
3289 appendStringInfo(result,
3290 "\n"
3291 " targetNamespace=\"%s\"\n"
3292 " elementFormDefault=\"qualified\"",
3293 targetns);
3295 ">\n\n");
3296}
3297
3298
3299static void
3301{
3302 appendStringInfoString(result, "</xsd:schema>");
3303}
3304
3305
3306static StringInfo
3307schema_to_xmlschema_internal(const char *schemaname, bool nulls,
3308 bool tableforest, const char *targetns)
3309{
3310 Oid nspid;
3313 ListCell *cell;
3314 StringInfo result;
3315
3316 result = makeStringInfo();
3317
3318 nspid = LookupExplicitNamespace(schemaname, false);
3319
3321
3322 SPI_connect();
3323
3325
3326 tupdesc_list = NIL;
3327 foreach(cell, relid_list)
3328 {
3329 Relation rel;
3330
3333 table_close(rel, NoLock);
3334 }
3335
3338
3341 nulls, tableforest, targetns));
3342
3343 xsd_schema_element_end(result);
3344
3345 SPI_finish();
3346
3347 return result;
3348}
3349
3350
3351Datum
3353{
3355 bool nulls = PG_GETARG_BOOL(1);
3356 bool tableforest = PG_GETARG_BOOL(2);
3357 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3358
3360 nulls, tableforest, targetns)));
3361}
3362
3363
3364Datum
3366{
3368 bool nulls = PG_GETARG_BOOL(1);
3369 bool tableforest = PG_GETARG_BOOL(2);
3370 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3371 char *schemaname;
3372 Oid nspid;
3374
3375 schemaname = NameStr(*name);
3376 nspid = LookupExplicitNamespace(schemaname, false);
3377
3378 xmlschema = schema_to_xmlschema_internal(schemaname, nulls,
3380
3382 xmlschema->data, nulls,
3383 tableforest, targetns, true)));
3384}
3385
3386
3387/*
3388 * Map SQL database to XML and/or XML Schema document; see SQL/XML:2008
3389 * sections 9.16, 9.17.
3390 */
3391
3392static StringInfo
3393database_to_xml_internal(const char *xmlschema, bool nulls,
3394 bool tableforest, const char *targetns)
3395{
3396 StringInfo result;
3398 ListCell *cell;
3399 char *xmlcn;
3400
3402 true, false);
3403 result = makeStringInfo();
3404
3406 appendStringInfoChar(result, '\n');
3407
3408 if (xmlschema)
3409 appendStringInfo(result, "%s\n\n", xmlschema);
3410
3411 SPI_connect();
3412
3414
3415 foreach(cell, nspid_list)
3416 {
3417 Oid nspid = lfirst_oid(cell);
3419
3421 tableforest, targetns, false);
3422
3423 appendBinaryStringInfo(result, subres->data, subres->len);
3424 appendStringInfoChar(result, '\n');
3425 }
3426
3427 SPI_finish();
3428
3430
3431 return result;
3432}
3433
3434
3435Datum
3437{
3438 bool nulls = PG_GETARG_BOOL(0);
3439 bool tableforest = PG_GETARG_BOOL(1);
3440 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(2));
3441
3444}
3445
3446
3447static StringInfo
3449 const char *targetns)
3450{
3454 ListCell *cell;
3455 StringInfo result;
3456
3457 result = makeStringInfo();
3458
3460
3461 SPI_connect();
3462
3465
3466 tupdesc_list = NIL;
3467 foreach(cell, relid_list)
3468 {
3469 Relation rel;
3470
3473 table_close(rel, NoLock);
3474 }
3475
3478
3481
3482 xsd_schema_element_end(result);
3483
3484 SPI_finish();
3485
3486 return result;
3487}
3488
3489
3490Datum
3492{
3493 bool nulls = PG_GETARG_BOOL(0);
3494 bool tableforest = PG_GETARG_BOOL(1);
3495 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(2));
3496
3499}
3500
3501
3502Datum
3504{
3505 bool nulls = PG_GETARG_BOOL(0);
3506 bool tableforest = PG_GETARG_BOOL(1);
3507 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(2));
3509
3511
3513 nulls, tableforest, targetns)));
3514}
3515
3516
3517/*
3518 * Map a multi-part SQL name to an XML name; see SQL/XML:2008 section
3519 * 9.2.
3520 */
3521static char *
3522map_multipart_sql_identifier_to_xml_name(const char *a, const char *b, const char *c, const char *d)
3523{
3524 StringInfoData result;
3525
3526 initStringInfo(&result);
3527
3528 if (a)
3529 appendStringInfoString(&result,
3530 map_sql_identifier_to_xml_name(a, true, true));
3531 if (b)
3532 appendStringInfo(&result, ".%s",
3533 map_sql_identifier_to_xml_name(b, true, true));
3534 if (c)
3535 appendStringInfo(&result, ".%s",
3536 map_sql_identifier_to_xml_name(c, true, true));
3537 if (d)
3538 appendStringInfo(&result, ".%s",
3539 map_sql_identifier_to_xml_name(d, true, true));
3540
3541 return result.data;
3542}
3543
3544
3545/*
3546 * Map an SQL table to an XML Schema document; see SQL/XML:2008
3547 * section 9.11.
3548 *
3549 * Map an SQL table to XML Schema data types; see SQL/XML:2008 section
3550 * 9.9.
3551 */
3552static const char *
3553map_sql_table_to_xmlschema(TupleDesc tupdesc, Oid relid, bool nulls,
3554 bool tableforest, const char *targetns)
3555{
3556 int i;
3557 char *xmltn;
3558 char *tabletypename;
3559 char *rowtypename;
3560 StringInfoData result;
3561
3562 initStringInfo(&result);
3563
3564 if (OidIsValid(relid))
3565 {
3566 HeapTuple tuple;
3568
3569 tuple = SearchSysCache1(RELOID, ObjectIdGetDatum(relid));
3570 if (!HeapTupleIsValid(tuple))
3571 elog(ERROR, "cache lookup failed for relation %u", relid);
3572 reltuple = (Form_pg_class) GETSTRUCT(tuple);
3573
3575 true, false);
3576
3579 get_namespace_name(reltuple->relnamespace),
3580 NameStr(reltuple->relname));
3581
3584 get_namespace_name(reltuple->relnamespace),
3585 NameStr(reltuple->relname));
3586
3587 ReleaseSysCache(tuple);
3588 }
3589 else
3590 {
3591 if (tableforest)
3592 xmltn = "row";
3593 else
3594 xmltn = "table";
3595
3596 tabletypename = "TableType";
3597 rowtypename = "RowType";
3598 }
3599
3601
3602 appendStringInfoString(&result,
3604
3605 appendStringInfo(&result,
3606 "<xsd:complexType name=\"%s\">\n"
3607 " <xsd:sequence>\n",
3608 rowtypename);
3609
3610 for (i = 0; i < tupdesc->natts; i++)
3611 {
3613
3614 if (att->attisdropped)
3615 continue;
3616 appendStringInfo(&result,
3617 " <xsd:element name=\"%s\" type=\"%s\"%s></xsd:element>\n",
3619 true, false),
3620 map_sql_type_to_xml_name(att->atttypid, -1),
3621 nulls ? " nillable=\"true\"" : " minOccurs=\"0\"");
3622 }
3623
3624 appendStringInfoString(&result,
3625 " </xsd:sequence>\n"
3626 "</xsd:complexType>\n\n");
3627
3628 if (!tableforest)
3629 {
3630 appendStringInfo(&result,
3631 "<xsd:complexType name=\"%s\">\n"
3632 " <xsd:sequence>\n"
3633 " <xsd:element name=\"row\" type=\"%s\" minOccurs=\"0\" maxOccurs=\"unbounded\"/>\n"
3634 " </xsd:sequence>\n"
3635 "</xsd:complexType>\n\n",
3637
3638 appendStringInfo(&result,
3639 "<xsd:element name=\"%s\" type=\"%s\"/>\n\n",
3641 }
3642 else
3643 appendStringInfo(&result,
3644 "<xsd:element name=\"%s\" type=\"%s\"/>\n\n",
3646
3647 xsd_schema_element_end(&result);
3648
3649 return result.data;
3650}
3651
3652
3653/*
3654 * Map an SQL schema to XML Schema data types; see SQL/XML:2008
3655 * section 9.12.
3656 */
3657static const char *
3659 bool tableforest, const char *targetns)
3660{
3661 char *dbname;
3662 char *nspname;
3663 char *xmlsn;
3664 char *schematypename;
3665 StringInfoData result;
3666 ListCell *cell;
3667
3669 nspname = get_namespace_name(nspid);
3670
3671 initStringInfo(&result);
3672
3673 xmlsn = map_sql_identifier_to_xml_name(nspname, true, false);
3674
3676 dbname,
3677 nspname,
3678 NULL);
3679
3680 appendStringInfo(&result,
3681 "<xsd:complexType name=\"%s\">\n", schematypename);
3682 if (!tableforest)
3683 appendStringInfoString(&result,
3684 " <xsd:all>\n");
3685 else
3686 appendStringInfoString(&result,
3687 " <xsd:sequence>\n");
3688
3689 foreach(cell, relid_list)
3690 {
3691 Oid relid = lfirst_oid(cell);
3692 char *relname = get_rel_name(relid);
3693 char *xmltn = map_sql_identifier_to_xml_name(relname, true, false);
3694 char *tabletypename = map_multipart_sql_identifier_to_xml_name(tableforest ? "RowType" : "TableType",
3695 dbname,
3696 nspname,
3697 relname);
3698
3699 if (!tableforest)
3700 appendStringInfo(&result,
3701 " <xsd:element name=\"%s\" type=\"%s\"/>\n",
3703 else
3704 appendStringInfo(&result,
3705 " <xsd:element name=\"%s\" type=\"%s\" minOccurs=\"0\" maxOccurs=\"unbounded\"/>\n",
3707 }
3708
3709 if (!tableforest)
3710 appendStringInfoString(&result,
3711 " </xsd:all>\n");
3712 else
3713 appendStringInfoString(&result,
3714 " </xsd:sequence>\n");
3715 appendStringInfoString(&result,
3716 "</xsd:complexType>\n\n");
3717
3718 appendStringInfo(&result,
3719 "<xsd:element name=\"%s\" type=\"%s\"/>\n\n",
3721
3722 return result.data;
3723}
3724
3725
3726/*
3727 * Map an SQL catalog to XML Schema data types; see SQL/XML:2008
3728 * section 9.15.
3729 */
3730static const char *
3732 bool tableforest, const char *targetns)
3733{
3734 char *dbname;
3735 char *xmlcn;
3736 char *catalogtypename;
3737 StringInfoData result;
3738 ListCell *cell;
3739
3741
3742 initStringInfo(&result);
3743
3745
3747 dbname,
3748 NULL,
3749 NULL);
3750
3751 appendStringInfo(&result,
3752 "<xsd:complexType name=\"%s\">\n", catalogtypename);
3753 appendStringInfoString(&result,
3754 " <xsd:all>\n");
3755
3756 foreach(cell, nspid_list)
3757 {
3758 Oid nspid = lfirst_oid(cell);
3759 char *nspname = get_namespace_name(nspid);
3760 char *xmlsn = map_sql_identifier_to_xml_name(nspname, true, false);
3762 dbname,
3763 nspname,
3764 NULL);
3765
3766 appendStringInfo(&result,
3767 " <xsd:element name=\"%s\" type=\"%s\"/>\n",
3769 }
3770
3771 appendStringInfoString(&result,
3772 " </xsd:all>\n");
3773 appendStringInfoString(&result,
3774 "</xsd:complexType>\n\n");
3775
3776 appendStringInfo(&result,
3777 "<xsd:element name=\"%s\" type=\"%s\"/>\n\n",
3779
3780 return result.data;
3781}
3782
3783
3784/*
3785 * Map an SQL data type to an XML name; see SQL/XML:2008 section 9.4.
3786 */
3787static const char *
3788map_sql_type_to_xml_name(Oid typeoid, int typmod)
3789{
3790 StringInfoData result;
3791
3792 initStringInfo(&result);
3793
3794 switch (typeoid)
3795 {
3796 case BPCHAROID:
3797 if (typmod == -1)
3798 appendStringInfoString(&result, "CHAR");
3799 else
3800 appendStringInfo(&result, "CHAR_%d", typmod - VARHDRSZ);
3801 break;
3802 case VARCHAROID:
3803 if (typmod == -1)
3804 appendStringInfoString(&result, "VARCHAR");
3805 else
3806 appendStringInfo(&result, "VARCHAR_%d", typmod - VARHDRSZ);
3807 break;
3808 case NUMERICOID:
3809 if (typmod == -1)
3810 appendStringInfoString(&result, "NUMERIC");
3811 else
3812 appendStringInfo(&result, "NUMERIC_%d_%d",
3813 ((typmod - VARHDRSZ) >> 16) & 0xffff,
3814 (typmod - VARHDRSZ) & 0xffff);
3815 break;
3816 case INT4OID:
3817 appendStringInfoString(&result, "INTEGER");
3818 break;
3819 case INT2OID:
3820 appendStringInfoString(&result, "SMALLINT");
3821 break;
3822 case INT8OID:
3823 appendStringInfoString(&result, "BIGINT");
3824 break;
3825 case FLOAT4OID:
3826 appendStringInfoString(&result, "REAL");
3827 break;
3828 case FLOAT8OID:
3829 appendStringInfoString(&result, "DOUBLE");
3830 break;
3831 case BOOLOID:
3832 appendStringInfoString(&result, "BOOLEAN");
3833 break;
3834 case TIMEOID:
3835 if (typmod == -1)
3836 appendStringInfoString(&result, "TIME");
3837 else
3838 appendStringInfo(&result, "TIME_%d", typmod);
3839 break;
3840 case TIMETZOID:
3841 if (typmod == -1)
3842 appendStringInfoString(&result, "TIME_WTZ");
3843 else
3844 appendStringInfo(&result, "TIME_WTZ_%d", typmod);
3845 break;
3846 case TIMESTAMPOID:
3847 if (typmod == -1)
3848 appendStringInfoString(&result, "TIMESTAMP");
3849 else
3850 appendStringInfo(&result, "TIMESTAMP_%d", typmod);
3851 break;
3852 case TIMESTAMPTZOID:
3853 if (typmod == -1)
3854 appendStringInfoString(&result, "TIMESTAMP_WTZ");
3855 else
3856 appendStringInfo(&result, "TIMESTAMP_WTZ_%d", typmod);
3857 break;
3858 case DATEOID:
3859 appendStringInfoString(&result, "DATE");
3860 break;
3861 case XMLOID:
3862 appendStringInfoString(&result, "XML");
3863 break;
3864 default:
3865 {
3866 HeapTuple tuple;
3868
3869 tuple = SearchSysCache1(TYPEOID, ObjectIdGetDatum(typeoid));
3870 if (!HeapTupleIsValid(tuple))
3871 elog(ERROR, "cache lookup failed for type %u", typeoid);
3872 typtuple = (Form_pg_type) GETSTRUCT(tuple);
3873
3874 appendStringInfoString(&result,
3875 map_multipart_sql_identifier_to_xml_name((typtuple->typtype == TYPTYPE_DOMAIN) ? "Domain" : "UDT",
3879
3880 ReleaseSysCache(tuple);
3881 }
3882 }
3883
3884 return result.data;
3885}
3886
3887
3888/*
3889 * Map a collection of SQL data types to XML Schema data types; see
3890 * SQL/XML:2008 section 9.7.
3891 */
3892static const char *
3894{
3895 List *uniquetypes = NIL;
3896 int i;
3897 StringInfoData result;
3898 ListCell *cell0;
3899
3900 /* extract all column types used in the set of TupleDescs */
3901 foreach(cell0, tupdesc_list)
3902 {
3903 TupleDesc tupdesc = (TupleDesc) lfirst(cell0);
3904
3905 for (i = 0; i < tupdesc->natts; i++)
3906 {
3908
3909 if (att->attisdropped)
3910 continue;
3912 }
3913 }
3914
3915 /* add base types of domains */
3916 foreach(cell0, uniquetypes)
3917 {
3918 Oid typid = lfirst_oid(cell0);
3919 Oid basetypid = getBaseType(typid);
3920
3921 if (basetypid != typid)
3923 }
3924
3925 /* Convert to textual form */
3926 initStringInfo(&result);
3927
3928 foreach(cell0, uniquetypes)
3929 {
3930 appendStringInfo(&result, "%s\n",
3932 -1));
3933 }
3934
3935 return result.data;
3936}
3937
3938
3939/*
3940 * Map an SQL data type to a named XML Schema data type; see
3941 * SQL/XML:2008 sections 9.5 and 9.6.
3942 *
3943 * (The distinction between 9.5 and 9.6 is basically that 9.6 adds
3944 * a name attribute, which this function does. The name-less version
3945 * 9.5 doesn't appear to be required anywhere.)
3946 */
3947static const char *
3948map_sql_type_to_xmlschema_type(Oid typeoid, int typmod)
3949{
3950 StringInfoData result;
3951 const char *typename = map_sql_type_to_xml_name(typeoid, typmod);
3952
3953 initStringInfo(&result);
3954
3955 if (typeoid == XMLOID)
3956 {
3957 appendStringInfoString(&result,
3958 "<xsd:complexType mixed=\"true\">\n"
3959 " <xsd:sequence>\n"
3960 " <xsd:any name=\"element\" minOccurs=\"0\" maxOccurs=\"unbounded\" processContents=\"skip\"/>\n"
3961 " </xsd:sequence>\n"
3962 "</xsd:complexType>\n");
3963 }
3964 else
3965 {
3966 appendStringInfo(&result,
3967 "<xsd:simpleType name=\"%s\">\n", typename);
3968
3969 switch (typeoid)
3970 {
3971 case BPCHAROID:
3972 case VARCHAROID:
3973 case TEXTOID:
3974 appendStringInfoString(&result,
3975 " <xsd:restriction base=\"xsd:string\">\n");
3976 if (typmod != -1)
3977 appendStringInfo(&result,
3978 " <xsd:maxLength value=\"%d\"/>\n",
3979 typmod - VARHDRSZ);
3980 appendStringInfoString(&result, " </xsd:restriction>\n");
3981 break;
3982
3983 case BYTEAOID:
3984 appendStringInfo(&result,
3985 " <xsd:restriction base=\"xsd:%s\">\n"
3986 " </xsd:restriction>\n",
3987 xmlbinary == XMLBINARY_BASE64 ? "base64Binary" : "hexBinary");
3988 break;
3989
3990 case NUMERICOID:
3991 if (typmod != -1)
3992 appendStringInfo(&result,
3993 " <xsd:restriction base=\"xsd:decimal\">\n"
3994 " <xsd:totalDigits value=\"%d\"/>\n"
3995 " <xsd:fractionDigits value=\"%d\"/>\n"
3996 " </xsd:restriction>\n",
3997 ((typmod - VARHDRSZ) >> 16) & 0xffff,
3998 (typmod - VARHDRSZ) & 0xffff);
3999 break;
4000
4001 case INT2OID:
4002 appendStringInfo(&result,
4003 " <xsd:restriction base=\"xsd:short\">\n"
4004 " <xsd:maxInclusive value=\"%d\"/>\n"
4005 " <xsd:minInclusive value=\"%d\"/>\n"
4006 " </xsd:restriction>\n",
4008 break;
4009
4010 case INT4OID:
4011 appendStringInfo(&result,
4012 " <xsd:restriction base=\"xsd:int\">\n"
4013 " <xsd:maxInclusive value=\"%d\"/>\n"
4014 " <xsd:minInclusive value=\"%d\"/>\n"
4015 " </xsd:restriction>\n",
4016 INT_MAX, INT_MIN);
4017 break;
4018
4019 case INT8OID:
4020 appendStringInfo(&result,
4021 " <xsd:restriction base=\"xsd:long\">\n"
4022 " <xsd:maxInclusive value=\"" INT64_FORMAT "\"/>\n"
4023 " <xsd:minInclusive value=\"" INT64_FORMAT "\"/>\n"
4024 " </xsd:restriction>\n",
4026 PG_INT64_MIN);
4027 break;
4028
4029 case FLOAT4OID:
4030 appendStringInfoString(&result,
4031 " <xsd:restriction base=\"xsd:float\"></xsd:restriction>\n");
4032 break;
4033
4034 case FLOAT8OID:
4035 appendStringInfoString(&result,
4036 " <xsd:restriction base=\"xsd:double\"></xsd:restriction>\n");
4037 break;
4038
4039 case BOOLOID:
4040 appendStringInfoString(&result,
4041 " <xsd:restriction base=\"xsd:boolean\"></xsd:restriction>\n");
4042 break;
4043
4044 case TIMEOID:
4045 case TIMETZOID:
4046 {
4047 const char *tz = (typeoid == TIMETZOID ? "(\\+|-)\\p{Nd}{2}:\\p{Nd}{2}" : "");
4048
4049 if (typmod == -1)
4050 appendStringInfo(&result,
4051 " <xsd:restriction base=\"xsd:time\">\n"
4052 " <xsd:pattern value=\"\\p{Nd}{2}:\\p{Nd}{2}:\\p{Nd}{2}(.\\p{Nd}+)?%s\"/>\n"
4053 " </xsd:restriction>\n", tz);
4054 else if (typmod == 0)
4055 appendStringInfo(&result,
4056 " <xsd:restriction base=\"xsd:time\">\n"
4057 " <xsd:pattern value=\"\\p{Nd}{2}:\\p{Nd}{2}:\\p{Nd}{2}%s\"/>\n"
4058 " </xsd:restriction>\n", tz);
4059 else
4060 appendStringInfo(&result,
4061 " <xsd:restriction base=\"xsd:time\">\n"
4062 " <xsd:pattern value=\"\\p{Nd}{2}:\\p{Nd}{2}:\\p{Nd}{2}.\\p{Nd}{%d}%s\"/>\n"
4063 " </xsd:restriction>\n", typmod - VARHDRSZ, tz);
4064 break;
4065 }
4066
4067 case TIMESTAMPOID:
4068 case TIMESTAMPTZOID:
4069 {
4070 const char *tz = (typeoid == TIMESTAMPTZOID ? "(\\+|-)\\p{Nd}{2}:\\p{Nd}{2}" : "");
4071
4072 if (typmod == -1)
4073 appendStringInfo(&result,
4074 " <xsd:restriction base=\"xsd:dateTime\">\n"
4075 " <xsd:pattern value=\"\\p{Nd}{4}-\\p{Nd}{2}-\\p{Nd}{2}T\\p{Nd}{2}:\\p{Nd}{2}:\\p{Nd}{2}(.\\p{Nd}+)?%s\"/>\n"
4076 " </xsd:restriction>\n", tz);
4077 else if (typmod == 0)
4078 appendStringInfo(&result,
4079 " <xsd:restriction base=\"xsd:dateTime\">\n"
4080 " <xsd:pattern value=\"\\p{Nd}{4}-\\p{Nd}{2}-\\p{Nd}{2}T\\p{Nd}{2}:\\p{Nd}{2}:\\p{Nd}{2}%s\"/>\n"
4081 " </xsd:restriction>\n", tz);
4082 else
4083 appendStringInfo(&result,
4084 " <xsd:restriction base=\"xsd:dateTime\">\n"
4085 " <xsd:pattern value=\"\\p{Nd}{4}-\\p{Nd}{2}-\\p{Nd}{2}T\\p{Nd}{2}:\\p{Nd}{2}:\\p{Nd}{2}.\\p{Nd}{%d}%s\"/>\n"
4086 " </xsd:restriction>\n", typmod - VARHDRSZ, tz);
4087 break;
4088 }
4089
4090 case DATEOID:
4091 appendStringInfoString(&result,
4092 " <xsd:restriction base=\"xsd:date\">\n"
4093 " <xsd:pattern value=\"\\p{Nd}{4}-\\p{Nd}{2}-\\p{Nd}{2}\"/>\n"
4094 " </xsd:restriction>\n");
4095 break;
4096
4097 default:
4098 if (get_typtype(typeoid) == TYPTYPE_DOMAIN)
4099 {
4101 int32 base_typmod = -1;
4102
4103 base_typeoid = getBaseTypeAndTypmod(typeoid, &base_typmod);
4104
4105 appendStringInfo(&result,
4106 " <xsd:restriction base=\"%s\"/>\n",
4108 }
4109 break;
4110 }
4111 appendStringInfoString(&result, "</xsd:simpleType>\n");
4112 }
4113
4114 return result.data;
4115}
4116
4117
4118/*
4119 * Map an SQL row to an XML element, taking the row from the active
4120 * SPI cursor. See also SQL/XML:2008 section 9.10.
4121 */
4122static void
4123SPI_sql_row_to_xmlelement(uint64 rownum, StringInfo result, char *tablename,
4124 bool nulls, bool tableforest,
4125 const char *targetns, bool top_level)
4126{
4127 int i;
4128 char *xmltn;
4129
4130 if (tablename)
4131 xmltn = map_sql_identifier_to_xml_name(tablename, true, false);
4132 else
4133 {
4134 if (tableforest)
4135 xmltn = "row";
4136 else
4137 xmltn = "table";
4138 }
4139
4140 if (tableforest)
4141 xmldata_root_element_start(result, xmltn, NULL, targetns, top_level);
4142 else
4143 appendStringInfoString(result, "<row>\n");
4144
4145 for (i = 1; i <= SPI_tuptable->tupdesc->natts; i++)
4146 {
4147 char *colname;
4148 Datum colval;
4149 bool isnull;
4150
4152 true, false);
4155 i,
4156 &isnull);
4157 if (isnull)
4158 {
4159 if (nulls)
4160 appendStringInfo(result, " <%s xsi:nil=\"true\"/>\n", colname);
4161 }
4162 else
4163 appendStringInfo(result, " <%s>%s</%s>\n",
4164 colname,
4167 colname);
4168 }
4169
4170 if (tableforest)
4171 {
4173 appendStringInfoChar(result, '\n');
4174 }
4175 else
4176 appendStringInfoString(result, "</row>\n\n");
4177}
4178
4179
4180/*
4181 * XPath related functions
4182 */
4183
4184#ifdef USE_LIBXML
4185
4186/*
4187 * Convert XML node to text.
4188 *
4189 * For attribute and text nodes, return the escaped text. For anything else,
4190 * dump the whole subtree.
4191 */
4192static text *
4194{
4195 xmltype *result = NULL;
4196
4197 if (cur->type != XML_ATTRIBUTE_NODE && cur->type != XML_TEXT_NODE)
4198 {
4199 void (*volatile nodefree) (xmlNodePtr) = NULL;
4200 volatile xmlBufferPtr buf = NULL;
4201 volatile xmlNodePtr cur_copy = NULL;
4202
4203 PG_TRY();
4204 {
4205 int bytes;
4206
4207 buf = xmlBufferCreate();
4208 if (buf == NULL || xmlerrcxt->err_occurred)
4210 "could not allocate xmlBuffer");
4211
4212 /*
4213 * Produce a dump of the node that we can serialize. xmlNodeDump
4214 * does that, but the result of that function won't contain
4215 * namespace definitions from ancestor nodes, so we first do a
4216 * xmlCopyNode() which duplicates the node along with its required
4217 * namespace definitions.
4218 *
4219 * Some old libxml2 versions such as 2.7.6 produce partially
4220 * broken XML_DOCUMENT_NODE nodes (unset content field) when
4221 * copying them. xmlNodeDump of such a node works fine, but
4222 * xmlFreeNode crashes; set us up to call xmlFreeDoc instead.
4223 */
4224 cur_copy = xmlCopyNode(cur, 1);
4225 if (cur_copy == NULL || xmlerrcxt->err_occurred)
4227 "could not copy node");
4228 nodefree = (cur_copy->type == XML_DOCUMENT_NODE) ?
4229 (void (*) (xmlNodePtr)) xmlFreeDoc : xmlFreeNode;
4230
4231 bytes = xmlNodeDump(buf, NULL, cur_copy, 0, 0);
4232 if (bytes == -1 || xmlerrcxt->err_occurred)
4234 "could not dump node");
4235
4236 result = xmlBuffer_to_xmltype(buf);
4237 }
4238 PG_FINALLY();
4239 {
4240 if (nodefree)
4242 if (buf)
4244 }
4245 PG_END_TRY();
4246 }
4247 else
4248 {
4249 volatile xmlChar *str = NULL;
4250
4251 PG_TRY();
4252 {
4253 char *escaped;
4254
4256 if (str == NULL || xmlerrcxt->err_occurred)
4258 "could not allocate xmlChar");
4259
4260 /* Here we rely on XML having the same representation as TEXT */
4261 escaped = escape_xml((char *) str);
4262
4263 result = (xmltype *) cstring_to_text(escaped);
4264 pfree(escaped);
4265 }
4266 PG_FINALLY();
4267 {
4268 if (str)
4269 xmlFree((xmlChar *) str);
4270 }
4271 PG_END_TRY();
4272 }
4273
4274 return result;
4275}
4276
4277/*
4278 * Convert an XML XPath object (the result of evaluating an XPath expression)
4279 * to an array of xml values, which are appended to astate. The function
4280 * result value is the number of elements in the array.
4281 *
4282 * If "astate" is NULL then we don't generate the array value, but we still
4283 * return the number of elements it would have had.
4284 *
4285 * Nodesets are converted to an array containing the nodes' textual
4286 * representations. Primitive values (float, double, string) are converted
4287 * to a single-element array containing the value's string representation.
4288 */
4289static int
4291 ArrayBuildState *astate,
4293{
4294 int result = 0;
4295 Datum datum;
4296 Oid datumtype;
4297 char *result_str;
4298
4299 switch (xpathobj->type)
4300 {
4301 case XPATH_NODESET:
4302 if (xpathobj->nodesetval != NULL)
4303 {
4304 result = xpathobj->nodesetval->nodeNr;
4305 if (astate != NULL)
4306 {
4307 int i;
4308
4309 for (i = 0; i < result; i++)
4310 {
4311 datum = PointerGetDatum(xml_xmlnodetoxmltype(xpathobj->nodesetval->nodeTab[i],
4312 xmlerrcxt));
4313 (void) accumArrayResult(astate, datum, false,
4315 }
4316 }
4317 }
4318 return result;
4319
4320 case XPATH_BOOLEAN:
4321 if (astate == NULL)
4322 return 1;
4323 datum = BoolGetDatum(xpathobj->boolval);
4325 break;
4326
4327 case XPATH_NUMBER:
4328 if (astate == NULL)
4329 return 1;
4330 datum = Float8GetDatum(xpathobj->floatval);
4332 break;
4333
4334 case XPATH_STRING:
4335 if (astate == NULL)
4336 return 1;
4337 datum = CStringGetDatum((char *) xpathobj->stringval);
4339 break;
4340
4341 default:
4342 elog(ERROR, "xpath expression result type %d is unsupported",
4343 xpathobj->type);
4344 return 0; /* keep compiler quiet */
4345 }
4346
4347 /* Common code for scalar-value cases */
4350 (void) accumArrayResult(astate, datum, false,
4352 return 1;
4353}
4354
4355
4356/*
4357 * Common code for xpath() and xmlexists()
4358 *
4359 * Evaluate XPath expression and return number of nodes in res_nitems
4360 * and array of XML values in astate. Either of those pointers can be
4361 * NULL if the corresponding result isn't wanted.
4362 *
4363 * It is up to the user to ensure that the XML passed is in fact
4364 * an XML document - XPath doesn't work easily on fragments without
4365 * a context node being known.
4366 */
4367static void
4369 int *res_nitems, ArrayBuildState *astate)
4370{
4372 volatile xmlParserCtxtPtr ctxt = NULL;
4373 volatile xmlDocPtr doc = NULL;
4374 volatile xmlXPathContextPtr xpathctx = NULL;
4376 volatile xmlXPathObjectPtr xpathobj = NULL;
4377 char *datastr;
4378 int32 len;
4380 xmlChar *string;
4382 size_t xmldecl_len = 0;
4383 int i;
4384 int ndim;
4386 bool *ns_names_uris_nulls;
4387 int ns_count;
4388
4389 /*
4390 * Namespace mappings are passed as text[]. If an empty array is passed
4391 * (ndim = 0, "0-dimensional"), then there are no namespace mappings.
4392 * Else, a 2-dimensional array with length of the second axis being equal
4393 * to 2 should be passed, i.e., every subarray contains 2 elements, the
4394 * first element defining the name, the second one the URI. Example:
4395 * ARRAY[ARRAY['myns', 'http://example.com'], ARRAY['myns2',
4396 * 'http://example2.com']].
4397 */
4398 ndim = namespaces ? ARR_NDIM(namespaces) : 0;
4399 if (ndim != 0)
4400 {
4401 int *dims;
4402
4403 dims = ARR_DIMS(namespaces);
4404
4405 if (ndim != 2 || dims[1] != 2)
4406 ereport(ERROR,
4408 errmsg("invalid array for XML namespace mapping"),
4409 errdetail("The array must be two-dimensional with length of the second axis equal to 2.")));
4410
4411 Assert(ARR_ELEMTYPE(namespaces) == TEXTOID);
4412
4415 &ns_count);
4416
4417 Assert((ns_count % 2) == 0); /* checked above */
4418 ns_count /= 2; /* count pairs only */
4419 }
4420 else
4421 {
4424 ns_count = 0;
4425 }
4426
4427 datastr = VARDATA(data);
4428 len = VARSIZE(data) - VARHDRSZ;
4430 if (xpath_len == 0)
4431 ereport(ERROR,
4433 errmsg("empty XPath expression")));
4434
4435 string = pg_xmlCharStrndup(datastr, len);
4437
4438 /*
4439 * In a UTF8 database, skip any xml declaration, which might assert
4440 * another encoding. Ignore parse_xml_decl() failure, letting
4441 * xmlCtxtReadMemory() report parse errors. Documentation disclaims
4442 * xpath() support for non-ASCII data in non-UTF8 databases, so leave
4443 * those scenarios bug-compatible with historical behavior.
4444 */
4447
4449
4450 PG_TRY();
4451 {
4452 xmlInitParser();
4453
4454 /*
4455 * redundant XML parsing (two parsings for the same value during one
4456 * command execution are possible)
4457 */
4458 ctxt = xmlNewParserCtxt();
4459 if (ctxt == NULL || xmlerrcxt->err_occurred)
4461 "could not allocate parser context");
4462 doc = xmlCtxtReadMemory(ctxt, (char *) string + xmldecl_len,
4463 len - xmldecl_len, NULL, NULL, 0);
4464 if (doc == NULL || xmlerrcxt->err_occurred)
4466 "could not parse XML document");
4468 if (xpathctx == NULL || xmlerrcxt->err_occurred)
4470 "could not allocate XPath context");
4471 xpathctx->node = (xmlNodePtr) doc;
4472
4473 /* register namespaces, if any */
4474 if (ns_count > 0)
4475 {
4476 for (i = 0; i < ns_count; i++)
4477 {
4478 char *ns_name;
4479 char *ns_uri;
4480
4481 if (ns_names_uris_nulls[i * 2] ||
4482 ns_names_uris_nulls[i * 2 + 1])
4483 ereport(ERROR,
4485 errmsg("neither namespace name nor URI may be null")));
4489 (xmlChar *) ns_name,
4490 (xmlChar *) ns_uri) != 0)
4491 ereport(ERROR, /* is this an internal error??? */
4492 (errmsg("could not register XML namespace with name \"%s\" and URI \"%s\"",
4493 ns_name, ns_uri)));
4494 }
4495 }
4496
4497 /*
4498 * Note: here and elsewhere, be careful to use xmlXPathCtxtCompile not
4499 * xmlXPathCompile. In libxml2 2.13.3 and older, the latter function
4500 * fails to defend itself against recursion-to-stack-overflow. See
4501 * https://gitlab.gnome.org/GNOME/libxml2/-/issues/799
4502 */
4504 if (xpathcomp == NULL || xmlerrcxt->err_occurred)
4506 "invalid XPath expression");
4507
4508 /*
4509 * Version 2.6.27 introduces a function named
4510 * xmlXPathCompiledEvalToBoolean, which would be enough for xmlexists,
4511 * but we can derive the existence by whether any nodes are returned,
4512 * thereby preventing a library version upgrade and keeping the code
4513 * the same.
4514 */
4516 if (xpathobj == NULL || xmlerrcxt->err_occurred)
4518 "could not create XPath object");
4519
4520 /*
4521 * Extract the results as requested.
4522 */
4523 if (res_nitems != NULL)
4525 else
4526 (void) xml_xpathobjtoxmlarray(xpathobj, astate, xmlerrcxt);
4527 }
4528 PG_CATCH();
4529 {
4530 if (xpathobj)
4532 if (xpathcomp)
4534 if (xpathctx)
4536 if (doc)
4537 xmlFreeDoc(doc);
4538 if (ctxt)
4539 xmlFreeParserCtxt(ctxt);
4540
4541 pg_xml_done(xmlerrcxt, true);
4542
4543 PG_RE_THROW();
4544 }
4545 PG_END_TRY();
4546
4550 xmlFreeDoc(doc);
4551 xmlFreeParserCtxt(ctxt);
4552
4553 pg_xml_done(xmlerrcxt, false);
4554}
4555#endif /* USE_LIBXML */
4556
4557/*
4558 * Evaluate XPath expression and return array of XML values.
4559 *
4560 * As we have no support of XQuery sequences yet, this function seems
4561 * to be the most useful one (array of XML functions plays a role of
4562 * some kind of substitution for XQuery sequences).
4563 */
4564Datum
4566{
4567#ifdef USE_LIBXML
4570 ArrayType *namespaces = PG_GETARG_ARRAYTYPE_P(2);
4571 ArrayBuildState *astate;
4572
4574 xpath_internal(xpath_expr_text, data, namespaces,
4575 NULL, astate);
4577#else
4579 return 0;
4580#endif
4581}
4582
4583/*
4584 * Determines if the node specified by the supplied XPath exists
4585 * in a given XML document, returning a boolean.
4586 */
4587Datum
4589{
4590#ifdef USE_LIBXML
4593 int res_nitems;
4594
4596 &res_nitems, NULL);
4597
4599#else
4601 return 0;
4602#endif
4603}
4604
4605/*
4606 * Determines if the node specified by the supplied XPath exists
4607 * in a given XML document, returning a boolean. Differs from
4608 * xmlexists as it supports namespaces and is not defined in SQL/XML.
4609 */
4610Datum
4612{
4613#ifdef USE_LIBXML
4616 ArrayType *namespaces = PG_GETARG_ARRAYTYPE_P(2);
4617 int res_nitems;
4618
4619 xpath_internal(xpath_expr_text, data, namespaces,
4620 &res_nitems, NULL);
4621
4623#else
4625 return 0;
4626#endif
4627}
4628
4629/*
4630 * Functions for checking well-formed-ness
4631 */
4632
4633#ifdef USE_LIBXML
4634static bool
4636{
4637 xmlDocPtr doc;
4639
4640 /*
4641 * We'll report "true" if no soft error is reported by xml_parse().
4642 */
4644 GetDatabaseEncoding(), NULL, NULL, (Node *) &escontext);
4645 if (doc)
4646 xmlFreeDoc(doc);
4647
4648 return !escontext.error_occurred;
4649}
4650#endif
4651
4652Datum
4654{
4655#ifdef USE_LIBXML
4657
4659#else
4661 return 0;
4662#endif /* not USE_LIBXML */
4663}
4664
4665Datum
4667{
4668#ifdef USE_LIBXML
4670
4672#else
4674 return 0;
4675#endif /* not USE_LIBXML */
4676}
4677
4678Datum
4680{
4681#ifdef USE_LIBXML
4683
4685#else
4687 return 0;
4688#endif /* not USE_LIBXML */
4689}
4690
4691/*
4692 * support functions for XMLTABLE
4693 *
4694 */
4695#ifdef USE_LIBXML
4696
4697/*
4698 * Returns private data from executor state. Ensure validity by check with
4699 * MAGIC number.
4700 */
4701static inline XmlTableBuilderData *
4703{
4704 XmlTableBuilderData *result;
4705
4707 elog(ERROR, "%s called with invalid TableFuncScanState", fname);
4708 result = (XmlTableBuilderData *) state->opaque;
4709 if (result->magic != XMLTABLE_CONTEXT_MAGIC)
4710 elog(ERROR, "%s called with invalid TableFuncScanState", fname);
4711
4712 return result;
4713}
4714#endif
4715
4716/*
4717 * XmlTableInitOpaque
4718 * Fill in TableFuncScanState->opaque for XmlTable processor; initialize
4719 * the XML parser.
4720 *
4721 * Note: Because we call pg_xml_init() here and pg_xml_done() in
4722 * XmlTableDestroyOpaque, it is critical for robustness that no other
4723 * executor nodes run until this node is processed to completion. Caller
4724 * must execute this to completion (probably filling a tuplestore to exhaust
4725 * this node in a single pass) instead of using row-per-call mode.
4726 */
4727static void
4729{
4730#ifdef USE_LIBXML
4731 volatile xmlParserCtxtPtr ctxt = NULL;
4734
4737 xtCxt->natts = natts;
4738 xtCxt->xpathscomp = palloc0_array(xmlXPathCompExprPtr, natts);
4739
4741
4742 PG_TRY();
4743 {
4744 xmlInitParser();
4745
4746 ctxt = xmlNewParserCtxt();
4747 if (ctxt == NULL || xmlerrcxt->err_occurred)
4749 "could not allocate parser context");
4750 }
4751 PG_CATCH();
4752 {
4753 if (ctxt != NULL)
4754 xmlFreeParserCtxt(ctxt);
4755
4756 pg_xml_done(xmlerrcxt, true);
4757
4758 PG_RE_THROW();
4759 }
4760 PG_END_TRY();
4761
4762 xtCxt->xmlerrcxt = xmlerrcxt;
4763 xtCxt->ctxt = ctxt;
4764
4765 state->opaque = xtCxt;
4766#else
4768#endif /* not USE_LIBXML */
4769}
4770
4771/*
4772 * XmlTableSetDocument
4773 * Install the input document
4774 */
4775static void
4777{
4778#ifdef USE_LIBXML
4781 char *str;
4782 xmlChar *xstr;
4783 int length;
4784 volatile xmlDocPtr doc = NULL;
4785 volatile xmlXPathContextPtr xpathcxt = NULL;
4786
4787 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableSetDocument");
4788
4789 /*
4790 * Use out function for casting to string (remove encoding property). See
4791 * comment in xml_out.
4792 */
4794
4795 length = strlen(str);
4796 xstr = pg_xmlCharStrndup(str, length);
4797
4798 PG_TRY();
4799 {
4800 doc = xmlCtxtReadMemory(xtCxt->ctxt, (char *) xstr, length, NULL, NULL, 0);
4801 if (doc == NULL || xtCxt->xmlerrcxt->err_occurred)
4803 "could not parse XML document");
4805 if (xpathcxt == NULL || xtCxt->xmlerrcxt->err_occurred)
4807 "could not allocate XPath context");
4808 xpathcxt->node = (xmlNodePtr) doc;
4809 }
4810 PG_CATCH();
4811 {
4812 if (xpathcxt != NULL)
4814 if (doc != NULL)
4815 xmlFreeDoc(doc);
4816
4817 PG_RE_THROW();
4818 }
4819 PG_END_TRY();
4820
4821 xtCxt->doc = doc;
4822 xtCxt->xpathcxt = xpathcxt;
4823#else
4825#endif /* not USE_LIBXML */
4826}
4827
4828/*
4829 * XmlTableSetNamespace
4830 * Add a namespace declaration
4831 */
4832static void
4833XmlTableSetNamespace(TableFuncScanState *state, const char *name, const char *uri)
4834{
4835#ifdef USE_LIBXML
4837
4838 if (name == NULL)
4839 ereport(ERROR,
4841 errmsg("DEFAULT namespace is not supported")));
4842 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableSetNamespace");
4843
4844 if (xmlXPathRegisterNs(xtCxt->xpathcxt,
4848 "could not set XML namespace");
4849#else
4851#endif /* not USE_LIBXML */
4852}
4853
4854/*
4855 * XmlTableSetRowFilter
4856 * Install the row-filter Xpath expression.
4857 */
4858static void
4860{
4861#ifdef USE_LIBXML
4863 xmlChar *xstr;
4864
4865 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableSetRowFilter");
4866
4867 if (*path == '\0')
4868 ereport(ERROR,
4870 errmsg("row path filter must not be empty string")));
4871
4872 xstr = pg_xmlCharStrndup(path, strlen(path));
4873
4874 /* We require XmlTableSetDocument to have been done already */
4875 Assert(xtCxt->xpathcxt != NULL);
4876
4877 xtCxt->xpathcomp = xmlXPathCtxtCompile(xtCxt->xpathcxt, xstr);
4878 if (xtCxt->xpathcomp == NULL || xtCxt->xmlerrcxt->err_occurred)
4880 "invalid XPath expression");
4881#else
4883#endif /* not USE_LIBXML */
4884}
4885
4886/*
4887 * XmlTableSetColumnFilter
4888 * Install the column-filter Xpath expression, for the given column.
4889 */
4890static void
4891XmlTableSetColumnFilter(TableFuncScanState *state, const char *path, int colnum)
4892{
4893#ifdef USE_LIBXML
4895 xmlChar *xstr;
4896
4897 Assert(path);
4898
4899 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableSetColumnFilter");
4900
4901 if (*path == '\0')
4902 ereport(ERROR,
4904 errmsg("column path filter must not be empty string")));
4905
4906 xstr = pg_xmlCharStrndup(path, strlen(path));
4907
4908 /* We require XmlTableSetDocument to have been done already */
4909 Assert(xtCxt->xpathcxt != NULL);
4910
4911 xtCxt->xpathscomp[colnum] = xmlXPathCtxtCompile(xtCxt->xpathcxt, xstr);
4912 if (xtCxt->xpathscomp[colnum] == NULL || xtCxt->xmlerrcxt->err_occurred)
4914 "invalid XPath expression");
4915#else
4917#endif /* not USE_LIBXML */
4918}
4919
4920/*
4921 * XmlTableFetchRow
4922 * Prepare the next "current" tuple for upcoming GetValue calls.
4923 * Returns false if the row-filter expression returned no more rows.
4924 */
4925static bool
4927{
4928#ifdef USE_LIBXML
4930
4931 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableFetchRow");
4932
4933 /* Propagate our own error context to libxml2 */
4935
4936 if (xtCxt->xpathobj == NULL)
4937 {
4938 xtCxt->xpathobj = xmlXPathCompiledEval(xtCxt->xpathcomp, xtCxt->xpathcxt);
4939 if (xtCxt->xpathobj == NULL || xtCxt->xmlerrcxt->err_occurred)
4941 "could not create XPath object");
4942
4943 xtCxt->row_count = 0;
4944 }
4945
4946 if (xtCxt->xpathobj->type == XPATH_NODESET)
4947 {
4948 if (xtCxt->xpathobj->nodesetval != NULL)
4949 {
4950 if (xtCxt->row_count++ < xtCxt->xpathobj->nodesetval->nodeNr)
4951 return true;
4952 }
4953 }
4954
4955 return false;
4956#else
4958 return false;
4959#endif /* not USE_LIBXML */
4960}
4961
4962/*
4963 * XmlTableGetValue
4964 * Return the value for column number 'colnum' for the current row. If
4965 * column -1 is requested, return representation of the whole row.
4966 *
4967 * This leaks memory, so be sure to reset often the context in which it's
4968 * called.
4969 */
4970static Datum
4972 Oid typid, int32 typmod, bool *isnull)
4973{
4974#ifdef USE_LIBXML
4975 Datum result = (Datum) 0;
4977 volatile xmlXPathObjectPtr xpathobj = NULL;
4978
4979 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableGetValue");
4980
4981 Assert(xtCxt->xpathobj &&
4982 xtCxt->xpathobj->type == XPATH_NODESET &&
4983 xtCxt->xpathobj->nodesetval != NULL);
4984
4985 /* Propagate our own error context to libxml2 */
4987
4988 *isnull = false;
4989
4990 Assert(xtCxt->xpathscomp[colnum] != NULL);
4991
4992 PG_TRY();
4993 {
4995 char *cstr = NULL;
4996
4997 /* Set current node as entry point for XPath evaluation */
4998 cur = xtCxt->xpathobj->nodesetval->nodeTab[xtCxt->row_count - 1];
4999 xtCxt->xpathcxt->node = cur;
5000
5001 /* Evaluate column path */
5002 xpathobj = xmlXPathCompiledEval(xtCxt->xpathscomp[colnum], xtCxt->xpathcxt);
5003 if (xpathobj == NULL || xtCxt->xmlerrcxt->err_occurred)
5005 "could not create XPath object");
5006
5007 /*
5008 * There are four possible cases, depending on the number of nodes
5009 * returned by the XPath expression and the type of the target column:
5010 * a) XPath returns no nodes. b) The target type is XML (return all
5011 * as XML). For non-XML return types: c) One node (return content).
5012 * d) Multiple nodes (error).
5013 */
5014 if (xpathobj->type == XPATH_NODESET)
5015 {
5016 int count = 0;
5017
5018 if (xpathobj->nodesetval != NULL)
5019 count = xpathobj->nodesetval->nodeNr;
5020
5021 if (xpathobj->nodesetval == NULL || count == 0)
5022 {
5023 *isnull = true;
5024 }
5025 else
5026 {
5027 if (typid == XMLOID)
5028 {
5029 text *textstr;
5031
5032 /* Concatenate serialized values */
5034 for (int i = 0; i < count; i++)
5035 {
5036 textstr =
5037 xml_xmlnodetoxmltype(xpathobj->nodesetval->nodeTab[i],
5038 xtCxt->xmlerrcxt);
5039
5041 }
5042 cstr = str.data;
5043 }
5044 else
5045 {
5046 xmlChar *str;
5047
5048 if (count > 1)
5049 ereport(ERROR,
5051 errmsg("more than one value returned by column XPath expression")));
5052
5054 cstr = str ? xml_pstrdup_and_free(str) : "";
5055 }
5056 }
5057 }
5058 else if (xpathobj->type == XPATH_STRING)
5059 {
5060 /* Content should be escaped when target will be XML */
5061 if (typid == XMLOID)
5062 cstr = escape_xml((char *) xpathobj->stringval);
5063 else
5064 cstr = (char *) xpathobj->stringval;
5065 }
5066 else if (xpathobj->type == XPATH_BOOLEAN)
5067 {
5068 char typcategory;
5069 bool typispreferred;
5070 xmlChar *str;
5071
5072 /* Allow implicit casting from boolean to numbers */
5074
5077 else
5079
5081 }
5082 else if (xpathobj->type == XPATH_NUMBER)
5083 {
5084 xmlChar *str;
5085
5088 }
5089 else
5090 elog(ERROR, "unexpected XPath object type %u", xpathobj->type);
5091
5092 /*
5093 * By here, either cstr contains the result value, or the isnull flag
5094 * has been set.
5095 */
5096 Assert(cstr || *isnull);
5097
5098 if (!*isnull)
5099 result = InputFunctionCall(&state->in_functions[colnum],
5100 cstr,
5101 state->typioparams[colnum],
5102 typmod);
5103 }
5104 PG_FINALLY();
5105 {
5106 if (xpathobj != NULL)
5108 }
5109 PG_END_TRY();
5110
5111 return result;
5112#else
5114 return 0;
5115#endif /* not USE_LIBXML */
5116}
5117
5118/*
5119 * XmlTableDestroyOpaque
5120 * Release all libxml2 resources
5121 */
5122static void
5124{
5125#ifdef USE_LIBXML
5127
5128 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableDestroyOpaque");
5129
5130 /* Propagate our own error context to libxml2 */
5132
5133 if (xtCxt->xpathscomp != NULL)
5134 {
5135 int i;
5136
5137 for (i = 0; i < xtCxt->natts; i++)
5138 if (xtCxt->xpathscomp[i] != NULL)
5139 xmlXPathFreeCompExpr(xtCxt->xpathscomp[i]);
5140 }
5141
5142 if (xtCxt->xpathobj != NULL)
5143 xmlXPathFreeObject(xtCxt->xpathobj);
5144 if (xtCxt->xpathcomp != NULL)
5145 xmlXPathFreeCompExpr(xtCxt->xpathcomp);
5146 if (xtCxt->xpathcxt != NULL)
5147 xmlXPathFreeContext(xtCxt->xpathcxt);
5148 if (xtCxt->doc != NULL)
5149 xmlFreeDoc(xtCxt->doc);
5150 if (xtCxt->ctxt != NULL)
5151 xmlFreeParserCtxt(xtCxt->ctxt);
5152
5153 pg_xml_done(xtCxt->xmlerrcxt, true);
5154
5155 /* not valid anymore */
5156 xtCxt->magic = 0;
5157 state->opaque = NULL;
5158
5159#else
5161#endif /* not USE_LIBXML */
5162}
#define ARR_NDIM(a)
Definition array.h:290
#define PG_GETARG_ARRAYTYPE_P(n)
Definition array.h:263
#define DatumGetArrayTypeP(X)
Definition array.h:261
#define ARR_ELEMTYPE(a)
Definition array.h:292
#define ARR_DIMS(a)
Definition array.h:294
ArrayBuildState * accumArrayResult(ArrayBuildState *astate, Datum dvalue, bool disnull, Oid element_type, MemoryContext rcontext)
ArrayBuildState * initArrayResult(Oid element_type, MemoryContext rcontext, bool subcontext)
void deconstruct_array_builtin(const ArrayType *array, Oid elmtype, Datum **elemsp, bool **nullsp, int *nelemsp)
Datum makeArrayResult(ArrayBuildState *astate, MemoryContext rcontext)
void deconstruct_array(const ArrayType *array, Oid elmtype, int elmlen, bool elmbyval, char elmalign, Datum **elemsp, bool **nullsp, int *nelemsp)
void j2date(int jd, int *year, int *month, int *day)
Definition datetime.c:321
void EncodeDateTime(struct pg_tm *tm, fsec_t fsec, bool print_tz, int tz, const char *tzn, int style, char *str)
Definition datetime.c:4464
void EncodeDateOnly(struct pg_tm *tm, int style, char *str)
Definition datetime.c:4349
int timestamp2tm(Timestamp dt, int *tzp, struct pg_tm *tm, fsec_t *fsec, const char **tzn, pg_tz *attimezone)
Definition timestamp.c:1910
#define TextDatumGetCString(d)
Definition builtins.h:99
#define NameStr(name)
Definition c.h:777
#define gettext_noop(x)
Definition c.h:1213
#define INT64_FORMAT
Definition c.h:576
#define VARHDRSZ
Definition c.h:723
#define Assert(condition)
Definition c.h:885
int16_t int16
Definition c.h:553
#define CppAsString2(x)
Definition c.h:440
int32_t int32
Definition c.h:554
#define PG_INT64_MAX
Definition c.h:618
#define PG_INT64_MIN
Definition c.h:617
uint64_t uint64
Definition c.h:559
#define pg_fallthrough
Definition c.h:144
#define OidIsValid(objectId)
Definition c.h:800
int nspid
int64 Timestamp
Definition timestamp.h:38
int64 TimestampTz
Definition timestamp.h:39
int32 fsec_t
Definition timestamp.h:41
#define TIMESTAMP_NOT_FINITE(j)
Definition timestamp.h:169
#define POSTGRES_EPOCH_JDATE
Definition timestamp.h:235
#define DATE_NOT_FINITE(j)
Definition date.h:49
int32 DateADT
Definition date.h:21
static DateADT DatumGetDateADT(Datum X)
Definition date.h:60
struct cursor * cur
Definition ecpg.c:29
Datum arg
Definition elog.c:1322
#define PG_RE_THROW()
Definition elog.h:405
#define errsave(context,...)
Definition elog.h:262
int int errdetail_internal(const char *fmt,...) pg_attribute_printf(1
int errhint(const char *fmt,...) pg_attribute_printf(1
#define FATAL
Definition elog.h:41
int int errmsg_internal(const char *fmt,...) pg_attribute_printf(1
#define PG_TRY(...)
Definition elog.h:372
#define WARNING
Definition elog.h:36
#define PG_END_TRY(...)
Definition elog.h:397
#define PG_CATCH(...)
Definition elog.h:382
#define elog(elevel,...)
Definition elog.h:226
#define NOTICE
Definition elog.h:35
#define PG_FINALLY(...)
Definition elog.h:389
#define palloc_object(type)
Definition fe_memutils.h:74
#define palloc0_array(type, count)
Definition fe_memutils.h:77
#define palloc0_object(type)
Definition fe_memutils.h:75
Datum InputFunctionCall(FmgrInfo *flinfo, char *str, Oid typioparam, int32 typmod)
Definition fmgr.c:1531
char * OidOutputFunctionCall(Oid functionId, Datum val)
Definition fmgr.c:1763
#define PG_GETARG_OID(n)
Definition fmgr.h:275
#define PG_GETARG_TEXT_PP(n)
Definition fmgr.h:310
#define PG_RETURN_BYTEA_P(x)
Definition fmgr.h:373
#define DatumGetByteaPP(X)
Definition fmgr.h:292
#define PG_GETARG_POINTER(n)
Definition fmgr.h:277
#define PG_RETURN_CSTRING(x)
Definition fmgr.h:364
#define PG_ARGISNULL(n)
Definition fmgr.h:209
#define DirectFunctionCall1(func, arg1)
Definition fmgr.h:684
#define PG_GETARG_CSTRING(n)
Definition fmgr.h:278
#define PG_RETURN_NULL()
Definition fmgr.h:346
#define PG_GETARG_NAME(n)
Definition fmgr.h:279
#define PG_RETURN_TEXT_P(x)
Definition fmgr.h:374
#define PG_GETARG_INT32(n)
Definition fmgr.h:269
#define PG_GETARG_BOOL(n)
Definition fmgr.h:274
#define PG_RETURN_DATUM(x)
Definition fmgr.h:354
#define PG_FUNCTION_ARGS
Definition fmgr.h:193
#define PG_RETURN_BOOL(x)
Definition fmgr.h:360
Oid MyDatabaseId
Definition globals.c:94
const char * str
#define HeapTupleIsValid(tuple)
Definition htup.h:78
static void * GETSTRUCT(const HeapTupleData *tuple)
#define MAXDATELEN
Definition datetime.h:200
#define ident
#define newline
FILE * input
static struct @174 value
static char * encoding
Definition initdb.c:139
int b
Definition isn.c:74
int x
Definition isn.c:75
int a
Definition isn.c:73
int i
Definition isn.c:77
List * lappend(List *list, void *datum)
Definition list.c:339
List * lappend_oid(List *list, Oid datum)
Definition list.c:375
List * list_append_unique_oid(List *list, Oid datum)
Definition list.c:1380
static struct pg_tm tm
Definition localtime.c:104
#define NoLock
Definition lockdefs.h:34
#define AccessShareLock
Definition lockdefs.h:36
char * get_rel_name(Oid relid)
Definition lsyscache.c:2078
char * get_database_name(Oid dbid)
Definition lsyscache.c:1242
void getTypeOutputInfo(Oid type, Oid *typOutput, bool *typIsVarlena)
Definition lsyscache.c:3059
void get_typlenbyvalalign(Oid typid, int16 *typlen, bool *typbyval, char *typalign)
Definition lsyscache.c:2421
char get_typtype(Oid typid)
Definition lsyscache.c:2781
Oid getBaseTypeAndTypmod(Oid typid, int32 *typmod)
Definition lsyscache.c:2690
Oid getBaseType(Oid typid)
Definition lsyscache.c:2673
char * get_namespace_name(Oid nspid)
Definition lsyscache.c:3518
void get_type_category_preferred(Oid typid, char *typcategory, bool *typispreferred)
Definition lsyscache.c:2862
#define type_is_array_domain(typid)
Definition lsyscache.h:216
#define PG_UTF8
Definition mbprint.c:43
unsigned int pg_wchar
Definition mbprint.c:31
int GetDatabaseEncoding(void)
Definition mbutils.c:1389
int pg_mblen_cstr(const char *mbstr)
Definition mbutils.c:1045
char * pg_any_to_server(const char *s, int len, int encoding)
Definition mbutils.c:687
unsigned char * pg_do_encoding_conversion(unsigned char *src, int len, int src_encoding, int dest_encoding)
Definition mbutils.c:365
int pg_get_client_encoding(void)
Definition mbutils.c:345
void pg_unicode_to_server(char32_t c, unsigned char *s)
Definition mbutils.c:875
char * pg_server_to_any(const char *s, int len, int encoding)
Definition mbutils.c:760
int pg_encoding_mb2wchar_with_len(int encoding, const char *from, pg_wchar *to, int len)
Definition mbutils.c:1004
char * MemoryContextStrdup(MemoryContext context, const char *string)
Definition mcxt.c:1768
void * MemoryContextAlloc(MemoryContext context, Size size)
Definition mcxt.c:1232
char * pstrdup(const char *in)
Definition mcxt.c:1781
void * repalloc(void *pointer, Size size)
Definition mcxt.c:1632
void pfree(void *pointer)
Definition mcxt.c:1616
MemoryContext TopMemoryContext
Definition mcxt.c:166
void * palloc(Size size)
Definition mcxt.c:1387
MemoryContext CurrentMemoryContext
Definition mcxt.c:160
#define AllocSetContextCreate
Definition memutils.h:129
#define ALLOCSET_DEFAULT_SIZES
Definition memutils.h:160
#define USE_XSD_DATES
Definition miscadmin.h:240
Oid LookupExplicitNamespace(const char *nspname, bool missing_ok)
Definition namespace.c:3457
Oid exprType(const Node *expr)
Definition nodeFuncs.c:42
#define IsA(nodeptr, _type_)
Definition nodes.h:164
FormData_pg_attribute * Form_pg_attribute
#define ERRCODE_DATA_CORRUPTED
NameData relname
Definition pg_class.h:40
FormData_pg_class * Form_pg_class
Definition pg_class.h:160
const void size_t len
const void * data
#define lfirst(lc)
Definition pg_list.h:172
#define NIL
Definition pg_list.h:68
#define forboth(cell1, list1, cell2, list2)
Definition pg_list.h:518
#define list_make1(x1)
Definition pg_list.h:212
#define lfirst_oid(lc)
Definition pg_list.h:174
#define list_make2(x1, x2)
Definition pg_list.h:214
#define plan(x)
Definition pg_regress.c:161
static char buf[DEFAULT_XLOG_SEG_SIZE]
END_CATALOG_STRUCT typedef FormData_pg_type * Form_pg_type
Definition pg_type.h:265
NameData typname
Definition pg_type.h:43
#define MAX_MULTIBYTE_CHAR_LEN
Definition pg_wchar.h:33
pg_enc
Definition pg_wchar.h:225
#define MAX_UNICODE_EQUIVALENT_STRING
Definition pg_wchar.h:329
#define pg_encoding_to_char
Definition pg_wchar.h:630
#define pg_char_to_encoding
Definition pg_wchar.h:629
long date
Definition pgtypes_date.h:9
int64 timestamp
int pg_strcasecmp(const char *s1, const char *s2)
int pg_strncasecmp(const char *s1, const char *s2, size_t n)
static bool DatumGetBool(Datum X)
Definition postgres.h:100
static Datum PointerGetDatum(const void *X)
Definition postgres.h:352
static Oid DatumGetObjectId(Datum X)
Definition postgres.h:252
static Datum BoolGetDatum(bool X)
Definition postgres.h:112
static Datum ObjectIdGetDatum(Oid X)
Definition postgres.h:262
static char * DatumGetCString(Datum X)
Definition postgres.h:365
uint64_t Datum
Definition postgres.h:70
static Datum Float8GetDatum(float8 X)
Definition postgres.h:512
static Datum CStringGetDatum(const char *X)
Definition postgres.h:380
#define InvalidOid
unsigned int Oid
void pq_sendtext(StringInfo buf, const char *str, int slen)
Definition pqformat.c:172
void pq_begintypsend(StringInfo buf)
Definition pqformat.c:325
const char * pq_getmsgbytes(StringInfo msg, int datalen)
Definition pqformat.c:507
bytea * pq_endtypsend(StringInfo buf)
Definition pqformat.c:345
char * c
e
char string[11]
XmlOptionType
Definition primnodes.h:1617
@ XMLOPTION_CONTENT
Definition primnodes.h:1619
@ XMLOPTION_DOCUMENT
Definition primnodes.h:1618
tree ctl root
Definition radixtree.h:1857
Datum regclassout(PG_FUNCTION_ARGS)
Definition regproc.c:951
uint64 SPI_processed
Definition spi.c:44
Oid SPI_gettypeid(TupleDesc tupdesc, int fnumber)
Definition spi.c:1308
const char * SPI_result_code_string(int code)
Definition spi.c:1972
SPITupleTable * SPI_tuptable
Definition spi.c:45
Portal SPI_cursor_find(const char *name)
Definition spi.c:1794
Portal SPI_cursor_open(const char *name, SPIPlanPtr plan, const Datum *Values, const char *Nulls, bool read_only)
Definition spi.c:1445
int SPI_connect(void)
Definition spi.c:94
void SPI_cursor_fetch(Portal portal, bool forward, long count)
Definition spi.c:1806
int SPI_finish(void)
Definition spi.c:182
SPIPlanPtr SPI_prepare(const char *src, int nargs, Oid *argtypes)
Definition spi.c:860
void SPI_cursor_close(Portal portal)
Definition spi.c:1862
void * SPI_palloc(Size size)
Definition spi.c:1338
int SPI_execute(const char *src, bool read_only, long tcount)
Definition spi.c:596
Datum SPI_getbinval(HeapTuple tuple, TupleDesc tupdesc, int fnumber, bool *isnull)
Definition spi.c:1252
char * SPI_fname(TupleDesc tupdesc, int fnumber)
Definition spi.c:1198
#define SPI_OK_SELECT
Definition spi.h:86
static void error(void)
char * dbname
Definition streamutil.c:49
struct StringInfoData * StringInfo
Definition string.h:15
StringInfo makeStringInfo(void)
Definition stringinfo.c:72
void appendStringInfo(StringInfo str, const char *fmt,...)
Definition stringinfo.c:145
void appendBinaryStringInfo(StringInfo str, const void *data, int datalen)
Definition stringinfo.c:281
void appendStringInfoString(StringInfo str, const char *s)
Definition stringinfo.c:230
void appendStringInfoChar(StringInfo str, char ch)
Definition stringinfo.c:242
void initStringInfo(StringInfo str)
Definition stringinfo.c:97
#define appendStringInfoCharMacro(str, ch)
Definition stringinfo.h:231
Definition pg_list.h:54
Definition nodes.h:135
TupleDesc tupDesc
Definition portal.h:159
TupleDesc rd_att
Definition rel.h:112
TupleDesc tupdesc
Definition spi.h:25
HeapTuple * vals
Definition spi.h:26
List * args
Definition primnodes.h:1634
List * named_args
Definition primnodes.h:1630
Definition c.h:772
Definition pgtime.h:35
int tm_mday
Definition pgtime.h:39
int tm_mon
Definition pgtime.h:40
int tm_year
Definition pgtime.h:41
Definition c.h:718
void ReleaseSysCache(HeapTuple tuple)
Definition syscache.c:264
HeapTuple SearchSysCache1(SysCacheIdentifier cacheId, Datum key1)
Definition syscache.c:220
void table_close(Relation relation, LOCKMODE lockmode)
Definition table.c:126
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition table.c:40
TupleDesc CreateTupleDescCopy(TupleDesc tupdesc)
Definition tupdesc.c:235
static FormData_pg_attribute * TupleDescAttr(TupleDesc tupdesc, int i)
Definition tupdesc.h:160
struct TupleDescData * TupleDesc
Definition tupdesc.h:145
static Timestamp DatumGetTimestamp(Datum X)
Definition timestamp.h:28
#define strVal(v)
Definition value.h:82
static Size VARSIZE_ANY_EXHDR(const void *PTR)
Definition varatt.h:472
static Size VARSIZE(const void *PTR)
Definition varatt.h:298
static char * VARDATA(const void *PTR)
Definition varatt.h:305
static char * VARDATA_ANY(const void *PTR)
Definition varatt.h:486
static void SET_VARSIZE(void *PTR, Size len)
Definition varatt.h:432
static void appendStringInfoText(StringInfo str, const text *t)
Definition varlena.c:3109
text * cstring_to_text_with_len(const char *s, int len)
Definition varlena.c:194
text * cstring_to_text(const char *s)
Definition varlena.c:182
char * text_to_cstring(const text *t)
Definition varlena.c:215
const char * type
const char * name
int pg_encoding_mblen(int encoding, const char *mbstr)
Definition wchar.c:2157
Datum xml_in(PG_FUNCTION_ARGS)
Definition xml.c:272
Datum cursor_to_xmlschema(PG_FUNCTION_ARGS)
Definition xml.c:3132
#define NO_XML_SUPPORT()
Definition xml.c:234
Datum table_to_xml(PG_FUNCTION_ARGS)
Definition xml.c:2923
Datum query_to_xmlschema(PG_FUNCTION_ARGS)
Definition xml.c:3103
Datum database_to_xml(PG_FUNCTION_ARGS)
Definition xml.c:3437
static const char * map_sql_catalog_to_xmlschema_types(List *nspid_list, bool nulls, bool tableforest, const char *targetns)
Definition xml.c:3732
xmltype * xmlroot(xmltype *data, text *version, int standalone)
Definition xml.c:1102
static void XmlTableInitOpaque(struct TableFuncScanState *state, int natts)
Definition xml.c:4729
static const char * map_sql_type_to_xml_name(Oid typeoid, int typmod)
Definition xml.c:3789
static const char * map_sql_type_to_xmlschema_type(Oid typeoid, int typmod)
Definition xml.c:3949
Datum texttoxml(PG_FUNCTION_ARGS)
Definition xml.c:659
static char * xml_out_internal(xmltype *x, pg_enc target_encoding)
Definition xml.c:311
char * map_sql_identifier_to_xml_name(const char *ident, bool fully_escaped, bool escape_period)
Definition xml.c:2418
static void xsd_schema_element_start(StringInfo result, const char *targetns)
Definition xml.c:3284
Datum query_to_xml_and_xmlschema(PG_FUNCTION_ARGS)
Definition xml.c:3183
Datum xmltotext(PG_FUNCTION_ARGS)
Definition xml.c:668
Datum schema_to_xml_and_xmlschema(PG_FUNCTION_ARGS)
Definition xml.c:3366
Datum xmlexists(PG_FUNCTION_ARGS)
Definition xml.c:4589
Datum xmltext(PG_FUNCTION_ARGS)
Definition xml.c:527
#define NAMESPACE_XSI
Definition xml.c:243
static char * map_multipart_sql_identifier_to_xml_name(const char *a, const char *b, const char *c, const char *d)
Definition xml.c:3523
int xmlbinary
Definition xml.c:108
static StringInfo database_to_xmlschema_internal(bool nulls, bool tableforest, const char *targetns)
Definition xml.c:3449
Datum database_to_xmlschema(PG_FUNCTION_ARGS)
Definition xml.c:3492
static List * schema_get_xml_visible_tables(Oid nspid)
Definition xml.c:2853
Datum schema_to_xmlschema(PG_FUNCTION_ARGS)
Definition xml.c:3353
text * xmltotext_with_options(xmltype *data, XmlOptionType xmloption_arg, bool indent)
Definition xml.c:678
static void xmldata_root_element_start(StringInfo result, const char *eltname, const char *xmlschema, const char *targetns, bool top_level)
Definition xml.c:3005
char * map_sql_value_to_xml_value(Datum value, Oid type, bool xml_escape_strings)
Definition xml.c:2516
Datum xml_send(PG_FUNCTION_ARGS)
Definition xml.c:438
static const char * map_sql_schema_to_xmlschema_types(Oid nspid, List *relid_list, bool nulls, bool tableforest, const char *targetns)
Definition xml.c:3659
Datum xmlcomment(PG_FUNCTION_ARGS)
Definition xml.c:491
static void XmlTableSetNamespace(struct TableFuncScanState *state, const char *name, const char *uri)
Definition xml.c:4834
Datum xmlconcat2(PG_FUNCTION_ARGS)
Definition xml.c:641
static void XmlTableSetRowFilter(struct TableFuncScanState *state, const char *path)
Definition xml.c:4860
static List * database_get_xml_visible_schemas(void)
Definition xml.c:2880
static void xmldata_root_element_end(StringInfo result, const char *eltname)
Definition xml.c:3032
xmltype * xmlconcat(List *args)
Definition xml.c:575
static Datum XmlTableGetValue(struct TableFuncScanState *state, int colnum, Oid typid, int32 typmod, bool *isnull)
Definition xml.c:4972
char * escape_xml(const char *str)
Definition xml.c:2735
Datum xml_is_well_formed_document(PG_FUNCTION_ARGS)
Definition xml.c:4667
Datum query_to_xml(PG_FUNCTION_ARGS)
Definition xml.c:2937
static StringInfo database_to_xml_internal(const char *xmlschema, bool nulls, bool tableforest, const char *targetns)
Definition xml.c:3394
int xmloption
Definition xml.c:109
static xmltype * stringinfo_to_xmltype(StringInfo buf)
Definition xml.c:467
Datum xml_is_well_formed_content(PG_FUNCTION_ARGS)
Definition xml.c:4680
#define XML_VISIBLE_SCHEMAS
Definition xml.c:2876
static List * database_get_xml_visible_tables(void)
Definition xml.c:2887
bool xml_is_document(xmltype *arg)
Definition xml.c:1168
static StringInfo schema_to_xmlschema_internal(const char *schemaname, bool nulls, bool tableforest, const char *targetns)
Definition xml.c:3308
Datum table_to_xml_and_xmlschema(PG_FUNCTION_ARGS)
Definition xml.c:3162
Datum xmlvalidate(PG_FUNCTION_ARGS)
Definition xml.c:1158
xmltype * xmlparse(text *data, XmlOptionType xmloption_arg, bool preserve_whitespace)
Definition xml.c:1032
static xmltype * cstring_to_xmltype(const char *string)
Definition xml.c:474
static List * query_to_oid_list(const char *query)
Definition xml.c:2824
static void XmlTableSetDocument(struct TableFuncScanState *state, Datum value)
Definition xml.c:4777
static void XmlTableDestroyOpaque(struct TableFuncScanState *state)
Definition xml.c:5124
static const char * map_sql_typecoll_to_xmlschema_types(List *tupdesc_list)
Definition xml.c:3894
#define NAMESPACE_XSD
Definition xml.c:242
#define PG_XML_DEFAULT_VERSION
Definition xml.c:300
Datum table_to_xmlschema(PG_FUNCTION_ARGS)
Definition xml.c:3084
static StringInfo query_to_xml_internal(const char *query, char *tablename, const char *xmlschema, bool nulls, bool tableforest, const char *targetns, bool top_level)
Definition xml.c:3039
static void SPI_sql_row_to_xmlelement(uint64 rownum, StringInfo result, char *tablename, bool nulls, bool tableforest, const char *targetns, bool top_level)
Definition xml.c:4124
static StringInfo schema_to_xml_internal(Oid nspid, const char *xmlschema, bool nulls, bool tableforest, const char *targetns, bool top_level)
Definition xml.c:3219
static StringInfo table_to_xml_internal(Oid relid, const char *xmlschema, bool nulls, bool tableforest, const char *targetns, bool top_level)
Definition xml.c:2906
Datum schema_to_xml(PG_FUNCTION_ARGS)
Definition xml.c:3262
char * map_xml_name_to_sql_identifier(const char *name)
Definition xml.c:2474
Datum database_to_xml_and_xmlschema(PG_FUNCTION_ARGS)
Definition xml.c:3504
static bool XmlTableFetchRow(struct TableFuncScanState *state)
Definition xml.c:4927
Datum cursor_to_xml(PG_FUNCTION_ARGS)
Definition xml.c:2951
Datum xpath_exists(PG_FUNCTION_ARGS)
Definition xml.c:4612
Datum xml_is_well_formed(PG_FUNCTION_ARGS)
Definition xml.c:4654
static char * _SPI_strdup(const char *s)
Definition xml.c:2767
static void XmlTableSetColumnFilter(struct TableFuncScanState *state, const char *path, int colnum)
Definition xml.c:4892
static const char * map_sql_table_to_xmlschema(TupleDesc tupdesc, Oid relid, bool nulls, bool tableforest, const char *targetns)
Definition xml.c:3554
Datum xml_out(PG_FUNCTION_ARGS)
Definition xml.c:355
Datum xml_recv(PG_FUNCTION_ARGS)
Definition xml.c:370
xmltype * xmlelement(XmlExpr *xexpr, const Datum *named_argvalue, const bool *named_argnull, const Datum *argvalue, const bool *argnull)
Definition xml.c:894
xmltype * xmlpi(const char *target, text *arg, bool arg_is_null, bool *result_is_null)
Definition xml.c:1050
Datum xpath(PG_FUNCTION_ARGS)
Definition xml.c:4566
static void xsd_schema_element_end(StringInfo result)
Definition xml.c:3301
@ XML_STANDALONE_OMITTED
Definition xml.h:30
@ XML_STANDALONE_NO_VALUE
Definition xml.h:29
@ XML_STANDALONE_YES
Definition xml.h:27
@ XML_STANDALONE_NO
Definition xml.h:28
struct PgXmlErrorContext PgXmlErrorContext
Definition xml.h:48
PgXmlErrorContext * pg_xml_init(PgXmlStrictness strictness)
#define PG_RETURN_XML_P(x)
Definition xml.h:63
void xml_ereport(PgXmlErrorContext *errcxt, int level, int sqlcode, const char *msg)
bool pg_xml_error_occurred(PgXmlErrorContext *errcxt)
static xmltype * DatumGetXmlP(Datum X)
Definition xml.h:51
void pg_xml_done(PgXmlErrorContext *errcxt, bool isError)
#define PG_GETARG_XML_P(n)
Definition xml.h:62
void pg_xml_init_library(void)
@ XMLBINARY_BASE64
Definition xml.h:35
PgXmlStrictness
Definition xml.h:40
@ PG_XML_STRICTNESS_LEGACY
Definition xml.h:41
@ PG_XML_STRICTNESS_ALL
Definition xml.h:44
@ PG_XML_STRICTNESS_WELLFORMED
Definition xml.h:43

◆ PG_XML_DEFAULT_VERSION

#define PG_XML_DEFAULT_VERSION   "1.0"

Definition at line 300 of file xml.c.

◆ XML_VISIBLE_SCHEMAS

#define XML_VISIBLE_SCHEMAS   "SELECT oid FROM pg_catalog.pg_namespace WHERE pg_catalog.has_schema_privilege (oid, 'USAGE') AND NOT " XML_VISIBLE_SCHEMAS_EXCLUDE

Definition at line 2876 of file xml.c.

◆ XML_VISIBLE_SCHEMAS_EXCLUDE

#define XML_VISIBLE_SCHEMAS_EXCLUDE   "(nspname ~ '^pg_' OR nspname = 'information_schema')"

Definition at line 2874 of file xml.c.

Function Documentation

◆ _SPI_strdup()

static char * _SPI_strdup ( const char s)
static

Definition at line 2767 of file xml.c.

2768{
2769 size_t len = strlen(s) + 1;
2770 char *ret = SPI_palloc(len);
2771
2772 memcpy(ret, s, len);
2773 return ret;
2774}

References fb(), len, and SPI_palloc().

Referenced by cursor_to_xmlschema(), query_to_xml_and_xmlschema(), and query_to_xmlschema().

◆ cstring_to_xmltype()

static xmltype * cstring_to_xmltype ( const char string)
static

Definition at line 474 of file xml.c.

475{
476 return (xmltype *) cstring_to_text(string);
477}

References cstring_to_text().

Referenced by cursor_to_xmlschema(), query_to_xmlschema(), and table_to_xmlschema().

◆ cursor_to_xml()

Datum cursor_to_xml ( PG_FUNCTION_ARGS  )

Definition at line 2951 of file xml.c.

2952{
2954 int32 count = PG_GETARG_INT32(1);
2955 bool nulls = PG_GETARG_BOOL(2);
2956 bool tableforest = PG_GETARG_BOOL(3);
2957 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(4));
2958
2959 StringInfoData result;
2960 Portal portal;
2961 uint64 i;
2962
2963 initStringInfo(&result);
2964
2965 if (!tableforest)
2966 {
2967 xmldata_root_element_start(&result, "table", NULL, targetns, true);
2968 appendStringInfoChar(&result, '\n');
2969 }
2970
2971 SPI_connect();
2972 portal = SPI_cursor_find(name);
2973 if (portal == NULL)
2974 ereport(ERROR,
2976 errmsg("cursor \"%s\" does not exist", name)));
2977
2978 SPI_cursor_fetch(portal, true, count);
2979 for (i = 0; i < SPI_processed; i++)
2980 SPI_sql_row_to_xmlelement(i, &result, NULL, nulls,
2981 tableforest, targetns, true);
2982
2983 SPI_finish();
2984
2985 if (!tableforest)
2986 xmldata_root_element_end(&result, "table");
2987
2989}

References appendStringInfoChar(), ereport, errcode(), errmsg(), ERROR, fb(), i, initStringInfo(), name, PG_GETARG_BOOL, PG_GETARG_INT32, PG_GETARG_TEXT_PP, PG_RETURN_XML_P, SPI_connect(), SPI_cursor_fetch(), SPI_cursor_find(), SPI_finish(), SPI_processed, SPI_sql_row_to_xmlelement(), stringinfo_to_xmltype(), text_to_cstring(), xmldata_root_element_end(), and xmldata_root_element_start().

◆ cursor_to_xmlschema()

Datum cursor_to_xmlschema ( PG_FUNCTION_ARGS  )

Definition at line 3132 of file xml.c.

3133{
3135 bool nulls = PG_GETARG_BOOL(1);
3136 bool tableforest = PG_GETARG_BOOL(2);
3137 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3138 const char *xmlschema;
3139 Portal portal;
3140
3141 SPI_connect();
3142 portal = SPI_cursor_find(name);
3143 if (portal == NULL)
3144 ereport(ERROR,
3146 errmsg("cursor \"%s\" does not exist", name)));
3147 if (portal->tupDesc == NULL)
3148 ereport(ERROR,
3150 errmsg("portal \"%s\" does not return tuples", name)));
3151
3153 InvalidOid, nulls,
3155 SPI_finish();
3156
3158}

References _SPI_strdup(), cstring_to_xmltype(), ereport, errcode(), errmsg(), ERROR, fb(), InvalidOid, map_sql_table_to_xmlschema(), name, PG_GETARG_BOOL, PG_GETARG_TEXT_PP, PG_RETURN_XML_P, SPI_connect(), SPI_cursor_find(), SPI_finish(), text_to_cstring(), and PortalData::tupDesc.

◆ database_get_xml_visible_schemas()

static List * database_get_xml_visible_schemas ( void  )
static

Definition at line 2880 of file xml.c.

2881{
2882 return query_to_oid_list(XML_VISIBLE_SCHEMAS " ORDER BY nspname;");
2883}

References query_to_oid_list(), and XML_VISIBLE_SCHEMAS.

Referenced by database_to_xml_internal(), and database_to_xmlschema_internal().

◆ database_get_xml_visible_tables()

static List * database_get_xml_visible_tables ( void  )
static

Definition at line 2887 of file xml.c.

2888{
2889 /* At the moment there is no order required here. */
2890 return query_to_oid_list("SELECT oid FROM pg_catalog.pg_class"
2891 " WHERE relkind IN ("
2895 " AND pg_catalog.has_table_privilege(pg_class.oid, 'SELECT')"
2896 " AND relnamespace IN (" XML_VISIBLE_SCHEMAS ");");
2897}

References CppAsString2, fb(), query_to_oid_list(), and XML_VISIBLE_SCHEMAS.

Referenced by database_to_xmlschema_internal().

◆ database_to_xml()

◆ database_to_xml_and_xmlschema()

◆ database_to_xml_internal()

static StringInfo database_to_xml_internal ( const char xmlschema,
bool  nulls,
bool  tableforest,
const char targetns 
)
static

Definition at line 3394 of file xml.c.

3396{
3397 StringInfo result;
3399 ListCell *cell;
3400 char *xmlcn;
3401
3403 true, false);
3404 result = makeStringInfo();
3405
3407 appendStringInfoChar(result, '\n');
3408
3409 if (xmlschema)
3410 appendStringInfo(result, "%s\n\n", xmlschema);
3411
3412 SPI_connect();
3413
3415
3416 foreach(cell, nspid_list)
3417 {
3418 Oid nspid = lfirst_oid(cell);
3420
3422 tableforest, targetns, false);
3423
3424 appendBinaryStringInfo(result, subres->data, subres->len);
3425 appendStringInfoChar(result, '\n');
3426 }
3427
3428 SPI_finish();
3429
3431
3432 return result;
3433}

References appendBinaryStringInfo(), appendStringInfo(), appendStringInfoChar(), StringInfoData::data, database_get_xml_visible_schemas(), fb(), get_database_name(), lfirst_oid, makeStringInfo(), map_sql_identifier_to_xml_name(), MyDatabaseId, nspid, schema_to_xml_internal(), SPI_connect(), SPI_finish(), xmldata_root_element_end(), and xmldata_root_element_start().

Referenced by database_to_xml(), and database_to_xml_and_xmlschema().

◆ database_to_xmlschema()

◆ database_to_xmlschema_internal()

static StringInfo database_to_xmlschema_internal ( bool  nulls,
bool  tableforest,
const char targetns 
)
static

◆ escape_xml()

char * escape_xml ( const char str)

Definition at line 2735 of file xml.c.

2736{
2738 const char *p;
2739
2741 for (p = str; *p; p++)
2742 {
2743 switch (*p)
2744 {
2745 case '&':
2746 appendStringInfoString(&buf, "&amp;");
2747 break;
2748 case '<':
2749 appendStringInfoString(&buf, "&lt;");
2750 break;
2751 case '>':
2752 appendStringInfoString(&buf, "&gt;");
2753 break;
2754 case '\r':
2755 appendStringInfoString(&buf, "&#x0d;");
2756 break;
2757 default:
2759 break;
2760 }
2761 }
2762 return buf.data;
2763}

References appendStringInfoCharMacro, appendStringInfoString(), buf, initStringInfo(), and str.

Referenced by ExplainProperty(), ExplainPropertyList(), map_sql_value_to_xml_value(), and XmlTableGetValue().

◆ map_multipart_sql_identifier_to_xml_name()

static char * map_multipart_sql_identifier_to_xml_name ( const char a,
const char b,
const char c,
const char d 
)
static

Definition at line 3523 of file xml.c.

3524{
3525 StringInfoData result;
3526
3527 initStringInfo(&result);
3528
3529 if (a)
3530 appendStringInfoString(&result,
3531 map_sql_identifier_to_xml_name(a, true, true));
3532 if (b)
3533 appendStringInfo(&result, ".%s",
3534 map_sql_identifier_to_xml_name(b, true, true));
3535 if (c)
3536 appendStringInfo(&result, ".%s",
3537 map_sql_identifier_to_xml_name(c, true, true));
3538 if (d)
3539 appendStringInfo(&result, ".%s",
3540 map_sql_identifier_to_xml_name(d, true, true));
3541
3542 return result.data;
3543}

References a, appendStringInfo(), appendStringInfoString(), b, StringInfoData::data, initStringInfo(), and map_sql_identifier_to_xml_name().

Referenced by map_sql_catalog_to_xmlschema_types(), map_sql_schema_to_xmlschema_types(), map_sql_table_to_xmlschema(), and map_sql_type_to_xml_name().

◆ map_sql_catalog_to_xmlschema_types()

static const char * map_sql_catalog_to_xmlschema_types ( List nspid_list,
bool  nulls,
bool  tableforest,
const char targetns 
)
static

Definition at line 3732 of file xml.c.

3734{
3735 char *dbname;
3736 char *xmlcn;
3737 char *catalogtypename;
3738 StringInfoData result;
3739 ListCell *cell;
3740
3742
3743 initStringInfo(&result);
3744
3746
3748 dbname,
3749 NULL,
3750 NULL);
3751
3752 appendStringInfo(&result,
3753 "<xsd:complexType name=\"%s\">\n", catalogtypename);
3754 appendStringInfoString(&result,
3755 " <xsd:all>\n");
3756
3757 foreach(cell, nspid_list)
3758 {
3759 Oid nspid = lfirst_oid(cell);
3760 char *nspname = get_namespace_name(nspid);
3761 char *xmlsn = map_sql_identifier_to_xml_name(nspname, true, false);
3763 dbname,
3764 nspname,
3765 NULL);
3766
3767 appendStringInfo(&result,
3768 " <xsd:element name=\"%s\" type=\"%s\"/>\n",
3770 }
3771
3772 appendStringInfoString(&result,
3773 " </xsd:all>\n");
3774 appendStringInfoString(&result,
3775 "</xsd:complexType>\n\n");
3776
3777 appendStringInfo(&result,
3778 "<xsd:element name=\"%s\" type=\"%s\"/>\n\n",
3780
3781 return result.data;
3782}

References appendStringInfo(), appendStringInfoString(), StringInfoData::data, dbname, fb(), get_database_name(), get_namespace_name(), initStringInfo(), lfirst_oid, map_multipart_sql_identifier_to_xml_name(), map_sql_identifier_to_xml_name(), MyDatabaseId, and nspid.

Referenced by database_to_xmlschema_internal().

◆ map_sql_identifier_to_xml_name()

char * map_sql_identifier_to_xml_name ( const char ident,
bool  fully_escaped,
bool  escape_period 
)

Definition at line 2418 of file xml.c.

2420{
2421#ifdef USE_LIBXML
2423 const char *p;
2424
2425 /*
2426 * SQL/XML doesn't make use of this case anywhere, so it's probably a
2427 * mistake.
2428 */
2430
2432
2433 for (p = ident; *p; p += pg_mblen_cstr(p))
2434 {
2435 if (*p == ':' && (p == ident || fully_escaped))
2436 appendStringInfoString(&buf, "_x003A_");
2437 else if (*p == '_' && *(p + 1) == 'x')
2438 appendStringInfoString(&buf, "_x005F_");
2439 else if (fully_escaped && p == ident &&
2440 pg_strncasecmp(p, "xml", 3) == 0)
2441 {
2442 if (*p == 'x')
2443 appendStringInfoString(&buf, "_x0078_");
2444 else
2445 appendStringInfoString(&buf, "_x0058_");
2446 }
2447 else if (escape_period && *p == '.')
2448 appendStringInfoString(&buf, "_x002E_");
2449 else
2450 {
2452
2453 if ((p == ident)
2456 appendStringInfo(&buf, "_x%04X_", (unsigned int) u);
2457 else
2459 }
2460 }
2461
2462 return buf.data;
2463#else /* not USE_LIBXML */
2465 return NULL;
2466#endif /* not USE_LIBXML */
2467}

References appendBinaryStringInfo(), appendStringInfo(), appendStringInfoString(), Assert, buf, fb(), ident, initStringInfo(), NO_XML_SUPPORT, pg_mblen_cstr(), and pg_strncasecmp().

Referenced by database_to_xml_internal(), map_multipart_sql_identifier_to_xml_name(), map_sql_catalog_to_xmlschema_types(), map_sql_schema_to_xmlschema_types(), map_sql_table_to_xmlschema(), query_to_xml_internal(), schema_to_xml_internal(), SPI_sql_row_to_xmlelement(), and transformXmlExpr().

◆ map_sql_schema_to_xmlschema_types()

static const char * map_sql_schema_to_xmlschema_types ( Oid  nspid,
List relid_list,
bool  nulls,
bool  tableforest,
const char targetns 
)
static

Definition at line 3659 of file xml.c.

3661{
3662 char *dbname;
3663 char *nspname;
3664 char *xmlsn;
3665 char *schematypename;
3666 StringInfoData result;
3667 ListCell *cell;
3668
3670 nspname = get_namespace_name(nspid);
3671
3672 initStringInfo(&result);
3673
3674 xmlsn = map_sql_identifier_to_xml_name(nspname, true, false);
3675
3677 dbname,
3678 nspname,
3679 NULL);
3680
3681 appendStringInfo(&result,
3682 "<xsd:complexType name=\"%s\">\n", schematypename);
3683 if (!tableforest)
3684 appendStringInfoString(&result,
3685 " <xsd:all>\n");
3686 else
3687 appendStringInfoString(&result,
3688 " <xsd:sequence>\n");
3689
3690 foreach(cell, relid_list)
3691 {
3692 Oid relid = lfirst_oid(cell);
3693 char *relname = get_rel_name(relid);
3694 char *xmltn = map_sql_identifier_to_xml_name(relname, true, false);
3695 char *tabletypename = map_multipart_sql_identifier_to_xml_name(tableforest ? "RowType" : "TableType",
3696 dbname,
3697 nspname,
3698 relname);
3699
3700 if (!tableforest)
3701 appendStringInfo(&result,
3702 " <xsd:element name=\"%s\" type=\"%s\"/>\n",
3704 else
3705 appendStringInfo(&result,
3706 " <xsd:element name=\"%s\" type=\"%s\" minOccurs=\"0\" maxOccurs=\"unbounded\"/>\n",
3708 }
3709
3710 if (!tableforest)
3711 appendStringInfoString(&result,
3712 " </xsd:all>\n");
3713 else
3714 appendStringInfoString(&result,
3715 " </xsd:sequence>\n");
3716 appendStringInfoString(&result,
3717 "</xsd:complexType>\n\n");
3718
3719 appendStringInfo(&result,
3720 "<xsd:element name=\"%s\" type=\"%s\"/>\n\n",
3722
3723 return result.data;
3724}

References appendStringInfo(), appendStringInfoString(), StringInfoData::data, dbname, fb(), get_database_name(), get_namespace_name(), get_rel_name(), initStringInfo(), lfirst_oid, map_multipart_sql_identifier_to_xml_name(), map_sql_identifier_to_xml_name(), MyDatabaseId, nspid, and relname.

Referenced by schema_to_xmlschema_internal().

◆ map_sql_table_to_xmlschema()

static const char * map_sql_table_to_xmlschema ( TupleDesc  tupdesc,
Oid  relid,
bool  nulls,
bool  tableforest,
const char targetns 
)
static

Definition at line 3554 of file xml.c.

3556{
3557 int i;
3558 char *xmltn;
3559 char *tabletypename;
3560 char *rowtypename;
3561 StringInfoData result;
3562
3563 initStringInfo(&result);
3564
3565 if (OidIsValid(relid))
3566 {
3567 HeapTuple tuple;
3569
3570 tuple = SearchSysCache1(RELOID, ObjectIdGetDatum(relid));
3571 if (!HeapTupleIsValid(tuple))
3572 elog(ERROR, "cache lookup failed for relation %u", relid);
3573 reltuple = (Form_pg_class) GETSTRUCT(tuple);
3574
3576 true, false);
3577
3580 get_namespace_name(reltuple->relnamespace),
3581 NameStr(reltuple->relname));
3582
3585 get_namespace_name(reltuple->relnamespace),
3586 NameStr(reltuple->relname));
3587
3588 ReleaseSysCache(tuple);
3589 }
3590 else
3591 {
3592 if (tableforest)
3593 xmltn = "row";
3594 else
3595 xmltn = "table";
3596
3597 tabletypename = "TableType";
3598 rowtypename = "RowType";
3599 }
3600
3602
3603 appendStringInfoString(&result,
3605
3606 appendStringInfo(&result,
3607 "<xsd:complexType name=\"%s\">\n"
3608 " <xsd:sequence>\n",
3609 rowtypename);
3610
3611 for (i = 0; i < tupdesc->natts; i++)
3612 {
3614
3615 if (att->attisdropped)
3616 continue;
3617 appendStringInfo(&result,
3618 " <xsd:element name=\"%s\" type=\"%s\"%s></xsd:element>\n",
3620 true, false),
3621 map_sql_type_to_xml_name(att->atttypid, -1),
3622 nulls ? " nillable=\"true\"" : " minOccurs=\"0\"");
3623 }
3624
3625 appendStringInfoString(&result,
3626 " </xsd:sequence>\n"
3627 "</xsd:complexType>\n\n");
3628
3629 if (!tableforest)
3630 {
3631 appendStringInfo(&result,
3632 "<xsd:complexType name=\"%s\">\n"
3633 " <xsd:sequence>\n"
3634 " <xsd:element name=\"row\" type=\"%s\" minOccurs=\"0\" maxOccurs=\"unbounded\"/>\n"
3635 " </xsd:sequence>\n"
3636 "</xsd:complexType>\n\n",
3638
3639 appendStringInfo(&result,
3640 "<xsd:element name=\"%s\" type=\"%s\"/>\n\n",
3642 }
3643 else
3644 appendStringInfo(&result,
3645 "<xsd:element name=\"%s\" type=\"%s\"/>\n\n",
3647
3648 xsd_schema_element_end(&result);
3649
3650 return result.data;
3651}

References appendStringInfo(), appendStringInfoString(), StringInfoData::data, elog, ERROR, fb(), get_database_name(), get_namespace_name(), GETSTRUCT(), HeapTupleIsValid, i, initStringInfo(), list_make1, map_multipart_sql_identifier_to_xml_name(), map_sql_identifier_to_xml_name(), map_sql_type_to_xml_name(), map_sql_typecoll_to_xmlschema_types(), MyDatabaseId, NameStr, TupleDescData::natts, ObjectIdGetDatum(), OidIsValid, ReleaseSysCache(), SearchSysCache1(), TupleDescAttr(), xsd_schema_element_end(), and xsd_schema_element_start().

Referenced by cursor_to_xmlschema(), query_to_xml_and_xmlschema(), query_to_xmlschema(), table_to_xml_and_xmlschema(), and table_to_xmlschema().

◆ map_sql_type_to_xml_name()

static const char * map_sql_type_to_xml_name ( Oid  typeoid,
int  typmod 
)
static

Definition at line 3789 of file xml.c.

3790{
3791 StringInfoData result;
3792
3793 initStringInfo(&result);
3794
3795 switch (typeoid)
3796 {
3797 case BPCHAROID:
3798 if (typmod == -1)
3799 appendStringInfoString(&result, "CHAR");
3800 else
3801 appendStringInfo(&result, "CHAR_%d", typmod - VARHDRSZ);
3802 break;
3803 case VARCHAROID:
3804 if (typmod == -1)
3805 appendStringInfoString(&result, "VARCHAR");
3806 else
3807 appendStringInfo(&result, "VARCHAR_%d", typmod - VARHDRSZ);
3808 break;
3809 case NUMERICOID:
3810 if (typmod == -1)
3811 appendStringInfoString(&result, "NUMERIC");
3812 else
3813 appendStringInfo(&result, "NUMERIC_%d_%d",
3814 ((typmod - VARHDRSZ) >> 16) & 0xffff,
3815 (typmod - VARHDRSZ) & 0xffff);
3816 break;
3817 case INT4OID:
3818 appendStringInfoString(&result, "INTEGER");
3819 break;
3820 case INT2OID:
3821 appendStringInfoString(&result, "SMALLINT");
3822 break;
3823 case INT8OID:
3824 appendStringInfoString(&result, "BIGINT");
3825 break;
3826 case FLOAT4OID:
3827 appendStringInfoString(&result, "REAL");
3828 break;
3829 case FLOAT8OID:
3830 appendStringInfoString(&result, "DOUBLE");
3831 break;
3832 case BOOLOID:
3833 appendStringInfoString(&result, "BOOLEAN");
3834 break;
3835 case TIMEOID:
3836 if (typmod == -1)
3837 appendStringInfoString(&result, "TIME");
3838 else
3839 appendStringInfo(&result, "TIME_%d", typmod);
3840 break;
3841 case TIMETZOID:
3842 if (typmod == -1)
3843 appendStringInfoString(&result, "TIME_WTZ");
3844 else
3845 appendStringInfo(&result, "TIME_WTZ_%d", typmod);
3846 break;
3847 case TIMESTAMPOID:
3848 if (typmod == -1)
3849 appendStringInfoString(&result, "TIMESTAMP");
3850 else
3851 appendStringInfo(&result, "TIMESTAMP_%d", typmod);
3852 break;
3853 case TIMESTAMPTZOID:
3854 if (typmod == -1)
3855 appendStringInfoString(&result, "TIMESTAMP_WTZ");
3856 else
3857 appendStringInfo(&result, "TIMESTAMP_WTZ_%d", typmod);
3858 break;
3859 case DATEOID:
3860 appendStringInfoString(&result, "DATE");
3861 break;
3862 case XMLOID:
3863 appendStringInfoString(&result, "XML");
3864 break;
3865 default:
3866 {
3867 HeapTuple tuple;
3869
3870 tuple = SearchSysCache1(TYPEOID, ObjectIdGetDatum(typeoid));
3871 if (!HeapTupleIsValid(tuple))
3872 elog(ERROR, "cache lookup failed for type %u", typeoid);
3873 typtuple = (Form_pg_type) GETSTRUCT(tuple);
3874
3875 appendStringInfoString(&result,
3876 map_multipart_sql_identifier_to_xml_name((typtuple->typtype == TYPTYPE_DOMAIN) ? "Domain" : "UDT",
3880
3881 ReleaseSysCache(tuple);
3882 }
3883 }
3884
3885 return result.data;
3886}

References appendStringInfo(), appendStringInfoString(), StringInfoData::data, elog, ERROR, fb(), Form_pg_type, get_database_name(), get_namespace_name(), GETSTRUCT(), HeapTupleIsValid, initStringInfo(), map_multipart_sql_identifier_to_xml_name(), MyDatabaseId, NameStr, ObjectIdGetDatum(), ReleaseSysCache(), SearchSysCache1(), and VARHDRSZ.

Referenced by map_sql_table_to_xmlschema(), and map_sql_type_to_xmlschema_type().

◆ map_sql_type_to_xmlschema_type()

static const char * map_sql_type_to_xmlschema_type ( Oid  typeoid,
int  typmod 
)
static

Definition at line 3949 of file xml.c.

3950{
3951 StringInfoData result;
3952 const char *typename = map_sql_type_to_xml_name(typeoid, typmod);
3953
3954 initStringInfo(&result);
3955
3956 if (typeoid == XMLOID)
3957 {
3958 appendStringInfoString(&result,
3959 "<xsd:complexType mixed=\"true\">\n"
3960 " <xsd:sequence>\n"
3961 " <xsd:any name=\"element\" minOccurs=\"0\" maxOccurs=\"unbounded\" processContents=\"skip\"/>\n"
3962 " </xsd:sequence>\n"
3963 "</xsd:complexType>\n");
3964 }
3965 else
3966 {
3967 appendStringInfo(&result,
3968 "<xsd:simpleType name=\"%s\">\n", typename);
3969
3970 switch (typeoid)
3971 {
3972 case BPCHAROID:
3973 case VARCHAROID:
3974 case TEXTOID:
3975 appendStringInfoString(&result,
3976 " <xsd:restriction base=\"xsd:string\">\n");
3977 if (typmod != -1)
3978 appendStringInfo(&result,
3979 " <xsd:maxLength value=\"%d\"/>\n",
3980 typmod - VARHDRSZ);
3981 appendStringInfoString(&result, " </xsd:restriction>\n");
3982 break;
3983
3984 case BYTEAOID:
3985 appendStringInfo(&result,
3986 " <xsd:restriction base=\"xsd:%s\">\n"
3987 " </xsd:restriction>\n",
3988 xmlbinary == XMLBINARY_BASE64 ? "base64Binary" : "hexBinary");
3989 break;
3990
3991 case NUMERICOID:
3992 if (typmod != -1)
3993 appendStringInfo(&result,
3994 " <xsd:restriction base=\"xsd:decimal\">\n"
3995 " <xsd:totalDigits value=\"%d\"/>\n"
3996 " <xsd:fractionDigits value=\"%d\"/>\n"
3997 " </xsd:restriction>\n",
3998 ((typmod - VARHDRSZ) >> 16) & 0xffff,
3999 (typmod - VARHDRSZ) & 0xffff);
4000 break;
4001
4002 case INT2OID:
4003 appendStringInfo(&result,
4004 " <xsd:restriction base=\"xsd:short\">\n"
4005 " <xsd:maxInclusive value=\"%d\"/>\n"
4006 " <xsd:minInclusive value=\"%d\"/>\n"
4007 " </xsd:restriction>\n",
4009 break;
4010
4011 case INT4OID:
4012 appendStringInfo(&result,
4013 " <xsd:restriction base=\"xsd:int\">\n"
4014 " <xsd:maxInclusive value=\"%d\"/>\n"
4015 " <xsd:minInclusive value=\"%d\"/>\n"
4016 " </xsd:restriction>\n",
4017 INT_MAX, INT_MIN);
4018 break;
4019
4020 case INT8OID:
4021 appendStringInfo(&result,
4022 " <xsd:restriction base=\"xsd:long\">\n"
4023 " <xsd:maxInclusive value=\"" INT64_FORMAT "\"/>\n"
4024 " <xsd:minInclusive value=\"" INT64_FORMAT "\"/>\n"
4025 " </xsd:restriction>\n",
4027 PG_INT64_MIN);
4028 break;
4029
4030 case FLOAT4OID:
4031 appendStringInfoString(&result,
4032 " <xsd:restriction base=\"xsd:float\"></xsd:restriction>\n");
4033 break;
4034
4035 case FLOAT8OID:
4036 appendStringInfoString(&result,
4037 " <xsd:restriction base=\"xsd:double\"></xsd:restriction>\n");
4038 break;
4039
4040 case BOOLOID:
4041 appendStringInfoString(&result,
4042 " <xsd:restriction base=\"xsd:boolean\"></xsd:restriction>\n");
4043 break;
4044
4045 case TIMEOID:
4046 case TIMETZOID:
4047 {
4048 const char *tz = (typeoid == TIMETZOID ? "(\\+|-)\\p{Nd}{2}:\\p{Nd}{2}" : "");
4049
4050 if (typmod == -1)
4051 appendStringInfo(&result,
4052 " <xsd:restriction base=\"xsd:time\">\n"
4053 " <xsd:pattern value=\"\\p{Nd}{2}:\\p{Nd}{2}:\\p{Nd}{2}(.\\p{Nd}+)?%s\"/>\n"
4054 " </xsd:restriction>\n", tz);
4055 else if (typmod == 0)
4056 appendStringInfo(&result,
4057 " <xsd:restriction base=\"xsd:time\">\n"
4058 " <xsd:pattern value=\"\\p{Nd}{2}:\\p{Nd}{2}:\\p{Nd}{2}%s\"/>\n"
4059 " </xsd:restriction>\n", tz);
4060 else
4061 appendStringInfo(&result,
4062 " <xsd:restriction base=\"xsd:time\">\n"
4063 " <xsd:pattern value=\"\\p{Nd}{2}:\\p{Nd}{2}:\\p{Nd}{2}.\\p{Nd}{%d}%s\"/>\n"
4064 " </xsd:restriction>\n", typmod - VARHDRSZ, tz);
4065 break;
4066 }
4067
4068 case TIMESTAMPOID:
4069 case TIMESTAMPTZOID:
4070 {
4071 const char *tz = (typeoid == TIMESTAMPTZOID ? "(\\+|-)\\p{Nd}{2}:\\p{Nd}{2}" : "");
4072
4073 if (typmod == -1)
4074 appendStringInfo(&result,
4075 " <xsd:restriction base=\"xsd:dateTime\">\n"
4076 " <xsd:pattern value=\"\\p{Nd}{4}-\\p{Nd}{2}-\\p{Nd}{2}T\\p{Nd}{2}:\\p{Nd}{2}:\\p{Nd}{2}(.\\p{Nd}+)?%s\"/>\n"
4077 " </xsd:restriction>\n", tz);
4078 else if (typmod == 0)
4079 appendStringInfo(&result,
4080 " <xsd:restriction base=\"xsd:dateTime\">\n"
4081 " <xsd:pattern value=\"\\p{Nd}{4}-\\p{Nd}{2}-\\p{Nd}{2}T\\p{Nd}{2}:\\p{Nd}{2}:\\p{Nd}{2}%s\"/>\n"
4082 " </xsd:restriction>\n", tz);
4083 else
4084 appendStringInfo(&result,
4085 " <xsd:restriction base=\"xsd:dateTime\">\n"
4086 " <xsd:pattern value=\"\\p{Nd}{4}-\\p{Nd}{2}-\\p{Nd}{2}T\\p{Nd}{2}:\\p{Nd}{2}:\\p{Nd}{2}.\\p{Nd}{%d}%s\"/>\n"
4087 " </xsd:restriction>\n", typmod - VARHDRSZ, tz);
4088 break;
4089 }
4090
4091 case DATEOID:
4092 appendStringInfoString(&result,
4093 " <xsd:restriction base=\"xsd:date\">\n"
4094 " <xsd:pattern value=\"\\p{Nd}{4}-\\p{Nd}{2}-\\p{Nd}{2}\"/>\n"
4095 " </xsd:restriction>\n");
4096 break;
4097
4098 default:
4099 if (get_typtype(typeoid) == TYPTYPE_DOMAIN)
4100 {
4102 int32 base_typmod = -1;
4103
4104 base_typeoid = getBaseTypeAndTypmod(typeoid, &base_typmod);
4105
4106 appendStringInfo(&result,
4107 " <xsd:restriction base=\"%s\"/>\n",
4109 }
4110 break;
4111 }
4112 appendStringInfoString(&result, "</xsd:simpleType>\n");
4113 }
4114
4115 return result.data;
4116}

References appendStringInfo(), appendStringInfoString(), StringInfoData::data, fb(), get_typtype(), getBaseTypeAndTypmod(), initStringInfo(), INT64_FORMAT, map_sql_type_to_xml_name(), PG_INT64_MAX, PG_INT64_MIN, VARHDRSZ, xmlbinary, and XMLBINARY_BASE64.

Referenced by map_sql_typecoll_to_xmlschema_types().

◆ map_sql_typecoll_to_xmlschema_types()

static const char * map_sql_typecoll_to_xmlschema_types ( List tupdesc_list)
static

Definition at line 3894 of file xml.c.

3895{
3896 List *uniquetypes = NIL;
3897 int i;
3898 StringInfoData result;
3899 ListCell *cell0;
3900
3901 /* extract all column types used in the set of TupleDescs */
3902 foreach(cell0, tupdesc_list)
3903 {
3904 TupleDesc tupdesc = (TupleDesc) lfirst(cell0);
3905
3906 for (i = 0; i < tupdesc->natts; i++)
3907 {
3909
3910 if (att->attisdropped)
3911 continue;
3913 }
3914 }
3915
3916 /* add base types of domains */
3917 foreach(cell0, uniquetypes)
3918 {
3919 Oid typid = lfirst_oid(cell0);
3920 Oid basetypid = getBaseType(typid);
3921
3922 if (basetypid != typid)
3924 }
3925
3926 /* Convert to textual form */
3927 initStringInfo(&result);
3928
3929 foreach(cell0, uniquetypes)
3930 {
3931 appendStringInfo(&result, "%s\n",
3933 -1));
3934 }
3935
3936 return result.data;
3937}

References appendStringInfo(), StringInfoData::data, fb(), getBaseType(), i, initStringInfo(), lfirst, lfirst_oid, list_append_unique_oid(), map_sql_type_to_xmlschema_type(), TupleDescData::natts, NIL, and TupleDescAttr().

Referenced by database_to_xmlschema_internal(), map_sql_table_to_xmlschema(), and schema_to_xmlschema_internal().

◆ map_sql_value_to_xml_value()

char * map_sql_value_to_xml_value ( Datum  value,
Oid  type,
bool  xml_escape_strings 
)

Definition at line 2516 of file xml.c.

2517{
2519 {
2520 ArrayType *array;
2521 Oid elmtype;
2522 int16 elmlen;
2523 bool elmbyval;
2524 char elmalign;
2525 int num_elems;
2526 Datum *elem_values;
2527 bool *elem_nulls;
2529 int i;
2530
2531 array = DatumGetArrayTypeP(value);
2532 elmtype = ARR_ELEMTYPE(array);
2533 get_typlenbyvalalign(elmtype, &elmlen, &elmbyval, &elmalign);
2534
2536 elmlen, elmbyval, elmalign,
2537 &elem_values, &elem_nulls,
2538 &num_elems);
2539
2541
2542 for (i = 0; i < num_elems; i++)
2543 {
2544 if (elem_nulls[i])
2545 continue;
2546 appendStringInfoString(&buf, "<element>");
2548 map_sql_value_to_xml_value(elem_values[i],
2549 elmtype, true));
2550 appendStringInfoString(&buf, "</element>");
2551 }
2552
2553 pfree(elem_values);
2554 pfree(elem_nulls);
2555
2556 return buf.data;
2557 }
2558 else
2559 {
2560 Oid typeOut;
2561 bool isvarlena;
2562 char *str;
2563
2564 /*
2565 * Flatten domains; the special-case treatments below should apply to,
2566 * eg, domains over boolean not just boolean.
2567 */
2569
2570 /*
2571 * Special XSD formatting for some data types
2572 */
2573 switch (type)
2574 {
2575 case BOOLOID:
2576 if (DatumGetBool(value))
2577 return "true";
2578 else
2579 return "false";
2580
2581 case DATEOID:
2582 {
2583 DateADT date;
2584 struct pg_tm tm;
2585 char buf[MAXDATELEN + 1];
2586
2588 /* XSD doesn't support infinite values */
2589 if (DATE_NOT_FINITE(date))
2590 ereport(ERROR,
2592 errmsg("date out of range"),
2593 errdetail("XML does not support infinite date values.")));
2595 &(tm.tm_year), &(tm.tm_mon), &(tm.tm_mday));
2597
2598 return pstrdup(buf);
2599 }
2600
2601 case TIMESTAMPOID:
2602 {
2604 struct pg_tm tm;
2605 fsec_t fsec;
2606 char buf[MAXDATELEN + 1];
2607
2609
2610 /* XSD doesn't support infinite values */
2612 ereport(ERROR,
2614 errmsg("timestamp out of range"),
2615 errdetail("XML does not support infinite timestamp values.")));
2616 else if (timestamp2tm(timestamp, NULL, &tm, &fsec, NULL, NULL) == 0)
2617 EncodeDateTime(&tm, fsec, false, 0, NULL, USE_XSD_DATES, buf);
2618 else
2619 ereport(ERROR,
2621 errmsg("timestamp out of range")));
2622
2623 return pstrdup(buf);
2624 }
2625
2626 case TIMESTAMPTZOID:
2627 {
2629 struct pg_tm tm;
2630 int tz;
2631 fsec_t fsec;
2632 const char *tzn = NULL;
2633 char buf[MAXDATELEN + 1];
2634
2636
2637 /* XSD doesn't support infinite values */
2639 ereport(ERROR,
2641 errmsg("timestamp out of range"),
2642 errdetail("XML does not support infinite timestamp values.")));
2643 else if (timestamp2tm(timestamp, &tz, &tm, &fsec, &tzn, NULL) == 0)
2644 EncodeDateTime(&tm, fsec, true, tz, tzn, USE_XSD_DATES, buf);
2645 else
2646 ereport(ERROR,
2648 errmsg("timestamp out of range")));
2649
2650 return pstrdup(buf);
2651 }
2652
2653#ifdef USE_LIBXML
2654 case BYTEAOID:
2655 {
2658 volatile xmlBufferPtr buf = NULL;
2659 volatile xmlTextWriterPtr writer = NULL;
2660 char *result;
2661
2663
2664 PG_TRY();
2665 {
2666 buf = xmlBufferCreate();
2667 if (buf == NULL || xmlerrcxt->err_occurred)
2669 "could not allocate xmlBuffer");
2671 if (writer == NULL || xmlerrcxt->err_occurred)
2673 "could not allocate xmlTextWriter");
2674
2678 else
2681
2682 /* we MUST do this now to flush data out to the buffer */
2684 writer = NULL;
2685
2686 result = pstrdup((const char *) xmlBufferContent(buf));
2687 }
2688 PG_CATCH();
2689 {
2690 if (writer)
2692 if (buf)
2694
2695 pg_xml_done(xmlerrcxt, true);
2696
2697 PG_RE_THROW();
2698 }
2699 PG_END_TRY();
2700
2702
2703 pg_xml_done(xmlerrcxt, false);
2704
2705 return result;
2706 }
2707#endif /* USE_LIBXML */
2708
2709 }
2710
2711 /*
2712 * otherwise, just use the type's native text representation
2713 */
2716
2717 /* ... exactly as-is for XML, and when escaping is not wanted */
2718 if (type == XMLOID || !xml_escape_strings)
2719 return str;
2720
2721 /* otherwise, translate special characters as needed */
2722 return escape_xml(str);
2723 }
2724}

References appendStringInfoString(), ARR_ELEMTYPE, buf, DATE_NOT_FINITE, DatumGetArrayTypeP, DatumGetBool(), DatumGetByteaPP, DatumGetDateADT(), DatumGetTimestamp(), deconstruct_array(), EncodeDateOnly(), EncodeDateTime(), ereport, errcode(), errdetail(), errmsg(), ERROR, escape_xml(), fb(), get_typlenbyvalalign(), getBaseType(), getTypeOutputInfo(), i, initStringInfo(), j2date(), map_sql_value_to_xml_value(), MAXDATELEN, OidOutputFunctionCall(), pfree(), PG_CATCH, PG_END_TRY, PG_RE_THROW, PG_TRY, pg_xml_done(), pg_xml_init(), PG_XML_STRICTNESS_ALL, POSTGRES_EPOCH_JDATE, pstrdup(), str, timestamp2tm(), TIMESTAMP_NOT_FINITE, tm, pg_tm::tm_mday, pg_tm::tm_mon, pg_tm::tm_year, type, type_is_array_domain, USE_XSD_DATES, value, VARDATA_ANY(), VARSIZE_ANY_EXHDR(), xml_ereport(), xmlbinary, and XMLBINARY_BASE64.

Referenced by ExecEvalXmlExpr(), map_sql_value_to_xml_value(), SPI_sql_row_to_xmlelement(), and xmlelement().

◆ map_xml_name_to_sql_identifier()

char * map_xml_name_to_sql_identifier ( const char name)

Definition at line 2474 of file xml.c.

2475{
2477 const char *p;
2478
2480
2481 for (p = name; *p; p += pg_mblen_cstr(p))
2482 {
2483 if (*p == '_' && *(p + 1) == 'x'
2484 && isxdigit((unsigned char) *(p + 2))
2485 && isxdigit((unsigned char) *(p + 3))
2486 && isxdigit((unsigned char) *(p + 4))
2487 && isxdigit((unsigned char) *(p + 5))
2488 && *(p + 6) == '_')
2489 {
2491 unsigned int u;
2492
2493 sscanf(p + 2, "%X", &u);
2494 pg_unicode_to_server(u, (unsigned char *) cbuf);
2496 p += 6;
2497 }
2498 else
2500 }
2501
2502 return buf.data;
2503}

References appendBinaryStringInfo(), appendStringInfoString(), buf, fb(), initStringInfo(), MAX_UNICODE_EQUIVALENT_STRING, name, pg_mblen_cstr(), and pg_unicode_to_server().

Referenced by get_rule_expr().

◆ query_to_oid_list()

static List * query_to_oid_list ( const char query)
static

Definition at line 2824 of file xml.c.

2825{
2826 uint64 i;
2827 List *list = NIL;
2828 int spi_result;
2829
2830 spi_result = SPI_execute(query, true, 0);
2832 elog(ERROR, "SPI_execute returned %s for %s",
2834
2835 for (i = 0; i < SPI_processed; i++)
2836 {
2837 Datum oid;
2838 bool isnull;
2839
2842 1,
2843 &isnull);
2844 if (!isnull)
2845 list = lappend_oid(list, DatumGetObjectId(oid));
2846 }
2847
2848 return list;
2849}

References DatumGetObjectId(), elog, ERROR, fb(), i, lappend_oid(), NIL, SPI_execute(), SPI_getbinval(), SPI_OK_SELECT, SPI_processed, SPI_result_code_string(), SPI_tuptable, SPITupleTable::tupdesc, and SPITupleTable::vals.

Referenced by database_get_xml_visible_schemas(), database_get_xml_visible_tables(), and schema_get_xml_visible_tables().

◆ query_to_xml()

Datum query_to_xml ( PG_FUNCTION_ARGS  )

Definition at line 2937 of file xml.c.

2938{
2939 char *query = text_to_cstring(PG_GETARG_TEXT_PP(0));
2940 bool nulls = PG_GETARG_BOOL(1);
2941 bool tableforest = PG_GETARG_BOOL(2);
2942 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
2943
2945 NULL, nulls, tableforest,
2946 targetns, true)));
2947}

References fb(), PG_GETARG_BOOL, PG_GETARG_TEXT_PP, PG_RETURN_XML_P, query_to_xml_internal(), stringinfo_to_xmltype(), and text_to_cstring().

◆ query_to_xml_and_xmlschema()

Datum query_to_xml_and_xmlschema ( PG_FUNCTION_ARGS  )

Definition at line 3183 of file xml.c.

3184{
3185 char *query = text_to_cstring(PG_GETARG_TEXT_PP(0));
3186 bool nulls = PG_GETARG_BOOL(1);
3187 bool tableforest = PG_GETARG_BOOL(2);
3188 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3189
3190 const char *xmlschema;
3192 Portal portal;
3193
3194 SPI_connect();
3195
3196 if ((plan = SPI_prepare(query, 0, NULL)) == NULL)
3197 elog(ERROR, "SPI_prepare(\"%s\") failed", query);
3198
3199 if ((portal = SPI_cursor_open(NULL, plan, NULL, NULL, true)) == NULL)
3200 elog(ERROR, "SPI_cursor_open(\"%s\") failed", query);
3201
3203 InvalidOid, nulls, tableforest, targetns));
3204 SPI_cursor_close(portal);
3205 SPI_finish();
3206
3208 xmlschema, nulls, tableforest,
3209 targetns, true)));
3210}

References _SPI_strdup(), elog, ERROR, fb(), InvalidOid, map_sql_table_to_xmlschema(), PG_GETARG_BOOL, PG_GETARG_TEXT_PP, PG_RETURN_XML_P, plan, query_to_xml_internal(), SPI_connect(), SPI_cursor_close(), SPI_cursor_open(), SPI_finish(), SPI_prepare(), stringinfo_to_xmltype(), text_to_cstring(), and PortalData::tupDesc.

◆ query_to_xml_internal()

static StringInfo query_to_xml_internal ( const char query,
char tablename,
const char xmlschema,
bool  nulls,
bool  tableforest,
const char targetns,
bool  top_level 
)
static

Definition at line 3039 of file xml.c.

3042{
3043 StringInfo result;
3044 char *xmltn;
3045 uint64 i;
3046
3047 if (tablename)
3048 xmltn = map_sql_identifier_to_xml_name(tablename, true, false);
3049 else
3050 xmltn = "table";
3051
3052 result = makeStringInfo();
3053
3054 SPI_connect();
3055 if (SPI_execute(query, true, 0) != SPI_OK_SELECT)
3056 ereport(ERROR,
3058 errmsg("invalid query")));
3059
3060 if (!tableforest)
3061 {
3063 targetns, top_level);
3064 appendStringInfoChar(result, '\n');
3065 }
3066
3067 if (xmlschema)
3068 appendStringInfo(result, "%s\n\n", xmlschema);
3069
3070 for (i = 0; i < SPI_processed; i++)
3071 SPI_sql_row_to_xmlelement(i, result, tablename, nulls,
3072 tableforest, targetns, top_level);
3073
3074 if (!tableforest)
3076
3077 SPI_finish();
3078
3079 return result;
3080}

References appendStringInfo(), appendStringInfoChar(), ereport, errcode(), errmsg(), ERROR, fb(), i, makeStringInfo(), map_sql_identifier_to_xml_name(), SPI_connect(), SPI_execute(), SPI_finish(), SPI_OK_SELECT, SPI_processed, SPI_sql_row_to_xmlelement(), xmldata_root_element_end(), and xmldata_root_element_start().

Referenced by query_to_xml(), query_to_xml_and_xmlschema(), and table_to_xml_internal().

◆ query_to_xmlschema()

Datum query_to_xmlschema ( PG_FUNCTION_ARGS  )

Definition at line 3103 of file xml.c.

3104{
3105 char *query = text_to_cstring(PG_GETARG_TEXT_PP(0));
3106 bool nulls = PG_GETARG_BOOL(1);
3107 bool tableforest = PG_GETARG_BOOL(2);
3108 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3109 const char *result;
3111 Portal portal;
3112
3113 SPI_connect();
3114
3115 if ((plan = SPI_prepare(query, 0, NULL)) == NULL)
3116 elog(ERROR, "SPI_prepare(\"%s\") failed", query);
3117
3118 if ((portal = SPI_cursor_open(NULL, plan, NULL, NULL, true)) == NULL)
3119 elog(ERROR, "SPI_cursor_open(\"%s\") failed", query);
3120
3122 InvalidOid, nulls,
3124 SPI_cursor_close(portal);
3125 SPI_finish();
3126
3128}

References _SPI_strdup(), cstring_to_xmltype(), elog, ERROR, fb(), InvalidOid, map_sql_table_to_xmlschema(), PG_GETARG_BOOL, PG_GETARG_TEXT_PP, PG_RETURN_XML_P, plan, SPI_connect(), SPI_cursor_close(), SPI_cursor_open(), SPI_finish(), SPI_prepare(), text_to_cstring(), and PortalData::tupDesc.

◆ schema_get_xml_visible_tables()

static List * schema_get_xml_visible_tables ( Oid  nspid)
static

Definition at line 2853 of file xml.c.

2854{
2855 StringInfoData query;
2856
2857 initStringInfo(&query);
2858 appendStringInfo(&query, "SELECT oid FROM pg_catalog.pg_class"
2859 " WHERE relnamespace = %u AND relkind IN ("
2863 " AND pg_catalog.has_table_privilege (oid, 'SELECT')"
2864 " ORDER BY relname;", nspid);
2865
2866 return query_to_oid_list(query.data);
2867}

References appendStringInfo(), CppAsString2, StringInfoData::data, fb(), initStringInfo(), nspid, and query_to_oid_list().

Referenced by schema_to_xml_internal(), and schema_to_xmlschema_internal().

◆ schema_to_xml()

Datum schema_to_xml ( PG_FUNCTION_ARGS  )

Definition at line 3262 of file xml.c.

3263{
3265 bool nulls = PG_GETARG_BOOL(1);
3266 bool tableforest = PG_GETARG_BOOL(2);
3267 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3268
3269 char *schemaname;
3270 Oid nspid;
3271
3272 schemaname = NameStr(*name);
3273 nspid = LookupExplicitNamespace(schemaname, false);
3274
3276 nulls, tableforest, targetns, true)));
3277}

References fb(), LookupExplicitNamespace(), name, NameStr, nspid, PG_GETARG_BOOL, PG_GETARG_NAME, PG_GETARG_TEXT_PP, PG_RETURN_XML_P, schema_to_xml_internal(), stringinfo_to_xmltype(), and text_to_cstring().

◆ schema_to_xml_and_xmlschema()

Datum schema_to_xml_and_xmlschema ( PG_FUNCTION_ARGS  )

Definition at line 3366 of file xml.c.

3367{
3369 bool nulls = PG_GETARG_BOOL(1);
3370 bool tableforest = PG_GETARG_BOOL(2);
3371 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3372 char *schemaname;
3373 Oid nspid;
3375
3376 schemaname = NameStr(*name);
3377 nspid = LookupExplicitNamespace(schemaname, false);
3378
3379 xmlschema = schema_to_xmlschema_internal(schemaname, nulls,
3381
3383 xmlschema->data, nulls,
3384 tableforest, targetns, true)));
3385}

References fb(), LookupExplicitNamespace(), name, NameStr, nspid, PG_GETARG_BOOL, PG_GETARG_NAME, PG_GETARG_TEXT_PP, PG_RETURN_XML_P, schema_to_xml_internal(), schema_to_xmlschema_internal(), stringinfo_to_xmltype(), and text_to_cstring().

◆ schema_to_xml_internal()

static StringInfo schema_to_xml_internal ( Oid  nspid,
const char xmlschema,
bool  nulls,
bool  tableforest,
const char targetns,
bool  top_level 
)
static

Definition at line 3219 of file xml.c.

3221{
3222 StringInfo result;
3223 char *xmlsn;
3225 ListCell *cell;
3226
3228 true, false);
3229 result = makeStringInfo();
3230
3231 xmldata_root_element_start(result, xmlsn, xmlschema, targetns, top_level);
3232 appendStringInfoChar(result, '\n');
3233
3234 if (xmlschema)
3235 appendStringInfo(result, "%s\n\n", xmlschema);
3236
3237 SPI_connect();
3238
3240
3241 foreach(cell, relid_list)
3242 {
3243 Oid relid = lfirst_oid(cell);
3245
3247 targetns, false);
3248
3249 appendBinaryStringInfo(result, subres->data, subres->len);
3250 appendStringInfoChar(result, '\n');
3251 }
3252
3253 SPI_finish();
3254
3256
3257 return result;
3258}

References appendBinaryStringInfo(), appendStringInfo(), appendStringInfoChar(), StringInfoData::data, fb(), get_namespace_name(), lfirst_oid, makeStringInfo(), map_sql_identifier_to_xml_name(), nspid, schema_get_xml_visible_tables(), SPI_connect(), SPI_finish(), table_to_xml_internal(), xmldata_root_element_end(), and xmldata_root_element_start().

Referenced by database_to_xml_internal(), schema_to_xml(), and schema_to_xml_and_xmlschema().

◆ schema_to_xmlschema()

◆ schema_to_xmlschema_internal()

static StringInfo schema_to_xmlschema_internal ( const char schemaname,
bool  nulls,
bool  tableforest,
const char targetns 
)
static

◆ SPI_sql_row_to_xmlelement()

static void SPI_sql_row_to_xmlelement ( uint64  rownum,
StringInfo  result,
char tablename,
bool  nulls,
bool  tableforest,
const char targetns,
bool  top_level 
)
static

Definition at line 4124 of file xml.c.

4127{
4128 int i;
4129 char *xmltn;
4130
4131 if (tablename)
4132 xmltn = map_sql_identifier_to_xml_name(tablename, true, false);
4133 else
4134 {
4135 if (tableforest)
4136 xmltn = "row";
4137 else
4138 xmltn = "table";
4139 }
4140
4141 if (tableforest)
4142 xmldata_root_element_start(result, xmltn, NULL, targetns, top_level);
4143 else
4144 appendStringInfoString(result, "<row>\n");
4145
4146 for (i = 1; i <= SPI_tuptable->tupdesc->natts; i++)
4147 {
4148 char *colname;
4149 Datum colval;
4150 bool isnull;
4151
4153 true, false);
4156 i,
4157 &isnull);
4158 if (isnull)
4159 {
4160 if (nulls)
4161 appendStringInfo(result, " <%s xsi:nil=\"true\"/>\n", colname);
4162 }
4163 else
4164 appendStringInfo(result, " <%s>%s</%s>\n",
4165 colname,
4168 colname);
4169 }
4170
4171 if (tableforest)
4172 {
4174 appendStringInfoChar(result, '\n');
4175 }
4176 else
4177 appendStringInfoString(result, "</row>\n\n");
4178}

References appendStringInfo(), appendStringInfoChar(), appendStringInfoString(), fb(), i, map_sql_identifier_to_xml_name(), map_sql_value_to_xml_value(), TupleDescData::natts, SPI_fname(), SPI_getbinval(), SPI_gettypeid(), SPI_tuptable, SPITupleTable::tupdesc, SPITupleTable::vals, xmldata_root_element_end(), and xmldata_root_element_start().

Referenced by cursor_to_xml(), and query_to_xml_internal().

◆ stringinfo_to_xmltype()

◆ table_to_xml()

Datum table_to_xml ( PG_FUNCTION_ARGS  )

Definition at line 2923 of file xml.c.

2924{
2925 Oid relid = PG_GETARG_OID(0);
2926 bool nulls = PG_GETARG_BOOL(1);
2927 bool tableforest = PG_GETARG_BOOL(2);
2928 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
2929
2931 nulls, tableforest,
2932 targetns, true)));
2933}

References fb(), PG_GETARG_BOOL, PG_GETARG_OID, PG_GETARG_TEXT_PP, PG_RETURN_XML_P, stringinfo_to_xmltype(), table_to_xml_internal(), and text_to_cstring().

◆ table_to_xml_and_xmlschema()

Datum table_to_xml_and_xmlschema ( PG_FUNCTION_ARGS  )

◆ table_to_xml_internal()

static StringInfo table_to_xml_internal ( Oid  relid,
const char xmlschema,
bool  nulls,
bool  tableforest,
const char targetns,
bool  top_level 
)
static

◆ table_to_xmlschema()

Datum table_to_xmlschema ( PG_FUNCTION_ARGS  )

Definition at line 3084 of file xml.c.

3085{
3086 Oid relid = PG_GETARG_OID(0);
3087 bool nulls = PG_GETARG_BOOL(1);
3088 bool tableforest = PG_GETARG_BOOL(2);
3089 const char *targetns = text_to_cstring(PG_GETARG_TEXT_PP(3));
3090 const char *result;
3091 Relation rel;
3092
3093 rel = table_open(relid, AccessShareLock);
3094 result = map_sql_table_to_xmlschema(rel->rd_att, relid, nulls,
3096 table_close(rel, NoLock);
3097
3099}

References AccessShareLock, cstring_to_xmltype(), fb(), map_sql_table_to_xmlschema(), NoLock, PG_GETARG_BOOL, PG_GETARG_OID, PG_GETARG_TEXT_PP, PG_RETURN_XML_P, RelationData::rd_att, table_close(), table_open(), and text_to_cstring().

◆ texttoxml()

Datum texttoxml ( PG_FUNCTION_ARGS  )

Definition at line 659 of file xml.c.

660{
662
664}

References data, PG_GETARG_TEXT_PP, PG_RETURN_XML_P, xmloption, and xmlparse().

◆ xml_in()

Datum xml_in ( PG_FUNCTION_ARGS  )

Definition at line 272 of file xml.c.

273{
274#ifdef USE_LIBXML
275 char *s = PG_GETARG_CSTRING(0);
278
279 /* Build the result object. */
281
282 /*
283 * Parse the data to check if it is well-formed XML data.
284 *
285 * Note: we don't need to worry about whether a soft error is detected.
286 */
288 NULL, NULL, fcinfo->context);
289 if (doc != NULL)
291
293#else
295 return 0;
296#endif
297}

References cstring_to_text(), fb(), GetDatabaseEncoding(), NO_XML_SUPPORT, PG_GETARG_CSTRING, PG_RETURN_XML_P, and xmloption.

◆ xml_is_document()

bool xml_is_document ( xmltype arg)

Definition at line 1168 of file xml.c.

1169{
1170#ifdef USE_LIBXML
1171 xmlDocPtr doc;
1173
1174 /*
1175 * We'll report "true" if no soft error is reported by xml_parse().
1176 */
1178 GetDatabaseEncoding(), NULL, NULL, (Node *) &escontext);
1179 if (doc)
1180 xmlFreeDoc(doc);
1181
1182 return !escontext.error_occurred;
1183#else /* not USE_LIBXML */
1185 return false;
1186#endif /* not USE_LIBXML */
1187}

References arg, ErrorSaveContext::error_occurred, fb(), GetDatabaseEncoding(), NO_XML_SUPPORT, and XMLOPTION_DOCUMENT.

Referenced by ExecEvalXmlExpr().

◆ xml_is_well_formed()

Datum xml_is_well_formed ( PG_FUNCTION_ARGS  )

Definition at line 4654 of file xml.c.

4655{
4656#ifdef USE_LIBXML
4658
4660#else
4662 return 0;
4663#endif /* not USE_LIBXML */
4664}

References data, fb(), NO_XML_SUPPORT, PG_GETARG_TEXT_PP, PG_RETURN_BOOL, and xmloption.

◆ xml_is_well_formed_content()

Datum xml_is_well_formed_content ( PG_FUNCTION_ARGS  )

Definition at line 4680 of file xml.c.

4681{
4682#ifdef USE_LIBXML
4684
4686#else
4688 return 0;
4689#endif /* not USE_LIBXML */
4690}

References data, fb(), NO_XML_SUPPORT, PG_GETARG_TEXT_PP, PG_RETURN_BOOL, and XMLOPTION_CONTENT.

◆ xml_is_well_formed_document()

Datum xml_is_well_formed_document ( PG_FUNCTION_ARGS  )

Definition at line 4667 of file xml.c.

4668{
4669#ifdef USE_LIBXML
4671
4673#else
4675 return 0;
4676#endif /* not USE_LIBXML */
4677}

References data, fb(), NO_XML_SUPPORT, PG_GETARG_TEXT_PP, PG_RETURN_BOOL, and XMLOPTION_DOCUMENT.

◆ xml_out()

Datum xml_out ( PG_FUNCTION_ARGS  )

Definition at line 355 of file xml.c.

356{
358
359 /*
360 * xml_out removes the encoding property in all cases. This is because we
361 * cannot control from here whether the datum will be converted to a
362 * different client encoding, so we'd do more harm than good by including
363 * it.
364 */
366}

References PG_GETARG_XML_P, PG_RETURN_CSTRING, x, and xml_out_internal().

◆ xml_out_internal()

static char * xml_out_internal ( xmltype x,
pg_enc  target_encoding 
)
static

Definition at line 311 of file xml.c.

312{
313 char *str = text_to_cstring((text *) x);
314
315#ifdef USE_LIBXML
316 size_t len = strlen(str);
317 xmlChar *version;
318 int standalone;
319 int res_code;
320
322 &len, &version, NULL, &standalone)) == 0)
323 {
325
327
329 {
330 /*
331 * If we are not going to produce an XML declaration, eat a single
332 * newline in the original string to prevent empty first lines in
333 * the output.
334 */
335 if (*(str + len) == '\n')
336 len += 1;
337 }
339
340 pfree(str);
341
342 return buf.data;
343 }
344
347 errmsg_internal("could not parse XML declaration in stored value"),
349#endif
350 return str;
351}

References appendStringInfoString(), buf, ereport, errcode(), ERRCODE_DATA_CORRUPTED, errmsg_internal(), fb(), initStringInfo(), len, pfree(), str, text_to_cstring(), WARNING, and x.

Referenced by xml_out(), xml_send(), and XmlTableSetDocument().

◆ xml_recv()

Datum xml_recv ( PG_FUNCTION_ARGS  )

Definition at line 370 of file xml.c.

371{
372#ifdef USE_LIBXML
374 xmltype *result;
375 const char *input;
376 char *str;
377 char *newstr;
378 int nbytes;
381 int encoding;
382
383 /*
384 * Read the data in raw format. We don't know yet what the encoding is, as
385 * that information is embedded in the xml declaration; so we have to
386 * parse that before converting to server encoding.
387 */
388 nbytes = buf->len - buf->cursor;
389 input = pq_getmsgbytes(buf, nbytes);
390
391 /*
392 * We need a null-terminated string to pass to parse_xml_decl(). Rather
393 * than make a separate copy, make the temporary result one byte bigger
394 * than it needs to be.
395 */
396 result = palloc(nbytes + 1 + VARHDRSZ);
397 SET_VARSIZE(result, nbytes + VARHDRSZ);
398 memcpy(VARDATA(result), input, nbytes);
399 str = VARDATA(result);
400 str[nbytes] = '\0';
401
403
404 /*
405 * If encoding wasn't explicitly specified in the XML header, treat it as
406 * UTF-8, as that's the default in XML. This is different from xml_in(),
407 * where the input has to go through the normal client to server encoding
408 * conversion.
409 */
411
412 /*
413 * Parse the data to check if it is well-formed XML data. Assume that
414 * xml_parse will throw ERROR if not.
415 */
416 doc = xml_parse(result, xmloption, true, encoding, NULL, NULL, NULL);
418
419 /* Now that we know what we're dealing with, convert to server encoding */
421
422 if (newstr != str)
423 {
424 pfree(result);
425 result = (xmltype *) cstring_to_text(newstr);
426 pfree(newstr);
427 }
428
429 PG_RETURN_XML_P(result);
430#else
432 return 0;
433#endif
434}

References buf, cstring_to_text(), encoding, fb(), input, NO_XML_SUPPORT, palloc(), pfree(), pg_any_to_server(), PG_GETARG_POINTER, PG_RETURN_XML_P, PG_UTF8, pq_getmsgbytes(), SET_VARSIZE(), str, VARDATA(), VARHDRSZ, and xmloption.

◆ xml_send()

Datum xml_send ( PG_FUNCTION_ARGS  )

Definition at line 438 of file xml.c.

439{
441 char *outval;
443
444 /*
445 * xml_out_internal doesn't convert the encoding, it just prints the right
446 * declaration. pq_sendtext will do the conversion.
447 */
449
452 pfree(outval);
454}

References buf, fb(), pfree(), pg_get_client_encoding(), PG_GETARG_XML_P, PG_RETURN_BYTEA_P, pq_begintypsend(), pq_endtypsend(), pq_sendtext(), x, and xml_out_internal().

◆ xmlcomment()

Datum xmlcomment ( PG_FUNCTION_ARGS  )

Definition at line 491 of file xml.c.

492{
493#ifdef USE_LIBXML
495 char *argdata = VARDATA_ANY(arg);
498 int i;
499
500 /* check for "--" in string or "-" at the end */
501 for (i = 1; i < len; i++)
502 {
503 if (argdata[i] == '-' && argdata[i - 1] == '-')
506 errmsg("invalid XML comment")));
507 }
508 if (len > 0 && argdata[len - 1] == '-')
511 errmsg("invalid XML comment")));
512
514 appendStringInfoString(&buf, "<!--");
517
519#else
521 return 0;
522#endif
523}

References appendStringInfoString(), appendStringInfoText(), arg, buf, ereport, errcode(), errmsg(), ERROR, fb(), i, initStringInfo(), len, NO_XML_SUPPORT, PG_GETARG_TEXT_PP, PG_RETURN_XML_P, stringinfo_to_xmltype(), VARDATA_ANY(), and VARSIZE_ANY_EXHDR().

◆ xmlconcat()

xmltype * xmlconcat ( List args)

Definition at line 575 of file xml.c.

576{
577#ifdef USE_LIBXML
578 int global_standalone = 1;
580 bool global_version_no_value = false;
582 ListCell *v;
583
585 foreach(v, args)
586 {
588 size_t len;
589 xmlChar *version;
590 int standalone;
591 char *str;
592
593 len = VARSIZE(x) - VARHDRSZ;
594 str = text_to_cstring((text *) x);
595
596 parse_xml_decl((xmlChar *) str, &len, &version, NULL, &standalone);
597
598 if (standalone == 0 && global_standalone == 1)
600 if (standalone < 0)
602
603 if (!version)
605 else if (!global_version)
606 global_version = version;
607 else if (xmlStrcmp(version, global_version) != 0)
609
611 pfree(str);
612 }
613
615 {
616 StringInfoData buf2;
617
618 initStringInfo(&buf2);
619
620 print_xml_decl(&buf2,
622 0,
624
625 appendBinaryStringInfo(&buf2, buf.data, buf.len);
626 buf = buf2;
627 }
628
629 return stringinfo_to_xmltype(&buf);
630#else
632 return NULL;
633#endif
634}

References appendBinaryStringInfo(), appendStringInfoString(), buf, StringInfoData::data, DatumGetXmlP(), fb(), initStringInfo(), len, lfirst, NO_XML_SUPPORT, pfree(), PointerGetDatum(), str, stringinfo_to_xmltype(), text_to_cstring(), VARHDRSZ, VARSIZE(), and x.

Referenced by ExecEvalXmlExpr(), and xmlconcat2().

◆ xmlconcat2()

Datum xmlconcat2 ( PG_FUNCTION_ARGS  )

Definition at line 641 of file xml.c.

642{
643 if (PG_ARGISNULL(0))
644 {
645 if (PG_ARGISNULL(1))
647 else
649 }
650 else if (PG_ARGISNULL(1))
652 else
654 PG_GETARG_XML_P(1))));
655}

References list_make2, PG_ARGISNULL, PG_GETARG_XML_P, PG_RETURN_NULL, PG_RETURN_XML_P, and xmlconcat().

◆ xmldata_root_element_end()

static void xmldata_root_element_end ( StringInfo  result,
const char eltname 
)
static

Definition at line 3032 of file xml.c.

3033{
3034 appendStringInfo(result, "</%s>\n", eltname);
3035}

References appendStringInfo(), and fb().

Referenced by cursor_to_xml(), database_to_xml_internal(), query_to_xml_internal(), schema_to_xml_internal(), and SPI_sql_row_to_xmlelement().

◆ xmldata_root_element_start()

static void xmldata_root_element_start ( StringInfo  result,
const char eltname,
const char xmlschema,
const char targetns,
bool  top_level 
)
static

Definition at line 3005 of file xml.c.

3008{
3009 /* This isn't really wrong but currently makes no sense. */
3010 Assert(top_level || !xmlschema);
3011
3012 appendStringInfo(result, "<%s", eltname);
3013 if (top_level)
3014 {
3015 appendStringInfoString(result, " xmlns:xsi=\"" NAMESPACE_XSI "\"");
3016 if (strlen(targetns) > 0)
3017 appendStringInfo(result, " xmlns=\"%s\"", targetns);
3018 }
3019 if (xmlschema)
3020 {
3021 /* FIXME: better targets */
3022 if (strlen(targetns) > 0)
3023 appendStringInfo(result, " xsi:schemaLocation=\"%s #\"", targetns);
3024 else
3025 appendStringInfoString(result, " xsi:noNamespaceSchemaLocation=\"#\"");
3026 }
3027 appendStringInfoString(result, ">\n");
3028}

References appendStringInfo(), appendStringInfoString(), Assert, fb(), and NAMESPACE_XSI.

Referenced by cursor_to_xml(), database_to_xml_internal(), query_to_xml_internal(), schema_to_xml_internal(), and SPI_sql_row_to_xmlelement().

◆ xmlelement()

xmltype * xmlelement ( XmlExpr xexpr,
const Datum named_argvalue,
const bool named_argnull,
const Datum argvalue,
const bool argnull 
)

Definition at line 894 of file xml.c.

897{
898#ifdef USE_LIBXML
899 xmltype *result;
902 int i;
903 ListCell *arg;
904 ListCell *narg;
906 volatile xmlBufferPtr buf = NULL;
907 volatile xmlTextWriterPtr writer = NULL;
908
909 /*
910 * All arguments are already evaluated, and their values are passed in the
911 * named_argvalue/named_argnull or argvalue/argnull arrays. This avoids
912 * issues if one of the arguments involves a call to some other function
913 * or subsystem that wants to use libxml on its own terms. We examine the
914 * original XmlExpr to identify the numbers and types of the arguments.
915 */
917 i = 0;
918 foreach(arg, xexpr->named_args)
919 {
920 Expr *e = (Expr *) lfirst(arg);
921 char *str;
922
923 if (named_argnull[i])
924 str = NULL;
925 else
926 str = map_sql_value_to_xml_value(named_argvalue[i],
927 exprType((Node *) e),
928 false);
930 i++;
931 }
932
934 i = 0;
935 foreach(arg, xexpr->args)
936 {
937 Expr *e = (Expr *) lfirst(arg);
938 char *str;
939
940 /* here we can just forget NULL elements immediately */
941 if (!argnull[i])
942 {
943 str = map_sql_value_to_xml_value(argvalue[i],
944 exprType((Node *) e),
945 true);
947 }
948 i++;
949 }
950
952
953 PG_TRY();
954 {
956 if (buf == NULL || xmlerrcxt->err_occurred)
958 "could not allocate xmlBuffer");
960 if (writer == NULL || xmlerrcxt->err_occurred)
962 "could not allocate xmlTextWriter");
963
964 if (xmlTextWriterStartElement(writer, (xmlChar *) xexpr->name) < 0 ||
965 xmlerrcxt->err_occurred)
967 "could not start xml element");
968
969 forboth(arg, named_arg_strings, narg, xexpr->arg_names)
970 {
971 char *str = (char *) lfirst(arg);
972 char *argname = strVal(lfirst(narg));
973
974 if (str)
975 {
977 (xmlChar *) argname,
978 (xmlChar *) str) < 0 ||
979 xmlerrcxt->err_occurred)
981 "could not write xml attribute");
982 }
983 }
984
985 foreach(arg, arg_strings)
986 {
987 char *str = (char *) lfirst(arg);
988
989 if (xmlTextWriterWriteRaw(writer, (xmlChar *) str) < 0 ||
990 xmlerrcxt->err_occurred)
992 "could not write raw xml text");
993 }
994
996 xmlerrcxt->err_occurred)
998 "could not end xml element");
999
1000 /* we MUST do this now to flush data out to the buffer ... */
1002 writer = NULL;
1003
1004 result = xmlBuffer_to_xmltype(buf);
1005 }
1006 PG_CATCH();
1007 {
1008 if (writer)
1010 if (buf)
1012
1013 pg_xml_done(xmlerrcxt, true);
1014
1015 PG_RE_THROW();
1016 }
1017 PG_END_TRY();
1018
1020
1021 pg_xml_done(xmlerrcxt, false);
1022
1023 return result;
1024#else
1026 return NULL;
1027#endif
1028}

References arg, XmlExpr::args, buf, ERROR, exprType(), fb(), forboth, i, lappend(), lfirst, map_sql_value_to_xml_value(), XmlExpr::named_args, NIL, NO_XML_SUPPORT, PG_CATCH, PG_END_TRY, PG_RE_THROW, PG_TRY, pg_xml_done(), pg_xml_init(), PG_XML_STRICTNESS_ALL, str, strVal, and xml_ereport().

Referenced by ExecEvalXmlExpr().

◆ xmlexists()

Datum xmlexists ( PG_FUNCTION_ARGS  )

Definition at line 4589 of file xml.c.

4590{
4591#ifdef USE_LIBXML
4594 int res_nitems;
4595
4597 &res_nitems, NULL);
4598
4600#else
4602 return 0;
4603#endif
4604}

References data, fb(), NO_XML_SUPPORT, PG_GETARG_TEXT_PP, PG_GETARG_XML_P, and PG_RETURN_BOOL.

◆ xmlparse()

xmltype * xmlparse ( text data,
XmlOptionType  xmloption_arg,
bool  preserve_whitespace 
)

Definition at line 1032 of file xml.c.

1033{
1034#ifdef USE_LIBXML
1035 xmlDocPtr doc;
1036
1039 xmlFreeDoc(doc);
1040
1041 return (xmltype *) data;
1042#else
1044 return NULL;
1045#endif
1046}

References data, fb(), GetDatabaseEncoding(), and NO_XML_SUPPORT.

Referenced by ExecEvalXmlExpr(), and texttoxml().

◆ xmlpi()

xmltype * xmlpi ( const char target,
text arg,
bool  arg_is_null,
bool result_is_null 
)

Definition at line 1050 of file xml.c.

1051{
1052#ifdef USE_LIBXML
1053 xmltype *result;
1055
1056 if (pg_strcasecmp(target, "xml") == 0)
1057 ereport(ERROR,
1059 errmsg("invalid XML processing instruction"),
1060 errdetail("XML processing instruction target name cannot be \"%s\".", target)));
1061
1062 /*
1063 * Following the SQL standard, the null check comes after the syntax check
1064 * above.
1065 */
1067 if (*result_is_null)
1068 return NULL;
1069
1071
1072 appendStringInfo(&buf, "<?%s", target);
1073
1074 if (arg != NULL)
1075 {
1076 char *string;
1077
1078 string = text_to_cstring(arg);
1079 if (strstr(string, "?>") != NULL)
1080 ereport(ERROR,
1082 errmsg("invalid XML processing instruction"),
1083 errdetail("XML processing instruction cannot contain \"?>\".")));
1084
1086 appendStringInfoString(&buf, string + strspn(string, " "));
1087 pfree(string);
1088 }
1090
1091 result = stringinfo_to_xmltype(&buf);
1092 pfree(buf.data);
1093 return result;
1094#else
1096 return NULL;
1097#endif
1098}

References appendStringInfo(), appendStringInfoChar(), appendStringInfoString(), arg, buf, ereport, errcode(), errdetail(), errmsg(), ERROR, fb(), initStringInfo(), NO_XML_SUPPORT, pfree(), pg_strcasecmp(), stringinfo_to_xmltype(), and text_to_cstring().

Referenced by ExecEvalXmlExpr().

◆ xmlroot()

xmltype * xmlroot ( xmltype data,
text version,
int  standalone 
)

Definition at line 1102 of file xml.c.

1103{
1104#ifdef USE_LIBXML
1105 char *str;
1106 size_t len;
1108 int orig_standalone;
1110
1111 len = VARSIZE(data) - VARHDRSZ;
1113
1115
1116 if (version)
1117 orig_version = xml_text2xmlChar(version);
1118 else
1120
1121 switch (standalone)
1122 {
1123 case XML_STANDALONE_YES:
1124 orig_standalone = 1;
1125 break;
1126 case XML_STANDALONE_NO:
1127 orig_standalone = 0;
1128 break;
1130 orig_standalone = -1;
1131 break;
1133 /* leave original value */
1134 break;
1135 }
1136
1140
1141 return stringinfo_to_xmltype(&buf);
1142#else
1144 return NULL;
1145#endif
1146}

References appendStringInfoString(), buf, data, fb(), initStringInfo(), len, NO_XML_SUPPORT, str, stringinfo_to_xmltype(), text_to_cstring(), VARHDRSZ, VARSIZE(), XML_STANDALONE_NO, XML_STANDALONE_NO_VALUE, XML_STANDALONE_OMITTED, and XML_STANDALONE_YES.

Referenced by ExecEvalXmlExpr().

◆ XmlTableDestroyOpaque()

static void XmlTableDestroyOpaque ( struct TableFuncScanState state)
static

Definition at line 5124 of file xml.c.

5125{
5126#ifdef USE_LIBXML
5128
5129 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableDestroyOpaque");
5130
5131 /* Propagate our own error context to libxml2 */
5133
5134 if (xtCxt->xpathscomp != NULL)
5135 {
5136 int i;
5137
5138 for (i = 0; i < xtCxt->natts; i++)
5139 if (xtCxt->xpathscomp[i] != NULL)
5140 xmlXPathFreeCompExpr(xtCxt->xpathscomp[i]);
5141 }
5142
5143 if (xtCxt->xpathobj != NULL)
5144 xmlXPathFreeObject(xtCxt->xpathobj);
5145 if (xtCxt->xpathcomp != NULL)
5146 xmlXPathFreeCompExpr(xtCxt->xpathcomp);
5147 if (xtCxt->xpathcxt != NULL)
5148 xmlXPathFreeContext(xtCxt->xpathcxt);
5149 if (xtCxt->doc != NULL)
5150 xmlFreeDoc(xtCxt->doc);
5151 if (xtCxt->ctxt != NULL)
5152 xmlFreeParserCtxt(xtCxt->ctxt);
5153
5154 pg_xml_done(xtCxt->xmlerrcxt, true);
5155
5156 /* not valid anymore */
5157 xtCxt->magic = 0;
5158 state->opaque = NULL;
5159
5160#else
5162#endif /* not USE_LIBXML */
5163}

References fb(), i, NO_XML_SUPPORT, and pg_xml_done().

◆ XmlTableFetchRow()

static bool XmlTableFetchRow ( struct TableFuncScanState state)
static

Definition at line 4927 of file xml.c.

4928{
4929#ifdef USE_LIBXML
4931
4932 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableFetchRow");
4933
4934 /* Propagate our own error context to libxml2 */
4936
4937 if (xtCxt->xpathobj == NULL)
4938 {
4939 xtCxt->xpathobj = xmlXPathCompiledEval(xtCxt->xpathcomp, xtCxt->xpathcxt);
4940 if (xtCxt->xpathobj == NULL || xtCxt->xmlerrcxt->err_occurred)
4942 "could not create XPath object");
4943
4944 xtCxt->row_count = 0;
4945 }
4946
4947 if (xtCxt->xpathobj->type == XPATH_NODESET)
4948 {
4949 if (xtCxt->xpathobj->nodesetval != NULL)
4950 {
4951 if (xtCxt->row_count++ < xtCxt->xpathobj->nodesetval->nodeNr)
4952 return true;
4953 }
4954 }
4955
4956 return false;
4957#else
4959 return false;
4960#endif /* not USE_LIBXML */
4961}

References ERROR, fb(), NO_XML_SUPPORT, and xml_ereport().

◆ XmlTableGetValue()

static Datum XmlTableGetValue ( struct TableFuncScanState state,
int  colnum,
Oid  typid,
int32  typmod,
bool isnull 
)
static

Definition at line 4972 of file xml.c.

4974{
4975#ifdef USE_LIBXML
4976 Datum result = (Datum) 0;
4978 volatile xmlXPathObjectPtr xpathobj = NULL;
4979
4980 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableGetValue");
4981
4982 Assert(xtCxt->xpathobj &&
4983 xtCxt->xpathobj->type == XPATH_NODESET &&
4984 xtCxt->xpathobj->nodesetval != NULL);
4985
4986 /* Propagate our own error context to libxml2 */
4988
4989 *isnull = false;
4990
4991 Assert(xtCxt->xpathscomp[colnum] != NULL);
4992
4993 PG_TRY();
4994 {
4996 char *cstr = NULL;
4997
4998 /* Set current node as entry point for XPath evaluation */
4999 cur = xtCxt->xpathobj->nodesetval->nodeTab[xtCxt->row_count - 1];
5000 xtCxt->xpathcxt->node = cur;
5001
5002 /* Evaluate column path */
5003 xpathobj = xmlXPathCompiledEval(xtCxt->xpathscomp[colnum], xtCxt->xpathcxt);
5004 if (xpathobj == NULL || xtCxt->xmlerrcxt->err_occurred)
5006 "could not create XPath object");
5007
5008 /*
5009 * There are four possible cases, depending on the number of nodes
5010 * returned by the XPath expression and the type of the target column:
5011 * a) XPath returns no nodes. b) The target type is XML (return all
5012 * as XML). For non-XML return types: c) One node (return content).
5013 * d) Multiple nodes (error).
5014 */
5015 if (xpathobj->type == XPATH_NODESET)
5016 {
5017 int count = 0;
5018
5019 if (xpathobj->nodesetval != NULL)
5020 count = xpathobj->nodesetval->nodeNr;
5021
5022 if (xpathobj->nodesetval == NULL || count == 0)
5023 {
5024 *isnull = true;
5025 }
5026 else
5027 {
5028 if (typid == XMLOID)
5029 {
5030 text *textstr;
5032
5033 /* Concatenate serialized values */
5035 for (int i = 0; i < count; i++)
5036 {
5037 textstr =
5038 xml_xmlnodetoxmltype(xpathobj->nodesetval->nodeTab[i],
5039 xtCxt->xmlerrcxt);
5040
5042 }
5043 cstr = str.data;
5044 }
5045 else
5046 {
5047 xmlChar *str;
5048
5049 if (count > 1)
5050 ereport(ERROR,
5052 errmsg("more than one value returned by column XPath expression")));
5053
5055 cstr = str ? xml_pstrdup_and_free(str) : "";
5056 }
5057 }
5058 }
5059 else if (xpathobj->type == XPATH_STRING)
5060 {
5061 /* Content should be escaped when target will be XML */
5062 if (typid == XMLOID)
5063 cstr = escape_xml((char *) xpathobj->stringval);
5064 else
5065 cstr = (char *) xpathobj->stringval;
5066 }
5067 else if (xpathobj->type == XPATH_BOOLEAN)
5068 {
5069 char typcategory;
5070 bool typispreferred;
5071 xmlChar *str;
5072
5073 /* Allow implicit casting from boolean to numbers */
5075
5078 else
5080
5082 }
5083 else if (xpathobj->type == XPATH_NUMBER)
5084 {
5085 xmlChar *str;
5086
5089 }
5090 else
5091 elog(ERROR, "unexpected XPath object type %u", xpathobj->type);
5092
5093 /*
5094 * By here, either cstr contains the result value, or the isnull flag
5095 * has been set.
5096 */
5097 Assert(cstr || *isnull);
5098
5099 if (!*isnull)
5100 result = InputFunctionCall(&state->in_functions[colnum],
5101 cstr,
5102 state->typioparams[colnum],
5103 typmod);
5104 }
5105 PG_FINALLY();
5106 {
5107 if (xpathobj != NULL)
5109 }
5110 PG_END_TRY();
5111
5112 return result;
5113#else
5115 return 0;
5116#endif /* not USE_LIBXML */
5117}

References appendStringInfoText(), Assert, cur, elog, ereport, errcode(), errmsg(), ERROR, escape_xml(), fb(), get_type_category_preferred(), i, initStringInfo(), InputFunctionCall(), NO_XML_SUPPORT, PG_END_TRY, PG_FINALLY, PG_TRY, str, and xml_ereport().

◆ XmlTableInitOpaque()

static void XmlTableInitOpaque ( struct TableFuncScanState state,
int  natts 
)
static

Definition at line 4729 of file xml.c.

4730{
4731#ifdef USE_LIBXML
4732 volatile xmlParserCtxtPtr ctxt = NULL;
4735
4738 xtCxt->natts = natts;
4739 xtCxt->xpathscomp = palloc0_array(xmlXPathCompExprPtr, natts);
4740
4742
4743 PG_TRY();
4744 {
4745 xmlInitParser();
4746
4747 ctxt = xmlNewParserCtxt();
4748 if (ctxt == NULL || xmlerrcxt->err_occurred)
4750 "could not allocate parser context");
4751 }
4752 PG_CATCH();
4753 {
4754 if (ctxt != NULL)
4755 xmlFreeParserCtxt(ctxt);
4756
4757 pg_xml_done(xmlerrcxt, true);
4758
4759 PG_RE_THROW();
4760 }
4761 PG_END_TRY();
4762
4763 xtCxt->xmlerrcxt = xmlerrcxt;
4764 xtCxt->ctxt = ctxt;
4765
4766 state->opaque = xtCxt;
4767#else
4769#endif /* not USE_LIBXML */
4770}

References ERROR, fb(), NO_XML_SUPPORT, palloc0_array, palloc0_object, PG_CATCH, PG_END_TRY, PG_RE_THROW, PG_TRY, pg_xml_done(), pg_xml_init(), PG_XML_STRICTNESS_ALL, and xml_ereport().

◆ XmlTableSetColumnFilter()

static void XmlTableSetColumnFilter ( struct TableFuncScanState state,
const char path,
int  colnum 
)
static

Definition at line 4892 of file xml.c.

4893{
4894#ifdef USE_LIBXML
4896 xmlChar *xstr;
4897
4898 Assert(path);
4899
4900 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableSetColumnFilter");
4901
4902 if (*path == '\0')
4903 ereport(ERROR,
4905 errmsg("column path filter must not be empty string")));
4906
4907 xstr = pg_xmlCharStrndup(path, strlen(path));
4908
4909 /* We require XmlTableSetDocument to have been done already */
4910 Assert(xtCxt->xpathcxt != NULL);
4911
4912 xtCxt->xpathscomp[colnum] = xmlXPathCtxtCompile(xtCxt->xpathcxt, xstr);
4913 if (xtCxt->xpathscomp[colnum] == NULL || xtCxt->xmlerrcxt->err_occurred)
4915 "invalid XPath expression");
4916#else
4918#endif /* not USE_LIBXML */
4919}

References Assert, ereport, errcode(), errmsg(), ERROR, fb(), NO_XML_SUPPORT, and xml_ereport().

◆ XmlTableSetDocument()

static void XmlTableSetDocument ( struct TableFuncScanState state,
Datum  value 
)
static

Definition at line 4777 of file xml.c.

4778{
4779#ifdef USE_LIBXML
4782 char *str;
4783 xmlChar *xstr;
4784 int length;
4785 volatile xmlDocPtr doc = NULL;
4786 volatile xmlXPathContextPtr xpathcxt = NULL;
4787
4788 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableSetDocument");
4789
4790 /*
4791 * Use out function for casting to string (remove encoding property). See
4792 * comment in xml_out.
4793 */
4795
4796 length = strlen(str);
4797 xstr = pg_xmlCharStrndup(str, length);
4798
4799 PG_TRY();
4800 {
4801 doc = xmlCtxtReadMemory(xtCxt->ctxt, (char *) xstr, length, NULL, NULL, 0);
4802 if (doc == NULL || xtCxt->xmlerrcxt->err_occurred)
4804 "could not parse XML document");
4806 if (xpathcxt == NULL || xtCxt->xmlerrcxt->err_occurred)
4808 "could not allocate XPath context");
4809 xpathcxt->node = (xmlNodePtr) doc;
4810 }
4811 PG_CATCH();
4812 {
4813 if (xpathcxt != NULL)
4815 if (doc != NULL)
4816 xmlFreeDoc(doc);
4817
4818 PG_RE_THROW();
4819 }
4820 PG_END_TRY();
4821
4822 xtCxt->doc = doc;
4823 xtCxt->xpathcxt = xpathcxt;
4824#else
4826#endif /* not USE_LIBXML */
4827}

References DatumGetXmlP(), ERROR, fb(), NO_XML_SUPPORT, PG_CATCH, PG_END_TRY, PG_RE_THROW, PG_TRY, str, value, xml_ereport(), and xml_out_internal().

◆ XmlTableSetNamespace()

static void XmlTableSetNamespace ( struct TableFuncScanState state,
const char name,
const char uri 
)
static

Definition at line 4834 of file xml.c.

4835{
4836#ifdef USE_LIBXML
4838
4839 if (name == NULL)
4840 ereport(ERROR,
4842 errmsg("DEFAULT namespace is not supported")));
4843 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableSetNamespace");
4844
4845 if (xmlXPathRegisterNs(xtCxt->xpathcxt,
4849 "could not set XML namespace");
4850#else
4852#endif /* not USE_LIBXML */
4853}

References ereport, errcode(), errmsg(), ERROR, fb(), name, NO_XML_SUPPORT, and xml_ereport().

◆ XmlTableSetRowFilter()

static void XmlTableSetRowFilter ( struct TableFuncScanState state,
const char path 
)
static

Definition at line 4860 of file xml.c.

4861{
4862#ifdef USE_LIBXML
4864 xmlChar *xstr;
4865
4866 xtCxt = GetXmlTableBuilderPrivateData(state, "XmlTableSetRowFilter");
4867
4868 if (*path == '\0')
4869 ereport(ERROR,
4871 errmsg("row path filter must not be empty string")));
4872
4873 xstr = pg_xmlCharStrndup(path, strlen(path));
4874
4875 /* We require XmlTableSetDocument to have been done already */
4876 Assert(xtCxt->xpathcxt != NULL);
4877
4878 xtCxt->xpathcomp = xmlXPathCtxtCompile(xtCxt->xpathcxt, xstr);
4879 if (xtCxt->xpathcomp == NULL || xtCxt->xmlerrcxt->err_occurred)
4881 "invalid XPath expression");
4882#else
4884#endif /* not USE_LIBXML */
4885}

References Assert, ereport, errcode(), errmsg(), ERROR, fb(), NO_XML_SUPPORT, and xml_ereport().

◆ xmltext()

Datum xmltext ( PG_FUNCTION_ARGS  )

Definition at line 527 of file xml.c.

528{
529#ifdef USE_LIBXML
531 text *result;
532 volatile xmlChar *xmlbuf = NULL;
534
535 /* First we gotta spin up some error handling. */
537
538 PG_TRY();
539 {
541
542 if (xmlbuf == NULL || xmlerrcxt->err_occurred)
544 "could not allocate xmlChar");
545
546 result = cstring_to_text_with_len((const char *) xmlbuf,
547 xmlStrlen((const xmlChar *) xmlbuf));
548 }
549 PG_CATCH();
550 {
551 if (xmlbuf)
553
554 pg_xml_done(xmlerrcxt, true);
555 PG_RE_THROW();
556 }
557 PG_END_TRY();
558
560 pg_xml_done(xmlerrcxt, false);
561
562 PG_RETURN_XML_P(result);
563#else
565 return 0;
566#endif /* not USE_LIBXML */
567}

References arg, cstring_to_text_with_len(), ERROR, fb(), NO_XML_SUPPORT, PG_CATCH, PG_END_TRY, PG_GETARG_TEXT_PP, PG_RE_THROW, PG_RETURN_XML_P, PG_TRY, pg_xml_done(), pg_xml_init(), PG_XML_STRICTNESS_ALL, and xml_ereport().

◆ xmltotext()

Datum xmltotext ( PG_FUNCTION_ARGS  )

Definition at line 668 of file xml.c.

669{
671
672 /* It's actually binary compatible. */
674}

References data, PG_GETARG_XML_P, and PG_RETURN_TEXT_P.

◆ xmltotext_with_options()

text * xmltotext_with_options ( xmltype data,
XmlOptionType  xmloption_arg,
bool  indent 
)

Definition at line 678 of file xml.c.

679{
680#ifdef USE_LIBXML
681 text *volatile result;
685 volatile xmlBufferPtr buf = NULL;
686 volatile xmlSaveCtxtPtr ctxt = NULL;
688 PgXmlErrorContext *volatile xmlerrcxt = NULL;
689#endif
690
691 if (xmloption_arg != XMLOPTION_DOCUMENT && !indent)
692 {
693 /*
694 * We don't actually need to do anything, so just return the
695 * binary-compatible input. For backwards-compatibility reasons,
696 * allow such cases to succeed even without USE_LIBXML.
697 */
698 return (text *) data;
699 }
700
701#ifdef USE_LIBXML
702
703 /*
704 * Parse the input according to the xmloption.
705 *
706 * preserve_whitespace is set to false in case we are indenting, otherwise
707 * libxml2 will fail to indent elements that have whitespace between them.
708 */
711 (Node *) &escontext);
712 if (doc == NULL || escontext.error_occurred)
713 {
714 if (doc)
716 /* A soft error must be failure to conform to XMLOPTION_DOCUMENT */
719 errmsg("not an XML document")));
720 }
721
722 /* If we weren't asked to indent, we're done. */
723 if (!indent)
724 {
726 return (text *) data;
727 }
728
729 /*
730 * Otherwise, we gotta spin up some error handling. Unlike most other
731 * routines in this module, we already have a libxml "doc" structure to
732 * free, so we need to call pg_xml_init() inside the PG_TRY and be
733 * prepared for it to fail (typically due to palloc OOM).
734 */
735 PG_TRY();
736 {
737 size_t decl_len = 0;
738
740
741 /* The serialized data will go into this buffer. */
743
744 if (buf == NULL || xmlerrcxt->err_occurred)
746 "could not allocate xmlBuffer");
747
748 /* Detect whether there's an XML declaration */
750
751 /*
752 * Emit declaration only if the input had one. Note: some versions of
753 * xmlSaveToBuffer leak memory if a non-null encoding argument is
754 * passed, so don't do that. We don't want any encoding conversion
755 * anyway.
756 */
757 if (decl_len == 0)
758 ctxt = xmlSaveToBuffer(buf, NULL,
760 else
761 ctxt = xmlSaveToBuffer(buf, NULL,
763
764 if (ctxt == NULL || xmlerrcxt->err_occurred)
766 "could not allocate xmlSaveCtxt");
767
769 {
770 /* If it's a document, saving is easy. */
771 if (xmlSaveDoc(ctxt, doc) == -1 || xmlerrcxt->err_occurred)
773 "could not save document to xmlBuffer");
774 }
775 else if (content_nodes != NULL)
776 {
777 /*
778 * Deal with the case where we have non-singly-rooted XML.
779 * libxml's dump functions don't work well for that without help.
780 * We build a fake root node that serves as a container for the
781 * content nodes, and then iterate over the nodes.
782 */
786
787 root = xmlNewNode(NULL, (const xmlChar *) "content-root");
788 if (root == NULL || xmlerrcxt->err_occurred)
790 "could not allocate xml node");
791
792 /*
793 * This attaches root to doc, so we need not free it separately...
794 * but instead, we have to free the old root if there was one.
795 */
797 if (oldroot != NULL)
799
801 xmlerrcxt->err_occurred)
803 "could not append xml node list");
804
805 /*
806 * We use this node to insert newlines in the dump. Note: in at
807 * least some libxml versions, xmlNewDocText would not attach the
808 * node to the document even if we passed it. Therefore, manage
809 * freeing of this node manually, and pass NULL here to make sure
810 * there's not a dangling link.
811 */
812 newline = xmlNewDocText(NULL, (const xmlChar *) "\n");
813 if (newline == NULL || xmlerrcxt->err_occurred)
815 "could not allocate xml node");
816
817 for (xmlNodePtr node = root->children; node; node = node->next)
818 {
819 /* insert newlines between nodes */
820 if (node->type != XML_TEXT_NODE && node->prev != NULL)
821 {
822 if (xmlSaveTree(ctxt, newline) == -1 || xmlerrcxt->err_occurred)
823 {
826 "could not save newline to xmlBuffer");
827 }
828 }
829
830 if (xmlSaveTree(ctxt, node) == -1 || xmlerrcxt->err_occurred)
831 {
834 "could not save content to xmlBuffer");
835 }
836 }
837
839 }
840
841 if (xmlSaveClose(ctxt) == -1 || xmlerrcxt->err_occurred)
842 {
843 ctxt = NULL; /* don't try to close it again */
845 "could not close xmlSaveCtxtPtr");
846 }
847
848 /*
849 * xmlDocContentDumpOutput may add a trailing newline, so remove that.
850 */
852 {
853 const char *str = (const char *) xmlBufferContent(buf);
854 int len = xmlBufferLength(buf);
855
856 while (len > 0 && (str[len - 1] == '\n' ||
857 str[len - 1] == '\r'))
858 len--;
859
861 }
862 else
863 result = (text *) xmlBuffer_to_xmltype(buf);
864 }
865 PG_CATCH();
866 {
867 if (ctxt)
868 xmlSaveClose(ctxt);
869 if (buf)
872
873 if (xmlerrcxt)
874 pg_xml_done(xmlerrcxt, true);
875
876 PG_RE_THROW();
877 }
878 PG_END_TRY();
879
882
883 pg_xml_done(xmlerrcxt, false);
884
885 return result;
886#else
888 return NULL;
889#endif
890}

References buf, cstring_to_text_with_len(), data, ereport, errcode(), errmsg(), ERROR, ErrorSaveContext::error_occurred, fb(), GetDatabaseEncoding(), len, newline, NO_XML_SUPPORT, PG_CATCH, PG_END_TRY, PG_RE_THROW, PG_TRY, pg_xml_done(), pg_xml_init(), PG_XML_STRICTNESS_ALL, root, str, xml_ereport(), and XMLOPTION_DOCUMENT.

Referenced by ExecEvalXmlExpr().

◆ xmlvalidate()

Datum xmlvalidate ( PG_FUNCTION_ARGS  )

Definition at line 1158 of file xml.c.

1159{
1160 ereport(ERROR,
1162 errmsg("xmlvalidate is not implemented")));
1163 return 0;
1164}

References ereport, errcode(), errmsg(), ERROR, and fb().

◆ xpath()

Datum xpath ( PG_FUNCTION_ARGS  )

Definition at line 4566 of file xml.c.

4567{
4568#ifdef USE_LIBXML
4571 ArrayType *namespaces = PG_GETARG_ARRAYTYPE_P(2);
4572 ArrayBuildState *astate;
4573
4575 xpath_internal(xpath_expr_text, data, namespaces,
4576 NULL, astate);
4578#else
4580 return 0;
4581#endif
4582}

References CurrentMemoryContext, data, fb(), initArrayResult(), makeArrayResult(), NO_XML_SUPPORT, PG_GETARG_ARRAYTYPE_P, PG_GETARG_TEXT_PP, PG_GETARG_XML_P, and PG_RETURN_DATUM.

Referenced by pgxml_xpath(), xpath_bool(), xpath_list(), xpath_nodeset(), xpath_number(), and xpath_string().

◆ xpath_exists()

Datum xpath_exists ( PG_FUNCTION_ARGS  )

Definition at line 4612 of file xml.c.

4613{
4614#ifdef USE_LIBXML
4617 ArrayType *namespaces = PG_GETARG_ARRAYTYPE_P(2);
4618 int res_nitems;
4619
4620 xpath_internal(xpath_expr_text, data, namespaces,
4621 &res_nitems, NULL);
4622
4624#else
4626 return 0;
4627#endif
4628}

References data, fb(), NO_XML_SUPPORT, PG_GETARG_ARRAYTYPE_P, PG_GETARG_TEXT_PP, PG_GETARG_XML_P, and PG_RETURN_BOOL.

◆ xsd_schema_element_end()

static void xsd_schema_element_end ( StringInfo  result)
static

Definition at line 3301 of file xml.c.

3302{
3303 appendStringInfoString(result, "</xsd:schema>");
3304}

References appendStringInfoString().

Referenced by database_to_xmlschema_internal(), map_sql_table_to_xmlschema(), and schema_to_xmlschema_internal().

◆ xsd_schema_element_start()

static void xsd_schema_element_start ( StringInfo  result,
const char targetns 
)
static

Definition at line 3284 of file xml.c.

3285{
3287 "<xsd:schema\n"
3288 " xmlns:xsd=\"" NAMESPACE_XSD "\"");
3289 if (strlen(targetns) > 0)
3290 appendStringInfo(result,
3291 "\n"
3292 " targetNamespace=\"%s\"\n"
3293 " elementFormDefault=\"qualified\"",
3294 targetns);
3296 ">\n\n");
3297}

References appendStringInfo(), appendStringInfoString(), fb(), and NAMESPACE_XSD.

Referenced by database_to_xmlschema_internal(), map_sql_table_to_xmlschema(), and schema_to_xmlschema_internal().

Variable Documentation

◆ xmlbinary

int xmlbinary = XMLBINARY_BASE64

Definition at line 108 of file xml.c.

Referenced by map_sql_type_to_xmlschema_type(), and map_sql_value_to_xml_value().

◆ xmloption

int xmloption = XMLOPTION_CONTENT

Definition at line 109 of file xml.c.

Referenced by texttoxml(), xml_in(), xml_is_well_formed(), and xml_recv().

◆ XmlTableRoutine

const TableFuncRoutine XmlTableRoutine
Initial value:
=
{
.InitOpaque = XmlTableInitOpaque,
.SetDocument = XmlTableSetDocument,
.SetNamespace = XmlTableSetNamespace,
.SetRowFilter = XmlTableSetRowFilter,
.SetColumnFilter = XmlTableSetColumnFilter,
.FetchRow = XmlTableFetchRow,
.GetValue = XmlTableGetValue,
.DestroyOpaque = XmlTableDestroyOpaque
}

Definition at line 222 of file xml.c.

223{
224 .InitOpaque = XmlTableInitOpaque,
225 .SetDocument = XmlTableSetDocument,
226 .SetNamespace = XmlTableSetNamespace,
227 .SetRowFilter = XmlTableSetRowFilter,
228 .SetColumnFilter = XmlTableSetColumnFilter,
229 .FetchRow = XmlTableFetchRow,
230 .GetValue = XmlTableGetValue,
231 .DestroyOpaque = XmlTableDestroyOpaque
232};

Referenced by ExecInitTableFuncScan().