## JACOB 1.19

### What's New

- Upgraded from Java 6 to Java 8 compilation
- Upgraded from junit 3.8.1 to 4.12
- Migrated from CVS to GIT using sourceforge migration instructions https://sourceforge.net/p/forge/documentation/CVS/

### Tracked Changes

Bugs
132 | 32 bit ponters not convertd to 64 bit
130 | Name value incorrect in Mainfest.MF affecting tamper check
Patches
n/a | none
Feature Requests
n/a | none

## JACOB 1.18

### What's New

- (M2) Built with Java 1.6 and Visual Studio 2013 Microsoft Platform SDK V7.1A (introduced with VS2012)instead of v7.0A (vs2010) Targeting SDK V7.1 with USING_V110_SDK71" http://en.wikipedia.org/wiki/Microsoft_Windows_SDK
- (M2) Temporarily using AMD64 compiler instead of x86_amd64 because of installation issues on dev machine. Should generate same output even though dll files are different sizes between M1 and M2. http://msdn.microsoft.com/en-us/library/x4d2c09s.aspx
- (M2) Dropped support for XP

### Tracked Changes

Bugs
119 (new numbers) | (M?)Attribute lacking in MANIFEST.MF required since Java 1.7u45
Patches
42 (new numbers) | (M3)Mapping of names to dispIDs implemented
Feature Requests

## JACOB 1.17

### What's New

- No new features

### Tracked Changes

Bugs
3505940 | (M2)JacobVersion.properties accidently omitted from JAR. Must build from command line to get it included.
3436102 | (M1)Fix memory pointer that was 32 bit. Causes defects in 64 bit systems above 2GB
115 (new numbers) | (M3)Release problem if you've got two threads with the same name
111 (new numbers) | (M3)m_pDispatch is not 0 if not attached
117 (new numbers) | (M4) NullPointerException injacob-1.17-M2
Patches
41 (new numbers) | (M3)Fix for SafeArray(String) constructor
Feature Requests

## JACOB 1.16

### What's New

- No new features

### Tracked Changes

Bugs
3436143 | (M2)Remove Main-Class from MANIFEST because there is no main class entry point for this jar file
3435567 | (M2)Add HRESULT to error message when unknown COM error raised in Dispatch
| (M2)Added debug info to advise failure messages.
| (M2)Added support for null dispatch object in putVariantDispatch.
| (M2)Fixed memory leak in Variant.cpp zeroVariant method possibly related to previous fix proposed in SF 1689061 but never implemented. I guess we should fix it since people keep pointing it out
| (M2)Variant.getString() now returns null for NULL or EMPTY Variants instead of throwing exception.
3412922 | (M1)Fix for: When a DispatchEvent is created with a COM object, the COM object is never released totally, and the destructor function is never called.
Patches
3377279 | (M1)Fix possible exception. Added initializing Variant used to retrieve the next value from IEnum because some implementations call VariantClear on it before setting a new value
| (M1)Isolate compilation of SafeArrayTest.java because it is UTF-16 and not UTF-8
| (M1)Changed windows version _WIN32_WINNT to 0x0500 to fix build with VS2010. (now 2000 or later)
| (M1)Fixed the leak in Java_com_jacob_com_Variant_putVariantNoParam
| (M1)Added Dispatch.Method to the invoke flags to call _NewEnum. There are some non-conforming legacy implementations that expose _NewEnum as a method.
Feature Requests

## JACOB 1.15

### What's New

- MS Libraries are now statically linked using /MT instead of /MD to reduce issues library compatibility issues, especially on older platforms. The VC++ redistributable library no longer needs to be installed as a stand alone product.

### Tracked Changes

Bugs
3065265 | (M4)Bit masking in Variant.getXXXRef() uses wrong mask allowing more than one type to be seen as the requested type. Code that passed in the correct type always worked but invalid types were not always detected.
2935662 | (M4)Error handling code crashes because of uninitialized data in Dispatch.cpp Check for NULL fails. pfnDeferredFillIn pointer is not initialized, but it's not NULL.
2819445 | (M3)SafeArray.fromLongArray fails when using VariantLongInt
2847577 | (M3) SafeArray#setString(*) incorrectly handles unicode strings
2721937 | (M2)System.getProperties call caused security exception in applet. com.jacob.includeAllClassesInROT now acts as master switch for class/ROT control. This change also has the side benefit that the PutInROT property is not checked on every object creation for users who run in the standard all classes in ROT mode.
Patches
2762275 | (M1)Support conversion of primitive arrays to Variant arrays.
2171967 | (M1)VariantUtils.populateVariant can cause VM crash with unrecognized type.
Feature Requests
3137337 | Add JNLP Applet example. Read the README to understand what jar file signing and file placement is required
2963102 | (M4)Convert API to use var args and remove the many overloaded Dispatch methods that each added one more parameter.
2927058 | (M4)a hasExited() method that allows polling until a COM server is terminated and implemented this method in JACOB
Known Issues

