mirror of
https://github.com/vanitasvitae/Smack.git
synced 2024-09-27 18:19:33 +02:00
86548b87bb
remove (set|get)ItemStatus. This was always the ask status, which can only be set to 'subscribe' or is non-existent. Use the standard (de-)serialization facilities for DirectoryRosterStore. Fixes Smack-657.
255 lines
7.8 KiB
Java
255 lines
7.8 KiB
Java
/**
|
|
*
|
|
* Copyright 2003-2007 Jive Software.
|
|
*
|
|
* 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.roster;
|
|
|
|
import java.util.ArrayList;
|
|
import java.util.Collection;
|
|
import java.util.Iterator;
|
|
import java.util.List;
|
|
|
|
import org.jivesoftware.smack.Manager;
|
|
import org.jivesoftware.smack.SmackException.NoResponseException;
|
|
import org.jivesoftware.smack.XMPPConnection;
|
|
import org.jivesoftware.smack.SmackException.NotConnectedException;
|
|
import org.jivesoftware.smack.XMPPException.XMPPErrorException;
|
|
import org.jivesoftware.smack.packet.IQ;
|
|
import org.jivesoftware.smack.roster.packet.RosterPacket;
|
|
import org.jxmpp.jid.BareJid;
|
|
|
|
|
|
/**
|
|
* 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
|
|
* @author Florian Schmaus
|
|
*/
|
|
public final class RosterEntry extends Manager {
|
|
|
|
private final RosterPacket.Item item;
|
|
final private Roster roster;
|
|
|
|
/**
|
|
* Creates a new roster entry.
|
|
*
|
|
* @param item the Roster Stanza's Item entry.
|
|
* @param roster The Roster managing this entry.
|
|
* @param connection a connection to the XMPP server.
|
|
*/
|
|
RosterEntry(RosterPacket.Item item, Roster roster, XMPPConnection connection) {
|
|
super(connection);
|
|
this.item = item;
|
|
this.roster = roster;
|
|
}
|
|
|
|
/**
|
|
* Returns the JID of the user associated with this entry.
|
|
*
|
|
* @return the user associated with this entry.
|
|
* @deprecated use {@link #getJid()} instead.
|
|
*/
|
|
@Deprecated
|
|
public String getUser() {
|
|
return getJid().toString();
|
|
}
|
|
|
|
/**
|
|
* Returns the JID associated with this entry.
|
|
*
|
|
* @return the user associated with this entry.
|
|
*/
|
|
public BareJid getJid() {
|
|
return item.getJid();
|
|
}
|
|
|
|
/**
|
|
* Returns the name associated with this entry.
|
|
*
|
|
* @return the name.
|
|
*/
|
|
public String getName() {
|
|
return item.getName();
|
|
}
|
|
|
|
/**
|
|
* Sets the name associated with this entry.
|
|
*
|
|
* @param name the name.
|
|
* @throws NotConnectedException
|
|
* @throws XMPPErrorException
|
|
* @throws NoResponseException
|
|
* @throws InterruptedException
|
|
*/
|
|
public synchronized void setName(String name) throws NotConnectedException, NoResponseException, XMPPErrorException, InterruptedException {
|
|
// Do nothing if the name hasn't changed.
|
|
if (name != null && name.equals(getName())) {
|
|
return;
|
|
}
|
|
|
|
RosterPacket packet = new RosterPacket();
|
|
packet.setType(IQ.Type.set);
|
|
|
|
// Create a new roster item with the current RosterEntry and the *new* name. Note that we can't set the name of
|
|
// RosterEntry right away, as otherwise the updated event wont get fired, because equalsDeep would return true.
|
|
packet.addRosterItem(toRosterItem(this, name));
|
|
connection().createPacketCollectorAndSend(packet).nextResultOrThrow();
|
|
|
|
// We have received a result response to the IQ set, the name was successfully changed
|
|
item.setName(name);
|
|
}
|
|
|
|
/**
|
|
* Updates the state of the entry with the new values.
|
|
*
|
|
* @param name the nickname for the entry.
|
|
* @param type the subscription type.
|
|
* @param subscriptionPending TODO
|
|
*/
|
|
void updateState(String name, RosterPacket.ItemType type, boolean subscriptionPending) {
|
|
item.setName(name);
|
|
item.setItemType(type);
|
|
item.setSubscriptionPending(subscriptionPending);
|
|
}
|
|
|
|
/**
|
|
* Returns the pre-approval state of this entry.
|
|
*
|
|
* @return the pre-approval state.
|
|
*/
|
|
public boolean isApproved() {
|
|
return item.isApproved();
|
|
}
|
|
|
|
/**
|
|
* Returns an copied list of the roster groups that this entry belongs to.
|
|
*
|
|
* @return an iterator for the groups this entry belongs to.
|
|
*/
|
|
public List<RosterGroup> getGroups() {
|
|
List<RosterGroup> results = new ArrayList<RosterGroup>();
|
|
// 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 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 RosterPacket.ItemType getType() {
|
|
return item.getItemType();
|
|
}
|
|
|
|
/**
|
|
* Returns the roster subscription request status of the entry. If
|
|
* {@code true}, then the contact did not answer the subscription request
|
|
* yet.
|
|
*
|
|
* @return the status.
|
|
* @since 4.2
|
|
*/
|
|
public boolean isSubscriptionPending() {
|
|
return item.isSubscriptionPending();
|
|
}
|
|
|
|
public String toString() {
|
|
StringBuilder buf = new StringBuilder();
|
|
if (getName() != null) {
|
|
buf.append(getName()).append(": ");
|
|
}
|
|
buf.append(getJid());
|
|
Collection<RosterGroup> groups = getGroups();
|
|
if (!groups.isEmpty()) {
|
|
buf.append(" [");
|
|
Iterator<RosterGroup> 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 getJid().hashCode();
|
|
}
|
|
|
|
public boolean equals(Object object) {
|
|
if (this == object) {
|
|
return true;
|
|
}
|
|
if (object != null && object instanceof RosterEntry) {
|
|
return getJid().equals(((RosterEntry)object).getJid());
|
|
}
|
|
else {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Indicates whether some other object is "equal to" this by comparing all members.
|
|
* <p>
|
|
* The {@link #equals(Object)} method returns <code>true</code> if the user JIDs are equal.
|
|
*
|
|
* @param obj the reference object with which to compare.
|
|
* @return <code>true</code> if this object is the same as the obj argument; <code>false</code>
|
|
* 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;
|
|
return other.item.equals(this.item);
|
|
}
|
|
|
|
static RosterPacket.Item toRosterItem(RosterEntry entry) {
|
|
return toRosterItem(entry, entry.getName());
|
|
}
|
|
|
|
private static RosterPacket.Item toRosterItem(RosterEntry entry, String name) {
|
|
RosterPacket.Item item = new RosterPacket.Item(entry.getJid(), name);
|
|
item.setItemType(entry.getType());
|
|
item.setSubscriptionPending(entry.isSubscriptionPending());
|
|
item.setApproved(entry.isApproved());
|
|
// Set the correct group names for the item.
|
|
for (RosterGroup group : entry.getGroups()) {
|
|
item.addGroupName(group.getName());
|
|
}
|
|
return item;
|
|
}
|
|
|
|
}
|