Skip to content

O
officejs
Commit 13c21f67 authored by Siddhant Sanyam's avatar Siddhant Sanyam
Browse files
Options

Added functions loadDocument and saveDocument for DAVStorage

parent 12b70f12
Hide whitespace changes
Inline Side-by-side
Showing with 201 additions and 83 deletions
UNGProject/js/jio.js
View file @ 13c21f67
/* /*
JIO: Javascript I/O. A library to load, edit, save documents to JIO: Javascript I/O. A library to load, edit, save documents to
multiple storage backends using a common interface multiple storage backends using a common interface
*/ */
/* /*
JIO Namespace. Everything related to JIO happens over here JIO Namespace. Everything related to JIO happens over here
*/ */
var JIO = (function () { var JIO = (function () {
/* Function returns us a JIOStorage, a basic stensil for other kind of storage*/
var JIOStorage = function (store_info){ /* Function returns us a JIOStorage, a basic stensil for other kind of storage*/
var J = {}; // dummy object. We will augment it and return it var JIOStorage = function (store_info) {
J = { var J = {}; // dummy object. We will augment it and return it
"initialize": function(server,path,username,password){ J = {
/* "initialize": function(server,path,username,password) {
Basic initilization or pre-rituals /*
*/ Basic initilization or pre-rituals
}, */
"loadDocument": function (doc_id, handler ) { },
/* "loadDocument": function (doc_id, handler ) {
Calls handler with an object associated with requested document of the `doc_id` /*
.hash of the object is the MD5 hash of the data Calls handler with an object associated with requested document of the `doc_id`
.data of the object is the data itself The first argument of handler is error object or null depending on if error occured or not.(Like NodeJS)
Second argmuent is the object literal containing
*/ .hash of the object is the MD5 hash of the data
}, .data of the object is the data itself
Signature of Handler:
handler = function (err, dataobject) {
if(err===null) {
console.log(dataobject.hash);
console.log(dataobject.data);
}
else{
console.log(err.status);
}
};
*/
},
"saveDocument": function (doc_id, data, hash, overwrite, async) { "saveDocument": function (doc_id, data, handler, hash, conflict_func, overwrite) {
/* /*
Saves the document with a particular `docid` Saves the document with a particular `doc_id`
If `docid` is `0` then the function assigns a docid automatically `hash` is used to check if the document was last changed by someone else,
`hash` is used to check if the document was last changed by someone else, If it was, it will call the conflict_func with all other parameters passed.
If it was, it will raise a JIOContentChanged exception If `hash` is not supplied, no validation would be performed and conflit_func won't be called and document would be saved directly.
If `hash` is not supplied, the document will be overwritten. Setting `overwrite` to false, will prevent overwriting the document in anycase if a document with doc_id already exists
If `overwrite` is true the content will be overwritten without any exception `handler` workes sames way as in loadDocument
*/ */
}, },
"getDocumentList": function (storage_id, query, order_by, metadata) {
/*
Storage implementation should provide this function which will
return the list of documents which are stored on the storage
beased on `query`.
TODO Define how `query` is specified
`ordered_by` how the results should be sorted
*/
},
"hashdata": function(data) {
if(typeof hex_sha1 !== 'function') {
//this means that the hashing library is not load it. Load it now
$.ajax({
async:false,
type: "GET",
url: "js/sha1-min.js",
dataType: "script"
});
}
//now we can use hex_sha1(hopefully)
return hex_sha1(data);
}
};
return J;
}; //JIOStorage
"getDocumentList": function (storage_id, query, order_by, metadata) { /* DAVStorage : Does JIO on a WebDAV server*/
/* var DAVStorage = function (store_info) {
Storage implementation should provide this function which will if(!store_info.server)
return the list of documents which are stored on the storage throw Error("No server specified for DAVStorage");
beased on `query`. store_info.path = store_info.path || '';
TODO Define how `query` is specified var auth=false;
`ordered_by` how the results should be sorted if(store_info.user) {
*/ if(store_info.pass===undefined)
} throw Error("No password specified of user for DAVStorage");
}; auth=true;
return J; }
}; //JIOStorage
//server,path should all be in correct format http://foo.com/ some/dir/
/* DAVStorage : Does JIO on a WebDAV server*/ var complete_path = store_info.server + store_info.path;
var DAVStorage = function (store_info){ var add_auth_headers = function (ajaxsetting) {
if(!store_info.serverSore) ajaxsetting.headers={'Authorization':"Basic "+btoa(store_info.user+":"+store_info.pass)};
throw Error("No server specified for DAVStorage"); ajaxsetting.fields={'withCredentials': "true"};
store_info.path = store_info.path || ''; return ajaxsetting;
var auth=false; };
if(store_info.user){
if(!store_info.pass) var J = JIOStorage(store_info); // we will return this object at the end
throw Error("No password specified of user for DAVStorage");
auth=true; J.loadDocument = function (doc_id,handler) {
} var ajaxsetting={
'url': complete_path+doc_id,
var J = JIOStorage(store_info); // we will return this object at the end 'type':'GET',
'cache':false,
J.loadDocument = function (doc_id,handler) { 'success': function (fetched_data, textStatus, jqXHR) {
ajaxsetting={ var hashed_data=J.hashdata(fetched_data);
/* server,path should all be in correct format http://foo.com/ some/dir/*/ handler(null,{'hash':hashed_data,'data':fetched_data});
url:store_info.server + store_info.path + doc_id; },
}; 'error': function(jqXHR, textStatus, errorThrown) {
}; console.log("Error while doing ajax request for loadDocument. Return code:"+jqXHR.status+"["+errorThrown+"]");
handler(jqXHR);
}
}; };
})(); if (auth) {
ajaxsetting = add_auth_headers(ajaxsetting);
}
$.ajax(ajaxsetting);
};
J.saveDocument = function(doc_id, data, handler, hash, conflict_func, overwrite){
var document_url=complete_path+doc_id;
var ajaxsetting={
'url':document_url,
'cache':false,
'type':'PUT',
'data':data,
'success' : function (fetched_data, textStatus, jqXHR) {
var hashed_data= J.hashdata(data);
handler(null,{'hash':hashed_data,'data':data});
},
'error' : function(jqXHR, textStatus, errorThrown) {
console.log("Error while doing ajax request for loadDocument. Return code:"+jqXHR.status+"["+errorThrown+"]");
handler(jqXHR);
}
};
if (auth) {
ajaxsetting = add_auth_headers(ajaxsetting);
}
//The logic:
if(hash){
//hash is provided, we will now have to get the document first.
J.loadDocument(doc_id, function(err, dataobject){
if(err!==null){
//error occured, check if it is 404
if(err.status===404){
//the document doesn't exist, just do the save
$.ajax(ajaxsetting);
}
else{
//some other strange error,just call the user's error handler
handler(err);
}
}
else{
//we got back a document, check for hash
if(dataobject.hash===hash){
//hash matched, now check for overwrite value
if(overwrite!==false){
$.ajax(ajaxsetting);
}
JIOStorage = }
} else{
//hash didn't match, raise conflict_func
conflict_func(doc_id,data,handler,hash,overwrite);
}
}
});
}
else{
//user didn't provide hash.
if(overwrite!==false){
//user doesn't care if document get's overwriten,
//save the document
$.ajax(ajaxsetting);
}
else{
//user doesn't wants to overwrite the document, now check if the document exists
J.loadDocument(doc_id,function(err,dataobject){
if(err!==null) {
//error occured while trying to fetch the doc, check if error was 404
if(err.status===404) {
//document doesn't exist, just do the save
$.ajax(ajaxsetting);
}
//now if any other error occurs, we don't care. (this is bad habbit)
}
});
}
}
};
J.getDocumentList = function(){};
//All methods are defined, now return J as the newly cooked object
return J;
};//DAVStorage
//defined all classes, now return the interface of JIO which has all these classes
return {
'JIOStorage':JIOStorage,
'DAVStorage':DAVStorage
};
})();
var JIODAVStorage=Object.create(JIOStorage);
JIODAVStorage.initialize = function (server,path,user,pass){
this.server=server;
this.path=path || '/';
if(user)
{
this.user=user;
this.pass=pass;
}
JIODAVStorage.loadDocument = function(doc_name){
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7