XQuery

XQuery......Page 0
Table of Contents......Page 3
Reading the Syntax Diagrams......Page 9
Conventions Used in This Book......Page 10
Using Code Examples......Page 11
Acknowledgments......Page 12
Capabilities of XQuery......Page 14
Processing Scenarios......Page 15
Easing into XQuery......Page 16
Path Expressions......Page 18
FLWORs......Page 19
Adding XML Elements and Attributes......Page 20
Adding Elements......Page 21
Adding Attributes......Page 22
Joins......Page 23
Aggregating and Grouping Values......Page 24
The Design of the XQuery Language......Page 25
XQuery Versus XSLT......Page 26
XQuery and XML Schema......Page 27
The Query......Page 28
The Query Processor......Page 29
The XQuery Data Model......Page 30
Node kinds......Page 31
The node family......Page 32
Roots, documents, and elements......Page 33
String and typed values of nodes......Page 34
Sequences......Page 35
Namespaces......Page 37
Categories of Expressions......Page 39
Whitespace in Queries......Page 40
Variables......Page 41
Comments......Page 42
General Comparisons......Page 43
General comparisons and types......Page 44
Value Comparisons......Page 46
Node Comparisons......Page 47
Conditional (if-then-else) Expressions......Page 48
Nesting Conditional Expressions......Page 49
Evaluation Order of Logical Expressions......Page 50
Negating a Boolean Value......Page 51
Path Expressions......Page 52
Steps and changing context......Page 53
Axes......Page 54
Node name tests......Page 55
Node name tests and wildcards......Page 56
Abbreviated Syntax......Page 57
Other Expressions As Steps......Page 58
Predicates......Page 59
Comparisons in Predicates......Page 60
Understanding positional predicates......Page 61
The position and last functions......Page 62
Using Multiple Predicates......Page 63
More Complex Predicates......Page 64
Input Documents......Page 65
Accessing a Collection......Page 66
Using Variables......Page 67
Working with the Context Node......Page 68
Accessing the Root......Page 69
Including Elements and Attributes from the Input Document......Page 70
Direct Element Constructors......Page 71
Containing Other Element Constructors......Page 72
Enclosed expressions that evaluate to elements......Page 73
Enclosed expressions with multiple subexpressions......Page 74
Specifying Attributes Directly......Page 75
Declaring Namespaces in Direct Constructors......Page 76
Use Case: Modifying an Element from the Input Document......Page 77
Boundary whitespace......Page 78
The boundary-space declaration......Page 79
Forcing boundary whitespace preservation......Page 80
Computed Element Constructors......Page 81
Content of computed element constructors......Page 82
Computed Attribute Constructors......Page 83
Use Case: Turning Content to Markup......Page 84
FLWOR Expressions......Page 85
Range expressions......Page 87
Multiple for clauses......Page 88
The let Clause......Page 89
The where Clause......Page 90
The return Clause......Page 91
Quantified Expressions......Page 92
Binding Multiple Variables......Page 93
Joins......Page 94
Three-Way Joins......Page 96
Joins and Types......Page 97
The order by Clause......Page 98
Sorting and types......Page 99
Empty order......Page 100
More complex order specifications......Page 101
Document order defined......Page 102
Inadvertent resorting in document order......Page 103
Indicating That Order Is Not Significant......Page 104
The unordered expression......Page 105
Grouping......Page 106
Aggregating Values......Page 107
Ignoring “Missing” Values......Page 108
Aggregating on Multiple Values......Page 109
Constraining and Sorting on Aggregated Values......Page 111
Calling Functions......Page 112
Function Signatures......Page 113
Argument lists and the empty sequence......Page 114
Argument lists and sequences......Page 115
User-Defined Functions......Page 116
Function Declarations......Page 117
The Function Body......Page 118
The Parameter List......Page 119
Accepting arguments that are the empty sequence......Page 120
Functions and Context......Page 121
Recursive Functions......Page 122
Copying Input Elements with Modifications......Page 123
Removing Attributes from an Element......Page 124
Removing Attributes from All Descendants......Page 125
Removing Child Elements......Page 126
Changing Names......Page 127
Adding Sequence Numbers to Results......Page 128
Testing for the Last Item......Page 130
The union Expression......Page 131
Using Intermediate XML Documents......Page 132
Creating Lookup Tables......Page 133
Reducing Complexity......Page 134
Namespace URIs......Page 136
Declaring Namespaces......Page 137
Namespaces and Attributes......Page 138
Namespace Declarations and Scope......Page 139
Namespaces and XQuery......Page 140
Prolog Namespace Declarations......Page 141
Default namespace declarations in the prolog......Page 142
Namespace Declarations in Element Constructors......Page 144
Scope of namespace declarations......Page 145
Names affected by namespace declarations......Page 146
Namespace declarations and input elements......Page 147
In-Scope Versus Statically Known Namespaces......Page 148
Controlling the Copying of Namespace Declarations......Page 151
Advantages of a Strong Type System......Page 154
Do You Need to Care About Types?......Page 155
The Built-in Types......Page 156
Atomic Values and Types......Page 158
The Dynamic Evaluation Phase......Page 159
Casting of Untyped Values......Page 160
Effective Boolean Value......Page 161
Function Conversion Rules......Page 163
Sequence Types......Page 164
Generic Sequence Types......Page 165
Atomic Type Names As Sequence Types......Page 166
The “instance of” Expression......Page 167
Constructors......Page 168
The Cast Expression......Page 169
The Castable Expression......Page 170
Casting to xs:string or xs:untypedAtomic......Page 171
Casting among derived types......Page 172
Structure of a Query: Prolog and Body......Page 173
Prolog Declarations......Page 174
The Version Declaration......Page 175
Library Modules......Page 176
Importing a Library Module......Page 177
The behavior of a module import......Page 178
The Scope of Variables......Page 179
Initializing Expressions......Page 180
Declaring External Functions......Page 181
What Is a Schema?......Page 183
Why Use Schemas with Queries?......Page 184
W3C XML Schema: A Brief Overview......Page 185
Simple and complex types......Page 186
List types......Page 187
In-Scope Schema Definitions......Page 188
Schema Imports......Page 189
Schema imports and library modules......Page 190
The Validate Expression......Page 191
Validation Mode......Page 192
Assigning Type Annotations to Nodes......Page 193
Nodes and Typed Values......Page 194
Types and Newly Constructed Elements and Attributes......Page 195
Sequence Types and Schemas......Page 196
What Is Static Typing?......Page 198
Static Typing and Schemas......Page 199
The Typeswitch Expression......Page 200
The Treat Expression......Page 202
Type Declarations......Page 203
Type Declarations in Quantified Expressions......Page 204
The zero-or-one, one-or-more, and exactly-one Functions......Page 205
Clarity......Page 206
Choosing Names......Page 207
Using Comments for Documentation......Page 208
Handling Data Variations......Page 209
Absent values......Page 210
Default “missing” values......Page 211
Error Handling......Page 212
The error and trace Functions......Page 213
Avoid Unnecessary Sorting......Page 214
Use Predicates Instead of where Clauses......Page 215
The xs:integer Type......Page 217
The number Function......Page 218
Comparing Numeric Values......Page 219
Arithmetic Operations......Page 220
Arithmetic Operations and Types......Page 221
Addition, Subtraction, and Multiplication......Page 222
Division......Page 223
Functions on Numbers......Page 224
String Literals......Page 226
Comparing Strings......Page 227
Determining Whether a String Contains Another String......Page 228
Substrings......Page 229
Finding the Length of a String......Page 230
Concatenating and Splitting Strings......Page 231
Splitting Strings Apart......Page 232
Replacing Individual Characters in Strings......Page 233
Replacing Substrings That Match a Pattern......Page 234
Whitespace and Strings......Page 235
Collations......Page 236
Determining the Language of an Element......Page 238
Quantifiers......Page 239
Parenthesized Sub-Expressions and Branches......Page 240
Representing Individual Characters......Page 241
Representing Any Character......Page 242
Multi-Character Escapes......Page 243
Category Escapes......Page 244
Block Escapes......Page 245
Single Characters and Ranges......Page 246
Negative Character Class Expressions......Page 247
Reluctant Quantifiers......Page 248
Anchors......Page 249
Back-References......Page 250
Using Flags......Page 251
Using Sub-Expressions with Replacement Variables......Page 252
The Date and Time Types......Page 255
Explicit versus implicit time zones......Page 256
Adjusting time zones......Page 257
Comparing Dates and Times......Page 258
The Duration Types......Page 259
Comparing Durations......Page 260
Extracting Components of Dates, Times, and Durations......Page 261
Subtracting Dates and Times......Page 262
Adding and Subtracting Durations from Dates and Times......Page 263
Multiplying and Dividing Durations by Numbers......Page 264
The Date Component Types......Page 265
Retrieving Node Names......Page 267
Other Name-Related Functions......Page 270
Base and Relative URIs......Page 272
Finding the base URI of a node......Page 273
The base URI of the static context......Page 274
Escaping URIs......Page 275
Working with IDs......Page 277
Joining IDs and IDREFs......Page 278
Constructing IDs......Page 279
XML Comments and the Data Model......Page 280
Constructing Comments......Page 281
Processing Instructions......Page 282
Querying Processing Instructions......Page 283
Constructing Processing Instructions......Page 284
Documents......Page 285
Constructing Document Nodes......Page 286
Text Nodes......Page 287
Text Nodes and the Data Model......Page 288
Why Work with Text Nodes?......Page 289
XML Entity and Character References......Page 291
CDATA Sections......Page 293
Serialization......Page 295
XQueryX......Page 297
Full-Text Search......Page 298
XQuery API for Java (XQJ)......Page 300
Conformance......Page 302
Setting the Query Context......Page 303
The Option Declaration......Page 304
Extension Expressions......Page 305
Specifying Serialization Parameters......Page 306
Relational Versus XML Data Models......Page 307
A Simple Query......Page 309
Comparisons......Page 310
Boolean operators......Page 311
Functions......Page 312
Selecting Distinct Values......Page 313
Working with Multiple Tables and Subqueries......Page 314
Grouping......Page 315
Combining Structured and Semistructured Data......Page 316
Flexible Data Structures......Page 317
SQL/XML......Page 319
XQuery Versus XSLT......Page 320
Shared Components......Page 321
Differences......Page 322
Paradigm differences: push versus pull......Page 323
Optimization for particular use cases......Page 326
Differences Between XQuery 1.0/XPath 2.0 and XPath 1.0......Page 327
Path Expressions......Page 328
Arithmetic and Comparison Expressions......Page 329
Built-in Functions......Page 330
Built-in Function Reference......Page 331
adjust-date-to-timezone......Page 333
adjust-time-to-timezone......Page 335
avg......Page 336
base-uri......Page 337
boolean......Page 339
codepoint-equal......Page 340
collection......Page 341
compare......Page 342
concat......Page 343
contains......Page 344
current-date......Page 345
current-time......Page 346
data......Page 347
dateTime......Page 348
day-from-dateTime......Page 349
days-from-duration......Page 350
deep-equal......Page 351
distinct-values......Page 352
doc......Page 354
doc-available......Page 355
document-uri......Page 356
encode-for-uri......Page 357
ends-with......Page 358
error......Page 359
escape-html-uri......Page 360
exactly-one......Page 361
exists......Page 362
floor......Page 363
hours-from-duration......Page 364
id......Page 365
idref......Page 367
implicit-timezone......Page 368
in-scope-prefixes......Page 369
insert-before......Page 370
iri-to-uri......Page 371
lang......Page 372
last......Page 373
local-name......Page 374
local-name-from-QName......Page 375
lower-case......Page 376
matches......Page 377
max......Page 378
min......Page 379
minutes-from-dateTime......Page 380
minutes-from-time......Page 381
month-from-dateTime......Page 382
name......Page 383
namespace-uri......Page 384
namespace-uri-for-prefix......Page 385
namespace-uri-from-QName......Page 386
nilled......Page 387
node-name......Page 388
normalize-space......Page 389
normalize-unicode......Page 390
not......Page 391
number......Page 392
one-or-more......Page 393
prefix-from-QName......Page 394
QName......Page 395
remove......Page 396
replace......Page 397
resolve-QName......Page 398
resolve-uri......Page 400
root......Page 401
round......Page 402
round-half-to-even......Page 403
seconds-from-duration......Page 404
starts-with......Page 405
string......Page 406
string-length......Page 408
string-to-codepoints......Page 409
substring......Page 410
substring-after......Page 411
substring-before......Page 412
sum......Page 413
timezone-from-date......Page 414
timezone-from-time......Page 415
tokenize......Page 416
trace......Page 417
translate......Page 418
unordered......Page 419
year-from-date......Page 420
years-from-duration......Page 421
zero-or-one......Page 422
xs:anyType......Page 423
xs:anyURI......Page 424
Casting and Comparing xs:anyURI Values......Page 425
xs:base64Binary......Page 426
Casting xs:boolean Values......Page 427
xs:dateTime......Page 428
xs:dayTimeDuration......Page 429
xs:decimal......Page 430
xs:double......Page 431
Casting xs:double Values......Page 432
xs:duration......Page 433
xs:ENTITY......Page 434
Casting xs:float Values......Page 435
xs:gDay......Page 436
xs:gMonthDay......Page 437
xs:gYear......Page 438
xs:hexBinary......Page 439
xs:ID......Page 440
xs:IDREFS......Page 441
Casting xs:integer Values......Page 442
xs:language......Page 443
xs:negativeInteger......Page 444
xs:normalizedString......Page 445
xs:QName......Page 446
xs:short......Page 447
xs:time......Page 448
xs:unsignedInt......Page 449
xs:untypedAtomic......Page 450
xs:yearMonthDuration......Page 451
FOAR0001......Page 452
FOCH0001......Page 453
FODC0004......Page 454
FONS0005......Page 455
FORG0006......Page 456
FORX0002......Page 457
SEPM0009......Page 458
SERE0012......Page 459
XPDY0002......Page 460
XPDY0050......Page 461
XPST0008......Page 462
XPST0051......Page 463
XPTY0004......Page 464
XPTY0020......Page 465
XQDY0061......Page 466
XQST0009......Page 467
XQST0033......Page 468
XQST0038......Page 469
XQST0046......Page 470
XQST0054......Page 471
XQST0059......Page 472
XQST0069......Page 473
XQST0079......Page 474
XQST0093......Page 475
XQTY0086......Page 476
Index......Page 477