Swift
summaryrefslogtreecommitdiffstats
path: root/src/com/isode/stroke/jid/JID.java
diff options
context:
space:
mode:
authorKevin Smith <git@kismith.co.uk>2011-07-01 09:19:49 (GMT)
committerKevin Smith <git@kismith.co.uk>2011-07-01 09:19:49 (GMT)
commit2da71a8a85486a494343f1662d64fb5ae5a2a44e (patch)
tree23992f9f2a00bac23b345e5c2cc9c1194efc25be /src/com/isode/stroke/jid/JID.java
downloadstroke-2da71a8a85486a494343f1662d64fb5ae5a2a44e.zip
stroke-2da71a8a85486a494343f1662d64fb5ae5a2a44e.tar.bz2
Initial import
Diffstat (limited to 'src/com/isode/stroke/jid/JID.java')
-rw-r--r--src/com/isode/stroke/jid/JID.java211
1 files changed, 211 insertions, 0 deletions
diff --git a/src/com/isode/stroke/jid/JID.java b/src/com/isode/stroke/jid/JID.java
new file mode 100644
index 0000000..70c2ccc
--- /dev/null
+++ b/src/com/isode/stroke/jid/JID.java
@@ -0,0 +1,211 @@
+/*
+ * Copyright (c) 2010-2011, Isode Limited, London, England.
+ * All rights reserved.
+ */
+/*
+ * Copyright (c) 2010, Remko Tron¨on.
+ * All rights reserved.
+ */
+package com.isode.stroke.jid;
+
+/**
+ * JID helper.
+ *
+ * This represents the JID used in XMPP
+ * (RFC6120 - http://tools.ietf.org/html/rfc6120 particularly section 1.4),
+ * further defined in XMPP Address Format (http://tools.ietf.org/html/rfc6122 ).
+ * For a description of format, see the RFC or page 14 of
+ * XMPP: The Definitive Guide (Saint-Andre et al.)
+ *
+ * Particularly - a Bare JID is a JID without a resource part.
+ *
+ * Note that invalid JIDs shouldn't have any calls made to them beyond isValid().
+ *
+ */
+public class JID {
+ public enum CompareType {
+ WithResource, WithoutResource
+ };
+
+ private final String node_;
+ private final String domain_;
+ private final String resource_;
+
+ /**
+ * Create an invalid JID.
+ */
+ public JID() {
+ this("", "", null);
+ }
+
+ /**
+ * Create a JID using the JID(String) constructor.
+ * @param jid String formatted JID.
+ */
+ public static JID fromString(final String jid) {
+ return new JID(jid);
+ }
+
+ /**
+ * Create a JID from its String representation.
+ *
+ * e.g.
+ * wonderland.lit
+ * wonderland.lit/rabbithole
+ * alice@wonderland.lit
+ * alice@wonderland.lit/TeaParty
+ *
+ * @param jid String representation. Invalid JID if null or invalid.
+ */
+ public JID(final String jid) {
+ //FIXME: This doesn't nameprep!
+ if (jid == null || jid.startsWith("@")) {
+ node_ = "";
+ domain_ = "";
+ resource_ = "";
+ return;
+ }
+
+ String bare;
+ String resource;
+ String[] parts = jid.split("/", 2);
+ if (parts.length > 1) {
+ bare = parts[0];
+ resource = parts[1];
+ } else {
+ resource = null;
+ bare = jid;
+ }
+ String[] nodeAndDomain = bare.split("@", 2);
+ if (nodeAndDomain.length == 1) {
+ node_ = "";
+ domain_ = nodeAndDomain[0];
+ resource_ = resource;
+ } else {
+ node_ = nodeAndDomain[0];
+ domain_ = nodeAndDomain[1];
+ resource_ = resource;
+ }
+
+ }
+
+ /**
+ * Create a bare JID from the node and domain parts.
+ *
+ * JID("node@domain") == JID("node", "domain")
+ * Use a different constructor instead of passing nulls.
+ *
+ * @param node JID node part.
+ * @param domain JID domain part.
+ */
+ public JID(final String node, final String domain) {
+ this(node, domain, null);
+ }
+
+ /**
+ * Create a bare JID from the node, domain and resource parts.
+ *
+ * JID("node@domain/resource") == JID("node", "domain", "resource")
+ * Use a different constructor instead of passing nulls.
+ *
+ * @param node JID node part.
+ * @param domain JID domain part.
+ * @param resource JID resource part.
+ */
+ public JID(final String node, final String domain, final String resource) {
+ //FIXME: This doesn't nameprep!
+ node_ = node;
+ domain_ = domain;
+ resource_ = resource;
+
+ }
+
+ /**
+ * @return Is a correctly-formatted JID.
+ */
+ public boolean isValid() {
+ return (domain_.length()!=0);
+ }
+
+ /**
+ * e.g. JID("node@domain").getNode() == "node"
+ * @return null for nodeless JIDs.
+ */
+ public String getNode() {
+ return node_;
+ }
+
+ /**
+ * e.g. JID("node@domain").getDomain() == "domain"
+ * @return only null for invalid JIDs.
+ */
+ public String getDomain() {
+ return domain_;
+ }
+
+ /**
+ * e.g. JID("node@domain/resource").getResource() == "resource"
+ * @return null for bare JIDs.
+ */
+ public String getResource() {
+ return resource_ != null ? resource_ : "";
+ }
+
+ /**
+ * Is a bare JID, i.e. has no resource part.
+ */
+ public boolean isBare() {
+ return resource_ == null;
+ }
+
+ /**
+ * Get the JID without a resource.
+ * @return non-null. Invalid if the original is invalid.
+ */
+ public JID toBare() {
+ return new JID(getNode(), getDomain());
+ }
+
+ @Override
+ public String toString() {
+ String string = new String();
+ if (node_.length()!=0) {
+ string += node_ + "@";
+ }
+ string += domain_;
+ if (!isBare()) {
+ string += "/" + resource_;
+ }
+ return string;
+ }
+
+ @Override
+ public boolean equals(final Object otherObject) {
+ if (otherObject == null || getClass() != otherObject.getClass()) {
+ return false;
+ }
+ if (otherObject == this) {
+ return true;
+ }
+ JID other = (JID)otherObject;
+ String node1 = getNode();
+ String node2 = other.getNode();
+ String domain1 = getDomain();
+ String domain2 = other.getDomain();
+ String resource1 = getResource();
+ String resource2 = other.getResource();
+ boolean nodeMatch = (node1 == null && node2 == null) || (node1 != null && node1.equals(node2));
+ boolean domainMatch = (domain1 == null && domain2 == null) || (domain1 != null && domain1.equals(domain2));
+ boolean resourceMatch = (resource1 == null && resource2 == null) || (resource1 != null && resource1.equals(resource2));
+ return nodeMatch && domainMatch && resourceMatch;
+ }
+
+ @Override
+ public int hashCode() {
+ int hash = 5;
+ hash = 73 * hash + (this.node_ != null ? this.node_.hashCode() : 0);
+ hash = 73 * hash + (this.domain_ != null ? this.domain_.hashCode() : 0);
+ hash = 73 * hash + (this.resource_ != null ? this.resource_.hashCode() : 0);
+ return hash;
+ }
+}