Table of Contents

---

XBinder Overview 1

Using XBinder 2

Running XBinder from the Command-line 2

Compiling and Linking Generated Code 13

Porting Run-time Code to Other Platforms 15

Getting Started with C or C++ Sample Programs 16

Getting Started with your own XML Schema 17

Generated C/C++ Source Code 19

Header (.h) File 19

C Code Generated for XSD Types 19

C Code Generated for XSD Global Elements 21

C Code Generated for WSDL Operation Input/Output/Fault Types 21

C++ Code Generated for XSD Types 23

C++ Code Generated for XSD Global Elements 24

C++ Code Generated for WSDL Operation Input/Output/Fault Types 25

C++ Code Generated for WSDL Operation Input/Output/Fault 27

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

Character String Types 33

Enumerated Type 35

Real Number Types 38

Binary String Types 39

Date/Time Types 41

Boolean Type 42

Union Type 42

List Type 44

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

SEQUENCE 47

Optional Elements 48

Repeating Elements 49

Nested Types 52

Any Element 54

ALL 55

CHOICE 55

Generated C++ Get/Set Methods 57

Substitution Groups 60

Attributes 62

ComplexContent 64

Element Extension 65

Attribute Extension 68

Restrictions 69

SimpleContent 70

Extensions 70

Restrictions 71

Derivations 72

Group 73

Any Type 74

Configuration File 77

Binding Language 77

Binding Declaration 77

Version Attribute 78

Configuration File Language Overview 78

Global <bindings> Declaration 79

<schemaBindings> Declaration 81

<nodeBindings> Declaration 83

<typemap> Declaration 85

Advanced XML Names Transformation 85

Configuration File Example 88

Generated C Encode/Decode Functions 91

Preparing C Data Variables for Encoding 91

Dynamic Memory Management 91

Populating Generated Structure Variables for Encoding 92

Accessing Encoded Message Components 93

Generated XML Encode Functions 94

Generated C Function Format and Calling Parameters 94

Generated C Encode Functions for Global Elements 95

Generated C Encode Functions for WSDL Operations 95

Generated C Encode Functions for DOM Encoding 96

Procedure for Calling a Generated C Encode Function 96

Generated XML Decode Functions 100

Pull-Parser Based Decode Functions 100

SAX Based Decode Functions 102

Procedure for Calling C Decode Functions 105

Generated Validation Functions 108

Procedure for Calling C Validation Functions 109

Generated Print Functions 111

Generated Test Functions 112

Generated Identity Constraint Test Functions 113

Generated Reader and Writer Programs 114

Generated WSDL SOAP Stub Functions 115

Generated WSDL SOAP Skeleton Server and Client Programs 116

Generated WSDL SOAP Stub Functions 116

Other Generated Functions 117

Initialization Functions 117

Memory Free Functions 117

Helper Functions 118

Generated Makefile 118

Generated C++ Class Methods 121

Preparing C++ Objects for Encoding 121

Dynamic Memory Management 121

Populating Generated Class Instances for Encoding 122

Generated XML C++ Encode Methods 125

Generated Method Format and Calling Parameters 125

Generated C++ Encode Methods for Global Elements 126

Generated C++ Encode Methods for WSDL Operations 126

Procedure for Using the Generated C++ Encode Method 126

Generated XML C++ Decode Methods 128

Pull-Parser Based Decode Methods 128

SAX Based Decode Methods 129

Generated C++ Method Format and Calling Parameters 130

Procedure for Calling C++ Decode Methods 130

Generated XML C++ Validation Methods 133

Generated C++ Method Format and Calling Parameters 134

Procedure for Calling C++ Validation Methods 134

XBinder C Runtime Library 137

XML Run-time Library Functions 139

XML C Encode Functions 139

XML C Pull-Parser Based Decode Functions 140

XML C SAX Based Decode Functions 141

XML C SAX Parser Interface 142

LibXML2 142

Expat 142

Micro Parser 142

XML C DOM Interface 143

EXI Run-Time Library Functions 145

Fidelity Options 145

XML to EXI Conversion 145

EXI to XML Conversion 146

C Common Runtime Library 147

Common Include Files 147

osSysTypes.h 147

rtxCommon.h 148

rtxContext.h 148

Context Management Functions 149

UTF-8 String Functions 150

Doubly-Linked List Utility Functions 151

Error Formatting and Print Functions 151

Diagnostic trace functions 151

Input/Output Data Stream Utility Functions 152

TCP/IP or UDP socket utility functions 153

SOAP and HTTP utility functions 153

C++ Built-in Runtime Classes 154

Message Buffer Classes 154

Global Element Base Class 155

XSD Type Base Classes 155

XML Parser Interface Classes 156

INDEX 157