src/documentation/content/xdocs/spreadsheet/index.xml - poi - Git at Google

 <?xml version="1.0" encoding="UTF-8"?>
 <!--
    ====================================================================
    Licensed to the Apache Software Foundation (ASF) under one or more
    contributor license agreements.  See the NOTICE file distributed with
    this work for additional information regarding copyright ownership.
    The ASF licenses this file to You 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.
    ====================================================================
 -->
 <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "../dtd/document-v11.dtd">

 <document>
     <header>
         <title>POI-HSSF and POI-XSSF - Java API To Access Microsoft Excel Format Files</title>
         <subtitle>Overview</subtitle>
         <authors>
             <person name="Andrew C. Oliver" email="acoliver@apache.org"/>
             <person name="Nicola Ken Barozzi" email="barozzi@nicolaken.com"/>
         </authors>
     </header>

     <body>
         <section>
             <title>Overview</title>

             <p>HSSF is the POI Project's pure Java implementation of the
             Excel '97(-2007) file format. XSSF is the POI Project's pure
             Java implementation of the Excel 2007 OOXML (.xlsx) file
             format.</p>
             <p>HSSF and XSSF provides ways to read spreadsheets create,
             modify, read and write XLS spreadsheets. They provide:
             </p>
             <ul>
                 <li>low level structures for those with special needs</li>
                 <li>an eventmodel api for efficient read-only access</li>
                 <li>a full usermodel api for creating, reading and modifying XLS files</li>
             </ul>
             <p>For people converting from pure HSSF usermodel, who wish
               to use the joint SS Usermodel for HSSF and XSSF support, then
               see the <link href="converting.html">ss usermodel converting
               guide</link>.
             </p>
             <p>
         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).
          With Cocoon you can serialize any XML datasource (which might be a ESQL page outputting in SQL for instance) by simply
         applying the stylesheet and designating the serializer.
             </p>
             <p>
         If you're merely reading spreadsheet data, then use the
         eventmodel api in either the org.apache.poi.hssf.eventusermodel
         package, or the org.apache.poi.xssf.eventusermodel package, depending
         on your file format.
             </p>
             <p>
         If you're modifying spreadsheet data then use the usermodel api.  You
         can also generate spreadsheets this way.
             </p>
         </section>
     </body>
 </document>
	<?xml version="1.0" encoding="UTF-8"?>
	<!--
	====================================================================
	Licensed to the Apache Software Foundation (ASF) under one or more
	contributor license agreements. See the NOTICE file distributed with
	this work for additional information regarding copyright ownership.
	The ASF licenses this file to You 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.
	====================================================================
	-->
	<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "../dtd/document-v11.dtd">

	<document>
	<header>
	<title>POI-HSSF and POI-XSSF - Java API To Access Microsoft Excel Format Files</title>
	<subtitle>Overview</subtitle>
	<authors>
	<person name="Andrew C. Oliver" email="acoliver@apache.org"/>
	<person name="Nicola Ken Barozzi" email="barozzi@nicolaken.com"/>
	</authors>
	</header>

	<body>
	<section>
	<title>Overview</title>

	<p>HSSF is the POI Project's pure Java implementation of the
	Excel '97(-2007) file format. XSSF is the POI Project's pure
	Java implementation of the Excel 2007 OOXML (.xlsx) file
	format.</p>
	<p>HSSF and XSSF provides ways to read spreadsheets create,
	modify, read and write XLS spreadsheets. They provide:
	</p>
	<ul>
	<li>low level structures for those with special needs</li>
	<li>an eventmodel api for efficient read-only access</li>
	<li>a full usermodel api for creating, reading and modifying XLS files</li>
	</ul>
	<p>For people converting from pure HSSF usermodel, who wish
	to use the joint SS Usermodel for HSSF and XSSF support, then
	see the <link href="converting.html">ss usermodel converting
	guide</link>.
	</p>
	<p>
	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).
	With Cocoon you can serialize any XML datasource (which might be a ESQL page outputting in SQL for instance) by simply
	applying the stylesheet and designating the serializer.
	</p>
	<p>
	If you're merely reading spreadsheet data, then use the
	eventmodel api in either the org.apache.poi.hssf.eventusermodel
	package, or the org.apache.poi.xssf.eventusermodel package, depending
	on your file format.
	</p>
	<p>
	If you're modifying spreadsheet data then use the usermodel api. You
	can also generate spreadsheets this way.
	</p>
	</section>
	</body>
	</document>