Table of Contents

---

XBinder Overview 1

Using XBinder 2

Running XBinder from the Command-line 2

Compiling and Linking Generated Code 11

Porting Run-time Code to Other Platforms 13

Getting Started with C or C++ Sample Programs 14

Getting Started with your own XML Schema 15

Generated C/C++ Source Code 17

Header (.h) File 17

C Code Generated for XSD Types 17

C Code Generated for XSD Global Elements 19

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

C++ Code Generated for XSD Types 22

C++ Code Generated for XSD Global Elements 23

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

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

Namespace Considerations 28

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

Character String Types 32

Enumerated Type 34

Real Number Types 37

Binary String Types 38

Date/Time Types 40

Boolean Type 41

Union Type 41

List Type 43

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

SEQUENCE 46

Optional Elements 47

Repeating Elements 48

Nested Types 51

Any Element 53

ALL 54

CHOICE 54

Generated C++ Get/Set Methods 56

Substitution Groups 59

Attributes 61

ComplexContent 63

Element Extension 63

Attribute Extension 65

Restrictions 66

SimpleContent 67

Extensions 67

Restrictions 68

Derivations 69

Group 71

Any Type 71

Configuration File 73

Binding Language 73

Binding Declaration 73

Version Attribute 74

Configuration File Language Overview 74

Global <bindings> Declaration 75

<schemaBindings> Declaration 77

<nodeBindings> Declaration 78

<typemap> Declaration 80

Advanced XML Names Transformation 81

Configuration File Example 83

Generated C Encode/Decode Functions 85

Preparing C Data Variables for Encoding 85

Dynamic Memory Management 85

Populating Generated Structure Variables for Encoding 86

Accessing Encoded Message Components 87

Generated XML Encode Functions 88

Generated C Function Format and Calling Parameters 88

Generated C Encode Functions for Global Elements 89

Generated C Encode Functions for WSDL Operations 89

Generated C Encode Functions for DOM Encoding 90

Procedure for Calling a Generated C Encode Function 90

Generated XML Decode Functions 94

Pull-Parser Based Decode Functions 94

SAX Based Decode Functions 96

Procedure for Calling C Decode Functions 99

Generated Validation Functions 102

Procedure for Calling C Validation Functions 103

Generated Print Functions 105

Generated Test Functions 106

Generated Reader and Writer Programs 107

Generated WSDL SOAP Stub Functions 108

Other Generated Functions 109

Initialization Functions 109

Memory Free Functions 109

Helper Functions 110

Generated Makefile 110

Generated C++ Class Methods 111

Preparing C++ Objects for Encoding 111

Dynamic Memory Management 111

Populating Generated Class Instances for Encoding 112

Generated XML C++ Encode Methods 115

Generated Method Format and Calling Parameters 115

Generated C++ Encode Methods for Global Elements 116

Generated C++ Encode Methods for WSDL Operations 116

Procedure for Using the Generated C++ Encode Method 116

Generated XML C++ Decode Methods 118

Pull-Parser Based Decode Methods 118

SAX Based Decode Methods 119

Generated C++ Method Format and Calling Parameters 120

Procedure for Calling C++ Decode Methods 120

Generated XML C++ Validation Methods 123

Generated C++ Method Format and Calling Parameters 124

Procedure for Calling C++ Validation Methods 124

XBinder C Runtime Library 127

XML Run-time Library Functions 129

XML C Encode Functions 129

XML C Pull-Parser Based Decode Functions 130

XML C SAX Based Decode Functions 131

XML C SAX Parser Interface 132

LibXML2 132

Expat 132

Micro Parser 132

XML C DOM Interface 133

EXI Run-Time Library Functions 135

Fidelity Options 135

XML to EXI Conversion 136

EXI to XML Conversion 136

C Common Runtime Library 137

Common Include Files 137

osSysTypes.h 137

rtxCommon.h 138

rtxContext.h 138

Context Management Functions 139

UTF-8 String Functions 140

Doubly-Linked List Utility Functions 141

Error Formatting and Print Functions 141

Diagnostic trace functions 141

Input/Output Data Stream Utility Functions 142

TCP/IP or UDP socket utility functions 143

SOAP and HTTP utility functions 143

C++ Built-in Runtime Classes 144

Message Buffer Classes 144

Global Element Base Class 145

XSD Type Base Classes 145

XML Parser Interface Classes 146

INDEX 147