- XStorage::openStreamElement
-
This method returns StorageStream
service implementation.
If the child stream is an encrypted one a corect
common storage password should be set through
XEncryptionProtectedSource interface to
this storage or to a one of storages in parent
hierarchy. In case the password is not set or is a
wrong one an exception will be thrown.
- XStorage::openEncryptedStreamElement
-
This method allows to specify reading password for the
stream explicitly. The password will be used to read
the stream. It is possible to specify a new password
for stream storing through
XEncryptionProtectedSource interface. In
case a new password is not specified an old one will
be used for storing.
- XStorage::openStorageElement
-
This method returns Storage service
implementation.
- XStorage::cloneStreamElement
-
This method returns StorageStream service
implementation.
The latest flashed version of the stream will be used.
The stream can be flashed explicitly by
XOutputStream::flush
call.
A storage flashes on commit all the child streams it
owns. So in case after the stream is changed neither
the storage was commited nor the stream was flushed
explicitly, the changes will not appear in the new
created stream. This method allows to retrieve copy of
a child stream even in case it is already opened for
writing.
If the child stream is an encrypted one a corect
common storage password should be set through
XEncryptionProtectedSource interface to
this storage or to a one of storages in parent
hierarchy. In case the password is not set or is a
wrong one an exception will be thrown.
- XStorage::cloneEncryptedStreamElement
-
This method returns StorageStream service
implementation.
The latest flashed version of the stream will be used.
The stream can be flashed explicitly by
XOutputStream::flush
call.
A storage flashes on commit all the child streams it
owns. So in case after the stream is changed neither
the storage was commited nor the stream was flushed
explicitly, the changes will not appear in the new
created stream. This method allows to retrieve copy of
a child stream even in case it is already opened for
writing.
- XStorage::copyLastCommitTo
-
This method gets Storage service
implementation and fills it in with the latest
commited version of this storage. So in case the
storage was not commited after it was changed, the
changes will not appear in the new created storage.
- XStorage::copyStorageElementLastCommitTo
-
This method gets Storage service
implementation and fills it in with the contents of
the requested substorage. The latest commited version
of child storage will be used. So in case the child
storage was not commited after it was changed, the
changes will not appear in the new created storage.
This method allows to retrieve copy of a child storage
even in case it is already opened for writing.
- XStorage::removeStorageElement
-
If the element is opened the removing will fail.