新年前最后几天，kbmmw 发布了新版本，增加一大波功能。
we are happy to announce v5.05.50 of our popular middleware for Delphi and C++Builder.
If you like kbmMW, please let others know! Share the word!
We strive hard to ensure kbmMW continues to set the bar for what an n-tier product must be capable of in the real world!
This is a major release with new features in addition to fixing reported bugs and enhancing existing features:
- NEW! kbmMW Linq functionality operating on objects, XML, JSON, YAML datasets and more.
- Lots of ORM improvements including delete options for marking records as deleted, or moving them to an alternative table.
- NEW! VirtualLogManager
- NEW! REST client support using TkbmMWSimpleClient.
- Lots of improvements.
Notice that kbmMemTable v. 7.78.00 is a prerequisite to this update.
Please look in the end of this post for a detailed change list.
New stuff
=========
- Added support for tracking dependency deregistration leaks.
It is enabled if KBMMW_DEBUG_DEPENDENCY is defined in kbmMWDependency.pas
- Added Declared property to TkbmMWXMLMarshal. If true will declare namespaces in the XML.
- Added function IfNotRunning:IkbmMWScheduledEvent flow method to TkbmMWScheduler.
It can be used with Run to ensure that there is not scheduled two of the same event
at the same time. If Name is given, that is used for unique validation, else event
method/anonymousfunction/anymousprocedure is used. If an existing Run is already scheduled
the new attempt to schedule one, is ignored.
- Added QueueLength to TkbmMWHTTPSysServerTransport. Default 1000. Defines max number of outstanding request.
- Added defaultDeleteMethod to TkbmMWTableAttribute. It determine what to do in a table when an object
is to be deleted. It can be set to:
- default or delete which is the normal way. The record is deleted.
- mark Marks a record as deleted, but do not actually remove it.
Queries via the ORM will respect the marking and default only return non deleted records.
Mark should be used in combination with the new deleteMarkProperty and deleteMarkValue settings.
deleteMarkProperty defines which property name (field) to put the mark in (default 'delete')
deleteMarkValue defines which value to put into the property (field) when the record is marked
as deleted. Default true.
- move Moves a record to another table. Should be used in combination with deleteMoveToTable
which must contain the object name of the table that is to receive the record.
- Added display setting to TkbmMW_FieldAttribute. Eg. display: { name: 'abc', width:20, visible:false }
It defines default presentation values for a field.
- Added oldNames setting to TkbmMW_FieldAttribute. Eg. oldNames: [ "field1","field2" ]
If a property is renamed, adding all the old names for which this property is known, in this list,
will make the ORM able to automatically upgrade tables with renamed fields.
Notice that no new field name may exist that collides with an old field name in this list!
- Added function RewriteStatement(const AStatement:string;
const AQueryMode:TkbmMWORMQueryMode=mwoqmMW;
const AOptions:TkbmMWORMQueryOptions=[]):string;
to TkbmMWORM easily allowing rewriting of kbmMW SQL statements to the ORM connected database format.
- Added additional overloaded Persist generic methods to TkbmMWORM.
- Added optional TkbmMWORMQueryOptions to may TkbmMWORM methods, to allow retrieving records
otherwised marked as deleted by providing [mwqoIgnoreDeleteModification].
- Added RandomDouble and RandomFraction functions to TkbmMWCustomRandom in kbmMWRandom.pas.
Makes it easy to return random values within a specific range.
- Added several Make class methods to TkbmMWCustomRandom to allow easy creation of a random number
without needing to manually instantiating an instance of the random number generator.
- Added support in REST transport stream format to generate request streams, and thus
make it possible to use a TkbmMWSimpleClient as a REST client.
- Added support in REST transport stream format to responding in XML or JSON depending
on set contentType in the response stream format.
- Added Make class functions to all password generators in kbmMWPassword.pas making it easy
to create a secure random password.
- Added optional path argument to PreparexxxStorage methods in TkbmMWConfiguration.
Makes it possible to specify exactly where the configuration should be retrieved from /stored to.
- Added Reset method to TkbmMWConfiguration which resets the configuration to default.
- Added optional default setting to TkbmMW_ConfigAttribute, which is used to set the default value
of the configurated item.
- Added support for marshalling dynamic arrays in kbmMWObjectMarshal.
- Added support for mwefInline in TkbmMW_ElementAttribute. Will instruct marshaller to attempt
to inline the element without the subelements root. Elements marshalled like this can not
be automatically unmarshalled again.
- Added TkbmMWPrettyBinary class to kbmMWGlobal.pas. Supports formatting binary data as a pretty hex dump.
- Added function kbmMWGetDocumentsDirectory:string and function kbmMWGetSharedDocumentsDirectory:string to
kbmMWGlobal.pas for cross platform access to valid storage paths.
- Updated transport stream format to 505 to support optional future use Duration response value.
- Added properties ComparativeMSecs:double, ComparativeSecs:double, ComparativeMinutes:double
and ComparativeHours:double properties to TkbmMWDuration. Returns values that can be compared.
- Added Normalize method to TkbmMWDuration which will normalize a duration value. Eg. 36 hours will be
1 day and 12 hours.
- Added OnAfterLog event to TkbmMWCustomLogManager.
- Added support for LogYAML, DebugYAML and LogStream methods to TkbmMWCustomLogManager and TkbmMWLog.
- Added support for specifying pretty mode when logging binary mode in TkbmMWLog.
- Added RemoveLogManager method and ForwardFilterSettings boolean property to TkbmMWTeeLogManager.
The later decides if settings on the Tee log manager is also set on its registered log managers.
- Added TkbmMWVirtualLogManager and IkbmMWVirtualLogManager which will call an anonymous function
each time the logmanager is to log something. Can for example be used for storing elect logs
in a database.
- Added support for ALTER TABLE RENAME COLUMN type operations in kbmMWSQLRewriter.
- Added support for table based metadata as supported in SQLite v 3.16.x+ in kbmMWSQLRewriter.
kbmMW will automatically detect version and use appropriate.
It is recommended to use latest SQLite version since it provides better access to
index definitions and default values of fields.
- Added support for declared and typed booleans settings in kbmMW_RestAttribute.
If declared is true, XML will contain full ?xml and namespace declarations.
If typed is true, XML will contain typed nodes.
- Added EkbmMWHTTPException exception and kbmMWRaiseHTTPError function to allow
raising specific HTTP errors. Eg. kbmMWRaiseHTTPError(407,'.....');
- Added TkbmMWRTTIAliasAttribute which makes it possible to define attributes for
types otherwise not actually declared in code, by defining a dummy class as
alias to a known, but not declared type.
- Added new kbmMWLinq.pas unit providing a global Linq variable which can be
used to make LINQ like operations on data.
Only supported in Enterprise Edition and only from XE5 and up.
Fixes
=====
- Fixed TkbmMWXMLMarshal marshalling.
- Fixed YAML parsing bugs.
- Fixed TkbmMWAuthorizationManager to easily support dirived authorizations.
- Fixed bugs in TkbmMWConfiguration.
- Fixed bugs in TkbmMWONStats.
- Fixed occational A/V caused by TkbmMWCustomValueReplacementVisualizer at designtime.
Changes/minor additions
=======================
- Improved TkbmMWXMLMarshal mashalling.
- Improved TkbmMWSQLXMLData.
- Fixed and improved TkbmMWHTTPSysServerTransport.
- Updated TkbmMW_VirtualTableAttribute and to easily support visibility
(private/protected/public/published) settings.
It makes it easy to automatically consider for example all published properties
to be stored and retrieved from the table.
- Significantly updated TkbmMWBinaryParser. Please notice that definition format has changed.
See samples.
- Updated TkbmMWCustomSQLMetaData to use SQL rewriter when applicable (and supported).
- Updated TkbmMWCustomSQLMetaData to attempt detection of more blob types.
- Implemented fixes to make most code compilable in pure C++Builder
environments.