Continued with file abstraction:
- added markCurrentBlockAsEmpty()
- added index names for 'gaps' array
- fixed typo in method name

Signed-off-by: Roland Häder <roland@mxchange.org>

Rewrote next() to avoid loading whole empty file.

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued:
- CalculatableBlock is the better interface as it narrows possible
  implemenations
- Moved a lot stuff from BaseFrameworkSystem to BaseFile as this is the right
  place (encapsulated place, not generic place).

Signed-off-by: Roland Häder <roland@mxchange.org>

Fixed

Signed-off-by: Roland Häder <haeder@hmmdeutschland.de>

Continued:
- removed getBlockSeparator()
- added calculation of minimum length of an index entry

Signed-off-by: Roland Häder <roland@mxchange.org>

This call leads nowhere, so better call own method.

Signed-off-by: Roland Häder <roland@mxchange.org>

Call these methods from the iterator.

Signed-off-by: Roland Häder <roland@mxchange.org>

Again interface satisfaction ... ;-)

Signed-off-by: Roland Häder <roland@mxchange.org>

Fixed parser error.

Signed-off-by: Roland Häder <roland@mxchange.org>

Added missing methods which wraps the block instances for callbacks.

Signed-off-by: Roland Häder <roland@mxchange.org>

Satisfied interface, still these methods are unsupported.

Signed-off-by: Roland Häder <roland@mxchange.org>

Renamed more and moved code to Block interface.

Signed-off-by: Roland Häder <roland@mxchange.org>

Satified interface.

Signed-off-by: Roland Häder <roland@mxchange.org>

Moved more code to BaseFile as it makes sense to have it there.

Signed-off-by: Roland Häder <roland@mxchange.org>

Satisfied Pointer again.

Signed-off-by: Roland Häder <roland@mxchange.org>

Added more methods (required).

Signed-off-by: Roland Häder <roland@mxchange.org>

Endless loop fixed.

Signed-off-by: Roland Häder <roland@mxchange.org>

Moved even more code to BaseFile where a much better place is for it (clear encapsulated).

Signed-off-by: Roland Häder <roland@mxchange.org>

Uh, need this method now, but does it work this way?

Signed-off-by: Roland Häder <roland@mxchange.org>

No iterator call here + added assertion.

Signed-off-by: Roland Häder <roland@mxchange.org>

Also satisfied it here.

Signed-off-by: Roland Häder <roland@mxchange.org>

Satisfied Pointer interface for this class.

Signed-off-by: Roland Häder <roland@mxchange.org>

Moved analyzeFile() to BaseFile where a much better place is (and duplicate
code is avoided, too).

Signed-off-by: Roland Häder <roland@mxchange.org>

If the EOF is reached (means no block found or really reached the last block),
the whole loaded data needs to be set as currently loaded block. Only
setCurrentBlock() needs to be called then. :-)

Signed-off-by: Roland Häder <roland@mxchange.org>

Added assert() + noisy debug line + fixed double-implementation of an interface.

Signed-off-by: Roland Häder <roland@mxchange.org>

EOF needs to be checked again.

Signed-off-by: Roland Häder <roland@mxchange.org>

Syntax error fixed.

Signed-off-by: Roland Häder <roland@mxchange.org>

Also satify these classes.

Signed-off-by: Roland Häder <roland@mxchange.org>

Introduced isEndOfFileReached() + added a noisy debug line.

Signed-off-by: Roland Häder <roland@mxchange.org>

Moved some code to BaseFrameworkSystem, and yes: getBlockSeparator() looks stupid. ;-)

Signed-off-by: Roland Häder <roland@mxchange.org>

Possible implementation for next().

Signed-off-by: Roland Häder <roland@mxchange.org>

Introduced CalculatableBlock + basic implementation for valid().

Signed-off-by: Roland Häder <roland@mxchange.org>

Satisfied Pointer interface, but it will throw an exception ... ;-)

Signed-off-by: Roland Häder <roland@mxchange.org>

Introduced interface Pointer, valid() is now used.

Signed-off-by: Roland Häder <roland@mxchange.org>

