OdfSpreadsheetDocument.java
/**
* **********************************************************************
*
* <p>DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
*
* <p>Copyright 2008, 2010 Oracle and/or its affiliates. All rights reserved.
*
* <p>Use is subject to license terms.
*
* <p>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. You can also obtain a copy of the License at
* http://odftoolkit.org/docs/license.txt
*
* <p>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.
*
* <p>See the License for the specific language governing permissions and limitations under the
* License.
*
* <p>**********************************************************************
*/
package org.odftoolkit.odfdom.doc;
import java.io.File;
import java.io.InputStream;
import java.util.List;
import org.odftoolkit.odfdom.doc.table.OdfTable;
import org.odftoolkit.odfdom.dom.element.office.OfficeSpreadsheetElement;
import org.odftoolkit.odfdom.pkg.MediaType;
import org.odftoolkit.odfdom.pkg.OdfPackage;
import org.xml.sax.SAXException;
/** This class represents an empty ODF spreadsheet document. */
public class OdfSpreadsheetDocument extends OdfDocument {
private static final String EMPTY_SPREADSHEET_DOCUMENT_PATH = "/OdfSpreadsheetDocument.ods";
static final Resource EMPTY_SPREADSHEET_DOCUMENT_RESOURCE =
new Resource(EMPTY_SPREADSHEET_DOCUMENT_PATH);
/** This enum contains all possible media types of OdfSpreadsheetDocument documents. */
public enum OdfMediaType implements MediaType {
SPREADSHEET(OdfDocument.OdfMediaType.SPREADSHEET),
SPREADSHEET_TEMPLATE(OdfDocument.OdfMediaType.SPREADSHEET_TEMPLATE);
private final OdfDocument.OdfMediaType mMediaType;
OdfMediaType(OdfDocument.OdfMediaType mediaType) {
this.mMediaType = mediaType;
}
/** @return the mediatype of this document */
public String getMediaTypeString() {
return mMediaType.getMediaTypeString();
}
/** @return the ODF filesuffix of this document */
public String getSuffix() {
return mMediaType.getSuffix();
}
/**
* @param mediaType string defining an ODF document
* @return the according OdfMediatype encapuslating the given string and the suffix
*/
public static OdfDocument.OdfMediaType getOdfMediaType(String mediaType) {
return OdfDocument.OdfMediaType.getOdfMediaType(mediaType);
}
}
/**
* Creates an empty spreadsheet document.
*
* @return ODF spreadsheet document based on a default template*
* @throws java.lang.Exception - if the document could not be created
*/
public static OdfSpreadsheetDocument newSpreadsheetDocument() throws Exception {
return (OdfSpreadsheetDocument)
OdfDocument.loadTemplate(
EMPTY_SPREADSHEET_DOCUMENT_RESOURCE, OdfDocument.OdfMediaType.SPREADSHEET);
}
/**
* Creates an empty spreadsheet template.
*
* @return ODF spreadsheet template based on a default
* @throws java.lang.Exception - if the template could not be created
*/
public static OdfSpreadsheetDocument newSpreadsheetTemplateDocument() throws Exception {
OdfSpreadsheetDocument doc =
(OdfSpreadsheetDocument)
OdfDocument.loadTemplate(
EMPTY_SPREADSHEET_DOCUMENT_RESOURCE, OdfDocument.OdfMediaType.SPREADSHEET_TEMPLATE);
doc.changeMode(OdfMediaType.SPREADSHEET_TEMPLATE);
return doc;
}
/**
* To avoid data duplication a new document is only created, if not already opened. A document is
* cached by this constructor using the internalpath as key.
*/
protected OdfSpreadsheetDocument(
OdfPackage pkg, String internalPath, OdfSpreadsheetDocument.OdfMediaType odfMediaType)
throws SAXException {
super(pkg, internalPath, odfMediaType.mMediaType);
}
/**
* Creates an OdfSpreadsheetDocument from the OpenDocument provided by a resource Stream.
*
* <p>Since an InputStream does not provide the arbitrary (non sequentiell) read access needed by
* OdfSpreadsheetDocument, the InputStream is cached. This usually takes more time compared to the
* other createInternalDocument methods. An advantage of caching is that there are no problems
* overwriting an input file.
*
* <p>If the resource stream is not a ODF spreadsheet document, ClassCastException might be
* thrown.
*
* @param inputStream - the InputStream of the ODF spreadsheet document.
* @return the spreadsheet document created from the given InputStream
* @throws java.lang.Exception - if the document could not be created.
*/
public static OdfSpreadsheetDocument loadDocument(InputStream inputStream) throws Exception {
return (OdfSpreadsheetDocument) OdfDocument.loadDocument(inputStream);
}
/**
* Loads an OdfSpreadsheetDocument from the provided path.
*
* <p>OdfSpreadsheetDocument relies on the file being available for read access over the whole
* lifecycle of OdfSpreadsheetDocument.
*
* <p>If the resource stream is not a ODF spreadsheet document, ClassCastException might be
* thrown.
*
* @param documentPath - the path from where the document can be loaded
* @return the spreadsheet document from the given path or NULL if the media type is not supported
* by ODFDOM.
* @throws java.lang.Exception - if the document could not be created.
*/
public static OdfSpreadsheetDocument loadDocument(String documentPath) throws Exception {
return (OdfSpreadsheetDocument) OdfDocument.loadDocument(documentPath);
}
/**
* Creates an OdfSpreadsheetDocument from the OpenDocument provided by a File.
*
* <p>OdfSpreadsheetDocument relies on the file being available for read access over the whole
* lifecycle of OdfSpreadsheetDocument.
*
* <p>If the resource stream is not a ODF spreadsheet document, ClassCastException might be
* thrown.
*
* @param file - a file representing the ODF spreadsheet document.
* @return the spreadsheet document created from the given File
* @throws java.lang.Exception - if the document could not be created.
*/
public static OdfSpreadsheetDocument loadDocument(File file) throws Exception {
return (OdfSpreadsheetDocument) OdfDocument.loadDocument(file);
}
/**
* Get the content root of a spreadsheet document.
*
* @return content root, representing the office:spreadsheet tag
* @throws Exception if the file DOM could not be created.
*/
@Override
public OfficeSpreadsheetElement getContentRoot() throws Exception {
return super.getContentRoot(OfficeSpreadsheetElement.class);
}
/**
* Changes the document to the given mediatype. This method can only be used to convert a document
* to a related mediatype, e.g. template.
*
* @param mediaType the related ODF mimetype
*/
public void changeMode(OdfMediaType mediaType) {
setOdfMediaType(mediaType.mMediaType);
}
/**
* Return a list of table features in this document. For general ODF documents it searches for
* them recursively through the document. For ODF documents, there is a getOdsTableList
*
* @see OdfDocument:getTableList
* @return a list of table features in this document.
*/
public List<OdfTable> getSpreadsheetTables() {
return getTableList(true);
}
}