OBEX library — Readme
18th September 2008 — release 1.6
(1.6.0918).
What’s new
For the full list of changes in the current and previous versions see the Changes document. In brief the changes in the core
library in this version include:
- Add option
IgnoreBadDateFormats to ObexFolderListingParser, to
allow it to continue even when the server provides invalid folder-listing
content. For instance the LG K800 phone sometimes produces date values like
modified="19800000T-90000" a negative time! See the Programmer’s
Guide for more information.
- Added ObexClientSession.PutFile which takes a pathname parameter of the file
to send.
- Add a
Headers property to the ObexResponseException which lists
the headers received along with the error response. (Note that the headers are
currently discarded if the exception is runtime-serialized).
These are a few fixes and improvements to the sample programs.
Features
The library provides very broad client-side OBEX support, providing not just
the ‘Put’ operation that most libraries and applications support, but also the
complete set of operations: Connect, Put, Get, SetPath, Delete, and Abort. This
is accessed through a session based interface. All errors communicating to the
peer OBEX server are exposed to the calling application.
As well as the ‘on-the-wire’ protocol support there is also broad support for
the objects defined in the OBEX specification, for instance the Folder Listing
XML documents as used by the Folder-Browsing service. A full parser, returning
an array of folder and file objects, is included
The library also provides access to its lower-level PDU (packet) creation and
parsing facilities, enabling third-party implementation of any required
features, for instance server-side operation, and perhaps even reliable-session
support.
The library, its class documentation in both compiled HTML Help, and in raw
XML for Intellisense, and a Programmer’s
Guide are included.
Assemblies for both the FXv2 desktop and Compact Framework versions 1 and 2
are supplied.
Included sample code contains examples in both C# and VB.NET, showing how to
use Put, Get, SetPath, and Folder Listings operations. They include examples of
asynchronous usage, along with progress bar updating. Most use the
TransportConnection library to form the connection to the OBEX server. Some
however manually create the connection.