Package ghidra.program.database

Class DatabaseObject

  • Direct Known Subclasses:
    BookmarkDB, EquateDB, FunctionDB, FunctionTagDB, InstructionDB, SourceArchiveDB, SymbolDB
    public abstract class DatabaseObject
extends java.lang.Object
    Base class for an cached object in the database. Database objects have keys. They are marked as invalid when a database cache is cleared and can be revived on a refresh as long as they haven't been deleted. Instantiating an object will cause it to be added immediately to the associated cache.

    • Field Summary

      Fields 
      ChangeModifier and Type Field Description
      NEWprotected long key  

    • Constructor Summary

      Constructors 
      ChangeConstructor Description
      DatabaseObject​(DBObjectCache cache, long key)
      Constructs a new DatabaseObject and adds it to the specified cache.

    • Method Summary

      All Methods Instance Methods Abstract Methods Concrete Methods 
      ChangeModifier and Type Method Description
      void checkDeleted()
      Checks if this object has been deleted, in which case any use of the object is not allowed.
      boolean checkIsValid()
      Check whether this object is still valid.
      boolean checkIsValid​(Record record)
      Check whether this object is still valid.
      long getKey()
      Get the database key for this object.
      boolean isDeleted()
      Returns true if this object has been deleted.
      boolean isInvalid()
      Returns true if object is currently invalid.
      NEWprotected void keyChanged​(long newKey)  
      NEWprotected abstract boolean refresh()
      Tells the object to refresh its state from the database.
      NEWprotected boolean refresh​(Record record)
      Tells the object to refresh its state from the database using the specified record if not null.
      void setInvalid()
      Invalidate this object.
      void validate​(Lock lock)
      This method provides a cheap (lock free) way to test if an object is valid.

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Field Detail

      • key NEW

        protected long key

Constructor Detail

  • Method Detail

    • getKey

      public long getKey()
      Get the database key for this object.

    • isDeleted

      public boolean isDeleted()
      Returns true if this object has been deleted. Note: once an object has been deleted, it will never be "refreshed". For example, if an object is ever deleted and is resurrected via an "undo", you will have get a fresh instance of the object.
      Returns:
      true if this object has been deleted.

    • setInvalid

      public void setInvalid()
      Invalidate this object. This does not necessarily mean that this object can never be used again. If the object can refresh itself, it may still be useable.

    • keyChanged NEW

      protected void keyChanged​(long newKey)

    • isInvalid

      public boolean isInvalid()
      Returns true if object is currently invalid. Calling checkIsValid may successfully refresh object making it valid.
      See Also:
      checkIsValid()

    • checkDeleted

      public void checkDeleted()
      Checks if this object has been deleted, in which case any use of the object is not allowed.
      Throws:
      java.util.ConcurrentModificationException - if the object has been deleted from the database.

    • checkIsValid

      public boolean checkIsValid()
      Check whether this object is still valid. If the object is invalid, the object will attempt to refresh itself. If the refresh fails, the object will be marked as deleted.
      Returns:
      true if the object is valid.

    • checkIsValid

      public boolean checkIsValid​(Record record)
      Check whether this object is still valid. If the object is invalid, the object will attempt to refresh itself using the specified record. If the refresh fails, the object will be marked as deleted and removed from cache. If this object is already marked as deleted, the record can not be used to refresh the object.
      Parameters:
      record - optional record which may be used to refresh invalid object
      Returns:
      true if the object is valid.

    • validate

      public void validate​(Lock lock)
      This method provides a cheap (lock free) way to test if an object is valid. If this object is invalid, then the lock will be used to refresh as needed.
      Parameters:
      lock - the lock that will be used if the object needs to be refreshed.

    • refresh NEW

      protected abstract boolean refresh()
      Tells the object to refresh its state from the database.
      Returns:
      true if the object was able to refresh itself. Return false if the object was deleted. Objects that extend this class must implement a refresh method. If an object can never refresh itself, then it should always return false.

    • refresh NEW

      protected boolean refresh​(Record record)
      Tells the object to refresh its state from the database using the specified record if not null. NOTE: The default implementation ignores the record and invokes refresh(). Implementations of this method must take care if multiple database tables are used since the record supplied could correspond to another object. In some cases it may be best not to override this method or ignore the record provided.
      Parameters:
      record - valid record associated with object's key (optional, may be null to force record lookup or other refresh technique)
      Returns:
      true if the object was able to refresh itself. Return false if record is null and object was deleted. Objects that extend this class must implement a refresh method. If an object can never refresh itself, then it should always return false.