module:store/File

module:store/File

File resources are resources located in the Entrystore repository that have a graph type of none, e.g. none of the special cases for which there are special treatment in EntryStore.

Constructor

new (require("store/File"))()

Source:

Methods

get() → {Promise}

Source:
Returns:

which format the resource is returned in the promise (string, json or xml) depends on what is specified in the mimetype. Xml is only returned in a browser environment, if not in a browser a string is returned.

Type
Promise

getJSON() → {Promise.<Object>}

Source:
Returns:

ignores what is specified in the mimetype and returns the resource as a javascript object in the promise.

Type
Promise.<Object>

getText() → {Promise.<String>}

Source:
Returns:

ignores what is specified in the mimetype and returns the resource as a string in the promise.

Type
Promise.<String>

getXML() → {Promise}

Source:
Returns:

ignores what is specified in the mimetype and returns the resource in the promise as a XML Document or a string (depending on if you are in browser or not).

Type
Promise

put(data, format) → {Promise}

Source:

Pushes data to the server for this resource.

Parameters:
Name Type Default Description
data string

to be stored as a file.
format string application/json

the format of the data as a mimetype.
Returns:
Type
Promise

putFile(data, format) → {Promise}

Source:
To Do:
  • fix-if-modified-since

Pushes a file to the server for this resource. In a browser environment a file is represented via an input tag which references the file to be uploaded via its value attribute. E.g.:

  <input type="file" name="uploadFile"/>

During the uploading process the input tag will be moved temporarily in the DOM tree, it will be restored to its original position afterwards (both upon success and failure).

In a nodejs environments the file is leveraged as a stream, i.e.: res.putFile(fs.createReadStream('file.txt'));

Parameters:
Name Type Description
data node | fileHandle

input tag or file handle that corresponds to a file.
format string

indicates the mimetype of the data
Returns:
Type
Promise

putJSON(obj) → {Promise}

Source:

Pushes JSON content to the server for this resource.

Parameters:
Name Type Description
obj Object

to be stored as a json object, format will be set to application/json.
Returns:
Type
Promise

putText(text) → {Promise}

Source:

Pushes text content to the server for this resource.

Parameters:
Name Type Description
text string

to be stored as a file, format will be set to text/plain.
Returns:
Type
Promise

putXML(xml) → {Promise}

Source:
To Do:
  • not finished or tested

Pushes xml content to the server for this resource.

Parameters:
Name Type Description
xml string | Document

to be stored as a xml object, format will be set to application/json.
Returns:
Type
Promise