Skip to content

About

Pupular OOP-OPF Library for Delphi (from DXE6 to latest version)

Topics

Resources

Code of conduct

Stars

107 stars

Watchers

12 watching

Forks

Repository files navigation

InstantObjects for Delphi

License: MPL 2.0 Latest release Delphi XE6+

InstantObject Logo

Welcome to InstantObjects, the integrated framework for developing object-oriented business solutions in Delphi (from Delphi 10.1 to latest version)

Support Delphi

www.embarcadero.com - learndelphi.org

What is InstantObjects

InstantObjects is a RAD technology that enables creation of applications based on persistent business objects. It simplifies the process of realizing ideas into products; shortens time-to-market, and helps keep business focus.

Even though it is still a bolted-on technology, InstantObjects integrates with the Delphi IDE and Object Pascal in a simple, flexible and intuitive manner. There are no sophisticated environments that have to be comprehended before application development can begin.

InstantObjects offers:

  1. Model realization in the Delphi IDE via integrated two-way tools (from editor to code)
  2. Object persistence in the most common relational databases or flat XML-based files (also with FireDAC Broker)
  3. Object presentation via standard data-aware controls.
  4. Serialization/Deserialization of object using delphi-neon library
  5. Rest Server of object using WiRL library
  6. Rest Server of object using MARS Curiosity library

From 4.2.2 version a new "Installer" read-to-use is located in the Release area: Download the Installer.

The Installer automatically detect your Delphi versions, install sources, build and install packages and add source paths.

Setup

Installation with DPM (Delphi Package Manager)

The library is also published on delphi.dev as the package EtheaDev.InstantObjects (Delphi XE6 to 13, Win32 and Win64): you can install it with DPM, the Delphi Package Manager, as an alternative to the Installer. From the IDE, right click on your project in the Project Manager and choose Manage DPM Packages, or from the command line:

dpm install EtheaDev.InstantObjects <path of your project>.dproj

DPM downloads the package, builds it for the Delphi version and the platforms of your project and adds it to the project. The package has the same packages as the Installer: the core, the catalogs and the ADO, dbExpress, XML and FireDAC brokers, with their design-time packages. The IBX broker is deprecated and the JSON broker, which needs delphi-neon, is not included.

Documentation

The complete documentation is online: ethea.it/docs/instantobjects. It has the User Guide (the business model, the user interface, programming with objects), the advanced topics (virtual containers, burst load modes, Id fields, XML blobs, data migration, JSON, REST servers), the Primer demo tutorial, the library reference and the release notes. Look at the PrimerCross demo to find out how to build applications with an Object Persistence Layer very flexible.

Primer demo

Project Status

The project is still managed by Ethea S.r.l., an italian company that uses InstantObjects for InstantSolution Framework.

You can find more information about this Open-Source project in the wiki section.

InstantObjects source files are released under the Mozilla Public License Version 2.0. You may obtain a copy of the License at

www.mozilla.org/en-US/MPL/2.0/

Full DUnitX Tests

InstantObjects contains about 500 Unit Tests written for DUnitX and ubMock framework.

From 3.0 version is also compatible with TestInsight test framework.

TestInsight Running

Release Notes

VERSION HISTORY

