org.jboss.remoting.marshal.PreferredStreamMarshaller Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of jboss-remoting

JBoss Remoting 2

There is a newer version: 5.0.29.Final

package org.jboss.remoting.marshal;

import java.io.IOException;
import java.io.OutputStream;
import java.util.Map;


/**
 * A PreferedStreamMarshaller can create from a raw OutputStream the
 * particular OutputStream it prefers to use.
 *
 * @author Ron Sigal
 * @version $Revision: 2320 $
 * 
 * Copyright (c) Jan 26, 2007
 * 
 */

public interface PreferredStreamMarshaller extends SerialMarshaller
{
   /**
    * An application that calls getMarshallingStream() should provide a
    * basic OutputStream, e.g., SocketOutputStream, which can be wrapped
    * to provide the facilities desired by the PreferredStreamMarshaller. 
    * 
    * @param outputStream a raw OutputStream
    * @return the OutputStream to be used for marshalling
    * @throws IOException if it unable to create OutputStream
    */
   OutputStream getMarshallingStream(OutputStream outputStream) throws IOException;
   
   /**
    * An application that calls getMarshallingStream() should provide a
    * basic OutputStream, e.g., SocketOutputStream, which can be wrapped
    * to provide the facilities desired by the PreferredStreamMarshaller. 
    * 
    * @param outputStream a raw OutputStream
    * @param config a Map with configuration information (e.g., serialization type)
    * @return the OutputStream to be used for marshalling
    * @throws IOException if it unable to create OutputStream
    */
   OutputStream getMarshallingStream(OutputStream outputStream, Map config) throws IOException;
}