Mercury-IM/Smack
Mercury-IM/Smack
1
0
Fork 0
mirror of https://codeberg.org/Mercury-IM/Smack synced 2024-11-22 14:22:05 +01:00
Code Issues Releases Wiki Activity

API fixes.

Browse source 
git-svn-id: http://svn.igniterealtime.org/svn/repos/smack/trunk@1809 b35dd754-fafc-0310-a699-88a17e54d16e
This commit is contained in:
Matt Tucker 2003-01-17 18:37:44 +00:00 committed by mtucker
parent 83016425cf
commit bd07f5a9aa
1 changed files with 14 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
documentation/gettingstarted.html
View file

@ -58,7 +58,7 @@ Working with the Roster
CONTENT COMING SOON
<p class="subheader">
Packets, the PacketReader, and the PacketWriter
Packets -- Reading and Writing
</p>
Each message to the XMPP server from a client is called a packet and is
@ -67,25 +67,28 @@ classes that encapsulate the different packet types allowed by XMPP (message,
presence, and IQ). Classes such as <tt>Chat</tt> and <tt>GroupChat</tt>
provide higher-level constructs that manage creating and sending packets
automatically, but you can also create and send packets directly. Below
is a code example for changing the presence to let people we're unavailable
because we're out fishing:<p>
is a code example for changing our presence to let people know we're unavailable
because we're "out fishing":<p>
<div class="code">
<pre>
<font color="gray"><i>// Create a new presence. Pass in false to indicate we're unavailable.</i></font>
Presence presence = new Presence(false);
Presence presence = new Presence(Presence.Type.UNAVAILABLE);
presence.setStatus(<font color="green">"Gone fishing"</font>);
<font color="gray"><i>// Send the packet (assume we have a XMPPConnection instance called "con").</i></font>
con.getPacketWriter().sendPacket(presence);
con.sendPacket(presence);
</pre></div>
<p>
Every connection has a <tt>PacketReader</tt> and <tt>PacketWriter</tt>. The
packet reader listens for XML data from the server and parses it into
individual packets. You can listen for incoming packets by registering
<tt>PacketWatcher</tt> objects with the packet reader. The packet writer
is responsible for writing packets to the server. It takes <tt>Packet</tt>
objects and converts them to XML before sending them over the network.
Smack provides two ways to read incoming packets: <tt>PacketListener</tt>, and
<tt>PacketCollector</tt>. Both use <tt>PacketFilter</tt> instances to determine
which packets should be processed. A packet listener is used for event style programming,
while a packet collector has a result queue of packets that you can do
polling and blocking operations on. So, a packet listener is useful when
you want to take some action whenever a packet happens to come in, while a
packet collector is useful when you want to wait for a specific packet
to come through. Packet collectors and listeners can be created using the
connection object.
<p><div class="footer">