Added simple loop for checking entries. This will change in the future which is
the reason for putting same code in 2 classes.

Signed-off-by: Roland Häder <roland@mxchange.org>

This factory method requires a 2nd parameter, 'wb' should be okay.

Signed-off-by: Roland Häder <haeder@hmmdeutschland.de>

Removed declarations + final.

Signed-off-by: Roland Häder <roland@mxchange.org>

Moved all to BaseFile. This currently makes all inheriting classes "lifeless"
but this will change in the future.

Signed-off-by: Roland Häder <roland@mxchange.org>

InputOutputPointer is the right interface.

Signed-off-by: Roland Häder <roland@mxchange.org>

Switched from unabstracted file pointer class to a better abstract approach (unfinished).

Signed-off-by: Roland Häder <roland@mxchange.org>

Added abstraction classes for file-based stacks and index files, some setter
have now access level 'protected' as 'public' was not a such good idea.

Signed-off-by: Roland Häder <roland@mxchange.org>

Commented out debug lines, another branch may help? But how then when this
repository is referenced as GIT module?

Signed-off-by: Roland Häder <roland@mxchange.org>

Introduced rewineUpdateSeekPosition() which needs to be called after
pre-allocation is done, else the seek position (pointer) shows to the end of
the file which is what you don't want.

Signed-off-by: Roland Häder <roland@mxchange.org>

Only seek back to old position if the header has been flushed.

Signed-off-by: Roland Häder <roland@mxchange.org>

If you don't rewind + update + flush header, the current seek position shows to
the end of the file. This is not what you want with empty files as the seek
position must show to zero (only "virgin" files).

Signed-off-by: Roland Häder <roland@mxchange.org>

Also include stack name in type. This will allow more index files than one ...

Signed-off-by: Roland Häder <roland@mxchange.org>

