2014-09-11 09:49:16 +02:00
|
|
|
/**
|
|
|
|
*
|
2019-02-10 19:01:47 +01:00
|
|
|
* Copyright © 2014-2019 Florian Schmaus
|
2014-09-11 09:49:16 +02:00
|
|
|
*
|
|
|
|
* 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.util;
|
|
|
|
|
2014-09-13 11:03:40 +02:00
|
|
|
import java.io.IOException;
|
2015-03-13 07:08:21 +01:00
|
|
|
import java.net.URI;
|
|
|
|
import java.net.URISyntaxException;
|
|
|
|
import java.text.ParseException;
|
|
|
|
import java.util.Date;
|
2014-09-11 09:49:16 +02:00
|
|
|
import java.util.Locale;
|
|
|
|
|
2018-04-23 22:00:12 +02:00
|
|
|
import javax.xml.namespace.QName;
|
|
|
|
|
2019-06-10 21:39:36 +02:00
|
|
|
import org.jivesoftware.smack.datatypes.UInt16;
|
|
|
|
import org.jivesoftware.smack.datatypes.UInt32;
|
2019-09-12 15:04:51 +02:00
|
|
|
import org.jivesoftware.smack.packet.XmlEnvironment;
|
2019-02-10 19:01:47 +01:00
|
|
|
import org.jivesoftware.smack.parsing.SmackParsingException;
|
2020-12-03 08:53:19 +01:00
|
|
|
import org.jivesoftware.smack.parsing.SmackParsingException.RequiredAttributeMissingException;
|
2019-02-10 19:01:47 +01:00
|
|
|
import org.jivesoftware.smack.parsing.SmackParsingException.SmackTextParseException;
|
|
|
|
import org.jivesoftware.smack.parsing.SmackParsingException.SmackUriSyntaxParsingException;
|
2019-05-06 22:06:13 +02:00
|
|
|
import org.jivesoftware.smack.xml.XmlPullParser;
|
|
|
|
import org.jivesoftware.smack.xml.XmlPullParserException;
|
2019-02-10 19:01:47 +01:00
|
|
|
|
2015-05-27 19:29:51 +02:00
|
|
|
import org.jxmpp.jid.EntityBareJid;
|
2016-07-29 16:21:20 +02:00
|
|
|
import org.jxmpp.jid.EntityFullJid;
|
2017-01-20 17:06:06 +01:00
|
|
|
import org.jxmpp.jid.EntityJid;
|
2015-02-14 17:15:02 +01:00
|
|
|
import org.jxmpp.jid.Jid;
|
|
|
|
import org.jxmpp.jid.impl.JidCreate;
|
|
|
|
import org.jxmpp.jid.parts.Resourcepart;
|
|
|
|
import org.jxmpp.stringprep.XmppStringprepException;
|
2015-03-13 07:08:21 +01:00
|
|
|
import org.jxmpp.util.XmppDateTime;
|
2014-09-11 09:49:16 +02:00
|
|
|
|
|
|
|
public class ParserUtils {
|
2015-03-11 21:31:37 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* The constant String "jid".
|
|
|
|
*/
|
|
|
|
public static final String JID = "jid";
|
|
|
|
|
2014-09-11 09:49:16 +02:00
|
|
|
public static void assertAtStartTag(XmlPullParser parser) throws XmlPullParserException {
|
2019-07-24 09:18:39 +02:00
|
|
|
assert parser.getEventType() == XmlPullParser.Event.START_ELEMENT;
|
2014-09-11 09:49:16 +02:00
|
|
|
}
|
|
|
|
|
2015-09-29 22:35:50 +02:00
|
|
|
public static void assertAtStartTag(XmlPullParser parser, String name) throws XmlPullParserException {
|
|
|
|
assertAtStartTag(parser);
|
|
|
|
assert name.equals(parser.getName());
|
|
|
|
}
|
|
|
|
|
2014-09-11 09:49:16 +02:00
|
|
|
public static void assertAtEndTag(XmlPullParser parser) throws XmlPullParserException {
|
2019-07-24 09:18:39 +02:00
|
|
|
assert parser.getEventType() == XmlPullParser.Event.END_ELEMENT;
|
2014-09-11 09:49:16 +02:00
|
|
|
}
|
|
|
|
|
2020-07-24 03:00:53 +02:00
|
|
|
public static void forwardToStartElement(XmlPullParser parser) throws XmlPullParserException, IOException {
|
|
|
|
// Wind the parser forward to the first start tag
|
|
|
|
XmlPullParser.Event event = parser.getEventType();
|
|
|
|
while (event != XmlPullParser.Event.START_ELEMENT) {
|
|
|
|
if (event == XmlPullParser.Event.END_DOCUMENT) {
|
|
|
|
throw new IllegalArgumentException("Document contains no start tag");
|
|
|
|
}
|
|
|
|
event = parser.next();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-10-07 21:15:20 +02:00
|
|
|
public static void forwardToEndTagOfDepth(XmlPullParser parser, int depth)
|
|
|
|
throws XmlPullParserException, IOException {
|
2019-05-06 22:06:13 +02:00
|
|
|
XmlPullParser.Event event = parser.getEventType();
|
|
|
|
while (!(event == XmlPullParser.Event.END_ELEMENT && parser.getDepth() == depth)) {
|
2014-10-07 21:15:20 +02:00
|
|
|
event = parser.next();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-02-14 17:15:02 +01:00
|
|
|
public static Jid getJidAttribute(XmlPullParser parser) throws XmppStringprepException {
|
2015-03-11 21:31:37 +01:00
|
|
|
return getJidAttribute(parser, JID);
|
2015-02-14 17:15:02 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
public static Jid getJidAttribute(XmlPullParser parser, String name) throws XmppStringprepException {
|
|
|
|
final String jidString = parser.getAttributeValue("", name);
|
|
|
|
if (jidString == null) {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
return JidCreate.from(jidString);
|
|
|
|
}
|
|
|
|
|
2015-05-27 19:29:51 +02:00
|
|
|
public static EntityBareJid getBareJidAttribute(XmlPullParser parser) throws XmppStringprepException {
|
2015-03-11 21:31:37 +01:00
|
|
|
return getBareJidAttribute(parser, JID);
|
|
|
|
}
|
|
|
|
|
2015-05-27 19:29:51 +02:00
|
|
|
public static EntityBareJid getBareJidAttribute(XmlPullParser parser, String name) throws XmppStringprepException {
|
2015-03-11 21:31:37 +01:00
|
|
|
final String jidString = parser.getAttributeValue("", name);
|
|
|
|
if (jidString == null) {
|
|
|
|
return null;
|
|
|
|
}
|
2015-06-06 09:00:19 +02:00
|
|
|
return JidCreate.entityBareFrom(jidString);
|
2015-03-11 21:31:37 +01:00
|
|
|
}
|
|
|
|
|
2016-07-29 16:21:20 +02:00
|
|
|
public static EntityFullJid getFullJidAttribute(XmlPullParser parser) throws XmppStringprepException {
|
|
|
|
return getFullJidAttribute(parser, JID);
|
|
|
|
}
|
|
|
|
|
|
|
|
public static EntityFullJid getFullJidAttribute(XmlPullParser parser, String name) throws XmppStringprepException {
|
|
|
|
final String jidString = parser.getAttributeValue("", name);
|
|
|
|
if (jidString == null) {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
return JidCreate.entityFullFrom(jidString);
|
|
|
|
}
|
|
|
|
|
2017-01-20 17:06:06 +01:00
|
|
|
public static EntityJid getEntityJidAttribute(XmlPullParser parser, String name) throws XmppStringprepException {
|
|
|
|
final String jidString = parser.getAttributeValue("", name);
|
|
|
|
if (jidString == null) {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
Jid jid = JidCreate.from(jidString);
|
|
|
|
|
|
|
|
if (!jid.hasLocalpart()) return null;
|
|
|
|
|
|
|
|
EntityFullJid fullJid = jid.asEntityFullJidIfPossible();
|
|
|
|
if (fullJid != null) {
|
|
|
|
return fullJid;
|
|
|
|
}
|
|
|
|
|
|
|
|
EntityBareJid bareJid = jid.asEntityBareJidIfPossible();
|
|
|
|
return bareJid;
|
|
|
|
}
|
|
|
|
|
2015-02-14 17:15:02 +01:00
|
|
|
public static Resourcepart getResourcepartAttribute(XmlPullParser parser, String name) throws XmppStringprepException {
|
|
|
|
final String resourcepartString = parser.getAttributeValue("", name);
|
|
|
|
if (resourcepartString == null) {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
return Resourcepart.from(resourcepartString);
|
|
|
|
}
|
|
|
|
|
2018-11-29 08:55:10 +01:00
|
|
|
/**
|
|
|
|
* Prase a string to a boolean value as per "xs:boolean". Valid input strings are "true", "1" for true, and "false", "0" for false.
|
|
|
|
*
|
|
|
|
* @param booleanString the input string.
|
|
|
|
* @return the boolean representation of the input string
|
|
|
|
* @throws IllegalArgumentException if the input string is not valid.
|
|
|
|
* @since 4.3.2
|
|
|
|
*/
|
|
|
|
public static boolean parseXmlBoolean(String booleanString) {
|
|
|
|
switch (booleanString) {
|
|
|
|
case "true":
|
|
|
|
case "1":
|
|
|
|
return true;
|
|
|
|
case "false":
|
|
|
|
case "0":
|
|
|
|
return false;
|
|
|
|
default:
|
|
|
|
throw new IllegalArgumentException(booleanString + " is not a valid boolean string");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-09-11 09:49:16 +02:00
|
|
|
/**
|
|
|
|
* Get the boolean value of an argument.
|
2018-05-09 23:06:12 +02:00
|
|
|
*
|
2019-08-30 12:08:30 +02:00
|
|
|
* @param parser TODO javadoc me please
|
|
|
|
* @param name TODO javadoc me please
|
2014-09-11 09:49:16 +02:00
|
|
|
* @return the boolean value or null of no argument of the given name exists
|
|
|
|
*/
|
|
|
|
public static Boolean getBooleanAttribute(XmlPullParser parser, String name) {
|
|
|
|
String valueString = parser.getAttributeValue("", name);
|
|
|
|
if (valueString == null)
|
|
|
|
return null;
|
|
|
|
valueString = valueString.toLowerCase(Locale.US);
|
2018-11-29 08:55:10 +01:00
|
|
|
return parseXmlBoolean(valueString);
|
2014-09-11 09:49:16 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
public static boolean getBooleanAttribute(XmlPullParser parser, String name,
|
|
|
|
boolean defaultValue) {
|
|
|
|
Boolean bool = getBooleanAttribute(parser, name);
|
|
|
|
if (bool == null) {
|
|
|
|
return defaultValue;
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
return bool;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-06-10 23:22:28 +02:00
|
|
|
public static Byte getByteAttributeFromNextText(XmlPullParser parser) throws IOException, XmlPullParserException {
|
|
|
|
String nextText = parser.nextText();
|
|
|
|
return Byte.valueOf(nextText);
|
|
|
|
}
|
|
|
|
|
2019-02-05 10:41:50 +01:00
|
|
|
public static int getIntegerAttributeOrThrow(XmlPullParser parser, String name, String throwMessage)
|
|
|
|
throws IOException {
|
2016-07-20 20:57:04 +02:00
|
|
|
Integer res = getIntegerAttribute(parser, name);
|
|
|
|
if (res == null) {
|
2019-02-05 10:41:50 +01:00
|
|
|
// TODO Should be SmackParseException.
|
|
|
|
throw new IOException(throwMessage);
|
2016-07-20 20:57:04 +02:00
|
|
|
}
|
|
|
|
return res;
|
|
|
|
}
|
|
|
|
|
2014-09-11 09:49:16 +02:00
|
|
|
public static Integer getIntegerAttribute(XmlPullParser parser, String name) {
|
|
|
|
String valueString = parser.getAttributeValue("", name);
|
|
|
|
if (valueString == null)
|
|
|
|
return null;
|
|
|
|
return Integer.valueOf(valueString);
|
|
|
|
}
|
|
|
|
|
|
|
|
public static int getIntegerAttribute(XmlPullParser parser, String name, int defaultValue) {
|
|
|
|
Integer integer = getIntegerAttribute(parser, name);
|
|
|
|
if (integer == null) {
|
|
|
|
return defaultValue;
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
return integer;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-06-10 21:39:36 +02:00
|
|
|
public static UInt16 getUInt16Attribute(XmlPullParser parser, String name) {
|
|
|
|
Integer integer = getIntegerAttribute(parser, name);
|
|
|
|
if (integer == null) {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
return UInt16.from(integer);
|
|
|
|
}
|
|
|
|
|
2020-12-03 08:53:19 +01:00
|
|
|
public static UInt16 getRequiredUInt16Attribute(XmlPullParser parser, String name) throws RequiredAttributeMissingException {
|
|
|
|
UInt16 uint16 = getUInt16Attribute(parser, name);
|
|
|
|
if (uint16 == null) {
|
|
|
|
throw new SmackParsingException.RequiredAttributeMissingException(name);
|
|
|
|
}
|
|
|
|
return uint16;
|
|
|
|
}
|
|
|
|
|
2014-09-13 11:03:40 +02:00
|
|
|
public static int getIntegerFromNextText(XmlPullParser parser) throws XmlPullParserException, IOException {
|
|
|
|
String intString = parser.nextText();
|
|
|
|
return Integer.valueOf(intString);
|
|
|
|
}
|
|
|
|
|
2014-09-11 09:49:16 +02:00
|
|
|
public static Long getLongAttribute(XmlPullParser parser, String name) {
|
|
|
|
String valueString = parser.getAttributeValue("", name);
|
|
|
|
if (valueString == null)
|
|
|
|
return null;
|
|
|
|
return Long.valueOf(valueString);
|
|
|
|
}
|
|
|
|
|
|
|
|
public static long getLongAttribute(XmlPullParser parser, String name, long defaultValue) {
|
|
|
|
Long l = getLongAttribute(parser, name);
|
|
|
|
if (l == null) {
|
|
|
|
return defaultValue;
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
return l;
|
|
|
|
}
|
|
|
|
}
|
2015-03-13 07:08:21 +01:00
|
|
|
|
2019-06-10 21:39:36 +02:00
|
|
|
public static UInt32 getUInt32Attribute(XmlPullParser parser, String name) {
|
|
|
|
Long l = getLongAttribute(parser, name);
|
|
|
|
if (l == null) {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
return UInt32.from(l);
|
|
|
|
}
|
|
|
|
|
2015-03-13 07:08:21 +01:00
|
|
|
public static double getDoubleFromNextText(XmlPullParser parser) throws XmlPullParserException, IOException {
|
|
|
|
String doubleString = parser.nextText();
|
|
|
|
return Double.valueOf(doubleString);
|
|
|
|
}
|
|
|
|
|
|
|
|
public static Double getDoubleAttribute(XmlPullParser parser, String name) {
|
|
|
|
String valueString = parser.getAttributeValue("", name);
|
|
|
|
if (valueString == null)
|
|
|
|
return null;
|
|
|
|
return Double.valueOf(valueString);
|
|
|
|
}
|
|
|
|
|
|
|
|
public static double getDoubleAttribute(XmlPullParser parser, String name, long defaultValue) {
|
|
|
|
Double d = getDoubleAttribute(parser, name);
|
|
|
|
if (d == null) {
|
|
|
|
return defaultValue;
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
return d;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2018-04-30 13:54:52 +02:00
|
|
|
public static Short getShortAttribute(XmlPullParser parser, String name) {
|
|
|
|
String valueString = parser.getAttributeValue("", name);
|
|
|
|
if (valueString == null) {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
return Short.valueOf(valueString);
|
|
|
|
}
|
|
|
|
|
|
|
|
public static short getShortAttribute(XmlPullParser parser, String name, short defaultValue) {
|
|
|
|
Short s = getShortAttribute(parser, name);
|
|
|
|
if (s == null) {
|
|
|
|
return defaultValue;
|
|
|
|
}
|
|
|
|
return s;
|
|
|
|
}
|
|
|
|
|
2019-02-10 19:01:47 +01:00
|
|
|
public static Date getDateFromOptionalXep82String(String dateString) throws SmackTextParseException {
|
|
|
|
if (dateString == null) {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
return getDateFromXep82String(dateString);
|
|
|
|
}
|
|
|
|
|
|
|
|
public static Date getDateFromXep82String(String dateString) throws SmackTextParseException {
|
|
|
|
try {
|
|
|
|
return XmppDateTime.parseXEP0082Date(dateString);
|
|
|
|
} catch (ParseException e) {
|
|
|
|
throw new SmackParsingException.SmackTextParseException(e);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public static Date getDateFromString(String dateString) throws SmackTextParseException {
|
|
|
|
try {
|
|
|
|
return XmppDateTime.parseDate(dateString);
|
|
|
|
} catch (ParseException e) {
|
|
|
|
throw new SmackParsingException.SmackTextParseException(e);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public static Date getDateFromNextText(XmlPullParser parser) throws XmlPullParserException, IOException, SmackTextParseException {
|
2015-03-13 07:08:21 +01:00
|
|
|
String dateString = parser.nextText();
|
2019-02-10 19:01:47 +01:00
|
|
|
return getDateFromString(dateString);
|
2015-03-13 07:08:21 +01:00
|
|
|
}
|
|
|
|
|
2019-02-10 19:01:47 +01:00
|
|
|
public static URI getUriFromNextText(XmlPullParser parser) throws XmlPullParserException, IOException, SmackUriSyntaxParsingException {
|
2015-03-13 07:08:21 +01:00
|
|
|
String uriString = parser.nextText();
|
2019-02-05 10:41:50 +01:00
|
|
|
try {
|
|
|
|
return new URI(uriString);
|
|
|
|
}
|
|
|
|
catch (URISyntaxException e) {
|
2019-02-10 19:01:47 +01:00
|
|
|
throw new SmackParsingException.SmackUriSyntaxParsingException(e);
|
2019-02-05 10:41:50 +01:00
|
|
|
}
|
2015-03-13 07:08:21 +01:00
|
|
|
}
|
|
|
|
|
2017-03-09 21:35:29 +01:00
|
|
|
public static String getRequiredAttribute(XmlPullParser parser, String name) throws IOException {
|
|
|
|
String value = parser.getAttributeValue("", name);
|
|
|
|
if (StringUtils.isNullOrEmpty(value)) {
|
|
|
|
throw new IOException("Attribute " + name + " is null or empty (" + value + ')');
|
|
|
|
}
|
|
|
|
return value;
|
|
|
|
}
|
|
|
|
|
|
|
|
public static String getRequiredNextText(XmlPullParser parser) throws XmlPullParserException, IOException {
|
|
|
|
String text = parser.nextText();
|
|
|
|
if (StringUtils.isNullOrEmpty(text)) {
|
|
|
|
throw new IOException("Next text is null or empty (" + text + ')');
|
|
|
|
}
|
|
|
|
return text;
|
|
|
|
}
|
2017-06-17 11:42:09 +02:00
|
|
|
|
2019-09-12 15:04:51 +02:00
|
|
|
public static String getXmlLang(XmlPullParser parser, XmlEnvironment xmlEnvironment) {
|
|
|
|
String currentXmlLang = getXmlLang(parser);
|
|
|
|
if (currentXmlLang != null) {
|
|
|
|
return currentXmlLang;
|
|
|
|
}
|
|
|
|
return xmlEnvironment.getEffectiveLanguage();
|
|
|
|
}
|
|
|
|
|
2017-06-17 11:42:09 +02:00
|
|
|
public static String getXmlLang(XmlPullParser parser) {
|
2017-12-13 23:10:11 +01:00
|
|
|
return parser.getAttributeValue("http://www.w3.org/XML/1998/namespace", "lang");
|
2017-06-17 11:42:09 +02:00
|
|
|
}
|
2018-04-23 22:00:12 +02:00
|
|
|
|
2019-06-02 10:44:50 +02:00
|
|
|
/**
|
|
|
|
* Get the QName of the current element.
|
|
|
|
*
|
|
|
|
* @param parser the parser.
|
|
|
|
* @return the Qname.
|
|
|
|
* @deprecated use {@link XmlPullParser#getQName()} instead.
|
|
|
|
*/
|
|
|
|
@Deprecated
|
|
|
|
// TODO: Remove in Smack 4.5
|
2018-04-23 22:00:12 +02:00
|
|
|
public static QName getQName(XmlPullParser parser) {
|
2019-06-02 10:44:50 +02:00
|
|
|
return parser.getQName();
|
2018-04-23 22:00:12 +02:00
|
|
|
}
|
2014-09-11 09:49:16 +02:00
|
|
|
}
|