SaxonC 13.0.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
30class SAXONC_EXPORT XsltExecutable {
31
32 friend class Xslt30Processor;
33
34public:
35 ~XsltExecutable();
36
45 void setcwd(const char *cwd);
46
53 const char * getcwd();
54
64 void setBaseOutputURI(const char *baseURI);
65
73
74 void setGlobalContextItem(XdmItem *value);
75
82 void setGlobalContextFromFile(const char *filename);
83
88 XsltExecutable *clone();
89
99 void setInitialMode(const char *modeName);
100
106 void setInitialMatchSelection(XdmValue *selection);
107
114 void setInitialMatchSelectionAsFile(const char *filename);
115
120 void setOutputFile(const char *outfile);
121
130 void setResultAsRawValue(bool option);
131
140 void setParameter(const char *name, XdmValue *value);
141
151 std::map<std::string, XdmValue *> &getResultDocuments();
152
159 XdmValue *getParameter(const char *name, bool withParam=true);
160
167 bool removeParameter(const char *name);
168
175 bool removeProperty(const char *name);
176
186 void setProperty(const char *name, const char *value);
187
216
217 void
218 setInitialTemplateParameters(std::map<std::string, XdmValue *> parameters,
219 bool tunnel);
220
227 const char *getProperty(const char *name);
228
236 std::map<std::string, XdmValue *> &getParameters();
237
242 std::map<std::string, std::string> &getProperties();
243
251 void clearParameters(bool deleteValues = false);
252
256 void clearProperties();
257
258
262 char **createCharArray(int len) { return (new char *[len]); }
263
270 void deleteXdmValueArray(XdmValue **arr, int len);
271
283 void setSaveXslMessage(bool show, const char *filename = nullptr);
284
299 void setCaptureResultDocuments(bool flag, bool rawResults = false);
300
315 void exportStylesheet(const char *filename);
316
325 void transformFileToFile(const char *sourcefile, const char *outputfile);
326
335 const char *transformFileToString(const char *sourcefile);
336
345 XdmValue *transformFileToValue(const char *sourcefile);
346
358 void applyTemplatesReturningFile(const char *outfile);
359
371 const char *applyTemplatesReturningString();
372
383 XdmValue *applyTemplatesReturningValue();
384
399 void callTemplateReturningFile(const char *templateName, const char *outfile);
400
417 const char *callTemplateReturningString(const char *templateName = nullptr);
418
435 XdmValue *callTemplateReturningValue(const char *templateName = nullptr);
436
451 void callFunctionReturningFile(const char *functionName, XdmValue **arguments,
452 int argument_length, const char *outfile);
453
470 const char *callFunctionReturningString(const char *functionName,
471 XdmValue **arguments,
472 int argument_length);
473
490 XdmValue *callFunctionReturningValue(const char *functionName,
491 XdmValue **arguments,
492 int argument_length);
493
505 const char *transformToString(XdmNode *source = nullptr);
506
517 XdmValue *transformToValue(XdmNode *source = nullptr);
518
527 void transformToFile(XdmNode *source = nullptr);
528
536 XdmValue *getXslMessages();
537
543 void clearXslMessages();
544
545
549 SaxonProcessor* getSaxonProcessor();
550
551
552private:
558
565 XsltExecutable(int64_t procRef, int64_t exObject, std::string cwd);
566
571 XsltExecutable(const XsltExecutable &other);
572
573
574 void setParameter(const char *name, XdmValue *value, bool withParam);
575
576 //SaxonProcessor *proc; /*! Pointer to the SaxonProcessor object which created this XsltExecutable */
577 // jclass cppClass;
578 // jclass messageListenerClass, resultDocumentClass;
579 int64_t procRef, executableRef, selectionRef, saxonMessageHandlerRef,
580 saxonResultDocRef;
581 bool selectionStringFlag;
584 std::string cwdXE;
585 bool jitCompilation, rawResultsFlag;
586 std::map<std::string, XdmValue *>
587 parameters;
589 std::map<std::string, std::string>
590 properties;
592 std::map<std::string, XdmValue *> resultDocumentMap;
593};
594
595#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:30
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:262
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