The DataStream Plug-in is a (non visible) component to take care of fast and reliable transfer of binary data between a Servoy Client and Server.

With the DataStream Plug-in you can stream the data, that needs to be imported, direct into a specific record in your database.
Of course, you can also export the data by streaming to a location on the client file-system.
An additional set of functions will allow you to import and export data to and from the Servoy server file-system as well.

When importing and/or exporting large data loads the User Interface will block. In many cases this is undersirable. An important feature of the DataStream Plug-in is that it can prefent the User Interface from blocking. Should the User Interface block, alternatively, settings can be applied to specify that the transfers should block, forcing the user to wait until the transfer is complete.

Import and export without effect on the Servoy User Interface?
All connections to the back-end database are provided by the Servoy server itself. By doing so there is no risk of interfering with the update notifications that Servoy does by default.
Apart from the above, the streams in both directions are plain http streams. Requests to import and export are standardized SQL queries. Both are managed by the Plug-in.

Client feedback
If configured (optionally, no need to do so), the user can be confronted with a progress dialog.
The dialog can be shown with or without history:

• When large data loads are sent between the Client and Server (via RMI) most failures can occur due to out-of-memory conditions (on both sides).
• Streaming data between these 2 endpoints removes this risk since a small placeholder is re-used to the data. Therefore an out-of-memory condition is almost eliminated.

In short every solution that needs import and export of larger loads of data can benefit from the DataStream Plug-in.

2.1-029 11/02/2011
[fix] fixed a few small bugs

2.1-028 08/22/2011
[chg] made several changes for improved compatibiliby with Servoy 6

2.1-027 08/09/2011
[chg] changed libraries to support (backward) compatibility between (beta) releases

2.1-024 05/05/2010
[chg] made several changes to fix security issue with latest Java release

2.1-021 01/29/2010
[chg] improved Framework to work with external (gui and command-line) installer
[new] added method setErrorReportMethod(method) for feedback when a stream failed

2.0-018 08/17/2009
[chg] changed Framework

2.0-017 07/28/2009
[fix] removed dialog for headless client instances

2.0-016 04/29/2009
[chg] removed signature from core-common.jar to avoid security issues

2.0-015 03/16/2009
[chg] it is not longer necessary to register a developer license

2.0-014 01/19/2009
[chg] made some adjustments to core activation wizard

2.0-013 12/05/2008
[new] added method 'checkServerFileExists' to check for an existing server file(path)
[new] added method 'setMimeTypeChooser(show, onlyShowOnUnknown, allowUnknown)' to define the mimeType dialog
[chg] deprecated method 'readServerFileBinary' now use 'streamServerFileToFile'
[chg] deprecated method 'writeServerFileBinary' now use 'streamFileToServerFile'
[chg] deprecated method 'readRecordBinary' now use 'streamRecordToFile'
[chg] deprecated method 'writeRecordBinary' now use 'streamFileToRecord'
[chg] deprecated method 'clearRecordBinary' now use 'clearRecord' (important, arguments changed)
[chg] deprecated method 'setMonitoringDialog' now use 'setProgressDialog'
[chg] deprecated method 'setMonitoringDialogButtons' now use 'setProgressDialogButtons'
[chg] deprecated method 'setMonitoringDialogToDefault' now use 'resetProgressDialog'
[chg] deprecated method 'setMonitoringDialogButtonsToDefault' now use 'resetProgressDialogButtons'
[chg] deprecated method 'setPromptOnOverwrite' now use property 'promptOnOverwrite'
[chg] deprecated method 'setPromptOnOverwriteToDefault' now use 'resetPromptOnOverwrite'
[chg] simplified and improved sample solution and sample data
[chg] Data Outcome Dialog now throws error to log file, respects headless environment and does not show upon user cancellation
[chg] method 'clearRecord' now works correct under all circumstances
[chg] Progress Dialog respects headless environment
[fix] improved debugger support for callback methods
[fix] correct file suffix is now selected

2.0-012 10/30/2008
[chg] reduced number of jars to download (including plug-in) from 12 to 3, saves 500 kb
[chg] changed feedback in progress dialog
[chg] improved license feedback in log file
[fix] changed a couple of core functions

1.5-011 10/30/2008
[fix] preference panel 'Components' is now available again

1.5-010 10/21/2008
[chg] redesigned for Servoy 4.0

1.4-009 04/14/2008
[new] added property performClientFlush (default true)

1.4-008 04/02/2008
[new] added method setMonitoringDialog(...) to override properties, lives globally (per session)
[new] added method setMonitoringDialogToDefault() to reset to default properties
[new] added method setPromptOnOverwrite(...) to override properties, lives globally (per session)
[new] added method setPromptOnOverwriteToDefault() to reset to default properties
[new] added method setMonitoringDialogButtons(...) to set button text, lives globally (per session)
[new] added method setMonitoringDialogButtonsToDefault() to reset to default english text

1.4-007 02/25/2008
[new] added method 'getVersionLicensed' to find out what version is licensed
[chg] reduced client download size for resources with overall savings up to 45%

1.4-006 09/19/2007
[fix] corrected the issue that prevented mimetypes from being set under certain circumstances

1.4-005
[new] added preference to autoHide progress dialog after xx seconds (only with 'remove after completion' = true)
[new] added preference to show/hide 'Clear Completed' button in progress dialog
[new] added preference to show/hide 'Clear Erroneus' button in progress dialog
[new] added preference to show/hide 'Clear All' button in progress dialog

1.4-004
[chg] improved sample code
[chg] improved sample solution
[fix] corrected errors in tooltips for all methods

1.4-003
[new] case 0000087: added preference to show progress dialog on top of Servoy window
[new] case 0000088: ability to start a (global) method after download or upload
[chg] switched positions of 'Clear All' and 'Clear Erroneous' buttons in progress dialog
[chg] corrected some (minor) layout issues in progress dialog

1.3-003
[new] added getVersion() and getLicense() methods to retrieve component information

1.3-002
[chg] created new sample solution
[chg] improved layout of progress dialog
[chg] renamed plug-in 'DataStreamer' to 'it2be_datastream'
[chg] renamed all plug-in methods ending with 'Stream', removed it
[chg] renamed admin server properties
[new] added (stored) icon to mimetypes

R1.2.16.1
[fix] Read media from file system if display_name column point to a valid server file and the media cell is null

R1.2.9
[fix] fixed a Preference management bug

R1.0
[new] initial DataStream plug-ins