Golang Database
ObjectBox Go is a lean NoSQL Golang database for persisting objects. It is designed to give you high performance and easy native Go APIs on any POSIX-system and embedded devices.
We welcome your feedback on ObjectBox Go and this documentation. Use the "Was this page helpful?" smiley at the end of each page or send us your comments to contact[at]objectbox.io - thank you! :)
Changelog
v1.5.0 (2021-08-18)
- update objectbox-c to v0.14.0
v1.4.0 (2021-04-01)
- add TimeSeries model definition support using
id-companionanddate-nanoannotations - avoid
time.Duration.Milliseconds()not available on old Go Versions NewSyncClient- flip return values to align with the other "constructors"- add
NanoTimeInt64*built-in converters
v1.3.0 (2021-03-19)
- add self-assignable IDs:
objectbox:"id(assignable)" - add query
GreaterOrEqual/LessOrEqualfor ints and floats - update objectbox-generator to v0.12.0
- update objectbox-c to v 0.13.0
- fix compiling on old gcc (e.g. the one in CentOS 7)
v1.2.0 (2020-08-25)
- update to objectbox-c v0.10.0 with latest improvements and fixes
- support comma in addition to space as an annotation separator
- extract code generation into a separate module/project objectbox-generator and depend on it to preserve existing
go:generateannotations
v1.1.2 (2020-03-18)
- ensure Query finalizer is only executed by Go GC after a native call finishes
v1.1.1 (2020-02-14)
- use temp directories in tests to prevent failure in recent Go versions checking-out modules as read-only
v1.1.0 (2019-12-16)
- add Box
InsertandUpdatemethods with stricter semantics thanPut - add AsyncBox with
Put,Insert,Update,Remove - Code generator improvements
- handle type-checker errors more gracefully (don't fail on failures in unneeded imports)
- add
cleancommand-line option to remove all generated files time.Timewill automatically use a built in converter to Unix timestamp (milliseconds)- improve model.json file diff-level compatibility with other language bindings
- embedded struct and to-one relations cycle detection
- support changing property type and resetting its stored value
- nil check for embedded pointer structs in the generated code
- minor bug fixes when the generated code wouldn't compile in some edge cases
- update to the latest ObjectBox-C library v0.8.1
- deprecate
box.PutAsync()in favor ofbox.async().Put()i.e. using AsyncBox - mark
byteproperties as unsigned - fix getters on objects with missing relations and non-existent IDs in
GetMany - better windows installation experience using a PowerShell script
- make
golinthappier :)
v1.0.0 (2019-07-16)
This is quite a big release, bringing some new features and cleaning up the API.
- explicit transaction support via
ObjectBox::RunInReadTxandObjectBox::RunInWriteTx - Go Modules support
- add
objectboxnamespace to tags to align withreflect.StructTag.Getunofficial spec - optional lazy loading on to-many relations -
lazyannotation - box additions:
GetMany,RemoveMany,RemoveIds,ContainsIds,RemoveIds- to-many relation auxiliary methods:
RelationIds,RelationPut,RelationRemove,RelationReplace
- switch default/recommended
go:generateentity generator command fromobjectbox-gogento//go:generate go run github.com/objectbox/objectbox-go/cmd/objectbox-gogen - quite a few internal changes, renames and other refactorings (e.g. renamed
PutAlltoPutMany, removedCursor, aligned model JSON with other bindings, ...)
v0.9.0 (2019-04-24)
- Fixed macOS build and 32-bit query support.
- Minor refactoring/linter issues
v0.9.0-rc (2019-02-22)
As we queued up quite a few changes, we're doing a release candidate first for you to test:
- Improved relations support
- Embedded structs
- Recognize and handle type aliases and named types used as entity fields
- New Box methods: CountMax(), IsEmpty(), Contains() and PutAsyncWithTimeout()
- Query support AND & OR (combine conditions)
- Query LT|GT|Between support for unsigned numbers
- Support numeric string ID in the entity
- Support for
[]stringas a field type - Optional pass/return-by-value for slice-of-structs in the generated code
- Change strings to use hash-based instead of value-based indexes by default
- A new option to AlwaysAwaitAsync that can be enabled during initialization
v0.8.0 (2018-12-06)
- Box and Query do not require manual closing anymore
v0.7.1 (2018-11-30)
- Fixed wrong mapping for Go types (u)int and (u)int8. Luckily we noticed this very early: if you used those types in previous versions, please delete old database files.
- Transactions are now safely aborted in case of panics
v0.7.0 (2018-11-29)
- Changed file name of generated code, e.g. file endings for model is now ".obx.go"
- Foundation for all query conditions (final query API will come with the next version)
- Put(object) now assigns the new id to the object itself
v0.6.0 (2018-11-28)
Initial public release
Last modified 3mo ago