Package org.faceless.publisher.web
Interface Store
- All Known Implementing Classes:
FileStore
public interface Store
An interface representing an abstract store, eg a FileSystem, which is used to store and retrieve files
-
Field Summary
Fields -
Method Summary
Modifier and TypeMethodDescriptionvoid
clear()
Clear the store of all datavoid
configure
(Json json) default void
copyStream
(InputStream in, OutputStream out) boolean
del
(String path, Authorization auth) Delete from the store.get
(String path, Json props, Authorization auth) Retrieve a file from the store.default String
Return a random folder name that doesn't existput
(String path, Json props, Authorization auth) Save a file to the store.void
setServiceEngine
(ServiceEngine engine) Set the ServiceEngine on this store.void
shutdown()
Prepare the Store for the ServiceEngine being shutdown
-
Field Details
-
PENDING
-
-
Method Details
-
setServiceEngine
Set the ServiceEngine on this store. Called immediately after the constructor -
configure
void configure(Json json) -
put
Save a file to the store. Return an OutputStream to write to. Props may contain: - content_type - expiry - if not null, the number of ms after the last access to delete the file. - panding - if false, the file is flushed on each write and any get should return an InputStream for what we have. Otherwise the returned stream is opened on the first write, and until that any "get" call returns PENDING. Props is live, and can be modified up until the point the returned OutputStream is closed. Any modifications to props before closing will be reflected in any subsequent "get" operations for object, and will be written to the store when the stream is finally closed. Props should be updated synchronized. Props should be set with "ok" to boolean indicating ok or not before error- Parameters:
folder
- the folder (required)path
- the path (required)- Returns:
- an OutputStream which is opened on the first write.
- Throws:
IOException
- if the path already exists
-
get
Retrieve a file from the store. Return an InputStream to read from, or null if it doesn't exist. Props may contain anything: and will be updated (ie set or the fields removed) with - name - the name of the path - ok - whether completion was ok - content_type - last_modified - length If no files in that folder can be read, an IOException("Unauthorized") will be thrown. It's a list containing items with at least name, and possibly contentType and length.- Parameters:
folder
- the folder (required)path
- the path (may be null);- Throws:
IOException
-
del
Delete from the store. Props may contain anything The path may be null, if it is any files in that folder will be deleted with permission. If an OutputStreaam is currently open for that writer, any further writes to it will fail. If any files cannot be deleted, an IOException("Unauthorized") will be thrown.- Parameters:
folder
- the folder (required)path
- the path (may be null)- Returns:
- true if a file was deleted, false otherwise
- Throws:
IOException
- if something went wrong
-
clear
void clear()Clear the store of all data -
shutdown
void shutdown()Prepare the Store for the ServiceEngine being shutdown -
newFolderName
Return a random folder name that doesn't exist -
copyStream
- Throws:
IOException
-