Table of Contents

---

XBinder Overview 1

Using XBinder 2

Running XBinder from the Command-line 2

Compiling and Linking Generated Code 10

Getting Started with C or C++ Sample Programs 11

Getting Started with your own XML Schema 12

Generated C/C++ Source Code 15

Header (.h) File 15

C Code Generated for XSD Types 15

C Code Generated for XSD Global Elements 17

C++ Code Generated for XSD Types 18

C++ Code Generated for XSD Global Elements 19

Namespace Considerations 20

XSD Simple Type to C/C++ Type Mappings 22

Character String Types 24

Enumerated Type 25

Real Number Types 28

Binary String Types 29

Dynamic Case (no length facet): 30

Static Case (length restricted to 32K or less): 30

Date/Time Types 31

Boolean Type 32

Union Type 32

List Type 34

XSD Complex Type to C/C++ Type Mappings 36

SEQUENCE 36

Optional Elements 37

Repeating Elements 38

Nested Types 41

Any Element 43

ALL 44

CHOICE 44

Generated C++ Get/Set Methods 46

Substitution Groups 49

Attributes 51

ComplexContent 53

Element Extension 53

Attribute Extension 55

Restrictions 56

SimpleContent 57

Extensions 58

Restrictions 59

59

Derivations 59

Group 61

Configuration File 63

Binding Language 63

Binding Declaration 63

Version Attribute 64

Configuration File Language Overview 64

Global <bindings> Declaration 65

<schemaBindings> Declaration 66

<nodeBindings> Declaration 68

Advanced XML Names Transformation 70

Configuration File Example 73

Generated C Encode/Decode Functions 75

Preparing C Data Variables for Encoding 75

Dynamic Memory Management 75

Populating Generated Structure Variables for Encoding 76

Accessing Encoded Message Components 77

Generated XML Encode Functions 78

Generated C Function Format and Calling Parameters 78

Generated C Encode Functions for Global Elements 79

Generated C Encode Functions for WSDL Messages 79

Generated C Encode Functions for DOM Encoding 80

Procedure for Calling a Generated C Encode Function 80

Generated XML Decode Functions 84

Pull-Parser Based Decode Functions 84

SAX Based Decode Functions 86

Procedure for Calling C Decode Functions 89

Generated Validation Functions 91

Procedure for Calling C Validation Functions 91

Generated Print Functions 93

Generated Test Functions 94

Other Generated Functions 95

Initialization Functions 96

Memory Free Functions 96

Helper Functions 97

Generated Makefile 97

Generated C++ Class Methods 99

Preparing C++ Objects for Encoding 99

Dynamic Memory Management 99

Populating Generated Class Instances for Encoding 100

Generated XML C++ Encode Methods 103

Generated Method Format and Calling Parameters 103

Generated C++ Encode Methods for Global Elements 104

Procedure for Using the Generated C++ Encode Method 104

Generated XML C++ Decode Methods 106

Pull-Parser Based Decode Methods 106

SAX Based Decode Methods 107

Generated C++ Method Format and Calling Parameters 108

Procedure for Calling C++ Decode Methods 108

Generated XML C++ Validation Methods 111

Generated C++ Method Format and Calling Parameters 111

Procedure for Calling C++ Validation Methods 111

XBinder C Runtime Library 113

XML Run-time Library Functions 114

XML C Encode Functions 114

XML C Pull-Parser Based Decode Functions 115

XML C SAX Based Decode Functions 116

XML C SAX Parser Interface 117

Expat 117

LibXML2 117

Micro Parser 117

XML C DOM Interface 118

C Common Runtime Library 119

Common Include Files 119

osSysTypes.h 119

rtxCommon.h 120

rtxContext.h 120

Context Management Functions 122

UTF-8 String Functions 123

Doubly-Linked List Utility Functions 123

Error Formatting and Print Functions 124

Diagnostic trace functions 124

Input/Output Data Stream Utility Functions 125

TCP/IP or UDP socket utility functions 126

SOAP and HTTP utility functions 126

C++ Built-in Runtime Classes 127

Message Buffer Classes 127

Global Element Base Class 128

XSD Type Base Classes 128

XML Parser Interface Classes 129

INDEX 131