• Skip to content
  • Skip to link menu
KDE 4.5 API Reference
  • KDE API Reference
  • KDE-PIM Libraries
  • Sitemap
  • Contact Us
 

KIMAP Library

  • KIMAP
  • KIMAP::MetaDataJobBase
Public Types | Public Member Functions | Protected Member Functions

KIMAP::MetaDataJobBase Class Reference

Base class for jobs that operate on mailbox metadata. More...

#include <metadatajobbase.h>

Inheritance diagram for KIMAP::MetaDataJobBase:
Inheritance graph
[legend]

List of all members.

Public Types

enum  ServerCapability { Metadata = 0, Annotatemore }

Public Member Functions

 MetaDataJobBase (Session *session)
QString mailBox () const
ServerCapability serverCapability () const
void setMailBox (const QString &mailBox)
void setServerCapability (const ServerCapability &capability)

Protected Member Functions

 MetaDataJobBase (JobPrivate &dd)

Detailed Description

Base class for jobs that operate on mailbox metadata.

Provides support for the IMAP METADATA extension; both the final RFC version (RFC 5464) and the older, incompatible draft version (known as ANNOTATEMORE) (draft-daboo-imap-annotatemore-07).

This class cannot be used directly, you must subclass it and reimplement at least the doStart() method.

Definition at line 47 of file metadatajobbase.h.


Member Enumeration Documentation

enum KIMAP::MetaDataJobBase::ServerCapability

Represents the capability level of the server.

Enumerator:
Metadata 

Used to indicate that the server supports the RFC 5464 version of the extension.

This corresponds to the METADATA server capability.

Annotatemore 

Used to indicate that the server supports the draft-daboo-imap-annotatemore-07 version of the extension.

This corresponds to the ANNOTATEMORE server capability.

Definition at line 61 of file metadatajobbase.h.


Member Function Documentation

QString MetaDataJobBase::mailBox (  )  const

The mailbox that will be acted upon.

If this is an empty string, server metadata will be retreived.

Returns:
a mailbox name, or an empty string

Definition at line 53 of file metadatajobbase.cpp.

MetaDataJobBase::ServerCapability MetaDataJobBase::serverCapability (  )  const

The version of the metadata extension that will be used.

Definition at line 65 of file metadatajobbase.cpp.

void MetaDataJobBase::setMailBox ( const QString &  mailBox  ) 

Set the mailbox to act on.

This may be an empty string, in which case metadata for the server (rather than a specific mailbox) will be retreived.

Parameters:
mailBox the name of an existing mailbox, or an empty string

Definition at line 47 of file metadatajobbase.cpp.

void MetaDataJobBase::setServerCapability ( const ServerCapability &  capability  ) 

Set what version of the metadata extension to be compatible with.

This will determine the commands that will be sent to the server.

The draft for the metadata extension changed in an incompatible way between versions 7 and 8, and some servers support version 7. It should be possible to check which version the server supports using CapabilityJob: servers implementing draft-daboo-imap-annotatemore-07 should advertise the ANNOTATEMORE capability, whereas servers implementing the final RFC 5464 should advertise the METADATA capability.

The default mode is Metadata.

Parameters:
capability the version of the extension implemented by the server

Definition at line 59 of file metadatajobbase.cpp.


The documentation for this class was generated from the following files:
  • metadatajobbase.h
  • metadatajobbase.cpp

KIMAP Library

Skip menu "KIMAP Library"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

KDE-PIM Libraries

Skip menu "KDE-PIM Libraries"
  • akonadi
  •   contact
  •   kmime
  • kabc
  • kblog
  • kcal
  • kholidays
  • kimap
  • kioslave
  •   imap4
  •   mbox
  •   nntp
  • kldap
  • kmime
  • kontactinterface
  • kpimidentities
  • kpimtextedit
  •   richtextbuilders
  • kpimutils
  • kresources
  • ktnef
  • kxmlrpcclient
  • mailtransport
  • microblog
  • qgpgme
  • syndication
  •   atom
  •   rdf
  •   rss2
Generated for KDE-PIM Libraries by doxygen 1.7.1
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal