/*
* Tigase Jabber/XMPP Server
* Copyright (C) 2004-2007 "Artur Hefczyc" <artur.hefczyc@tigase.org>
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. Look for COPYING file in the top folder.
* If not, see http://www.gnu.org/licenses/.
*
* $Rev: 1246 $
* Last modified by $Author: kobit $
* $Date: 2008-11-28 17:27:36 +0000 (Fri, 28 Nov 2008) $
*/
package tigase.disco;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.Set;
import java.util.HashSet;
import tigase.xml.Element;
/**
* Describe class ServiceEntity here.
*
*
* Created: Sat Feb 10 13:11:34 2007
*
* @author <a href="mailto:artur.hefczyc@tigase.org">Artur Hefczyc</a>
* @version $Rev: 1246 $
*/
public class ServiceEntity {
private String jid = null;
private String node = null;
private String name = null;
private List<String> features = null;
private List<ServiceIdentity> identities = null;
private Set<ServiceEntity> items = null;
/**
* Creates a new <code>ServiceEntity</code> instance.
*
*
* @param jid
* @param node
* @param name
*/
public ServiceEntity(String jid, String node, String name) {
this.jid = jid;
this.node = node;
this.name = name;
}
/**
* 2 ServiceEntities are equal of JIDs are equal and NODEs are equal.
*
* @param obj an <code>Object</code> value
* @return a <code>boolean</code> value
*/
@Override
public boolean equals(Object obj) {
if (obj instanceof ServiceEntity) {
ServiceEntity se = (ServiceEntity)obj;
// Assuming here that jid can never be NULL
// Node can be NULL so we need to do more calculation on it
return (se == null ? false : jid.equals(se.jid))
&&
((node == se.node) ||
(node != null ? node.equals(se.node) : se.node.equals(node)));
}
return false;
}
/**
* Describe <code>hashCode</code> method here.
*
* @return an <code>int</code> value
*/
public int hashCode() {
return (jid != null ? jid.hashCode() : 0)
+ (node != null ? node.hashCode() : 0);
}
/**
* Describe <code>addFeatures</code> method here.
*
*
* @param features
*/
public void addFeatures(String... features) {
if (this.features == null) {
this.features = new ArrayList<String>();
}
Collections.addAll(this.features, features);
}
/**
* Describe <code>addIdentities</code> method here.
*
*
* @param identities
*/
public void addIdentities(ServiceIdentity... identities) {
if (this.identities == null) {
this.identities = new ArrayList<ServiceIdentity>();
}
Collections.addAll(this.identities, identities);
}
/**
* Describe <code>addItems</code> method here.
*
*
* @param items
*/
public void addItems(ServiceEntity... items) {
if (this.items == null) {
this.items = new HashSet<ServiceEntity>();
}
// It may look very strange but look at equals() method....
// So some items which might be the same from the Set point of
// view are not really the same. They may have different name.
// This is to allow "update" the service discovery with some changed
// info.... So in particular the "name" may contain some additional
// information which can change at runtime
for (ServiceEntity item: items) {
if (this.items.contains(item)) {
this.items.remove(item);
}
this.items.add(item);
}
}
public void removeItems(ServiceEntity... items) {
if (this.items == null) {
return;
}
for (ServiceEntity item: items) {
this.items.remove(item);
}
}
/**
* Describe <code>getJID</code> method here.
*
* @return a <code>String</code> value
*/
public String getJID() {
return jid;
}
/**
* Describe <code>getNode</code> method here.
*
* @return a <code>String</code> value
*/
public String getNode() {
return node;
}
/**
* Describe <code>getName</code> method here.
*
* @return a <code>String</code> value
*/
public String getName() {
return name;
}
/**
* Describe <code>getDiscoInfo</code> method here.
*
* @param node a <code>String</code> value
* @return an <code>Element</code> value
*/
public Element getDiscoInfo(String node) {
Element query = null;
if (node == null) {
query = new Element("query",
new String[] {"xmlns"},
new String[] {"http://jabber.org/protocol/disco#info"});
if (identities != null) {
for (ServiceIdentity ident: identities) {
query.addChild(ident.getElement());
}
}
if (features != null) {
for (String feature: features) {
query.addChild(new Element("feature",
new String[] {"var"},
new String[] {feature}));
}
}
} else {
ServiceEntity entity = findNode(node);
if (entity != null) {
query = entity.getDiscoInfo(null);
query.setAttribute("node", node);
}
}
return query;
}
/**
* Describe <code>getDiscoItem</code> method here.
*
* @param node a <code>String</code> value
* @param jid a <code>String</code> value
* @return an <code>Element</code> value
*/
public Element getDiscoItem(String node, String jid) {
Element item = new Element("item");
if (jid != null) {
item.setAttribute("jid", jid);
} else {
if (this.jid != null) {
item.setAttribute("jid", this.jid);
}
}
if (node != null) {
item.setAttribute("node", node + (this.node != null ? "/" + this.node : ""));
} else {
if (this.node != null) {
item.setAttribute("node", this.node);
}
}
if (name != null) {
item.setAttribute("name", name);
}
return item;
}
public List<Element> getItems(String node, String jid) {
List<Element> result = null;
if (items != null) {
result = new ArrayList<Element>();
for (ServiceEntity item: items) {
result.add(item.getDiscoItem(node, jid));
}
}
return result;
}
public List<Element> getDiscoItems(String node, String jid) {
List<Element> result = null;
if (node == null) {
result = getItems(null, jid);
} else {
ServiceEntity entity = findNode(node);
if (entity != null) {
result = entity.getItems(node, jid);
}
}
return result;
}
/**
* Describe <code>findNode</code> method here.
*
* @param node a <code>String</code> value
* @return a <code>ServiceEntity</code> value
*/
public ServiceEntity findNode(String node) {
if (this.node != null && this.node.equals(node)) {
return this;
}
if (items == null) {
return null;
}
for (ServiceEntity item: items) {
String n = item.getNode();
if (n != null && node.equals(n)) {
return item;
}
}
int idx = node.indexOf('/');
if (idx >= 0) {
String top = node.substring(0, idx);
ServiceEntity current = findNode(top);
if (current != null) {
String rest = node.substring(idx+1);
return current.findNode(rest);
}
}
return null;
}
/**
* Describe <code>toString</code> method here.
*
* @return a <code>String</code> value
*/
public String toString() {
return getDiscoItem(null, null).toString();
}
}