devNote d061201  ODMJNI 1.0 Deployment 0.80 Beta Refactoring

ODMdev>devNotes> 2006>12> d061201k> 0.00 2008-04-23 21:12 -0700

• Latest version: The latest ODMJNI 1.0 Deployment material can be found via   <http://ODMA.info/dev/devNotes/2006/12/d061201b.htm>.

  visits to popular ODMdev pages

• Previous version:  ODMJNI 1.0 0.70beta Deployment Release <http://ODMA.info/dev/devNotes/2006/12/d061201j.htm>.
• Next version: ODMJNI 1.0 0.90beta Hardening <http://ODMA.info/dev/devNotes/2006/12/d061201l.htm>.
• This page:  ODMJNI 1.0 0.80 Beta Refactoring 0.00 <http://ODMA.info/dev/devNotes/2006/12/d061201k.htm>.   0.80beta reintegrates odmjni100 with a refactored OdmNative100.
• Downloads:
  • d061201k-license.txt: 0.00 version of the ODMA License 1.0 applied to the 0.80beta release (tbd)
  • d061201k-ReleaseNotes.txt: 0.00 for the 0.80beta release, --- byte file dated -----. (tbd)
  • d061201k.txt: 0.00 manifest for the version ---- archive package version (tbd)
  • d061201k-ODMJNI1.0-0.80beta.zip: 0.00 archive of the 0.80beta release, ----- byte file dated -----.    This is a complete roll-up and preservation copy of the essential files for using and confirming the 0.80beta release (tbd).    

{Author Note: More editing and Further Explanations Required}

1. Purpose and Scope

0.80beta Refactoring (tbd, tentative).  Along with maintenance and any bug fixes, this release includes a major refactoring of the Java native implementations in odmjni100 to exploit a significant improvement and restructuring of OdmNative100 interfaces and code.  There is continuing improvement of regression tests and sample applications begin to take form.

2. Description

3. Bugs and Caveats

4. Changes

There is a progression of key changes as part of the refactoring:

1. The performance of library entry-point detection and access is consolidated inside a set of global interfaces.  This removes the funky coordination of the library handle with the implementations of document instances.
    
2. There is refactoring of the top-level interfaces so the part that might be shared can be reduced and shared with administrative and non-DMS functions separate from the practical100 level of DMS-related functions.
     
3. The public interfaces are changed to not reveal ODMA API features in any respect.  Instead, all ODMA-related functions are replaced by COM-interface methods that work with Unicode strings and consistently deliver HRESULTs.
    
4. There is a COM-interface version of UTF-16 character arrays (BSTRs) that allow appropriate caching and also work in coordination with Object-Oriented implementation of wide-character and Unicode strings.
     
5. There is a common library used for validation of the Unicode strings that are supplied as parameters to OdmNative100 methods.  This common library can be used "up front" in wrappers, such as odmjni100, to provide pre-filtering of string-valued parameters at the application level.

5. Development

6. Developer Notes

2008-03-31-12:18 Public Beta of OdmNative100

This release is accompanied by the public beta of OdmNative100.  This is the level at which we want to start public support for the library, headers, and the interfaces.  There can be additions, and we will work carefully with the versioning of interfaces, but this should establish what we hope is the model continuing into the future.

Revision History:

0.00 2008-03-31-09:57 Establish Placeholder for 0.80beta

Create page for preserving the 0.70beta release materials and capturing notes prior to the initiation of this development stage.

You are navigating ODMdev. This work is licensed under a Creative Commons Attribution 2.5 License.

created 2008-03-27-15:35 -0700 (pdt) by orcmid $$Author: Orcmid $ $$Date: 08-04-23 21:12 $ $$Revision: 5 $