/**
 *  ServingXML
 *  
 *  Copyright (C) 2006  Daniel Parker
 *    daniel.parker@servingxml.com 
 * 
 * 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 com.servingxml.io.streamsink;

import java.nio.charset.Charset;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Properties;
import javax.xml.transform.Result;

public interface StreamSink {

  static final OutputStream NULL_OUTPUT_STREAM = new NullOutputStream();
  static final StreamSink NULL = new OutputStreamSinkAdaptor(NULL_OUTPUT_STREAM);

  OutputStream getOutputStream();

  void setOutputProperties(Properties outputProperties);

  void setOutputProperty(String key, String value);

  Properties getOutputProperties();

  Charset getCharset();

  Charset getCharset(Charset defaultCharset);

  Result getResult();

  void close(); 

  static class NullOutputStream extends OutputStream {
    public void write(int b) throws IOException {
    }
  }
}                    