## JACOB 1.14.3

### Tracked Changes

Bugs
2011706 | Fixed windows memory corruption unhooking call back proxy
1986987 | Possible deadlock when multiple threads starting and stopping that rely on implicit ComThread.InitMTA
Patches
Feature Requests
Known Issues

## JACOB 1.14.1

### Tracked Changes

Bugs
1919441 | Type: loading 64 bit jacob.dll. Computed dll name includes space that is not in name of actual dll
Patches
Feature Requests
Known Issues

## JACOB 1.14

### What's New

- Binaries are now compiled with Java 5. JDK 1.4 support dropped.
- Jacob now loads dlls based on platform (32 bit /64 bit) and version number.

### Tracked Changes

Bugs
1857439 | (M7) version.properties renamed to META-INF/JacobVersion.properties to remove collision with WebSphere version.properties.
1840487 | (M6) toJavaObject() converting to SafeArray did shallow copy that left two objects pointing at the same windows memory.
1829201 | (M5) DECIMAL rounding behavior externalized and old Variant decimal API restored.
1829201 | (M5) DECIMAL rounding behavior externalized and old Variant decimal API restored.
1829201 | (M4) Decimal type now throws IllegalArgumentException when more than 12 bytes worth the digits exist in BigDecimal. Rounding support added to reduce precision of BigDecimals when converting into VT_DECIMAL
1815163 | (M2) Double and Decimal conversion to Int fails for negative values
Patches
Feature Requests
1845039 | (M7) Jacob DLL name can now be customized to support bundling of Jacob in other products.
1845039 | (M6) Jacob DLL names are now qualified by platform and release. The JacobLibraryLoader now determines the correct 32bit or 64bit dll based on the system architecture. Jacob.jar now also knows the version of the dll it is looking for (by name) and loads the correct one. JWS clients will have to modify their dll loaders. See: The JWS classloader sample
1828371 | (M4) Added VT_I8 support to SafeArray.
1813458 | (M3) Expand type support. Changed currency support to use new Currency class. Added VT_I8 64 bit support. VT_I8 support requires Windows XP or later. VT_I8 not supported by windows in Windows 2000 and earlier. Added more primitive constructors to Variant.
1816863 | (M1) Migrate Jacob to JDK 5
Known Issues
| This is now built with Java 5 compiler and Java 5 syntax. This release is not compatible with JDK 1.4.x and earlier.
| This release requires the Visual C++ 2005 libraries. See 1.13 Known Issues for more information.

## JACOB 1.13

### What's New

- Binaries compiled with with Visual Studio 2005 in place of VC98.
- Changed milestone release naming convention from "pre..." to "M..."
- The unittest directory now a JUnit 3.8.1 test repository

### Tracked Changes

Bugs
1793362 | (M5) ERROR_MORE_DATA causes failures. Fix submitted for defect found while porting Jameleon to use current release of Jacob.
1775889 | (M4) Fixed leak SafeArray setString(int[],value) and other setString() methods
Patches
1794811 | (M5) Support Unicode strings in COM failure messages
1793346 | (M5) Replaced use of deprecated API and removed unused variables.
1701995 | (M2) Added option to exclude classes from ROT to try and manage memory in heavy event callback programs. Feature is 100% backwards compatible by default.
1709841 | (M1) Compiled with Visual Studio 2005. Jacob now requires 2005 or later libraries. See the UsingJacob.html file for impact this has on NT, 2000 and Server 2003 users.
Feature Requests
1772783 | (M4) Added VT_DECIMAL support for BigDecimals whose scale less than 28
1761727 | (M3) unittest directory test programs converted to JUnit 3.8.1. New ANT target created to run all unit tests.
Known Issues

Jacob 1.13 is built using VC++ 2005. That creates a dependency on the Visual C++ 2005 libraries and msvcr80.dll. This library is normally installed on XP systems but may have to be manually installed on older systems. The pagackage, often referred to as vcredist.exe can be obtained from the MS downloads site. If you are getting loader errors on this release or later when loading the dll then you may be missing this library.

## JACOB 1.12

### What's New

- Now compiles with with Visual versions later than VC 98

### Tracked Changes

