001/** 002 * 003 * Copyright 2019-2021 Florian Schmaus 004 * 005 * Licensed under the Apache License, Version 2.0 (the "License"); 006 * you may not use this file except in compliance with the License. 007 * You may obtain a copy of the License at 008 * 009 * http://www.apache.org/licenses/LICENSE-2.0 010 * 011 * Unless required by applicable law or agreed to in writing, software 012 * distributed under the License is distributed on an "AS IS" BASIS, 013 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 014 * See the License for the specific language governing permissions and 015 * limitations under the License. 016 */ 017package org.jivesoftware.smack.provider; 018 019import java.io.IOException; 020import java.text.ParseException; 021 022import org.jivesoftware.smack.packet.IQ; 023import org.jivesoftware.smack.packet.IqData; 024import org.jivesoftware.smack.packet.XmlEnvironment; 025import org.jivesoftware.smack.parsing.SmackParsingException; 026import org.jivesoftware.smack.xml.XmlPullParser; 027import org.jivesoftware.smack.xml.XmlPullParserException; 028 029public abstract class IqProvider<I extends IQ> extends AbstractProvider<I> { 030 031 public final I parse(XmlPullParser parser, IqData iqCommon) 032 throws XmlPullParserException, IOException, SmackParsingException { 033 return parse(parser, iqCommon, null); 034 } 035 036 public final I parse(XmlPullParser parser, IqData iqData, XmlEnvironment outerXmlEnvironment) 037 throws XmlPullParserException, IOException, SmackParsingException { 038 final int initialDepth = parser.getDepth(); 039 final XmlEnvironment xmlEnvironment = XmlEnvironment.from(parser, outerXmlEnvironment); 040 041 I i = wrapExceptions(() -> parse(parser, initialDepth, iqData, xmlEnvironment)); 042 043 return i; 044 } 045 046 public abstract I parse(XmlPullParser parser, int initialDepth, IqData iqData, XmlEnvironment xmlEnvironment) 047 throws XmlPullParserException, IOException, SmackParsingException, ParseException; 048 049}