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>

Continued with file-based stacks:
- added flushFileHeader()
- still there will be a lot stub messages

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

Re-added them again ...

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

Moved to correct method.

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

Added missing methods from Streamable interface.

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

Opps, had 2 Streamable interfaces ...

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

Continued with file i/o:
- added saveStreamToFile() to IoHandler
- added saveFile() as unsupported method to FileIoHandler

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

Maybe more classes needs to have these methods (with thrown exception) as they
may implement any sub interface of Streamable. Please report any you can find.

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

Continued with file-based stacks and file i/o:
- added new interfaces (with some methods)
- added those methods to BaseFileIo so all implementations can have it. Still I
  need to find out if really all can e.g. seek.
- Used those new interfaces accordingly

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

Added new interfaces for file i/o classes.

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

Continued on file-based stack:
- renamed path file_stack -> file
- added (stubs) seek() and size()
- some improvements on format "documentation"

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

Added some class fields/attributes.

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

Fixed assertion.

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

Fixed type-hint (still no interface).

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

Mode must be 'a+b' (append, binary-safe).

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

Revert "Use realpath() to secure file and path names."

This reverts commit be3ab368cc0fc436205faf22c910c96a5937bf5e.

Use realpath() to secure file and path names.

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

Continued:
- added new (and missing) exception FileIsEmptyException
- renamed 'io' -> 'file_directory'.

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

Renamed initStack() -> initFileStack() in BaseFileStack + added initStack()
from BaseStacker to overwrite it.

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

Continued with file-based stacks:
- BaseFileStack now extends BaseStacker and overwrites some methods to have own implementations
- renamed 'io' to 'file_directory'

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

Fixed, opps.

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

Continued with loader and file i/o stuff:
- renamed interface to SeekableWritableFileIterator as this interface allows
  write operations (such calls are forwarded to the wrapped
  file_raw_input_output_pointer_class instance).
- Removed .svn from excepted paths as this won't be the case.

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

Fixed calling ObjectFactory::createObjectByConfiguredName() as 2nd parameter must be an array.

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

Check if path can be loadded before attempting it.

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

Added scanApplicationClasses().

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

Continued:
- added FileIoIterator class and rewrote BaseFileStack to use it.
- added BaseIterator class from 'hub' project.
- added SeekableFileIterator which extends SPLs SeekableIterator.
- assertion added for above interface to make sure that 'file_io_iterator'
  is a valid instance.

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

Initialize the file-based stack with initStack() where e.g. the file i/o
pointer instance can be set.

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

Added fileName parameter.

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

Don't call the class' factory method directly, use ObjectFactory and
createObjectByConfiguredName() instead. This makes reimplementing classes much
easier.

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

Introduced scanFrameworkClasses().

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

Reverted some last changes + added FrameworkFileInputOutputPointer which allows reading and writing.

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

Rewrote both file i/o classes to have a common BaseFileIo class.

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

Added explanation and improved format (idea).

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

Continued with file-based stacks:
- added first draft of file-based stacks (hash sums are missing)
- added initial base class and stub for file-based stacks
- ignored chash.pos (file created by chash.php)
- ignored any backup files (*.*~)

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