Package cz.fidentis.analyst.data.face.impl

Class HumanFaceMemoryManagerImpl

java.lang.Object
cz.fidentis.analyst.data.face.impl.HumanFaceMemoryManagerImpl
All Implemented Interfaces:
HumanFaceMemoryManager
public class HumanFaceMemoryManagerImpl extends Object implements HumanFaceMemoryManager
A flyweight factory that creates and caches human faces. Faces are stored in the memory until there is enough space in the Java heap. Then they are cached on disk automatically. The dumping strategy can be switched at run-time.

Currently, listeners registered to HumanFace are neither dumped nor recovered!

  • Constructor Details

    • HumanFaceMemoryManagerImpl

      public HumanFaceMemoryManagerImpl()
      Constructor.

  • Method Details

    • setStrategy

      public void setStrategy(HumanFaceMemoryManager.Strategy strategy)
      Description copied from interface: HumanFaceMemoryManager
      Changes the dumping strategy
      Specified by:
      setStrategy in interface HumanFaceMemoryManager
      Parameters:
      strategy - Dumping strategy. Must not be null

    • getStrategy

      public HumanFaceMemoryManager.Strategy getStrategy()
      Description copied from interface: HumanFaceMemoryManager
      Returns current dumping strategy.
      Specified by:
      getStrategy in interface HumanFaceMemoryManager
      Returns:
      current dumping strategy

    • loadFace

      public Long loadFace(Long id, File file)
      Description copied from interface: HumanFaceMemoryManager
      Loads new face. If the face is already loaded, then the ID of existing instance is returned. To access the human face instance, use
      invalid reference 
      #getFace(String)
      .
      Specified by:
      loadFace in interface HumanFaceMemoryManager
      Parameters:
      file - OBJ file with human face.
      Returns:
      ID of the human face or null

    • isLoaded

      public boolean isLoaded(Long faceId)
      Description copied from interface: HumanFaceMemoryManager
      Checks whether the given face is loaded in the factory
      Specified by:
      isLoaded in interface HumanFaceMemoryManager
      Parameters:
      faceId - OBJ file with human face.
      Returns:
      true if the face exists in the factory, false otherwise.

    • addFace

      public Long addFace(HumanFace face)
      Description copied from interface: HumanFaceMemoryManager
      Directly adds an existing face instance into the factory. If a face with the same ID already exists, then it is replaced.
      Specified by:
      addFace in interface HumanFaceMemoryManager
      Parameters:
      face - Human face
      Returns:
      ID of the human face or null

    • getFace

      public HumanFace getFace(Long faceId)
      Description copied from interface: HumanFaceMemoryManager
      Returns a human face. Recovers the face from the disk if necessary.
      Specified by:
      getFace in interface HumanFaceMemoryManager
      Parameters:
      faceId - ID of the face
      Returns:
      Human face or null

    • removeFace

      public boolean removeFace(Long faceId)
      Description copied from interface: HumanFaceMemoryManager
      Removes the face from either memory or swap space. To re-initiate the face, use HumanFaceMemoryManager.loadFace(Long, java.io.File) again.
      Specified by:
      removeFace in interface HumanFaceMemoryManager
      Parameters:
      faceId - Face ID
      Returns:
      true if the face existed and was removed.

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • updateAccessTime

      protected boolean updateAccessTime(Long faceId)
      Updates last access time of the face allocated in the memory. Returns false if the face is not in the memory.
      Parameters:
      faceId - Face to be updated
      Returns:
      false if the face is not in the memory.

    • checkMemAndDump

      protected int checkMemAndDump() throws IOException
      Checks and releases the heap, if necessary.
      Returns:
      true if some existing face has been dumped to free the memory.
      Throws:
      IOException - on I/O error

    • formatSize

      protected static String formatSize(long v)

    • presumableFreeMemory

      protected long presumableFreeMemory()
      https://stackoverflow.com/questions/12807797/java-get-available-memory
      Returns:

    • dumpToFile

      protected File dumpToFile(HumanFace face) throws IOException
      Throws:
      IOException

    • restoreFromFile

      protected static HumanFace restoreFromFile(File dumpFile) throws IOException
      Throws:
      IOException

    • clearFaces

      public void clearFaces()
      Description copied from interface: HumanFaceMemoryManager
      Removes all faces from memory and swap space
      Specified by:
      clearFaces in interface HumanFaceMemoryManager