ODMdev: ActiveODMA Development Framework

devNote d061201
 ODMJNI 1.0 Deployment
0.80 Beta Refactoring

ODMdev>devNotes>
2006>12>

d061201k>
0.00 2008-04-23 21:12 -0700


{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.

Attribution:
Hamilton, Dennis E.
ODMJNI 1.0 0.80 Beta Refactoring.  AIIM ODMA Interoperability Exchange, ODMdev Development Note page d061201k 0.00, March 31, 2008.  Current version with downloadable software available at <http://ODMA.info/dev/devNotes/2006/12/d061201k.htm>.
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.

Construction Structure (Hard Hat Area)
Creative Commons License 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 $