mirror of
https://github.com/vanitasvitae/Smack.git
synced 2024-11-16 09:12:06 +01:00
c81cd34561
Introducing a clean split between the constant connection configuration parameters, which are now all in ConnectionConfiguration and the dynamic connection state (e.g. hostAddresses) which are now in AbstractXMPPConnection. Also removed all arguments of login() since the username, password, resource and callback handler need now to be configured via ConnectionConfiguration. Also remove documentation/extensions/messageevents.md, as it's already in documentation/legacy
48 lines
2 KiB
Markdown
48 lines
2 KiB
Markdown
Smack Overview
|
|
==============
|
|
|
|
[Back](index.html)
|
|
|
|
Smack is a library for communicating with XMPP servers to perform real-time
|
|
communications, including instant messaging and group chat.
|
|
|
|
Smack Key Advantages
|
|
--------------------
|
|
|
|
* Extremely simple to use, yet powerful API. Sending a text message to a user can be accomplished in only a few lines of code:
|
|
|
|
```java
|
|
AbstractXMPPConnection connection = new XMPPTCPConnection("mtucker", "password", "jabber.org");
|
|
connection.connect();
|
|
connection.login();
|
|
Chat chat = ChatManager.getInstanceFor(connection)
|
|
.createChat("jsmith@jivesoftware.com", new MessageListener() {
|
|
|
|
public void processMessage(Chat chat, Message message) {
|
|
System.out.println("Received message: " + message);
|
|
}
|
|
});
|
|
chat.sendMessage("Howdy!");
|
|
```
|
|
|
|
* Doesn't force you to code at the packet level, as other libraries do. Smack provides intelligent higher level constructs such as the `Chat` and `Roster` classes, which let you program more efficiently.
|
|
* Does not require that you're familiar with the XMPP XML format, or even that you're familiar with XML.
|
|
* Provides easy machine to machine communication. Smack lets you set any number of properties on each message, including properties that are Java objects.
|
|
* Open Source under the Apache License, which means you can incorporate Smack into your commercial or non-commercial applications.
|
|
|
|
About XMPP
|
|
----------
|
|
|
|
XMPP (eXtensible Messaging and Presence Protocol) is an open protocol
|
|
standardized by the IETF and supported and extended by the XMPP Standards
|
|
Foundation (([http://www.xmpp.org](http://www.xmpp.org)).
|
|
|
|
How To Use This Documentation
|
|
-----------------------------
|
|
|
|
This documentation assumes that you're already familiar with the main features
|
|
of XMPP instant messaging. It's also highly recommended that you open the
|
|
Javadoc API guide and use that as a reference while reading through this
|
|
documentation.
|
|
|
|
Copyright (C) Jive Software 2002-2008
|