JinglePacket.java

  1package eu.siacs.conversations.xmpp.jingle.stanzas;
  2
  3import android.support.annotation.NonNull;
  4
  5import com.google.common.base.CaseFormat;
  6import com.google.common.base.Preconditions;
  7import com.google.common.collect.ImmutableMap;
  8
  9import java.util.Map;
 10
 11import eu.siacs.conversations.xml.Element;
 12import eu.siacs.conversations.xml.Namespace;
 13import eu.siacs.conversations.xmpp.stanzas.IqPacket;
 14import rocks.xmpp.addr.Jid;
 15
 16public class JinglePacket extends IqPacket {
 17
 18    //TODO add support for groups: https://xmpp.org/extensions/xep-0338.html
 19
 20    private JinglePacket() {
 21        super();
 22    }
 23
 24    public JinglePacket(final Action action, final String sessionId) {
 25        super(TYPE.SET);
 26        final Element jingle = addChild("jingle", Namespace.JINGLE);
 27        jingle.setAttribute("sid", sessionId);
 28        jingle.setAttribute("action", action.toString());
 29    }
 30
 31    public static JinglePacket upgrade(final IqPacket iqPacket) {
 32        Preconditions.checkArgument(iqPacket.hasChild("jingle", Namespace.JINGLE));
 33        final JinglePacket jinglePacket = new JinglePacket();
 34        jinglePacket.setAttributes(iqPacket.getAttributes());
 35        jinglePacket.setChildren(iqPacket.getChildren());
 36        return jinglePacket;
 37    }
 38
 39    //TODO deprecate this somehow and make file transfer fail if there are multiple (or something)
 40    public Content getJingleContent() {
 41        final Element content = getJingleChild("content");
 42        return content == null ? null : Content.upgrade(content);
 43    }
 44
 45    public Group getGroup() {
 46        final Element group = this.findChild("group", Namespace.JINGLE_APPS_GROUPING);
 47        return group == null ? null : Group.upgrade(group);
 48    }
 49
 50    public void addGroup(final Group group) {
 51        this.addJingleChild(group);
 52    }
 53
 54    public Map<String, Content> getJingleContents() {
 55        final Element jingle = findChild("jingle", Namespace.JINGLE);
 56        ImmutableMap.Builder<String, Content> builder = new ImmutableMap.Builder<>();
 57        for (final Element child : jingle.getChildren()) {
 58            if ("content".equals(child.getName())) {
 59                final Content content = Content.upgrade(child);
 60                builder.put(content.getContentName(), content);
 61            }
 62        }
 63        return builder.build();
 64    }
 65
 66    public void addJingleContent(final Content content) { //take content interface
 67        addJingleChild(content);
 68    }
 69
 70    public Reason getReason() {
 71        final Element reason = getJingleChild("reason");
 72        return reason == null ? null : Reason.upgrade(reason);
 73    }
 74
 75    public void setReason(final Reason reason) {
 76        final Element jingle = findChild("jingle", Namespace.JINGLE);
 77        jingle.addChild(reason);
 78    }
 79
 80    //RECOMMENDED for session-initiate, NOT RECOMMENDED otherwise
 81    public void setInitiator(final Jid initiator) {
 82        Preconditions.checkArgument(initiator.isFullJid(), "initiator should be a full JID");
 83        findChild("jingle", Namespace.JINGLE).setAttribute("initiator", initiator.toEscapedString());
 84    }
 85
 86    //RECOMMENDED for session-accept, NOT RECOMMENDED otherwise
 87    public void setResponder(Jid responder) {
 88        Preconditions.checkArgument(responder.isFullJid(), "responder should be a full JID");
 89        findChild("jingle", Namespace.JINGLE).setAttribute("responder", responder.toEscapedString());
 90    }
 91
 92    public Element getJingleChild(final String name) {
 93        final Element jingle = findChild("jingle", Namespace.JINGLE);
 94        return jingle == null ? null : jingle.findChild(name);
 95    }
 96
 97    public void addJingleChild(final Element child) {
 98        final Element jingle = findChild("jingle", Namespace.JINGLE);
 99        jingle.addChild(child);
100    }
101
102    public String getSessionId() {
103        return findChild("jingle", Namespace.JINGLE).getAttribute("sid");
104    }
105
106    public Action getAction() {
107        return Action.of(findChild("jingle", Namespace.JINGLE).getAttribute("action"));
108    }
109
110    public enum Action {
111        CONTENT_ACCEPT,
112        CONTENT_ADD,
113        CONTENT_MODIFY,
114        CONTENT_REJECT,
115        CONTENT_REMOVE,
116        DESCRIPTION_INFO,
117        SECURITY_INFO,
118        SESSION_ACCEPT,
119        SESSION_INFO,
120        SESSION_INITIATE,
121        SESSION_TERMINATE,
122        TRANSPORT_ACCEPT,
123        TRANSPORT_INFO,
124        TRANSPORT_REJECT,
125        TRANSPORT_REPLACE;
126
127        public static Action of(final String value) {
128            //TODO handle invalid
129            return Action.valueOf(CaseFormat.LOWER_HYPHEN.to(CaseFormat.UPPER_UNDERSCORE, value));
130        }
131
132        @Override
133        @NonNull
134        public String toString() {
135            return CaseFormat.UPPER_UNDERSCORE.to(CaseFormat.LOWER_HYPHEN, super.toString());
136        }
137    }
138}