uk.ac.starlink.table
Interface MultiStarTableWriter

All Superinterfaces:
StarTableWriter
All Known Implementing Classes:
AbstractFitsTableWriter, ColFitsPlusTableWriter, ColFitsTableWriter, FitsPlusTableWriter, FitsTableWriter, HduFitsTableWriter, HealpixFitsTableWriter, HTMLTableWriter, TextTableWriter, VariableFitsTableWriter, VOTableFitsTableWriter, VOTableWriter

public interface MultiStarTableWriter
extends StarTableWriter

Interface for table output handlers that can write multiple tables to the same stream. It should be possible in principle (and ideally in practice using a corresponding input handler) to recover these as an array of distinct tables by reading the result later. It is not in general expected that the tables have similar characteristics.

Since:
1 Jul 2010

Method Summary
 void writeStarTables(TableSequence tableSeq, java.io.OutputStream out)
          Writes an array of StarTable objects to a given output stream.
 void writeStarTables(TableSequence tableSeq, java.lang.String location, StarTableOutput sto)
          Writes an array of StarTable objects to a given location.
 
Methods inherited from interface uk.ac.starlink.table.StarTableWriter
getFormatName, getMimeType, looksLikeFile, writeStarTable, writeStarTable
 

Method Detail

writeStarTables

void writeStarTables(TableSequence tableSeq,
                     java.io.OutputStream out)
                     throws java.io.IOException
Writes an array of StarTable objects to a given output stream. The implementation can assume that the stream is suitable for direct writing (for instance it should not normally wrap it in a BufferedOutputStream), and should not close it at the end of the call.

Parameters:
tableSeq - sequence of tables to write
out - destination stream
Throws:
java.io.IOException

writeStarTables

void writeStarTables(TableSequence tableSeq,
                     java.lang.String location,
                     StarTableOutput sto)
                     throws java.io.IOException
Writes an array of StarTable objects to a given location. Implementations are free to interpret the location argument in any way appropriate for them. Typically however the location will simply be used to get an output stream (for instance interpreting it as a filename). In this case the sto argument should normally be used to turn location into a stream.

Parameters:
tableSeq - sequence of tables to write
location - destination for tables
sto - StarTableOutput instance
Throws:
java.io.IOException