There are many examples of DFDL Schemas and data that can be run using Daffodil. They can be found at:
- DFDLSchemas on github
- DFDL/Daffodil project on DI2E.net (for those with access. US Citizens only, DoD Sponsorship required.)
Examples showing how to use the Daffodil API so as to embed Daffodil into an application are at:
Contents
Table of Contents | ||
---|---|---|
|
Following are commands that can be run from the root directory of the of the daffodil tree. That is, if you download and extract a daffodil release file, from the root directory of that tree.
Note that these commands assume a Linux terminal. If you are using Windows, replace ./bin/daffodil
with .\bin\daffodil.bat
, and use the appropriate file delimiting character when specifying paths.
Visit the Daffodil Command Line Interface for more detailed usage on the CLI.
There is also a separate example integration of Daffodil into the Calabash XProc processor. See the Daffodil Calabash page.
Comma-separated Values (CSV)
This DFDL schema is found at https://github.com/DFDLSchemas/CSV.
We assume you have created a directory named 'examples' in your home directory, and in it you have cloned the CSV git repository via:
Code Block | ||
---|---|---|
| ||
cd ~/examples
git clone https://github.com/DFDLSchemas/CSV.git |
A comma-separated value file is a file that contains lines that are table rows. There is a single row of headers followed by one or more rows of data. The header and data rows are separated into data fields by a comma. For information on the file format, visit Comma-separated Values.
Code Block | ||||
---|---|---|---|---|
| ||||
$ ./bin/daffodil parse --schema ~/examples/CSV/src/main/resources/com/tresys/csv/xsd/csv.dfdl.xsd ~/examples/CSV/src/test/resources/com/tresys/csv/data/simpleCSV.csv |
This is the CSV schema:
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2012-2015 Tresys Technology, LLC. All rights reserved.
...
-->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:fn="http://www.w3.org/2005/xpath-functions"
xmlns:dfdl="http://www.ogf.org/dfdl/dfdl-1.0/" xmlns:ex="http://example.com"
targetNamespace="http://example.com" elementFormDefault="unqualified">
<xs:include schemaLocation="xsd/built-in-formats.xsd" />
<xs:annotation>
<xs:appinfo source="http://www.ogf.org/dfdl/">
<dfdl:format ref="ex:daffodilTest1" separator="" initiator=""
terminator="" leadingSkip='0' textTrimKind="none" initiatedContent="no"
alignment="implicit" alignmentUnits="bits" trailingSkip="0" ignoreCase="no"
separatorPosition="infix" occursCountKind="parsed"
emptyValueDelimiterPolicy="both" representation="text" textNumberRep="standard"
lengthKind="delimited" encoding="ASCII" />
</xs:appinfo>
</xs:annotation>
<xs:element name="file">
<xs:complexType>
<xs:sequence dfdl:separator="%NL;" dfdl:separatorPosition="postfix">
<xs:element name="header" minOccurs="0" maxOccurs="1"
dfdl:occursCountKind="implicit">
<xs:complexType>
<xs:sequence dfdl:separator=",">
<xs:element name="title" type="xs:string" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="record" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence dfdl:separator=",">
<xs:element name="item" type="xs:string" maxOccurs="unbounded"
dfdl:occursCount="{ fn:count(../../header/title) }"
dfdl:occursCountKind="expression" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema> |
And this is the data
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
last,first,middle,DOB
smith,robert,brandon,1988-03-24
johnson,john,henry,1986-01-23
jones,arya,cat,1986-02-19 |
This is the result of using Daffodil to parse that data:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<ex:file xmlns:ex="http://example.com">
<header>
<title>last</title>
<title>first</title>
<title>middle</title>
<title>DOB</title>
</header>
<record>
<item>smith</item>
<item>robert</item>
<item>brandon</item>
<item>1988-03-24</item>
</record>
<record>
<item>johnson</item>
<item>john</item>
<item>henry</item>
<item>1986-01-23</item>
</record>
<record>
<item>jones</item>
<item>arya</item>
<item>cat</item>
<item>1986-02-19</item>
</record>
</ex:file> |
PCAP - Packet Capture
This DFDL schema is found at https://github.com/DFDLSchemas/PCAP.
The PCAP file format is a binary file format used to capture network packets. For information on this file format, visit the Wireshark Libpcap File Format page.
We assume you have created a directory named 'examples' and in it you have cloned the PCAP git repository via:
Code Block | ||
---|---|---|
| ||
cd ~/examples
git clone https://github.com/DFDLSchemas/PCAP.git
|
This is the command line.
Code Block | ||||
---|---|---|---|---|
| ||||
$ ./bin/daffodil parse --schema ~/examples/PCAP/src/main/resources/com/tresys/pcap/xsd/pcap.dfdl.xsd ~/examples/PCAP/src/test/resources/com/tresys/pcap/data/icmp.cap |
The PCAP Schema is not reproduced here simply due to its size.
The data, viewed as a hex dump, looks like this:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
0000000 c3d4 a1b2 0002 0004 0000 0000 0000 0000
0000020 ffff 0000 0001 0000 6fc4 51c1 ccf8 000c
0000040 004a 0000 004a 0000 5000 e056 4914 0c00
...
0001300 0000 5c2f 0002 0024 6261 6463 6665 6867
0001320 6a69 6c6b 6e6d 706f 7271 7473 7675 6177
0001340 6362 6564 6766 6968 |
The resulting infoset, in XML looks like:
...
language | html/xml |
---|---|
title | output |
linenumbers | true |
...