//////////////////////////////////////////////////////////////////////////// // // Copyright 2015 Realm Inc. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // //////////////////////////////////////////////////////////////////////////// #ifndef REALM_TRANSACT_LOG_HANDLER_HPP #define REALM_TRANSACT_LOG_HANDLER_HPP #include <cstdint> #include <stdexcept> #include <memory> #include <realm/version_id.hpp> namespace realm { class BindingContext; class Transaction; namespace _impl { class NotifierPackage; struct TransactionChangeInfo; struct UnsupportedSchemaChange : std::logic_error { UnsupportedSchemaChange(); }; namespace transaction { // Advance the read transaction version, with change notifications sent to delegate // Must not be called from within a write transaction. void advance(const std::shared_ptr<Transaction>& sg, BindingContext* binding_context, NotifierPackage&&); void advance(Transaction& sg, BindingContext* binding_context, VersionID); // Begin a write transaction // If the read transaction version is not up to date, will first advance to the // most recent read transaction and sent notifications to delegate void begin(const std::shared_ptr<Transaction>& sg, BindingContext* binding_context, NotifierPackage&&); // Cancel a write transaction and roll back all changes, with change notifications // for reverting to the old values sent to delegate void cancel(Transaction& sg, BindingContext* binding_context); // Advance the read transaction version, with change information gathered in info void advance(Transaction& sg, TransactionChangeInfo& info, VersionID version = VersionID{}); // Parse the transaction logs between initial_version and end_version, // populating `info` with the results. initial_version must be a version that // has not been pruned (i.e. greater than or equal to the oldest pinned live // version) and end_version must be less than or equal to the transaction's // version. void parse(Transaction& tr, TransactionChangeInfo& info, VersionID::version_type initial_version, VersionID::version_type end_version); } // namespace transaction } // namespace _impl } // namespace realm #endif /* REALM_TRANSACT_LOG_HANDLER_HPP */