src/documentation/content/xdocs/hssf/index.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!--
   3    ====================================================================
   4    Licensed to the Apache Software Foundation (ASF) under one or more
   5    contributor license agreements.  See the NOTICE file distributed with
   6    this work for additional information regarding copyright ownership.
   7    The ASF licenses this file to You under the Apache License, Version 2.0
   8    (the "License"); you may not use this file except in compliance with
   9    the License.  You may obtain a copy of the License at
  10
  11        http://www.apache.org/licenses/LICENSE-2.0
  12
  13    Unless required by applicable law or agreed to in writing, software
  14    distributed under the License is distributed on an "AS IS" BASIS,
  15    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16    See the License for the specific language governing permissions and
  17    limitations under the License.
  18    ====================================================================
  19 -->
  20 <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "../dtd/document-v11.dtd">
  21
  22 <document>
  23     <header>
  24         <title>POI-HSSF - Java API To Access Microsoft Excel Format Files</title>
  25         <subtitle>Overview</subtitle>
  26         <authors>
  27             <person name="Andrew C. Oliver" email="acoliver@apache.org"/>
  28             <person name="Nicola Ken Barozzi" email="barozzi@nicolaken.com"/>
  29         </authors>
  30     </header>
  31
  32     <body>
  33         <section>
  34             <title>Overview</title>
  35
  36             <p>HSSF is the POI Project's pure Java implementation of the Excel
  37                         '97(-2007) file format. It <em>does not</em> support the new
  38                         Excel 2007 .xlsx OOXML file format, which is not OLE2 based.</p>
  39             <p>HSSF provides a way to read spreadsheets create, modify, read and write XLS spreadsheets
  40              It provides:
  41             </p>
  42             <ul>
  43                 <li>low level structures for those with special needs</li>
  44                 <li>an eventmodel api for efficient read-only access</li>
  45                 <li>a full usermodel api for creating, reading and modifying XLS files</li>
  46             </ul>
  47             <p>
  48         An alternate way of generating a spreadsheet is via the <link href="http://cocoon.apache.org">Cocoon</link> serializer (yet you'll still be using HSSF indirectly).
  49          With Cocoon you can serialize any XML datasource (which might be a ESQL page outputting in SQL for instance) by simply
  50         applying the stylesheet and designating the serializer.
  51             </p>
  52             <p>
  53         If you're merely reading spreadsheet data, then use the eventmodel api
  54         in the org.apache.poi.hssf.eventusermodel package.
  55             </p>
  56             <p>
  57         If you're modifying spreadsheet data then use the usermodel api.  You
  58         can also generate spreadsheets this way.
  59             </p>
  60
  61         </section>
  62     </body>
  63 </document>