MATLAB® Builder for
Java™ Release Notes
Contents
MATLAB Builder for Java Release Notes
Summary by Version
This table provides quick access to what’s new in each version. For clarification, see “About Release Notes” on page 1.
Version (Release) | New Features and Changes | Version Compatibility Considerations | Fixed Bugs and Known Problems | Related Documentation at Web Site |
Latest Version V2.0 (R2007b) | Yes Details | Yes | Bug Reports | Printable Release Notes: PDF
Current product documentation |
V1.1 (R 2 0 07 a ) | Yes Details | No | Bug Reports | No |
V1.0 (R2006b) | Yes Details | No | No | No |
About Release Notes
Use release notes when upgrading to a newer version to learn about new features and changes, and the potential impact on your existing files and practices. Release notes are also beneficial if you use or support multiple versions.
If you are not upgrading from the most recent previous version, review release notes for all interim versions, not just for the version you are installing. For example, when upgrading from V1.0 to V2.0, review the New Features and Changes, Version Compatibility Considerations, and Bug Reports for V1.1
and V2.0.
New Features and Changes
These include
• New functionality
• Changes to existing functionality
1
MATLAB Builder for Java Release Notes
• Changes to system requirements (complete system requirements for the
current version are at the MathWorks Web site)
• Any version compatibility considerations associated with each new feature or change
Version Compatibility Considerations
When a new feature or change introduces a reported incompatibility
between versions, its description includes a Compatibility Considerations subsection that details the impact. For a list of all new features and changes that have reported compatibility impact, see the “Compatibility Summary for MATLAB Builder for Java” on page 13.
Compatibility issues that are reported after the product has been released
are added to Bug Reports at the MathWorks Web site. Because bug fixes can sometimes result in incompatibilities, also review fixed bugs in Bug Reports for any compatibility impact.
Fixed Bugs and Known Problems
MathWorks Bug Reports is a user-searchable database of known problems, workarounds, and fixes. The MathWorks updates the Bug Reports database as new problems and resolutions become known, so check it as needed for
the latest information.
Access Bug Reports at the MathWorks Web site using your MathWorks
Account. If you are not logged in to your MathWorks Account when you link
to Bug Reports, you are prompted to log in or create an account. You then can view bug fixes and known problems for R14SP2 and more recent releases.
Related Documentation at Web Site
Printable Release Notes (PDF). You can print release notes from the PDF version, located at the MathWorks Web site. The PDF version does not support links to other documents or to the Web site, such as to Bug Reports. Use the browser-based version of release notes for access to all information.
2
Summary by Version
Product Documentation. At the MathWorks Web site, you can access
complete product documentation for the current version and some previous versions, as noted in the summary table.
3
MATLAB Builder for Java Release Notes
Version 2.0 (R2007b) MATLAB Builder for Java
This table summarizes what’s new in Version 2.0 (R2007b):
New Features and Changes | Version Compatibility Considerations | Fixed Bugs and Known Problems | Related Documentation at Web Site |
Yes Details below | Yes | Bug Reports | Printable Release Notes: PDF
Current product documentation |
New features and changes introduced in this version are
• “Support for RMI” on page 4
• “Interactive MATLAB Graphics Support” on page 4
• “Enhanced CTF Archives” on page 5
• “Web Deployment Documentation” on page 5
• “Enhanced Javadoc Support” on page 5
• “Functions Being Removed” on page 5
Support for RMI
The Java™ native RPC mechanism, RMI, is now supported for “Creating
Scalable Web Applications With RMI”. RMI support enables automatic
generation of interface code for Java remoting, allowing components to be started in separate processes.
Interactive MATLAB Graphics Support
Interactive graphics are now available for user-developed Web applications, using AJAX technology to enable rotating, zooming, and panning.
4
Version 2.0 (R2007b) MATLAB Builder for Java
Enhanced CTF Archives
Output JAR files containing embedded CTF files are now produced for more convenient deployment. Also, it is now possible to ensure that CTF archives containing MEX files are platform independent.
Web Deployment Documentation
The basics of Web deployment with Java Builder, interactive Web graphics, and performance features utilizing RMI are now included in the MATLAB Builder for Java User’s Guide Documentation.
Enhanced Javadoc Support
Javadoc is now searchable from the MathWorks Web site and is also available within packaged Java Builder components.
Functions Being Removed
For more information about The MathWorks process of removing functions, see the section “About Functions Being Removed” in “About Release Notes”.
Functions Being Removed | What Happens When You Run Function? | Use This Instead | Compatibility Considerations |
buildmcr | Errors | MCRInstaller.exe (Windows), MCRInstaller.bin (UNIX), MATLAB_Component_Runtime .dmg (Mac) | See the MATLAB Compiler User’s Guide documentation for more details. |
comtool | Undefined function error | deploytool | Migrate to deploytool. |
dotnettoo | l Undefined function error | deploytool | Migrate to deploytool. |
5
MATLAB Builder for Java Release Notes
Functions Being Removed | What Happens When You Run Function? | Use This Instead | Compatibility Considerations |
mxltool | Undefined function error | deploytool | Migrate to deploytool. |
opennbl | Undefined function error | deploytool | Migrate to deploytool. |
openmxl | Undefined function error | deploytool | Migrate to deploytool. |
opencbl | Undefined function error | deploytool | Migrate to deploytool. |
6
Version 1.1 (R 2 00 7a ) MATLAB Builder for Java
Version 1.1 (R 2007a ) MATLAB Builder for Java
This table summarizes what’s new in Version 1.1 (R 2007 a ):
New Features and Changes | Version Compatibility Considerations | Fixed Bugs and Known Problems | Related Documentation at Web Site |
Yes Details below | No | Bug Reports | Printable Release Notes: PDF Current product documentation |
New features and changes introduced in this version are
• “Support Added for Win 64, Mac, Intel Mac, and Solaris 6 4 ” on page 7
• “Support Dropped for Solaris 2 ” on page 7
• “Java Objects Accessible by MATLAB Java Interface” on page 8
• “Conversion Methods Available for Java Primitive Types” on page 8
• “Image Conversion from RGB to Java AWT Format Available” on page 8
• “Issues with the Microsoft Windows Vista Operating System” on page 8
Support Added for Win 64, Mac, Intel Mac, and
Solaris 64
Support has been added for the following operating systems:
• Windows 64-bit
• Mac
• Intel Mac
• Solaris 64-bit
Support Dropped for Solaris 2
Support has been dropped for the Solaris 2 operating system. It has been replaced by support for Solaris 64.
7
MATLAB Builder for Java Release Notes
Java Objects Accessible by MATLAB Java Interface
Java objects can now be passed by reference to compiled M-functions and be fully accessible by the MATLAB Java interface.
Conversion Methods Available for Java Primitive
Types
Conversion methods are now available that force MATLAB numeric array data into Java primitive numeric types.
Image Conversion from RGB to Java AWT Format
Available
Conversion of RGB image data to Java AWT image object data format is now available.
Issues with the Microsoft Windows Vista Operating
System
The following are known compatibility issues with Microsoft Vista as of this release:
• With User Account Control (UAC) enabled, a standard user is not able to write to a directory in the c:/Program Files directory. See the MATLAB Release Notes for more details regarding this issue.
• Whith User Account Control (UAC) enabled, a standard user is not able to register DLLs. When mbuild -setup attempts to register mwcomutil.dll, the following errors are displayed:
Trying to update options file: C:/Users/qe/AppData/Roaming/MathWorks/MATLAB/R 2007a /compopts.bat
From template: C:/PROGRA~1/MATLAB/R 2007a /bin/win64/mbuildopts/msvc80compp.bat
Done . . .
--> "C:/PROGRA~1/MATLAB/R 2007a /bin/win64/mwregsvr C:/PROGRA~1/MATLAB/R 2007a /bin/
win64/mwcomutil.dll"
8
Version 1.1 (R 2 00 7a ) MATLAB Builder for Java
Error: DllRegisterServer in C:/PROGRA~1/MATLAB/R 2007a /bin/win64/mwcomutil.dll
failed
Undefined subroutine &mexsetup::expire called at C:/PROGRA~1/MATLAB/R 2007a /bin//
mexsetup.pm line 839.
This is also the case when MATLAB Builder for Excel invokes mbuild in an attempt to register DLLs after a compilation completes.
• The following message is displayed when MATLAB Builder for .NET, attempts to install a DLL into the Global Assembly Cache from a network location:
Unhandled Exception: System.IO.FileLoadException: Could not load file or assembly
'GACInstaller, Version=1.0.2568.30711, Culture=neutral, PublicKeyToken=null' or one of its dependencies. Failed to grant permission to execute. (Exception from HRESULT: 0x80131418)
File name: 'GACInstaller, Version=1.0.2568.30711, Culture=neutral, PublicKeyToken=null' ---> System.Security.Policy.PolicyException: Execution permission cannot be acquired.
at System.Security.SecurityManager.ResolvePolicy(Evidence evidence, PermissionSet reqdPset, PermissionSet optPset, PermissionSet denyPset, PermissionSet& denied, Boolean checkExecutionPermission)
at System.Security.SecurityManager.ResolvePolicy(Evidence evidence, PermissionSet reqdPset, PermissionSet optPset, PermissionSet denyPset, PermissionSet& denied, Int32& securitySpecialFlags, Boolean checkExecutionPermission)
• Printing from a compiled application is not currently available with Microsoft Windows Vista. The following message is displayed if you attempt to print on systems with the Microsoft Windows Vista 32-bit operating system installed:
PrintImage Error
StartPage failed with error 6: The handle is invalid.
Printing with Vista 64-bit installed results in an error message that lists a manifest as missing. Please check http://www.mathworks.com/support/ for updates on these issues.
9
MATLAB Builder for Java Release Notes
Version 1.0 (R2006b) MATLAB Builder for Java
This table summarizes what’s new in Version 1.0 (R2006b):
New Features and Changes | Version Compatibility Considerations | Fixed Bugs and Known Problems | Related Documentation at Web Site |
Yes Details below | No | Bug Reports | Printable Release Notes: PDF
Current product documentation |
New features and changes introduced in this version are:
• “Support for MATLAB Features in Java” on page 10
• “Deployment Tool User Interface” on page 11
• “Known Issues” on page 11
MATLAB Builder for Java (also called Java Builder), a new product, is
an extension to MATLAB Compiler. Use Java Builder to wrap MATLAB functions into one or more Java classes that comprise a Java package. Each of the MATLAB functions is encapsulated as a method of a Java class and can be invoked from within a Java application.
When you distribute the application to your users, you must include supporting files generated by Java Builder as well as the MATLAB Component Runtime (MCR), which is provided by the product. Your users do not have to purchase and install MATLAB.
Support for MATLAB Features in Java
Java Builder provides robust data conversion, indexing, and array formatting capabilities to preserve the flexibility of MATLAB when called from Java
code. To support the MATLAB data types, Java Builder provides the MWArray
class hierarchy. You can use MWArray and other Java class members in your application to convert native arrays to MATLAB arrays and vice versa. Java
10
Version 1.0 (R2006b) MATLAB Builder for Java
Builder also provides automatic data conversion for passing arguments that
are Java types.
Java Builder provides custom error handling so that errors originating from MATLAB functions are reported as standard exceptions. The error
description contains specific references to the MATLAB code, thus simplifying the debugging process.
Deployment Tool User Interface
To use Java Builder, open the Deployment Tool by issuing the following
MATLAB command:
deploytool
You can use the Deployment Tool to create a project that encapsulates MATLAB code. You can perform the following tasks using the Deployment Tool:
Known Issues
The following issue is known and a patch to fix the problem is available at the linked bug report.
Data Returned by toArray Referencing Sparse Format May
Be Corrupt
The data returned by calling toArray on a MWNumericArray or
MWLogicalArray object that references a MATLAB array stored in sparse format may be incorrect or corrupted. More
information and a patch that corrects this issue may be found at the Customer Bug Reports area of the MathWorks Web site:
http://www.mathworks.com/support/bugreports/index.html?release=R2006b.
At the Bug Reports page, select R2006b in the Release list, and select
MATLAB Builder for Java in the Product list.
11
MATLAB Builder for Java Release Notes
This bug does not affect normal (non-sparse) arrays, nor does it affect other
methods of retrieving data from a sparse array, such as get, getDouble, and
getData.
12
Compatibility Summary for MATLAB Builder for Java
Compatibility Summary for MATLAB Builder for Java
This table summarizes new features and changes that might cause incompatibilities when you upgrade from an earlier version, or when you
use files on multiple versions. Details are provided in the description of the new feature or change.
Version (Release) | New Features and Changes with Version Compatibility Impact |
Latest Version V2.0 (R2007b) | See “Functions Being Removed” on page 5. |
V1.1 (R 20 0 7a ) | None |
V1.0 (R2006b) | None |
13