Bugs
1651926 | (pre-release 1) ActiveXComponent: getPropertyAsString should call getString() instead of toString()
1569864 | (pre-release 1) IEnumVariant leak fixed in patch 1674179
1112667 | (pre-release 1) IEnumVariant leak fixed in patch 1674179
1465539 | (pre-release 1) IEnumVariant leak fixed in patch 1674179
1699946 | (pre-release 5) Unrecognized event callback id leaves thread attached to VM when ComFailException is thrown.
1699965 | (pre-release 5) toJavaObject() fails for Dispatch because getDispatchRef() called instead of getDispatch().
Patches
1674015 | (pre-release 1) ROT hashmap key generation when autogc=no (default) can lead to key collisions in hashmap. This causes objects to be garbage finalized when they shouldn't be resulting in vm failures with large (large) numbers of objects.
1674179 | (pre-release 1) Fixed Enum leaks with EnumVariants in Variant.cpp and EnumVariant.cpp
1687419 | (pre-release 3) Corrected calls to AttachCurrentThread in EventProxy
1689061 | (pre-release 4) C code changes to fix VC2003 compiler warnings.
1690420 | (pre-release 4) Incorrect memcpy lengths for Currency Variants
1650134 | (pre-release 6) Beta support for VT_VARIANT (VariantVariant). Includes support for putVariant, getVariant, toJavaObject, Variant(Object,flag). Enclosed variants are retreived as Java objects.
Feature Requests
1662887 | (pre-release 1) Dispatch static methods should throw runtime exceptions when null is passed in for the Dispatch object and when the Dispatch object is in an invalid state.
1702604 | (pre-release 6) Support java semantics in event callbacks. Create ActiveXInvocationProxy and ActiveXDispatchEvents that provide the supplemental API. See IETestActiveXProxy.java for an example.
Known Issues
1504120 | Identified 1.11.1 Microsoft 2003 Server crashes. Server crashes on MS 2003 Server have been reported over time. Some users have had say that Jacob must be built on MS2003 Server to run reliably. The Jacob distribution on Sourceforge is built on Windows XP SP2
1677933 | Identified 1.11.1 Process affinity may have to be set on dual core machines to avoid com exceptions.
no ticket | Identified 1.11.1 Versions of JDK 1.5 prior to 1.5_10 are known to leak JNI handles. See the Sun bug tracking system http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6399321 for more details.

## JACOB 1.11.1

### What's New

Bug fix release

### Tracked Changes

Bugs
1602188 | Variant toString() causes stack overflow for byRef() Variants (This show stopper defect forced the 1.11.1 release)
1611487 | Variant toJavaObject() doesn't work for byRef Variables and returned the wrong value for unrecognized Variant types.
1607878 | Variant getJavaDateRef() fails.
Patches
SF1603631 | Concurrent modification of ROT causes VM crashes. Access to the ROT has been sychronized. No performance impact analysis has been done
Feature Requests

## JACOB 1.11

### What's New

- Build
  - Build process now notifies developer if version property missing
  - Build process now compiles 32 bit and/or 64 bit DLLs as appropriate for the build environment.
- API Changes
  - Variant.noParam() changed to Variant.putNoParam()
  - Variant.toString() now follows normal java semantics. This conflicted with the jacob toXXX() standard.
  - Many Variant.toXXX() did type conversion in addition to a get. The methods have deprecated because folks didn't realize they were doing type conversion. Most calls to toXXX() methods should actually be getXXX() calls. This also allowed toString() to follow Java conventions
  - Variant native methods are wrapped with java methods that do parameter and state checking to better armor the Variant

### Tracked Changes

Bugs
1550604 | Build process died with confusing error if version not set in properties file(pre1)
1511033 | Fix array index out of bounds problem due to coding error (pre1)
1570270 | ~Event method in EventProxy may unhook java thread from VM. Can get JNI error because unhooking listner detatched Java VM thread (pre1)
1538011 | toString() non compliant with java standards. The toString() method converted the underlying data to a string and it shouldn't. This caused a rethinking of all toXXX() methods other than toDispatch(). Most of the toXXX() methods have now been deprecated and should be replaced with getXXX() methods. (pre1)
1478162 | Variant does not warn user if methods called after released. All putXXX() and getXXX() methods now check to see if they've been released prior to calling the JNI code. toXXX() methods are deprecated but protected in the same way.(pre1)
Patches
SF1493647 | Support command line parameter dll location specification. Applets and other tools can now specificy the dll location that is fed to a System.load() rather than System.loadLibrary for the situation where the app can't write the dll to a library path directory.(pre1)
Feature Requests
1580993 | Modify the build process to support 64 bit dll construction(pre2)
1550628 | Moved all LoadLibrary requests into LibraryLoader. Classes not subclassed off of JacobObject make calls to a static method on LibraryLoader to make sure DLL is loaded(pre1)

