SaxonC 13.1.0
Saxon Processor library for C/C++, PHP and Python
Loading...
Searching...
No Matches
XsltExecutable.h
1
2// Copyright (c) 2022 - 2025 Saxonica Limited.
3// This Source Code Form is subject to the terms of the Mozilla Public License,
4// v. 2.0. If a copy of the MPL was not distributed with this file, You can
5// obtain one at http://mozilla.org/MPL/2.0/. This Source Code Form is
6// "Incompatible With Secondary Licenses", as defined by the Mozilla Public
7// License, v. 2.0.
9
10#ifndef SAXON_XSLT_EXEC_H
11#define SAXON_XSLT_EXEC_H
12
13#include "saxonc_export.h"
14#include "saxonc/SaxonProcessor.h"
15//#include "XdmValue.h"
16#include <string>
17
18class SaxonProcessor;
20class Xslt30Processor;
21class XdmValue;
22class XdmItem;
23class XdmNode;
24class XdmFunctionItem;
25
33class SAXONC_EXPORT XsltExecutable {
34
35 friend class Xslt30Processor;
36
37public:
38 ~XsltExecutable();
39
48 void setcwd(const char *cwd);
49
56 const char * getcwd();
57
67 void setBaseOutputURI(const char *baseURI);
68
76
77 void setGlobalContextItem(XdmItem *value);
78
85 void setGlobalContextFromFile(const char *filename);
86
91 XsltExecutable *clone();
92
102 void setInitialMode(const char *modeName);
103
109 void setInitialMatchSelection(XdmValue *selection);
110
117 void setInitialMatchSelectionAsFile(const char *filename);
118
123 void setOutputFile(const char *outfile);
124
133 void setResultAsRawValue(bool option);
134
143 void setParameter(const char *name, XdmValue *value);
144
154 std::map<std::string, XdmValue *> &getResultDocuments();
155
162 XdmValue *getParameter(const char *name, bool withParam=true);
163
170 bool removeParameter(const char *name);
171
178 bool removeProperty(const char *name);
179
189 void setProperty(const char *name, const char *value);
190
219
220 void
221 setInitialTemplateParameters(std::map<std::string, XdmValue *> parameters,
222 bool tunnel);
223
230 const char *getProperty(const char *name);
231
239 std::map<std::string, XdmValue *> &getParameters();
240
245 std::map<std::string, std::string> &getProperties();
246
254 void clearParameters(bool deleteValues = false);
255
259 void clearProperties();
260
261
265 char **createCharArray(int len) { return (new char *[len]); }
266
273 void deleteXdmValueArray(XdmValue **arr, int len);
274
286 void setSaveXslMessage(bool show, const char *filename = nullptr);
287
302 void setCaptureResultDocuments(bool flag, bool rawResults = false);
303
318 void exportStylesheet(const char *filename);
319
328 void transformFileToFile(const char *sourcefile, const char *outputfile);
329
338 const char *transformFileToString(const char *sourcefile);
339
348 XdmValue *transformFileToValue(const char *sourcefile);
349
361 void applyTemplatesReturningFile(const char *outfile);
362
374 const char *applyTemplatesReturningString();
375
386 XdmValue *applyTemplatesReturningValue();
387
402 void callTemplateReturningFile(const char *templateName, const char *outfile);
403
420 const char *callTemplateReturningString(const char *templateName = nullptr);
421
438 XdmValue *callTemplateReturningValue(const char *templateName = nullptr);
439
454 void callFunctionReturningFile(const char *functionName, XdmValue **arguments,
455 int argument_length, const char *outfile);
456
473 const char *callFunctionReturningString(const char *functionName,
474 XdmValue **arguments,
475 int argument_length);
476
493 XdmValue *callFunctionReturningValue(const char *functionName,
494 XdmValue **arguments,
495 int argument_length);
496
508 const char *transformToString(XdmNode *source = nullptr);
509
520 XdmValue *transformToValue(XdmNode *source = nullptr);
521
530 void transformToFile(XdmNode *source = nullptr);
531
539 XdmValue *getXslMessages();
540
546 void clearXslMessages();
547
548
552 SaxonProcessor* getSaxonProcessor();
553
554
555private:
561
568 XsltExecutable(int64_t procRef, int64_t exObject, std::string cwd);
569
574 XsltExecutable(const XsltExecutable &other);
575
576
577 void setParameter(const char *name, XdmValue *value, bool withParam);
578
579 //SaxonProcessor *proc; /*! Pointer to the SaxonProcessor object which created this XsltExecutable */
580 // jclass cppClass;
581 // jclass messageListenerClass, resultDocumentClass;
582 int64_t procRef, executableRef, selectionRef, saxonMessageHandlerRef,
583 saxonResultDocRef;
584 bool selectionStringFlag;
587 std::string cwdXE;
588 bool jitCompilation, rawResultsFlag;
589 std::map<std::string, XdmValue *>
590 parameters;
592 std::map<std::string, std::string>
593 properties;
595 std::map<std::string, XdmValue *> resultDocumentMap;
596};
597
598#endif /* SAXON_XSLT_EXEC_H */
SAXONC_EXPORT void setParameter(sxnc_parameter **parameters, int *parLen, int *parCap, const char *name, sxnc_value *value)
Set a parameter.
Definition SaxonCGlue.c:202
SAXONC_EXPORT int64_t getParameter(sxnc_parameter *parameters, int parLen, const char *name)
Get a parameter from the list.
Definition SaxonCGlue.c:178
SAXONC_EXPORT void setProperty(sxnc_property **properties, int *propLen, int *propCap, const char *name, const char *value)
Set a property.
Definition SaxonCGlue.c:228
SAXONC_EXPORT char * getProperty(sxnc_property *properties, int propLen, const char *name)
Get a property from the list.
Definition SaxonCGlue.c:190
SaxonApiException.
Definition SaxonApiException.h:25
The SaxonProcessor class acts as a factory for generating XQuery, XPath, Schema and XSLT compilers.
Definition SaxonProcessor.h:137
The class XdmFunctionItem represents a function item.
Definition XdmFunctionItem.h:26
The class XdmItem represents an item in a sequence, as defined by the XDM data model.
Definition XdmItem.h:31
This class represents a node in the XDM data model.
Definition XdmNode.h:57
An XdmValue represents a value in the XDM data model.
Definition XdmValue.h:33
An Xslt30Processor represents a factory to compile, load and execute stylesheets.
Definition Xslt30Processor.h:31
An XsltExecutable represents the compiled form of a stylesheet.
Definition XsltExecutable.h:33
void setInitialMatchSelectionAsFile(const char *filename)
Set the initial match selection for the transformation to be a specified file.
Definition XsltExecutable.cpp:154
void clearParameters(bool deleteValues=false)
Clear stylesheet parameter values set.
Definition XsltExecutable.cpp:357
const char * getcwd()
Get the current working directory (cwd).
Definition XsltExecutable.cpp:402
void clearProperties()
Clear configuration property values set.
Definition XsltExecutable.cpp:376
void setInitialMatchSelection(XdmValue *selection)
Set the initial match selection for the transformation to be a specified XDM value.
Definition XsltExecutable.cpp:145
bool removeParameter(const char *name)
Remove a parameter (name, value) pair set for a stylesheet parameter.
Definition XsltExecutable.cpp:312
void setGlobalContextFromFile(const char *filename)
Supply the context item to be used when evaluating global variables and parameters.
Definition XsltExecutable.cpp:135
XsltExecutable * clone()
Create a clone of this XsltExecutable object.
Definition XsltExecutable.cpp:326
void setResultAsRawValue(bool option)
Specify how transformation results are returned.
Definition XsltExecutable.cpp:316
std::map< std::string, XdmValue * > & getResultDocuments()
Obtain the secondary result documents resulting from the execution of the stylesheet,...
Definition XsltExecutable.cpp:258
void setcwd(const char *cwd)
Set the current working directory (cwd).
Definition XsltExecutable.cpp:396
void setBaseOutputURI(const char *baseURI)
Set the base output URI.
Definition XsltExecutable.cpp:172
std::map< std::string, std::string > & getProperties()
Get all configuration properties specified on the processor as a std::map.
Definition XsltExecutable.cpp:391
void setOutputFile(const char *outfile)
Set the output file where the transformation result is sent.
Definition XsltExecutable.cpp:168
void setInitialMode(const char *modeName)
Set the initial mode for the transformation.
Definition XsltExecutable.cpp:178
char ** createCharArray(int len)
Utility method for working with SaxonC on Python - internal use only.
Definition XsltExecutable.h:265
std::map< std::string, XdmValue * > & getParameters()
Get all parameters as a std::map.
Definition XsltExecutable.cpp:386
void setGlobalContextItem(XdmItem *value)
Supply the context item to be used when evaluating global variables and parameters.
Definition XsltExecutable.cpp:125
void setInitialTemplateParameters(std::map< std::string, XdmValue * > parameters, bool tunnel)
Set parameters to be passed to the initial template.
Definition XsltExecutable.cpp:217
bool removeProperty(const char *name)
Remove a configuration property (name, value) pair specific to the processor in use.
Definition XsltExecutable.cpp:344