* instead of a File, or if this is not the root document. For those cases,
* you must use {@link #write(OutputStream)} or {@link #write(File)} to
* write to a brand new document.
+ *
+ * @since POI 3.15 beta 3
*
* @throws IOException thrown on errors writing to the file
*/
* Writes the document out to the specified new {@link File}. If the file
* exists, it will be replaced, otherwise a new one will be created
*
+ * @since POI 3.15 beta 3
+ *
* @param newFile The new File to write to.
*
* @throws IOException thrown on errors writing to the file
package org.apache.poi;
import java.io.File;
-import java.io.IOException;
import java.io.OutputStream;
import org.apache.poi.poifs.filesystem.DirectoryNode;
/**
* This holds the common functionality for all read-only
* POI Document classes, i.e. ones which don't support writing.
+ *
+ * @since POI 3.15 beta 3
*/
public abstract class POIReadOnlyDocument extends POIDocument {
public POIReadOnlyDocument(DirectoryNode dir) {
/**
* Note - writing is not yet supported for this file format, sorry.
+ *
+ * @throws IllegalStateException If you call the method, as writing is not supported
*/
@Override
- public void write() throws IOException {
+ public void write() {
throw new IllegalStateException("Writing is not yet implemented for this Document Format");
}
/**
* Note - writing is not yet supported for this file format, sorry.
+ *
+ * @throws IllegalStateException If you call the method, as writing is not supported
*/
@Override
- public void write(File file) throws IOException {
+ public void write(File file) {
throw new IllegalStateException("Writing is not yet implemented for this Document Format");
}
/**
* Note - writing is not yet supported for this file format, sorry.
+ *
+ * @throws IllegalStateException If you call the method, as writing is not supported
*/
@Override
- public void write(OutputStream out) throws IOException {
+ public void write(OutputStream out) {
throw new IllegalStateException("Writing is not yet implemented for this Document Format");
}
}