poi/src/ooxml
Paolo Mottadelli 99f5c38440 Table of Contents first implementation
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@819469 13f79535-47bb-0310-9956-ffa450edef68
2009-09-28 07:42:50 +00:00
..
java/org/apache/poi Table of Contents first implementation 2009-09-28 07:42:50 +00:00
testcases Table of Contents first implementation 2009-09-28 07:42:50 +00:00
README.interfaces [ooxml-branch] Split the common ss interfaces into two sets - one that works with jdk 1.5 and has the full functionality, and another that works with jdk 1.4 and only has dummy functionality. Update build.xml to spit out two versions of the main classes, one for jdk 1.5 with the full interfaces, and one for jdk 1.4 with the dummy ones (but which is otherwise like the current behaviour). Also add readme explaining all this 2008-01-21 18:00:30 +00:00

            Fun with Interfaces
            -------------------

Let us consider a simple case

  public Interface IFoo {}
  public Interface IBar {
     public IFoo getFoo();
  }

  public class RealFoo implements IFoo {}
  public class RealBar implements IBar {
     public RealFoo getFoo() { return new RealFoo(); }
  }

Looks ok, doesn't it? If you access RealBar directly, you get back a
RealFoo. If you access RealBar via the IBar interface, you get back a
IFoo object instead. All looks good.

Only snag - this doesn't work with any JDK older than 1.5. If you're on
JDK 1.3 or JDK 1.4, you will get a compile time error about incompatible
return signatures.


At the moment, we're still committed to having the core of POI work on
JDK 1.3 / JDK 1.4. If you want the OOXML support, then you need to move
to JDK 1.5. This allows us a sort of work-around for the problems:

JDK 1.3 / JDK 1.4:
 You can't use the OOXML stuff anyway, so you probably don't care about
  the new interfaces
 So, have the existing code (hssf) compile against dummy interfaces, which 
  don't actually provide any methods
 You can't then use the interfaces, but you probably didn't want to anyway
 These live in src/ooxml/interfaces-jdk14

JDK 1.5:
 Compile the existing code (hssf) against full interfaces. Users can still
  use the concrete HSSF classes if they want, or if they use the interfaces,
  their code will work with the ooxml support too
 Need to change any methods that take a concrete object (eg HSSFCell) to
  take the interface (eg Cell), and cast, otherwise they're not compatible
  with the interface contract (which specifies Cell not HSSFCell).
 These live in src/ooxml/interfaces-jdk15