d37e113d8b
https://svn.apache.org:443/repos/asf/poi/trunk ........ r651992 | nick | 2008-04-27 19:02:13 +0100 (Sun, 27 Apr 2008) | 1 line Fix from Trejkaz from bug #44857 - Avoid OOM on unknown escher records when EscherMetafileBlip is incorrect ........ r652285 | yegor | 2008-04-30 07:18:05 +0100 (Wed, 30 Apr 2008) | 1 line start a new section for 3.1-beta2 ........ r652288 | yegor | 2008-04-30 07:19:38 +0100 (Wed, 30 Apr 2008) | 1 line correctly process PICT blips (see bug #44886) ........ r652290 | yegor | 2008-04-30 07:21:04 +0100 (Wed, 30 Apr 2008) | 1 line more flexible creation of a cluster ........ r652292 | yegor | 2008-04-30 07:22:02 +0100 (Wed, 30 Apr 2008) | 1 line a few more words in the release guide ........ r652298 | yegor | 2008-04-30 07:29:11 +0100 (Wed, 30 Apr 2008) | 1 line more work on rendering ppt slides ........ r652329 | nick | 2008-04-30 12:10:49 +0100 (Wed, 30 Apr 2008) | 1 line Tests to show that bugs 44891 and 44861 were both already fixed ........ r652426 | josh | 2008-05-01 04:25:37 +0100 (Thu, 01 May 2008) | 1 line fixed bug 44892 - made HSSFWorkbook.getSheet(String) case insensitive ........ r652446 | josh | 2008-05-01 08:42:18 +0100 (Thu, 01 May 2008) | 1 line 44914 - Fix/suppress warning message - WARN. Unread n bytes of record 0xNN ........ r652561 | josh | 2008-05-01 16:46:21 +0100 (Thu, 01 May 2008) | 1 line added disabled junit for bug 44916 ........ r652934 | josh | 2008-05-02 23:36:49 +0100 (Fri, 02 May 2008) | 1 line 44921 - allow Ptg.writeBytes() to be called on relative ref Ptgs (RefN* and AreaN*) ........ r652936 | josh | 2008-05-02 23:49:38 +0100 (Fri, 02 May 2008) | 1 line should have been submitted with r652934 ........ r652994 | josh | 2008-05-03 04:59:32 +0100 (Sat, 03 May 2008) | 1 line Fixed 44675 - Parameter operand classes (function metadata) required to encode SUM() etc properly. Added parse validation for number of parameters ........ r653117 | josh | 2008-05-03 20:53:38 +0100 (Sat, 03 May 2008) | 1 line 44929 - Improved error handling in HSSFWorkbook when attempting to read a BIFF5 file ........ r653125 | josh | 2008-05-03 21:13:56 +0100 (Sat, 03 May 2008) | 1 line Swapped ArrayIndexOutOfBoundsException for plain array length check in AbstractFunctionPtg.getParameterClass(). (To help debugging when trying to find a real AIOOB) ........ r653484 | yegor | 2008-05-05 14:59:11 +0100 (Mon, 05 May 2008) | 1 line take into account indentation in HSSFSheet.autosizeColumn ........ r653485 | yegor | 2008-05-05 14:59:38 +0100 (Mon, 05 May 2008) | 1 line take into account indentation in HSSFSheet.autosizeColumn ........ r653486 | yegor | 2008-05-05 15:00:30 +0100 (Mon, 05 May 2008) | 1 line getting ready to 3.1-beta2 ........ r653520 | yegor | 2008-05-05 17:12:21 +0100 (Mon, 05 May 2008) | 1 line bug #44235 is not reproducible in 3.1-beta1 ........ r653521 | yegor | 2008-05-05 17:13:24 +0100 (Mon, 05 May 2008) | 1 line restored mistakenly commented line ........ r653551 | josh | 2008-05-05 19:30:49 +0100 (Mon, 05 May 2008) | 1 line Added test case method javadoc for old bug 44675 ........ r653608 | josh | 2008-05-05 22:38:07 +0100 (Mon, 05 May 2008) | 1 line Follow-on from 28754 - StringPtg.toFormulaString() should escape double quotes ........ r653668 | josh | 2008-05-06 03:02:41 +0100 (Tue, 06 May 2008) | 1 line 42564 - fixed ArrayPtg to use ConstantValueParser. Fixed a few other ArrayPtg encoding issues. ........ r653675 | josh | 2008-05-06 04:57:15 +0100 (Tue, 06 May 2008) | 1 line 42570 - fixed LabelRecord to use empty string instead of null when the length is zero. ........ git-svn-id: https://svn.apache.org/repos/asf/poi/branches/ooxml@653822 13f79535-47bb-0310-9956-ffa450edef68
223 lines
11 KiB
XML
223 lines
11 KiB
XML
<?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.3//EN" "./dtd/document-v13.dtd">
|
|
|
|
<document>
|
|
<header>
|
|
<title>Apache POI - Java API To Access Microsoft Format Files</title>
|
|
<authors>
|
|
<person id="AO" name="Andrew C. Oliver" email="acoliver@apache.org"/>
|
|
<person id="GJS" name="Glen Stampoultzis" email="user@poi.apache.org"/>
|
|
<person id="AS" name="Avik Sengupta" email="user@poi.apache.org"/>
|
|
<person id="RK" name="Rainer Klute" email="klute@apache.org"/>
|
|
</authors>
|
|
</header>
|
|
|
|
<body>
|
|
<section><title>Office Open XML Support</title>
|
|
<p>We are currently working to support the new Office Open XML
|
|
file formats, such as XLSX and PPTX, which were introduced in
|
|
Office 2007.</p>
|
|
<p>Support for these is currently only available in an svn branch,
|
|
but we hope to have a full release including it by the summer.
|
|
People interested should follow the
|
|
<link href="mailinglists.html">dev list</link> to track progress.</p>
|
|
</section>
|
|
<section><title>POI 3.1-BETA1 Released (2008-04028)</title>
|
|
<p>
|
|
The POI team is pleased to announce the release of 3.1 BETA1 which is one of the final steps before 3.1 FINAL.
|
|
The status of this release is a beta, meaning that we encourage users to try it out.
|
|
If you find any bugs, please report them to the POI <link href="https://issues.apache.org/bugzilla/buglist.cgi?product=POI">bug database</link> or to
|
|
the <link href="./mailinglists.html">POI Developer List</link>.
|
|
</p><p> A full list of changes is available in
|
|
<link href="./changes.html">the changelog</link>, and
|
|
<link href="http://www.apache.org/dyn/closer.cgi/poi/dev/">download</link>
|
|
the source and binaries from your
|
|
<link href="http://www.apache.org/dyn/closer.cgi/poi/dev/">local mirror</link>.
|
|
</p>
|
|
<p>
|
|
The release is also available from the central Maven repository
|
|
under Group ID "org.apache.poi" and Version "3.1-beta1".
|
|
</p>
|
|
</section>
|
|
<section><title>POI 3.0.2 Released</title>
|
|
<p>The POI team is pleased to announce POI 3.0.2, the latest release of Apache POI.
|
|
There have been many important bug fixes since the 3.0.1 release and a lot of new features. A full list of changes is available in
|
|
<link href="./changes.html">the changelog</link>, and
|
|
<link href="http://www.apache.org/dyn/closer.cgi/poi/release/">download</link>
|
|
the source and binaries from your
|
|
<link href="http://www.apache.org/dyn/closer.cgi/poi/release/">local mirror</link>.
|
|
</p>
|
|
<p>
|
|
The release is also available from the central Maven repository
|
|
under Group ID "org.apache.poi" and Version "3.0.2-FINAL".
|
|
</p>
|
|
<p>We would also like to confirm that verions 3.0 and 3.0.1 of Apache
|
|
POI do
|
|
<em>not</em> contain any viruses. Users of broken virus checkers
|
|
which do detect a 94 byte file, sci_cec.db, as containing one are
|
|
advised to contact their vendor for a fix.</p>
|
|
</section>
|
|
|
|
<section><title>Purpose</title>
|
|
<p>
|
|
The POI project consists of APIs for manipulating various file formats
|
|
based upon Microsoft's OLE 2 Compound Document format, and Office OpenXML format, using
|
|
pure Java. In short, you can read and write MS Excel files using Java. In addition,
|
|
you can read and write MS Word and MS PowerPoint files using Java. POI is your Java Excel
|
|
solution (for Excel 97-2007). However, we have a complete API for porting other OLE 2
|
|
Compound Document formats and welcome others to participate.
|
|
</p>
|
|
<p>
|
|
OLE 2 Compound Document Format based files include most Microsoft Office
|
|
files such as XLS and DOC as well as MFC serialization API based file formats.
|
|
</p>
|
|
<p>
|
|
Office OpenXML Format based files include the new (2007+) xml based file formats,
|
|
including Microsoft office files such as XLSX, DOCX and PPTX.
|
|
</p>
|
|
<p>
|
|
As a general policy we try to collaborate as much as possible with other projects to
|
|
provide this functionality. Examples include: <link href="http://xml.apache.org/cocoon">Cocoon</link> for
|
|
which there are serializers for HSSF;
|
|
<link href="http://www.openoffice.org">Open Office.org</link> with whom we collaborate in documenting the
|
|
XLS format; and <link href="http://lucene.apache.org/">Lucene</link>
|
|
for which we provide format interpretors. When practical, we donate
|
|
components directly to those projects for POI-enabling them.
|
|
</p>
|
|
<section><title>Why/when would I use POI?</title>
|
|
<p>
|
|
We'll tackle this on a component level. POI refers to the whole project.
|
|
</p>
|
|
<p>
|
|
So why should you use POIFS, HSSF or XSSF?
|
|
</p>
|
|
<p>
|
|
You'd use POIFS if you had a document written in OLE 2 Compound Document Format, probably written using
|
|
MFC, that you needed to read in Java. Alternatively, you'd use POIFS to write OLE 2 Compound Document Format
|
|
if you needed to inter-operate with software running on the Windows platform. We are not just bragging when
|
|
we say that POIFS is the most complete and correct implementation of this file format to date!
|
|
</p>
|
|
<p>
|
|
You'd use HSSF if you needed to read or write an Excel file using Java (XLS). You'd use
|
|
XSSF if you need to read or write an OOXML Excel file using Java (XLSX). The combined
|
|
SS interface allows you to easily read and write all kinds of Excel files (XLS and XLSX)
|
|
using Java.
|
|
</p>
|
|
</section>
|
|
</section>
|
|
|
|
|
|
<section><title>Components To Date</title>
|
|
<section><title>Overview</title>
|
|
<p>The following are components of the entire POI project and a brief
|
|
summary of their purpose.</p>
|
|
</section>
|
|
<section><title>POIFS for OLE 2 Documents</title>
|
|
<p>POIFS is the oldest and most stable part of the project. It is our port of the OLE 2 Compound Document Format to
|
|
pure Java. It supports both read and write functionality. All of our components ultimately rely on it by
|
|
definition. Please see <link href="./poifs/index.html">the POIFS project page</link> for more information.</p>
|
|
</section>
|
|
<section><title>HSSF and XSSF for Excel Documents</title>
|
|
<p>HSSF is our port of the Microsoft Excel 97(-2007) file format (BIFF8) to pure
|
|
Java. XSSF is our port of the Microsoft Excel XML (2007+) file format (OOXML) to
|
|
pure Java. They both supports read and write capability. Please see
|
|
<link href="./spreadsheet/index.html">the HSSF+XSSF project page</link> for more
|
|
information.</p>
|
|
</section>
|
|
<section><title>HWPF for Word Documents</title>
|
|
<p>HWPF is our port of the Microsoft Word 97 file format to pure
|
|
Java. It supports read, and limited write capabilities. Please see <link
|
|
href="./hwpf/index.html">the HWPF project page for more
|
|
information</link>. This component is in the early stages of
|
|
development. It can already read and write simple files.</p>
|
|
<p>Presently we are looking for a contributor to foster the HWPF
|
|
development. Jump in!</p>
|
|
</section>
|
|
<section><title>HSLF for PowerPoint Documents</title>
|
|
<p>HSLF is our port of the Microsoft PowerPoint 97(-2003) file format to pure
|
|
Java. It supports read and write capabilities. Please see <link
|
|
href="./slideshow/index.html">the HSLF project page for more
|
|
information</link>.</p>
|
|
</section>
|
|
<section><title>HDGF for Visio Documents</title>
|
|
<p>HDGF is our port of the Microsoft Viso 97(-2003) file format to pure
|
|
Java. It currently only supports reading at a very low level, and
|
|
simple text extraction. Please see <link
|
|
href="./hdgf/index.html">the HDGF project page for more
|
|
information</link>.</p>
|
|
</section>
|
|
<section><title>HPSF for Document Properties</title>
|
|
<p>HPSF is our port of the OLE 2 property set format to pure
|
|
Java. Property sets are mostly use to store a document's properties
|
|
(title, author, date of last modification etc.), but they can be used
|
|
for application-specific purposes as well.</p>
|
|
|
|
<p>HPSF supports reading and writing of properties. However, you will
|
|
need to be using version 3.0 of POI to utilise the write support.</p>
|
|
|
|
<p>Please see <link href="./hpsf/index.html">the HPSF project
|
|
page</link> for more information.</p>
|
|
</section>
|
|
|
|
</section>
|
|
|
|
<section><title>Contributing </title>
|
|
<p>
|
|
So you'd like to contribute to the project? Great! We need enthusiastic, hard-working, talented folks to help
|
|
us on the project in several areas. The first is bug reports and feature requests! The second is documentation -
|
|
we'll be at your every beck and call if you've got a critique or you'd like to contribute or otherwise improve
|
|
the documentation. We could especially use some help documenting the HSSF file format! Last, but not least, we
|
|
could use some binary crunching Java coders to chew through the complexity that characterizes Microsoft's file
|
|
formats and help us port new ones to a superior Java platform!
|
|
</p>
|
|
<p>So if you're motivated, ready, and have the time, join the mail lists and we'll be happy to help you get started on the
|
|
project!
|
|
</p>
|
|
|
|
|
|
</section>
|
|
</body>
|
|
<footer>
|
|
<legal>
|
|
Copyright (c) @year@ The Apache Software Foundation. All rights reserved.
|
|
$Revision$ $Date$
|
|
</legal>
|
|
</footer>
|
|
</document>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: xml
|
|
sgml-omittag:nil
|
|
sgml-shorttag:nil
|
|
sgml-namecase-general:nil
|
|
sgml-general-insert-case:lower
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:2
|
|
sgml-indent-data:t
|
|
sgml-parent-document:nil
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
-->
|