Version 4.4.0 (2026-11-11)

  • Compatibility with Delphi 13.2
  • IBX broker deprecated and no longer maintained: its packages (IOIBX_4, dclIOIBX_4) are kept, but they are not included in the package groups and in the setup. Use the FireDAC broker for InterBase/Firebird
  • New modern graphics of the library: new logo, product box and setup images; new multi-resolution icon (IO_icon_multires.ico, up to 256x256) for the demos, the tests and the tools
  • New attribute type TimeStamp (TInstantTimeStamp, data type dtTimeStamp) for date and time with the highest precision of the database. Available in the Model Explorer and in the IOMETADATA ("Name: TimeStamp;"). Column types with the FireDAC broker: DATETIME2(7) on MS SQL Server, TIMESTAMP(6) on Oracle and PostgreSQL, DATETIME(6) on MySQL, TIMESTAMP on Firebird/InterBase and SQLite. The other brokers (ADO, DBX, IBX) store TimeStamp attributes in the same column type of DateTime attributes
  • MS SQL Server with the FireDAC broker: DateTime attributes are stored in DATETIME2(3) columns and TimeStamp attributes in DATETIME2(7) columns (existing DATETIME columns of DateTime attributes are kept by the evolution, DATETIME columns of TimeStamp attributes are evolved to DATETIME2(7)). DATETIME2 is used only with the FireDAC broker: the ADO and DBX brokers keep DATETIME, because legacy providers (SQLOLEDB) read DATETIME2 columns as strings
  • FireDAC on MS SQL Server: fixed ALTER COLUMN syntax of the database evolution (the type of a column could not be changed)
  • PrimerCross demo and test model: TContact.ObjectTimeStamp (TimeStamp, read only), set by BeforeStore when the contact is created or changed, shown in the contacts grid ("Last saved") and in the contact, person and company forms; demos compiled without IBX (NO_IBX) and delphi-neon (NO_DELPHI_NEON) for Delphi 13
  • New Tools\MdrGen\InstantMdrGen: generates the model resource (.mdr) of a project from the command line, as the Model Expert does in the IDE (for msbuild/dcc32 builds outside the IDE)
  • Deep code review of the library: report and fix status in Docs/BugReview-2026-11.md; every fix is covered by a test that fails with the previous code
  • Core: commit failures roll back the backend transaction and restore the objects; fixed double free / "invalid pointer operation" on close with circular references (PrimerCross Person <-> Company); fixed RefreshAll, Retrieve, Reference(s).Assign between connectors, Parts.Items[], cache Remove, Dereference retry, ForEachAttribute/StoreAllInstantObjects with circular references, Blob/Memo unicode, Float/Currency Reset, Boolean AsInteger
  • Fixed TInstantPump leak of every pumped object
  • SQL brokers: external links/parts use the stored Id; statement cache no longer closes a dataset still in use; virtual containers with delimited identifiers; DateTime primary keys; RecNoOfObject for navigational queries
  • FireDAC catalog: DATETIME accepted for Date/Time attributes (no ALTER at every evolve on MS SQL Server), dtSingle/dtExtended, Boolean on SMALLINT
  • XML/JSON brokers: Dispose uses PersistentId and fails if the file is not deleted; storing a new object (or changing the Id of a stored object) with the Id of another stored object raises EInstantKeyViolation, as with the SQL brokers, instead of overwriting its file
  • DB build/evolution: new tables created with their indexes, indexes dropped before altering fields, generic alter field keeps the data on errors, OnCommandExecuteError event fired
  • IQL: unterminated constants/strings raise errors (no infinite loop), fixed NOT EXISTS, parameters, functions and unary minus
  • InstantCode (Model Explorer): common options of Reference/Part(s) attributes, quotes in metadata values, // comments with LF line breaks
  • Presentation (Exposer/Selector): Locate/SetRecNo in edit mode, null Date/Time fields, Revert after edits and delete, InsertObject on empty dataset, Unicode string truncation, ValidChars ranges, blob stream Cancel
  • Tests: new test units (about 500 DUnitX tests), new TestIO_FireDAC_MSSQL_D13 integration tests on MS SQL Server, model with virtual containers
  • All source files saved as UTF-8 with BOM

The release notes of all the versions (from 1.0.0 to the latest) are in the online documentation: Release Notes.

Contributors are welcome

All InstantObjects users are invited to join us in this project.

License

Copyright (c) 2005-2026 Ethea S.r.l. The original code is Copyright (c) 2001-2003 Seleqt.

Licensed under the Mozilla Public License, Version 2.0 (the "License"): you may not use this software except in compliance with the License. Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License.

About

Pupular OOP-OPF Library for Delphi (from DXE6 to latest version)

Topics

Resources

Code of conduct

Stars

107 stars

Watchers

12 watching

Forks

Releases

Packages

Used by

Contributors

Languages