## JACOB 1.10.1

### What's New

- Variants
  - Static constnats are no longer released
  - obj2variant on Dispatch now supports passing a java.util.Date

### Tracked Changes

Bugs
1474474 | Static constants in the Variant class can no longer have SafeRelease() called on them.
1477793 | obj2variant should accept java.util.Date the same way the Variant constructor does
Patches
Feature Requests

## JACOB 1.10

### What's New

- Windows Processes
  - New proposed API to support ActiveXComponent connections to already running applications. Factory methods have been added to the ActiveXComponent to support this. (Feedback wanted)
- Variants
  - Variant now accept Java Dates in the constructor.
  - Redundant constructors removed
  - Experimental toJavaObject() method added that automatically converts to appropriate java type
  - Support added for "NOTHING", a Variant of type Dispatch with no value
  - Non functional getNull() and getEmpty() methods deprecated. They were void methods
- Event Callbacks
  - Jacob normally uses information in the registry to find the connection information needed to set up event callbacks. Excel and other programs don't put that information in the registry. A new optional parameter has been added to the DispatchEvents constructors that lets a user provide the location of the OLB or EXE that contains the information required to retrieve the events.
  - Event handlers can now return a Variant to calling MS Windows program. Event handlers that do not return an object should still be defined as being of type "void". This means that support for event handler's returning values should be backwards compatible with previous releases.

### Tracked Changes

Bugs
1340233 | Null Program Id in Dispatch Constructor does bad things to VM(pre1)
1341763 | Removed Variant serializable interface because it is not actually serializable on 2000/xp(pre1)
1435215 | Incorrect memory release in SafeArray.cpp (pre4)
1224219 | Memory leak in SafeArray.GetString() Olivier Laurent, Software AG Luxembourg and David Pierron, Software AG Luxembourg (pre3)
1224219 | Change from UTF to UNICODE SafeArray.fromStringArray() Olivier Laurent, Software AG Luxembourg and David Pierron, Software AG Luxembourg (pre3)
Patches
1386454 | Return values from event callbacks (pre3)
1394001 | Missing variable initialization (pre3)
1208570 | Support Excel and other objects events(pre1)
Feature Requests
1241037 | Support NULL VT_DISPATCH.(pre2)
1169851 | Support of VB's Nothing.(pre2)
1185167 | Provide methods to connect to running instance.(pre1)
959381 | Auto variant to object conversion method method added to Variant.(pre1)
1341779 | Variant should accept java.util.Date in Variant(Object) constructor(pre1)

## JACOB 1.9.1

### What's New

- License
  - License standardized on LGPL. See LICENSE.TXT for more information
- Event Callbacks
  - Event handlers are now wrapped in an InvocationProxy. The COM/JNI event code knows only about InvocationProxies and calls the appropriate methods on the Invocation proxy to get needed Variant instances and to forward events to the Java layer.
- Variants
  - Automatic conversion between Windows Time and Java Date is now supported in Variant object.
- SafeArray
  - Multi-dimensional (greater than 2) support

### Tracked Changes

Bugs
1335897 | SafeArray() called toString() on objects when debug was turned on
Patches
1314116 | putString UNICODE string length not detected
Feature Requests
1264850 | Custom Event Dispatching
959382 | Time Conversion
1313892 | Multi-Dimensional SafeArray

## JACOB 1.9

### What's New

- Event Callbacks
  - Variant parameters can now be modified by the receiver to be passed back to the COM caller
  - Callbacks now create objects of class VariantViaEvent rather than Variant. This was aided to add debugging and tracing
  - Callbacks can now be received when running in JWS other launchers where JACOB.jar is not in the system classloader's path.
- Dispatch API Clarifications
  - All static method's first parameters have been more strongly typed to the Dispatch class, rather than Object. This may call for code changes in the cases of code that just asigned Dispatch objects to variables of type Object rather than Dispatch or one of its subclasses
- Dispatch subclasses are now supported with pointer modifying constructor
  - Dispatch and ActiveXComponent now includes a constructor to be used by Dispatch subclasses that swaps the pointers around. This eliminates the need for every Dispatch subclass to have a constructor that swapped and nulled out the pointers to the COM layer. All samples have updated to use the new api
- ActiveXComponent has been upgraded
  - ActiveXComponent methods return ActiveXComponets
  - Methods have been added to the ActiveXComponents to retrieve parameters as Dispatch objects or ActiveX components. The Script Tests have been updated to show the same programs in Dispatch format or ActiveXComponentFormat
