Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QObexHeader Class Reference
[QtBaseModule]

The QObexHeader class contains header information for an OBEX request or response. More...

    #include <QObexHeader>

List of all members, including inherited members

Public Types

enum HeaderId { Count, Name, Type, Length, ..., MaximumHeaderId }

Public Functions

QObexHeader ()
QObexHeader ( const QObexHeader & other )
~QObexHeader ()
QByteArray appParameters () const
void clear ()
quint32 connectionId () const
bool contains ( int headerId ) const
quint32 count () const
quint32 creatorId () const
QString description () const
QList<int> headerIds () const
QByteArray http () const
quint32 length () const
QString name () const
QByteArray objectClass () const
bool remove ( int headerId )
QByteArray sessionParameters () const
quint8 sessionSequenceNumber () const
void setAppParameters ( const QByteArray & params )
void setAuthenticationChallenge ( QObex::AuthChallengeOptions options = 0, const QString & realm = QString() )
void setConnectionId ( quint32 connectionId )
void setCount ( quint32 count )
void setCreatorId ( quint32 creatorId )
void setDescription ( const QString & description )
void setHttp ( const QByteArray & http )
void setLength ( quint32 length )
void setName ( const QString & name )
void setObjectClass ( const QByteArray & objectClass )
void setSessionParameters ( const QByteArray & params )
void setSessionSequenceNumber ( quint8 num )
void setTarget ( const QByteArray & target )
void setTime ( const QDateTime & dateTime )
void setType ( const QString & type )
bool setValue ( int headerId, const QVariant & variant )
void setWanUuid ( QUuid uuid )
void setWho ( const QByteArray & who )
int size () const
QByteArray target () const
QDateTime time () const
QString type () const
QVariant value ( int headerId ) const
QUuid wanUuid () const
QByteArray who () const
bool operator!= ( const QObexHeader & other ) const
QObexHeader & operator= ( const QObexHeader & other )
bool operator== ( const QObexHeader & other ) const

Static Public Members

QDateTime dateTimeFromString ( const QString & dateTimeString )
QString stringFromDateTime ( const QDateTime & dateTime )

Detailed Description

The QObexHeader class contains header information for an OBEX request or response.

The QObexHeader class provides a container for a set of headers for an OBEX request or response.

Convenience methods are provided to set and get header values for all header identifiers that are defined in the IrOBEX specification; for example, setName(), name(), setType(), type().

Additionally, setValue() and value() can be used to set and retrieve custom header values as QVariant values.

Member Type Documentation

enum QObexHeader::HeaderId

This enum defines the Header Identifiers that can be added to a QObexHeader. Note the range 0x30 to 0x3F can be used for user-defined headers.

Constant	Value	Description
`QObexHeader::Count`	`0xc0`	The number of objects in the operation.
`QObexHeader::Name`	`0x01`	The name of the object.
`QObexHeader::Type`	`0x42`	The type of the object.
`QObexHeader::Length`	`0xc3`	The size of the object.
`QObexHeader::Time`	`0x44`	A date/time stamp in ISO 8601 format.
`QObexHeader::Description`	`0x05`	A text description of the object.
`QObexHeader::Target`	`0x46`	The service that is the target of the operation.
`QObexHeader::Http`	`0x47`	A HTTP 1.x header.
`QObexHeader::Who`	`0x4A`	Identifies the OBEX application.
`QObexHeader::ConnectionId`	`0xcb`	An identifier used for OBEX connection multiplexing.
`QObexHeader::AppParameters`	`0x4c`	Used for extended application request and response information.
`QObexHeader::AuthChallenge`	`0x4d`	An authentication digest-challenge.
`QObexHeader::AuthResponse`	`0x4e`	An authentication digest-response.
`QObexHeader::CreatorId`	`0xcf`	Indicates the creator of an object.
`QObexHeader::WanUuid`	`0x50`	Uniquely identifies a network client (OBEX server).
`QObexHeader::ObjectClass`	`0x51`	Details the object class and properties.
`QObexHeader::SessionParameters`	`0x52`	Parameters used in session commands and responses.
`QObexHeader::SessionSequenceNumber`	`0x93`	Sequence number used in each OBEX packet for reliability.
`QObexHeader::MaximumHeaderId`	`0x3f`	The maximum value for a Header Identifer, as defined in the OBEX specification.

