2003-04-23 20:53:41 -04:00
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
2007-01-15 18:11:09 -05:00
|
|
|
<!--
|
|
|
|
|
====================================================================
|
|
|
|
|
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.
|
|
|
|
|
====================================================================
|
|
|
|
|
-->
|
2003-04-23 20:53:41 -04:00
|
|
|
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "./dtd/document-v11.dtd">
|
|
|
|
|
|
|
|
|
|
<document>
|
|
|
|
|
<header>
|
|
|
|
|
<title>Overview</title>
|
|
|
|
|
<authors>
|
2003-07-19 21:42:17 -04:00
|
|
|
<person id="AO" name="Andrew C. Oliver" email="acoliver@apache.org"/>
|
2005-01-25 15:08:18 -05:00
|
|
|
<person id="RK" name="Rainer Klute" email="klute@apache.org"/>
|
2003-04-23 20:53:41 -04:00
|
|
|
</authors>
|
|
|
|
|
</header>
|
|
|
|
|
|
|
|
|
|
<body>
|
|
|
|
|
<section><title>What is it?</title>
|
|
|
|
|
<p>The POI project is the master project for developing pure
|
|
|
|
|
Java ports of file formats based on Microsoft's OLE 2 Compound
|
|
|
|
|
Document Format. OLE 2 Compound Document Format is used by
|
|
|
|
|
Microsoft Office Documents, as well as by programs using MFC
|
|
|
|
|
property sets to serialize their document objects.
|
|
|
|
|
</p>
|
|
|
|
|
</section>
|
|
|
|
|
<section><title>Sub-Projects</title>
|
|
|
|
|
<p>
|
|
|
|
|
There following are ports, packages or components contained in the POI project.
|
|
|
|
|
</p>
|
|
|
|
|
<section><title>POIFS</title>
|
|
|
|
|
<p>
|
|
|
|
|
<link href="poifs/index.html">POIFS</link> is the set of APIs
|
|
|
|
|
for reading and writing OLE 2 Compound Document Formats using (only) Java.
|
|
|
|
|
</p>
|
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section><title>HSSF</title>
|
|
|
|
|
<p>
|
|
|
|
|
<link href="hssf/index.html">HSSF</link> is the set of APIs
|
2007-05-29 12:51:41 -04:00
|
|
|
for reading and writing Microsoft Excel 97(-XP) spreadsheets using (only) Java.
|
2003-04-23 20:53:41 -04:00
|
|
|
</p>
|
|
|
|
|
</section>
|
|
|
|
|
|
2003-08-05 00:00:14 -04:00
|
|
|
<section><title>HWPF</title>
|
2003-04-23 20:53:41 -04:00
|
|
|
<p>
|
2003-08-05 00:00:14 -04:00
|
|
|
<link href="hwpf/index.html">HWPF</link> is the set of APIs
|
2007-05-29 12:51:41 -04:00
|
|
|
for reading and writing Microsoft Word 97(-XP) documents using (only) Java.
|
|
|
|
|
</p>
|
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section><title>HSLF</title>
|
|
|
|
|
<p>
|
|
|
|
|
<link href="hslf/index.html">HSLF</link> is the set of APIs
|
|
|
|
|
for reading and writing Microsoft PowerPoint 97(-XP) documents using (only) Java.
|
2003-04-23 20:53:41 -04:00
|
|
|
</p>
|
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section><title>HPSF</title>
|
|
|
|
|
<p>
|
|
|
|
|
<link href="hpsf/index.html">HPSF</link> is the set of APIs
|
|
|
|
|
for reading property sets using (only) Java.
|
|
|
|
|
</p>
|
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section><title>POI-Utils</title>
|
|
|
|
|
<p>
|
|
|
|
|
<link href="utils/index.html">POI-Utils</link> are general purpose artifacts
|
2005-01-25 15:08:18 -05:00
|
|
|
from POI development that have not yet been implemented elsewhere. We're
|
2003-04-23 20:53:41 -04:00
|
|
|
always looking to donate these and maintain them as part of a general library
|
|
|
|
|
used in another project. These are things we need to complete our mission but
|
|
|
|
|
are generally outside of it.
|
|
|
|
|
</p>
|
|
|
|
|
</section>
|
|
|
|
|
</section>
|
2005-01-25 15:08:18 -05:00
|
|
|
|
|
|
|
|
<section>
|
|
|
|
|
<title>Examples</title>
|
|
|
|
|
|
|
|
|
|
<p>Small sample programs using the POI API are available in the
|
|
|
|
|
<em>src/examples</em> directory of the source distribution. Before
|
|
|
|
|
studying the source code you might want to have a look at the
|
|
|
|
|
"Examples" section of the <link
|
|
|
|
|
href="apidocs/overview-summary.html">POI API
|
|
|
|
|
documentation</link>.</p>
|
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section><title>Contributed Software</title>
|
|
|
|
|
<p>Besides the "official" components outlined above there is some further
|
|
|
|
|
software distributed with POI. This is called "contributed" software. It
|
|
|
|
|
is not explicitly recommended or even maintained by the POI team, but
|
|
|
|
|
it might still be useful to you.</p>
|
|
|
|
|
|
|
|
|
|
<section>
|
|
|
|
|
<title>POI Browser</title>
|
|
|
|
|
<p>The POI Browser is a very simple Swing GUI tool that displays the
|
|
|
|
|
internal structure of a Microsoft Office file and especially the
|
|
|
|
|
property set streams. Further information and instructions how to
|
|
|
|
|
execute it can be found in the <link
|
|
|
|
|
href="apidocs/org/apache/poi/contrib/poibrowser/package-summary.html#package_description">POI
|
|
|
|
|
Browser package description</link>.</p>
|
|
|
|
|
</section>
|
|
|
|
|
</section>
|
2003-04-23 20:53:41 -04:00
|
|
|
</body>
|
|
|
|
|
<footer>
|
|
|
|
|
<legal>
|
2007-05-29 12:51:41 -04:00
|
|
|
Copyright 2007 The Apache Software Foundation or its licensors, as applicable.
|
2003-04-23 20:53:41 -04:00
|
|
|
$Revision$ $Date$
|
|
|
|
|
</legal>
|
|
|
|
|
</footer>
|
|
|
|
|
</document>
|