Opps. ;-(

Signed-off-by: Roland Häder <roland@mxchange.org>

Introduced seekToOldPosition() and avoided endless loop.

Signed-off-by: Roland Häder <roland@mxchange.org>

Renamed method + flushFileHeader() must be callable and have protected access level.

Signed-off-by: Roland Häder <roland@mxchange.org>

Introduced: caluclateMinimumFileEntryLength() which calculates the minimum length for one file entry.

Signed-off-by: Roland Häder <roland@mxchange.org>

Added missing config entries.

Signed-off-by: Roland Häder <roland@mxchange.org>

Opps, needs to append index' file extension.

Signed-off-by: Roland Häder <roland@mxchange.org>

Had to rename more stuff.

Signed-off-by: Roland Häder <roland@mxchange.org>

Use print_r() instead of direct value.

Signed-off-by: Roland Häder <roland@mxchange.org>

readFileHeader() needs to have protected access level + assert on it.

Signed-off-by: Roland Häder <roland@mxchange.org>

And another one needs to be removed.

Signed-off-by: Roland Häder <roland@mxchange.org>

Removed duplicate methods.

Signed-off-by: Roland Häder <roland@mxchange.org>

Renamed one getSeekPosition() to determineSeekPosition().

Signed-off-by: Roland Häder <roland@mxchange.org>

Remove duplicate super constructor.

Signed-off-by: Roland Häder <roland@mxchange.org>

Could generalize ("generic") more code which avoid some duplicate fields and methods in BaseIndex.

Signed-off-by: Roland Häder <roland@mxchange.org>

Added missing index instance with getter/setter.

Signed-off-by: Roland Häder <roland@mxchange.org>

Added required interface, a special factories uses the Registry Pattern.

Signed-off-by: Roland Häder <roland@mxchange.org>

:-( :-(

Signed-off-by: Roland Häder <roland@mxchange.org>

:-(

Signed-off-by: Roland Häder <roland@mxchange.org>

Moved 'file_stack_' after $type to have a nice name.

Signed-off-by: Roland Häder <roland@mxchange.org>

Added missing setter.

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued with indexes/stacks:
- The FileStackIndexFactory now uses the Registry Pattern to have one index
  instance per given type.
- Passed through $prefix as "type"

Signed-off-by: Roland Häder <roland@mxchange.org>

Added initIndex().

Signed-off-by: Roland Häder <roland@mxchange.org>

Added basic classes (and unimplemented) for file-based indexes.

Signed-off-by: Roland Häder <roland@mxchange.org>

Some 'final' more, some 'final' less. ;-)

Signed-off-by: Roland Häder <roland@mxchange.org>

Methods isStackFull() and isStackEmpty() needs to be overwritten, too.

Signed-off-by: Roland Häder <roland@mxchange.org>

This method can be supported:
- isStackEmpty() can use getStackCount() and compare it with zero.

Signed-off-by: Roland Häder <roland@mxchange.org>

These methods may never be supported as initialization of file-based stacks does
currently not work.

Signed-off-by: Roland Häder <roland@mxchange.org>

Added Registerable interface as the FileStackFactory is using it.

Signed-off-by: Roland Häder <roland@mxchange.org>

Added Registerable interface as the FileStackFactory is using it.

Signed-off-by: Roland Häder <roland@mxchange.org>

Introduced validateFilePointer().

Signed-off-by: Roland Häder <roland@mxchange.org>

Always read file header.

Signed-off-by: Roland Häder <roland@mxchange.org>

It is readFileHeader().

Signed-off-by: Roland Häder <roland@mxchange.org>

More commented out.

Signed-off-by: Roland Häder <roland@mxchange.org>

Implemented rudely reading file header + commented out a lot noisy debug lines.

Signed-off-by: Roland Häder <roland@mxchange.org>

Fixed variable name ...

Signed-off-by: Roland Häder <roland@mxchange.org>

Fixed constant name.

Signed-off-by: Roland Häder <roland@mxchange.org>

Fixed parser error.

Signed-off-by: Roland Häder <roland@mxchange.org>

Added read().

Signed-off-by: Roland Häder <roland@mxchange.org>

Add stuff for reading header of a file-based stack.

Signed-off-by: Roland Häder <roland@mxchange.org>

Introduced writeData() (low-level method).

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued with hash-based stacks:
- added separator between count->seek position
- changed separators: chr(0) is for pre-allocation

Signed-off-by: Roland Häder <roland@mxchange.org>

Pre-allocate way more ...

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued with file-based stacks:
- used writeAtPosition() instead of seek()
- added debug line
- updated documentation

Signed-off-by: Roland Häder <roland@mxchange.org>

Fixed typo.

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued with file-based stacks:
- implemented pre-allocation of the file (untested)
- renamed hashString() in BaseFrameworkSystem to hash() and made it static
- added static "getter" getHashLength() (this method's return value is "cached")

Signed-off-by: Roland Häder <roland@mxchange.org>

Added debug lines.

Signed-off-by: Roland Häder <roland@mxchange.org>

Removed asserts as they seem to be to hard and returned status code instead.

Signed-off-by: Roland Häder <roland@mxchange.org>

Much easier (but not reliable) test.

Signed-off-by: Roland Häder <roland@mxchange.org>

The 'c' mode will do the following:
- open file for writing (with + also for reading aka "random access mode")
- if file does not exist, create it
- if file exists, don't truncate (unlike 'w' does) and don't fail (unlike 'x'
  does).
- set seek position to beginning of file
- 'b' is for binary data

Signed-off-by: Roland Häder <roland@mxchange.org>

Renamed getPosition() -> getSeekPosition().

Signed-off-by: Roland Häder <roland@mxchange.org>

Typo fixed. ;-(

Signed-off-by: Roland Häder <roland@mxchange.org>

Opps, don't use instance here, file pointer is okay. ;-)

Signed-off-by: Roland Häder <roland@mxchange.org>

Fixed parser error.

Signed-off-by: Roland Häder <roland@mxchange.org>

Continued with file-based hash:
- added a lot stuff, such as getter/setter, seek(), rewind()
- moved class fields totalEntries and seekPosition to BaseFileStack

Signed-off-by: Roland Häder <roland@mxchange.org>