Merged old FileIO

1 files changed, 819 insertions, 0 deletions

diff --git a/js/io/system/coreioapi.js b/js/io/system/coreioapi.js
new file mode 100755
index 00000000..c920d8cd
--- /dev/null
+++ b/js/io/system/coreioapi.js
@@ -0,0 +1,819 @@
+/* <copyright>
+This file contains proprietary software owned by Motorola Mobility, Inc.<br/>
+No rights, expressed or implied, whatsoever to this software are provided by Motorola Mobility, Inc. hereunder.<br/>
+(c) Copyright 2011 Motorola Mobility, Inc.  All Rights Reserved.
+</copyright> */
+
+/* /////////////////////////////////////////////////////////////////////
+////////////////////////////////////////////////////////////////////////
+NOTES:
+These methods should only be access through the file and project IO classes.
+////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////// */
+var Montage =           require("montage/core/core").Montage,
+    Component =         require("montage/ui/component").Component;
+////////////////////////////////////////////////////////////////////////
+//Exporting as Project I/O
+exports.CoreIoApi = Montage.create(Component, {
+        ////////////////////////////////////////////////////////////////////
+    // private property containing the file service URL to use for all file IO calls
+    _fileServiceURL: {
+        enumerable: false,
+        value: "http://localhost:16380/file"
+    },
+        ////////////////////////////////////////////////////////////////////
+    // private property containing the directory service URL to use for all file IO calls
+    _directoryServiceURL: {
+        enumerable: false,
+        value: "http://localhost:16380/directory"
+    },
+        ////////////////////////////////////////////////////////////////////
+    // private helper to parse URIs and append them to the service URL
+    _prepareServiceURL: {
+        enumerable: false,
+        value: function(serviceURL, path) {
+            var urlOut = path.replace(/\\/g,"/");
+            urlOut = urlOut.replace(/:/g,"");
+            urlOut = encodeURI(urlOut);
+            //add leading / if not already there
+            if((urlOut.length > 0) && (urlOut.charAt(0) !== "/")){
+                urlOut = "/" + urlOut;
+            }
+            //remove extra / at the end
+            if((urlOut.length > 1) && (urlOut.charAt(urlOut.length - 1) === "/")){
+                urlOut = urlOut.substring(0, (urlOut.length - 1));
+            }
+
+            return serviceURL + urlOut;
+        }
+    },
+    ////////////////////////////////////////////////////////////////////
+    // Checks for the existence of a file
+    // Parameters:
+    //      the file parameter must contain the following properties
+    //          uri: string value containing the full file path/URI i.e. "c:/foo/bar.html"
+    //
+    // Return values:
+    //    returns an object with two properties
+    //      success: boolean indicating if the call succeeded or failed
+    //      status: int indicating the request HTTP status code
+    //              204 - the file exists
+    //              404 - the file does not exist
+    //              500 - unknown server error occurred
+    fileExists: {
+        enumerable: false,
+        value: function(file) {
+                //
+            var retValue = { success:null, status:null };
+            //
+            if(file && file.uri && file.uri.length) {
+                try {
+                    var serviceURL = this._prepareServiceURL(this._fileServiceURL, file.uri),
+                        xhr = new XMLHttpRequest();
+                    //  
+                    xhr.open("GET", serviceURL, false);
+                    xhr.setRequestHeader("check-existence-only", "true");
+                    xhr.send();
+                                        //
+                    if (xhr.readyState === 4) {
+                        retValue.status = xhr.status;
+                        retValue.success = true;
+                    }
+                }
+                catch(error) {
+                    xhr = null;
+                    retValue.success = false;
+                }
+            }
+                        //
+            return retValue;
+        }
+    },
+    ////////////////////////////////////////////////////////////////////
+    // Creates a new file at the specified path
+    // Parameters:
+    //      the file parameter must contain the following properties
+    //          uri: string value containing the full file path/URI i.e. "c:/foo/bar.html"
+    //      it can optionally contain the following properties
+    //          contentType: string with the content type  i.e. "text/plain". "text/plain" is assumed if this property is not specified
+    //          contents: string containing the file contents. These contents will be saved to the new file.
+    //
+    // Return values:
+    //    returns an object with two properties
+    //      success: boolean indicating if the call succeeded or failed
+    //      status: int indicating the request HTTP status code
+    //              201 - the file was created and contents were saved if they were passed
+    //              400 - the file already exists and could not be created
+    //              500 - unknown server error occurred
+    createFile: {
+        enumerable: false,
+        value: function(file) {
+            var retValue = { success:null, status:null };
+            if(file && file.uri && file.uri.length) {
+                try {
+                    var serviceURL = this._prepareServiceURL(this._fileServiceURL, file.uri),
+                        xhr = new XMLHttpRequest();
+                    //
+                    xhr.open("POST", serviceURL, false);
+                    if(file.contentType && file.contentType.length)
+                        xhr.setRequestHeader("Content-Type", file.contentType);
+                    else
+                        xhr.setRequestHeader("Content-Type", "text/plain");
+
+                    if(file.contents && file.contents.length)
+                        xhr.send(file.contents);
+                    else
+                        xhr.send();
+
+                    if (xhr.readyState === 4) {
+                        retValue.status = xhr.status;
+                        retValue.success = true;
+                    }
+                }
+                catch(error) {
+                    xhr = null;
+                    retValue.success = false;
+                }
+            }
+
+            return retValue;
+        }
+    },
+    ////////////////////////////////////////////////////////////////////
+    // Save contents into an existing file at the specified path
+    // Parameters:
+    //      the file parameter must contain the following properties
+    //          uri: string value containing the full file path/URI i.e. "c:/foo/bar.html"
+    //      it can optionally contain the following properties
+    //          contentType: string with the content type  i.e. "text/plain". "text/plain" is assumed if this property is not specified
+    //          contents: string containing the file contents. These contents will be saved to the new file.
+    //
+    // Return values:
+    //    returns an object with two properties
+    //      success: boolean indicating if the call succeeded or failed
+    //      status: int indicating the request HTTP status code
+    //              204 - the file was saved
+    //              404 - the file specified does not exist
+    //              500 - unknown server error occurred
+    updateFile: {
+        enumerable: false,
+        value: function(file) {
+            var retValue = { success:null, status:null };
+            if(file && file.uri && file.uri.length && file.contents && file.contents.length) {
+                try {
+                    var serviceURL = this._prepareServiceURL(this._fileServiceURL, file.uri),
+                        xhr = new XMLHttpRequest();
+                    //
+                    xhr.open("PUT", serviceURL, false);
+                    if(file.contentType && file.contentType.length)
+                        xhr.setRequestHeader("Content-Type", file.contentType);
+                    else
+                        xhr.setRequestHeader("Content-Type", "text/plain");
+
+                    xhr.send(file.contents);
+
+                    if (xhr.readyState === 4) {
+                        retValue.status = xhr.status;
+                        retValue.success = true;
+                    }
+                }
+                catch(error) {
+                    xhr = null;
+                    retValue.success = false;
+                }
+            }
+
+            return retValue;
+        }
+    },
+    ////////////////////////////////////////////////////////////////////
+    // Copies a file from one location to another
+    // Parameters:
+    //      the file parameter must contain the following properties
+    //          sourceUri: string value containing the full file path/URI to copy from i.e. "c:/foo/bar.html"
+    //          destUri: string containing the full path/URI to copy to
+    //      it can optionally contain the following properties
+    //          overwriteDestination: bool indicating whether it is okay to overwrite the file specified at destUri if it already exists
+    //
+    // Return values:
+    //    returns an object with two properties
+    //      success: boolean indicating if the call succeeded or failed
+    //      status: int indicating the request HTTP status code
+    //              204 - the file was copied
+    //              404 - the file specified in sourceUri does not exist
+    //              500 - unknown server error occurred
+    copyFile: {
+        enumerable: false,
+        value: function(file) {
+            var retValue = { success:null, status:null };
+            if(file && file.sourceUri && file.sourceUri.length && file.destUri && file.destUri.length) {
+                try {
+                    var serviceURL = this._prepareServiceURL(this._fileServiceURL, file.destUri),
+                        xhr = new XMLHttpRequest();
+                    //
+                    xhr.open("PUT", serviceURL, false);
+                    xhr.setRequestHeader("sourceURI", file.sourceUri);
+                                        //
+                    if(file.overwriteDestination && file.overwriteDestination === true) {
+                        xhr.setRequestHeader("overwrite-destination", "true");
+                    }
+                                        //
+                    xhr.send();
+                                        //
+                    if (xhr.readyState === 4) {
+                        retValue.status = xhr.status;
+                        retValue.success = true;
+                    }
+                }
+                catch(error) {
+                    xhr = null;