Interface IBmModel


  • public interface IBmModel
    Entry point for all interactions with the BM integration mechanism.
    • Method Detail

      • addResourceSyncListener

        void addResourceSyncListener​(IBmWorkspaceSynchronizationListener listener)
        Registers the given workspace synchronization listener.
        Parameters:
        listener - The workspace synchronization listener. May not be null.
      • removeResourceSyncListener

        void removeResourceSyncListener​(IBmWorkspaceSynchronizationListener listener)
        Unregisters the given workspace synchronization listener.
        Parameters:
        listener - The workspace synchronization listener. May not be null.
      • addSyncEventListener

        void addSyncEventListener​(IBmSyncEventListener listener)
        Adds the specified synchronous event listener.
        Parameters:
        listener - The listener to add. May not be null.
      • removeSyncEventListener

        void removeSyncEventListener​(IBmSyncEventListener listener)
        Removes the specified synchronous event listener.
        Parameters:
        listener - The listener to remove. May not be null.
      • addAsyncEventListener

        void addAsyncEventListener​(IBmAsyncEventListener listener,
                                   BmEventFilter... filters)
        Adds a new IBmAsyncEventListener listener with associated a set of filters. Listener is being notified only in case if input matches at least one filter criteria, i.e. filters work in "OR" logic together as triggers.
        Parameters:
        listener - The Listener to add. May not be null.
        filters - The set of associated filters. May be null.
      • removeAsyncEventListener

        void removeAsyncEventListener​(IBmAsyncEventListener listener)
        Removes the specified asynchronous event listener.
        Parameters:
        listener - The listener to remove. May not be null.
      • waitAllEnqueuedEventsSent

        void waitAllEnqueuedEventsSent()
        Waits till all the events enqueued prior to calling this method are sent.
      • waitForProcessing

        @Deprecated
        void waitForProcessing​(long timeOut)
        Deprecated.
        Testing only method for waiting till all the specified providers complete their data processing.
        Parameters:
        timeOut - The maximum time to wait in milliseconds.
      • createLocalContext

        IBmLocalEditingContext createLocalContext​(String name)
        Creates a local context.
        Parameters:
        name - The name of the context. May not be null.
        Returns:
        a newly created local context instance, never null.
      • getGlobalContext

        IBmGlobalEditingContext getGlobalContext()
        Gets the global context instance.
        Returns:
        the global context instance, never null.
      • getEngine

        IBmEngine getEngine()
        Gets the underlying engine.
        Returns:
        the underlying engine, never null.
      • getId

        String getId()
        Gets the identifier of the model.
        Returns:
        the identifier of the model, never null.
      • execute

        <T> T execute​(IBmTask<T> task)
        Executes the given task without recording history.
        • If the task execution causes the transaction deadlock (throw BmDeadlockDetectedException), the transaction is rolled back, and the task executed again.
        • If after certain amount of retries the task still fails to execute without deadlock, an exception is thrown.
        • If the task throws any exception other than BmDeadlockDetectedException it is re-thrown.
        Parameters:
        task - The task. May not be null.
        Returns:
        the result returned by IBmTask.execute(IBmTransaction, IProgressMonitor) method.
      • executeAndRollback

        <T> T executeAndRollback​(IBmTask<T> task)
        Executes the given task without recording history.
        • If the task execution causes the transaction deadlock (throw BmDeadlockDetectedException), the transaction is rolled back, and the task executed again.
        • If after certain amount of retries the task still fails to execute without deadlock, an exception is thrown.
        • If the task throws any exception other than BmDeadlockDetectedException it is re-thrown.
        The transaction will be rolled back.
        Parameters:
        task - The task. May not be null.
        Returns:
        the result returned by IBmTask.execute(IBmTransaction, IProgressMonitor) method.
      • executeReadonlyTask

        <T> T executeReadonlyTask​(IBmTask<T> task,
                                  boolean lightweight)
        Executes the given task. The task is executed within read-only transaction.
        • If the task execution causes the transaction deadlock (throw BmDeadlockDetectedException), the transaction is rolled back, and the task executed again.
        • If after certain amount of retries the task still fails to execute without deadlock, an exception is thrown.
        • If the task throws any exception other than BmDeadlockDetectedException it is re-thrown.
        Parameters:
        task - The task. May not be null.
        lightweight - the flag indicating whether the transaction should be lightweight or not.
        Returns:
        the result returned by IBmTask.execute(IBmTransaction, IProgressMonitor) method.
      • getAllLocalContexts

        List<IBmLocalEditingContext> getAllLocalContexts()
        Gets all the active local contexts.
        Returns:
        a list of all the active contexts, never null.
      • isDisposed

        boolean isDisposed()
        Checks if the model is disposed.
        Returns:
        true if the model is disposed, false otherwise.
      • close

        void close()
        Closes the BM model.
      • beginBatchSession

        Object beginBatchSession()
        Begins batch session.
        Returns:
        the handle object of the batch session, never null.
      • beginBatchSession

        Object beginBatchSession​(Object handle)
        Begins batch mode.
        Parameters:
        The - externally provided handle object. Can be null. In case if the descendant of the IBatchSessionController is supplied as a handle - enables managed batch mode.
        Returns:
        the batch mode handle object, never null.
      • endBatchSession

        void endBatchSession​(Object handle)
        Ends the batch session associated with the specified handle.
        Parameters:
        handle - The batch session handle. May not be null.
        See Also:
        #beginBatchMode()
      • executeInBatchSession

        <T> T executeInBatchSession​(Object handle,
                                    IBmTask<T> task)
        Executes the given task within the batch session associated with the specified handle.
        • If the task execution causes the transaction deadlock (throw BmDeadlockDetectedException), the transaction is rolled back, and the task executed again.
        • If after certain amount of retries the task still fails to execute without deadlock, an exception is thrown.
        • If the task throws any exception other than BmDeadlockDetectedException it is re-thrown.
        Parameters:
        handle - The batch session handle. May not be null.
        task - The task. May not be null.
        Returns:
        the result returned by IBmTask.execute(IBmTransaction, IProgressMonitor) method.
      • registerProvider

        @Deprecated
        void registerProvider​(IBmProvider provider)
        Deprecated.
        The method has been added to support existing legacy solutions only.
        Registers the specified provider.
        Parameters:
        provider - The provider to register. May not be null.
      • getProvider

        @Deprecated
        IBmProvider getProvider​(String providerId)
        Deprecated.
        The method has been added to support existing legacy solutions only.
        Gets provider by ID.
        Parameters:
        providerId - The ID to get provider by. May not be null.
        Returns:
        the provider or null if the there is no provider with the specified ID.