- Memory Management
  - Beta test option that lets an application use automatic object object removal through the use of weak reference hash maps in the ROT class. The default behavior of manual release via the COMThread class has been retained as the default behavior. Developers can test automatic memory collection by using the command line option -Dcom.JACOB.autogc=true
- JNI Changes
  - Erroneous Array dimension checking fixed for certain boolean set and get functions
  - Alternative method for finding Variant class for callbacks in JWS or other application lanchers where the system classloader does not know about JACOB classes.
  - Unicode is supported for putString and putStringRef
  - EventProxy zeros out the com object reference in the Variant objects that are created by EventProxy so that they are not double released, by both the Java VM and calling code from the COM side. The caller is supposed to be responsible for releasing the memory it created. This fix only applies to Variants created in callbacks.
- Logging Additions
  - Debugging logging to standard out for JACOB can be turned on by using the command line option -Dcom.JACOB.debug=true
- Visual Studio
  - The VisualStudio directory in the CVS repository will be removed in the next release
- Documentation
  - API documentation via Javadoc is now being generated for all classes.
  - The development team is looking for help in upgrading the quality of the class documentation
- Build Changes
  - A static method has been added to JacobObject that returns the build version
  - The project is now being built using ANT. Most of the developers are running this from inside of Eclipse
  - All makefiles have been purged

  ### Tracked Changes

  Bugs
  1116101 | jacob-msg 0284 : Access Violation while garbage collecting
  1114159 | Problem with COM Error Trapping in JACOB DLL
  1113610 | Bad error check in SafeArray.cpp
  1066698 | Minor Memory leak in Dispatch.cpp
  1065533 | Problem with unicode conversion
  1053871 | solution for memory leak in 1.7
  1053870 | JACOB0msg 2019 - Safe Array
  1053866 | getHResult only returns 80020009
  960646 | But in SafeArray:: getBoolean for 2D arrays
  Patches
  1115187 | EventCallbacks fail w/Variant ClassNotFoundException in JWS
  1105915 | Fix for event handling memory corruption
  1090104 | Weak Reference in teh ROT
  1068544 | in/out parameter support for event handlers
  981540 | jre 1.4.2 fix as patch
  Feature Requests
  1049390 | static Version information
  1049224 | Javadocs or at least script to generate it
  1049158 | API to get ProgId of ActiveXComponent

## JACOB 1.8

### What's New

- Move To SourceForge The project is not housed at Sourceforge.net.
- Licensing Change All limitations on commercial use of JACOB have been removed and it is now being developed under a BSD license at Sourceforge.net.
- Compiled with Java 1.4.2 Version 1.8 was compiled with JSEE 1.4.2 and fixes the compilation bug that was remnant of compilation with JDK 1.1.
- Baseline For Change This version is the baseline for the first CVS checkin and we encourage people to start contributing to the project with this version.

- ## JACOB 1.7

  ### What's New

  - Explicit COM Threading Model Support: See a detailed discussion of COM Apartments in JACOB
  - New COM Object Lifetime model: See a detailed discussion of COM Object Lifetime in JACOB.
  - Improved Event Handling: Thanks to code contributed by Niels Olof Bouvin and Henning Jae JACOB 1.7 can read the type information of a Connection Point interface by looking it up in the registry. This makes it possible to use events with IE as well as office products.
  - Improved Dispatch: Error messages from Invoke failures are now printed out as well as allowing the passing in of arguments to a Get method.
  - EnumVariant Implementation: Makes it easier to iterate over COM collections. Thanks to code contributed by Thomas Hallgren.
  - SafeArray leaks: SafeArrays were not being properly freed prior to version 1.7, many other memory leaks were fixed as well.
  - Visual Studio Project: For those who want to debug: vstudio/JACOB. At the moment all the native code is replicated there from the jni directory...

  ## Related Links

  - The best way to get support or the latest version of JACOB is on http://sourceforge.net/projects/jacob-project This is the preferred way to get support for JACOB. It also includes an extensive archive. If you are doing any development with JACOB, please join sourceforge.
  - Massimiliano Bigatti has developed JACOBgen - a generator that automatically creates JACOB code from Type Libraries, now available on sourceforge
  - Steven Lewis is developing a version of Java2Com that supports JACOB code generation. See: http://www.lordjoe.com/Java2Com/index.html.
  - To find documentation on the com.ms.com package, go to: http://www.microsoft.com/java/download/dl_sdk40.htm and at the bottom of the page is a link that says: Microsoft SDK for Java 4.0 Documentation Only. You should download that file and install it. Then, view sdkdocs.chm and look for "Microsoft Packages Reference". Hopefully, the next release of JACOB will include full javadoc (volunteers?)...