org.jivesoftware.smack.RosterEntry Maven / Gradle / Ivy
Show all versions of jamppa Show documentation
/**
*
* Copyright 2003-2007 Jive Software.
*
* All rights reserved. Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.jivesoftware.smack;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.Iterator;
import java.util.List;
import org.xmpp.packet.IQ;
import org.xmpp.packet.JID;
import org.xmpp.packet.Roster;
import org.xmpp.packet.Roster.Ask;
import org.xmpp.packet.Roster.Subscription;
/**
* Each user in your roster is represented by a roster entry, which contains the
* user's JID and a name or nickname you assign.
*
* @author Matt Tucker
*/
public class RosterEntry {
private String user;
private String name;
private Subscription subscription;
private Ask ask;
final private UserRoster roster;
final private Connection connection;
/**
* Creates a new roster entry.
*
* @param user
* the user.
* @param name
* the nickname for the entry.
* @param type
* the subscription type.
* @param ask
* the subscription status (related to subscriptions pending to
* be approbed).
* @param connection
* a connection to the XMPP server.
*/
RosterEntry(String user, String name, Subscription subscription, Ask ask,
UserRoster roster, Connection connection) {
this.user = user;
this.name = name;
this.subscription = subscription;
this.ask = ask;
this.roster = roster;
this.connection = connection;
}
/**
* Returns the JID of the user associated with this entry.
*
* @return the user associated with this entry.
*/
public String getUser() {
return user;
}
/**
* Returns the name associated with this entry.
*
* @return the name.
*/
public String getName() {
return name;
}
/**
* Sets the name associated with this entry.
*
* @param name
* the name.
*/
public void setName(String name) {
// Do nothing if the name hasn't changed.
if (name != null && name.equals(this.name)) {
return;
}
this.name = name;
Roster packet = new Roster();
packet.setType(IQ.Type.set);
packet.addItem(new JID(user), name, ask, subscription, getGroupNames());
connection.sendPacket(packet);
}
/**
* Updates the state of the entry with the new values.
*
* @param name
* the nickname for the entry.
* @param type
* the subscription type.
* @param status
* the subscription status (related to subscriptions pending to
* be approbed).
*/
void updateState(String name, Subscription type, Ask status) {
this.name = name;
this.subscription = type;
this.ask = status;
}
/**
* Returns an unmodifiable collection of the roster groups that this entry
* belongs to.
*
* @return an iterator for the groups this entry belongs to.
*/
public Collection getGroups() {
List results = new ArrayList();
// Loop through all roster groups and find the ones that contain this
// entry. This algorithm should be fine
for (RosterGroup group : roster.getGroups()) {
if (group.contains(this)) {
results.add(group);
}
}
return Collections.unmodifiableCollection(results);
}
public List getGroupNames() {
List results = new ArrayList();
// Loop through all roster groups and find the ones that contain this
// entry. This algorithm should be fine
for (RosterGroup group : roster.getGroups()) {
if (group.contains(this)) {
results.add(group.getName());
}
}
return Collections.unmodifiableList(results);
}
/**
* Returns the roster subscription type of the entry. When the type is
* RosterPacket.ItemType.none or RosterPacket.ItemType.from, refer to
* {@link RosterEntry getStatus()} to see if a subscription request is
* pending.
*
* @return the type.
*/
public Subscription getSubscription() {
return subscription;
}
/**
* Returns the roster subscription status of the entry. When the status is
* RosterPacket.ItemStatus.SUBSCRIPTION_PENDING, the contact has to answer
* the subscription request.
*
* @return the status.
*/
public Ask getAsk() {
return ask;
}
public String toString() {
StringBuilder buf = new StringBuilder();
if (name != null) {
buf.append(name).append(": ");
}
buf.append(user);
Collection groups = getGroups();
if (!groups.isEmpty()) {
buf.append(" [");
Iterator iter = groups.iterator();
RosterGroup group = iter.next();
buf.append(group.getName());
while (iter.hasNext()) {
buf.append(", ");
group = iter.next();
buf.append(group.getName());
}
buf.append("]");
}
return buf.toString();
}
@Override
public int hashCode() {
return (user == null ? 0 : user.hashCode());
}
public boolean equals(Object object) {
if (this == object) {
return true;
}
if (object != null && object instanceof RosterEntry) {
return user.equals(((RosterEntry) object).getUser());
} else {
return false;
}
}
/**
* Indicates whether some other object is "equal to" this by comparing all
* members.
*
* The {@link #equals(Object)} method returns true if the user
* JIDs are equal.
*
* @param obj
* the reference object with which to compare.
* @return true if this object is the same as the obj argument;
* false otherwise.
*/
public boolean equalsDeep(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (getClass() != obj.getClass())
return false;
RosterEntry other = (RosterEntry) obj;
if (name == null) {
if (other.name != null)
return false;
} else if (!name.equals(other.name))
return false;
if (ask == null) {
if (other.ask != null)
return false;
} else if (!ask.equals(other.ask))
return false;
if (subscription == null) {
if (other.subscription != null)
return false;
} else if (!subscription.equals(other.subscription))
return false;
if (user == null) {
if (other.user != null)
return false;
} else if (!user.equals(other.user))
return false;
return true;
}
}