Warning, /network/kio-extras/DESIGN is written in an unsupported language. File is not indexed.

0001 What is a KIO worker you ask yourself?
0002 
0003 A KIO worker is a program designed to be intimately familiar with a certian
0004 protocol, so that a standardized interface can be used to get at data from
0005 any number of places.  A few examples are the http and ftp KIO workers,
0006 which using nearly identical methods will retrieve data from an http or
0007 ftp server respectively.
0008 
0009 Well, that's nice.  How do they work?
0010 
0011 To understand it, you'll need two ice cubes, a pair of handcuffs, and a
0012 ferret.  Some Crisco (or other shortening) is optional.  Well, that aside,
0013 this document focuses on the business end of the whole kio library.  The
0014 KIO worker. See the documentation of the KIO::WorkerBase class for the methods
0015 you need to reimplement.
0016 
0017 That's nice, but how can I use it?
0018 
0019 Any time you'd like to use non blocking IO over a high level protocol
0020 (such as HTTP or FTP) a KIO worker is for you.
0021 
0022 That's nice, but how do I use it?
0023 
0024 Basically, you create "jobs" by calling a public KIO::blah method
0025 (the correct prototypes, etc, are in kio/job.h). Once this is done, you
0026 connect to the result() signal, and wait for the result. There are
0027 other signals emitted by jobs, see kio/jobclasses.h. Once again,
0028 see the online documentation for more.
0029 
0030 -------------
0031 
0032 Original document by Rich.
0033 Updated for KDE 2 by David.
0034