Member Function Documentation

QObexHeader::QObexHeader ()

Constructs an empty QObexHeader.

QObexHeader::QObexHeader ( const QObexHeader & other )

Constructs a QObexHeader with the contents from other.

QObexHeader::~QObexHeader ()

Destroys the header.

QByteArray QObexHeader::appParameters () const

Returns the value of the OBEX header field Application Parameters.

Returns an empty byte array if the Application Parameters header is not present.

void QObexHeader::clear ()

Removes all header entries.

quint32 QObexHeader::connectionId () const

Returns the value of the OBEX header field Connection Id.

Returns 0 if the Connection Id header is not present.

bool QObexHeader::contains ( int headerId ) const

Returns true if this set of headers has a header entry with the header identifier headerId; otherwise returns false.

quint32 QObexHeader::count () const

Returns the value of the OBEX header field Count.

Returns 0 if the Count header is not present.

quint32 QObexHeader::creatorId () const

Returns the value of the OBEX header field Connection Id.

Returns 0 if the Creator ID header is not present.

QDateTime QObexHeader::dateTimeFromString ( const QString & dateTimeString ) `[static]`

Returns a QDateTime that represents the date/time specified by dateTimeString, which must be in the Time header value format defined in the OBEX specification. That is, it must be in the format YYYYMMDDTHHMMSS (for local times) or YYYYMMDDTHHMMSSZ (for UTC time). The letter 'T' separates the date from the time.

Returns an invalid QDateTime if dateTimeString could not be parsed.

QString QObexHeader::description () const

Returns the value of the OBEX header field Description.

Returns an empty string if the Description header is not present.

QList<int> QObexHeader::headerIds () const

Returns a list of the header identifiers in this set of headers.

QByteArray QObexHeader::http () const

Returns the value of the OBEX header field HTTP.

Returns an empty byte array if the HTTP header is not present.

quint32 QObexHeader::length () const

Returns the value of the OBEX header field Length.

Returns 0 if the Length header is not present.

QString QObexHeader::name () const

Returns the value of the OBEX header field Name.

Returns an empty string if the Name header is not present.

QByteArray QObexHeader::objectClass () const

Returns the value of the OBEX header field Object Class.

Returns an empty byte array if the Object Class header is not present.

bool QObexHeader::remove ( int headerId )

Removes the header entry with identifier headerId.

Returns true if the value was removed, or returns false if no entry exists for the identifier headerId.

QByteArray QObexHeader::sessionParameters () const

Returns the value of the OBEX header field Session-Parameters.

Returns an empty byte array if the Session-Parameters header is not present.

quint8 QObexHeader::sessionSequenceNumber () const

Returns the value of the OBEX header field Session-Sequence-Number.

Returns 0 if the Session-Sequence-Number header is not present.

void QObexHeader::setAppParameters ( const QByteArray & params )

Sets the value of the OBEX header field Application Parameters to params.

void QObexHeader::setAuthenticationChallenge ( QObex::AuthChallengeOptions options = 0, const QString & realm = QString() )

Sets the value of the OBEX header field Authentication Challenge to an authentication challenge generated using the given options and realm.

The realm is a string that can be displayed to users to inform them of the username and password to be used for authentication. The supported encodings for the realm are ASCII, ISO-8859-1 and Unicode.

The options and realm fields are optional when creating a challenge.

void QObexHeader::setConnectionId ( quint32 connectionId )

Sets the value of the OBEX header field Connection Id to connectionId.

This value identifies the OBEX connection to which an OBEX request belongs, in order to differentiate between multiple clients on the same connection.

Note: If this header is to be sent in an OBEX request, you should not also add a Target value, as it is illegal to send a Target header and a Connection Id header in the same request (as stated in the OBEX specification).

See also connectionId() and QObexClientSession::connectionId().

void QObexHeader::setCount ( quint32 count )

Sets the value of the OBEX header field Count to count.

This value indicates the number of objects involved in the OBEX operation.

void QObexHeader::setCreatorId ( quint32 creatorId )

Sets the value of the OBEX header field Creator ID to creatorId.

void QObexHeader::setDescription ( const QString & description )

Sets the value of the OBEX header field Description to description.

This value can be used to provide additional information about the operation.

void QObexHeader::setHttp ( const QByteArray & http )

Sets the value of the OBEX header field HTTP to http.

This value should be a byte sequence containing a HTTP 1.x header.

void QObexHeader::setLength ( quint32 length )

Sets the value of the OBEX header field Length to length.

If the length of the object to be transferred is known in advance, this header should be used.

void QObexHeader::setName ( const QString & name )

Sets the value of the OBEX header field Name to name.

If an object is being sent to another device, this value should generally be the filename of the object.

An empty name string is used to specify particular behaviors for some GET and SETPATH operations. For GET, an empty string means that the "default" object should be retrieved. For SETPATH, an empty string means the path should be reset to the "default" folder.

void QObexHeader::setObjectClass ( const QByteArray & objectClass )

Sets the value of the OBEX header field Object Class to objectClass.

void QObexHeader::setSessionParameters ( const QByteArray & params )

Sets the value of the OBEX header field Session-Parameters to params.

void QObexHeader::setSessionSequenceNumber ( quint8 num )

Sets the value of the OBEX header field Session-Sequence-Number to num.

void QObexHeader::setTarget ( const QByteArray & target )

Sets the value of the OBEX header field Target to target.

This value should identify the intended target of an OBEX operation.

Note: If this header is to be sent in an OBEX request, you should not also add a Connection Id value, as it is illegal to send a Target header and a Connection Id header in the same request (as stated in the OBEX specification).

void QObexHeader::setTime ( const QDateTime & dateTime )

If dateTime is a valid QDateTime object, sets the value of the OBEX header field Time to dateTime.

void QObexHeader::setType ( const QString & type )

Sets the value of the OBEX header field Type to type.

This header corresponds to the content-type header in HTTP. The type value should be a standard ASCII mime type string, e.g. "text/plain", "image/jpeg".

bool QObexHeader::setValue ( int headerId, const QVariant & variant )

Sets the value of the header entry with identifier headerId to the value in variant.

The variant must be able to be converted into one of the following types:

QString
QByteArray
quint8
quint32

The header encoding of headerId will be used to determine which of the data types should be used for conversion.

Returns true if the value was set for the header. Otherwise, returns false (for example, if the value in variant cannot be converted to the data type specified by headerId).

void QObexHeader::setWanUuid ( QUuid uuid )

Sets the value of the OBEX header field WAN UUID to uuid.

void QObexHeader::setWho ( const QByteArray & who )

Sets the value of the OBEX header field Who to who.

This value can be used to allow peer applications to identify each other.

int QObexHeader::size () const

Returns the number of entries in the OBEX header.

QString QObexHeader::stringFromDateTime ( const QDateTime & dateTime ) `[static]`

Returns a date/time string that represents dateTime in the format defined for the Time header value in the OBEX specification.

The dateTime timeSpec() value is used to determine the time zone information. That is, the string will be in the format YYYYMMDDTHHMMSS if timeSpec() is Qt::LocalTime, or the format YYYYMMDDTHHMMSSZ if it is Qt::UTC.

Returns an empty string if dateTime is invalid.

QByteArray QObexHeader::target () const

Returns the value of the OBEX header field Target.

Returns an empty byte array if the Target header is not present.

QDateTime QObexHeader::time () const

Returns the value of the OBEX header field Time.

Returns an invalid QDateTime object if the Time header is not present, or if the header value does not conform to the ISO 8601 format.

QString QObexHeader::type () const

Returns the value of the OBEX header field Type.

Returns an empty string if the Type header is not present.

QVariant QObexHeader::value ( int headerId ) const

Returns the value of the header entry with identifier headerId.

Returns an invalid variant if no entry exists for headerId.

QUuid QObexHeader::wanUuid () const

Returns the value of the OBEX header field WAN UUID.

Returns a null UUID if the WAN UUID header is not present.

QByteArray QObexHeader::who () const

Returns the value of the OBEX header field Who.

Returns an empty byte array if the Who header is not present.

bool QObexHeader::operator!= ( const QObexHeader & other ) const

Returns true if other is not equal to this header; otherwise returns false.

QObexHeader & QObexHeader::operator= ( const QObexHeader & other )

Assigns the contents of other to this object and returns a reference to this header.

bool QObexHeader::operator== ( const QObexHeader & other ) const

Returns true if other contains the same values as this header; otherwise returns false.

QObexHeader Class Reference[QtBaseModule]