mirror of
https://github.com/vanitasvitae/Smack.git
synced 2024-09-27 10:09:32 +02:00
e98d42790a
This commit adds - SmackReactor / NIO - a framework for finite state machine connections - support for Java 8 - pretty printed XML debug output It also - reworks the integration test framework - raises the minimum Android API level to 19 - introduces XmppNioTcpConnection Furthermore fixes SMACK-801 (at least partly). Java 8 language features are available, but not all runtime library methods. For that we would need to raise the Android API level to 24 or higher.
77 lines
2.8 KiB
Java
77 lines
2.8 KiB
Java
/**
|
|
*
|
|
* Copyright 2018 Florian Schmaus
|
|
*
|
|
* 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;
|
|
|
|
import java.io.IOException;
|
|
import java.nio.ByteBuffer;
|
|
import java.security.cert.CertificateException;
|
|
|
|
import org.jivesoftware.smack.SmackException.NoResponseException;
|
|
|
|
public interface XmppInputOutputFilter {
|
|
|
|
/**
|
|
* The {@code outputData} argument may be a direct {@link ByteBuffer}. The filter has consume the data of the buffer
|
|
* completely.
|
|
*
|
|
* This method must return a {@link OutputResult}. Use {@link OutputResult#NO_OUTPUT} if there is no output.
|
|
*
|
|
* @param outputData the data this method needs to process.
|
|
* @param isFinalDataOfElement if this is the final data of the element.
|
|
* @param destinationAddressChanged if the destination address has changed.
|
|
* @param moreDataAvailable if more data is available.
|
|
* @return a output result.
|
|
* @throws IOException in case an I/O exception occurs.
|
|
*/
|
|
OutputResult output(ByteBuffer outputData, boolean isFinalDataOfElement, boolean destinationAddressChanged,
|
|
boolean moreDataAvailable) throws IOException;
|
|
|
|
class OutputResult {
|
|
public static final OutputResult NO_OUTPUT = new OutputResult(false, null);
|
|
|
|
public final boolean pendingFilterData;
|
|
public final ByteBuffer filteredOutputData;
|
|
|
|
public OutputResult(ByteBuffer filteredOutputData) {
|
|
this(false, filteredOutputData);
|
|
}
|
|
|
|
public OutputResult(boolean pendingFilterData, ByteBuffer filteredOutputData) {
|
|
this.pendingFilterData = pendingFilterData;
|
|
this.filteredOutputData = filteredOutputData;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The returned {@link ByteBuffer} is going to get fliped by the caller. The callee must not flip the buffer.
|
|
* @param inputData the data this methods needs to process.
|
|
* @return a {@link ByteBuffer} or {@code null} if no data could be produced.
|
|
* @throws IOException in case an I/O exception occurs.
|
|
*/
|
|
ByteBuffer input(ByteBuffer inputData) throws IOException;
|
|
|
|
default void closeInputOutput() {
|
|
}
|
|
|
|
default void waitUntilInputOutputClosed() throws IOException, NoResponseException, CertificateException, InterruptedException, SmackException {
|
|
}
|
|
|
|
default Object getStats() {
|
|
return null;
|
|
}
|
|
}
|