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 jingle = findChild("jingle", Namespace.JINGLE);
 47        final Element group = jingle.findChild("group", Namespace.JINGLE_APPS_GROUPING);
 48        return group == null ? null : Group.upgrade(group);
 49    }
 50
 51    public void addGroup(final Group group) {
 52        this.addJingleChild(group);
 53    }
 54
 55    public Map<String, Content> getJingleContents() {
 56        final Element jingle = findChild("jingle", Namespace.JINGLE);
 57        ImmutableMap.Builder<String, Content> builder = new ImmutableMap.Builder<>();
 58        for (final Element child : jingle.getChildren()) {
 59            if ("content".equals(child.getName())) {
 60                final Content content = Content.upgrade(child);
 61                builder.put(content.getContentName(), content);
 62            }
 63        }
 64        return builder.build();
 65    }
 66
 67    public void addJingleContent(final Content content) { //take content interface
 68        addJingleChild(content);
 69    }
 70
 71    public Reason getReason() {
 72        final Element reason = getJingleChild("reason");
 73        return reason == null ? null : Reason.upgrade(reason);
 74    }
 75
 76    public void setReason(final Reason reason) {
 77        final Element jingle = findChild("jingle", Namespace.JINGLE);
 78        jingle.addChild(reason);
 79    }
 80
 81    //RECOMMENDED for session-initiate, NOT RECOMMENDED otherwise
 82    public void setInitiator(final Jid initiator) {
 83        Preconditions.checkArgument(initiator.isFullJid(), "initiator should be a full JID");
 84        findChild("jingle", Namespace.JINGLE).setAttribute("initiator", initiator.toEscapedString());
 85    }
 86
 87    //RECOMMENDED for session-accept, NOT RECOMMENDED otherwise
 88    public void setResponder(Jid responder) {
 89        Preconditions.checkArgument(responder.isFullJid(), "responder should be a full JID");
 90        findChild("jingle", Namespace.JINGLE).setAttribute("responder", responder.toEscapedString());
 91    }
 92
 93    public Element getJingleChild(final String name) {
 94        final Element jingle = findChild("jingle", Namespace.JINGLE);
 95        return jingle == null ? null : jingle.findChild(name);
 96    }
 97
 98    public void addJingleChild(final Element child) {
 99        final Element jingle = findChild("jingle", Namespace.JINGLE);
100        jingle.addChild(child);
101    }
102
103    public String getSessionId() {
104        return findChild("jingle", Namespace.JINGLE).getAttribute("sid");
105    }
106
107    public Action getAction() {
108        return Action.of(findChild("jingle", Namespace.JINGLE).getAttribute("action"));
109    }
110
111    public enum Action {
112        CONTENT_ACCEPT,
113        CONTENT_ADD,
114        CONTENT_MODIFY,
115        CONTENT_REJECT,
116        CONTENT_REMOVE,
117        DESCRIPTION_INFO,
118        SECURITY_INFO,
119        SESSION_ACCEPT,
120        SESSION_INFO,
121        SESSION_INITIATE,
122        SESSION_TERMINATE,
123        TRANSPORT_ACCEPT,
124        TRANSPORT_INFO,
125        TRANSPORT_REJECT,
126        TRANSPORT_REPLACE;
127
128        public static Action of(final String value) {
129            //TODO handle invalid
130            return Action.valueOf(CaseFormat.LOWER_HYPHEN.to(CaseFormat.UPPER_UNDERSCORE, value));
131        }
132
133        @Override
134        @NonNull
135        public String toString() {
136            return CaseFormat.UPPER_UNDERSCORE.to(CaseFormat.LOWER_HYPHEN, super.toString());
137        }
138    }
139}