The final restructured version for automatic build using maven tycho

[Mograsim.git] / plugins / net.mograsim.machine / src / net / mograsim / machine / Memory.java

diff --git a/plugins/net.mograsim.machine/src/net/mograsim/machine/Memory.java b/plugins/net.mograsim.machine/src/net/mograsim/machine/Memory.java
new file mode 100644 (file)
index 0000000..0ff9bb4
--- /dev/null
+++ b/plugins/net.mograsim.machine/src/net/mograsim/machine/Memory.java
@@ -0,0 +1,36 @@
+package net.mograsim.machine;
+
+public interface Memory<T>
+{
+       /**
+        * @param address The address of the desired data. Must be non-negative
+        * @return The data at the requested address
+        * 
+        * @throws IndexOutOfBoundsException
+        */
+       public T getCell(long address);
+
+       /**
+        * Sets the data at the supplied address
+        * 
+        * @throws IndexOutOfBoundsException
+        */
+       public void setCell(long address, T data);
+
+       public default long size()
+       {
+               MemoryDefinition def = getDefinition();
+               return Long.max(0, def.getMaximalAddress() - def.getMinimalAddress() + 1);
+       }
+
+       /**
+        * Registers an observer to be notified when a memory cell is modified
+        */
+       public void registerObserver(MemoryObserver ob);
+
+       public void deregisterObserver(MemoryObserver ob);
+
+       public void notifyObservers(long address);
+
+       public MemoryDefinition getDefinition();
+}