001/** 002 * 003 * Copyright 2013 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.compression; 018 019import java.io.InputStream; 020import java.io.OutputStream; 021 022public abstract class XMPPInputOutputStream { 023 024 protected static FlushMethod flushMethod; 025 026 /** 027 * Set the used flushed method when compressing data. The default is full flush which may not 028 * achieve the best compression ratio, but provides better security against certain attacks. 029 * Only use sync flush if you fully understand the implications. 030 * 031 * @see <a href="https://blog.thijsalkema.de/blog/2014/08/07/https-attacks-and-xmpp-2-crime-and-breach/">Attacks against XMPP when using compression</a> 032 * @param flushMethod 033 */ 034 public static void setFlushMethod(FlushMethod flushMethod) { 035 XMPPInputOutputStream.flushMethod = flushMethod; 036 } 037 038 protected String compressionMethod; 039 040 public String getCompressionMethod() { 041 return compressionMethod; 042 } 043 044 public abstract boolean isSupported(); 045 046 public abstract InputStream getInputStream(InputStream inputStream) throws Exception; 047 048 public abstract OutputStream getOutputStream(OutputStream outputStream) throws Exception; 049 050 public enum FlushMethod { 051 FULL_FLUSH, 052 SYNC_FLUSH, 053 } 054}