[Filesystem] Add missing deprecation warnings since Tizen 5.0 80/186580/4
authorPawel Kaczmarczyk <p.kaczmarczy@samsung.com>
Fri, 10 Aug 2018 10:37:47 +0000 (12:37 +0200)
committerPawel Kaczmarczyk <p.kaczmarczy@samsung.com>
Fri, 17 Aug 2018 07:25:37 +0000 (09:25 +0200)
[Verification]
tct-filesystem-tizen-tests: 100%

Change-Id: I8f0c2b888d1965a3ca633e1f56d77d88c4505ab1
Signed-off-by: Pawel Kaczmarczyk <p.kaczmarczy@samsung.com>
src/filesystem/filesystem_instance.cc
src/filesystem/js/file.js
src/filesystem/js/file_stream.js
src/filesystem/js/file_system_manager.js

index 52f5948c32ac099b5cf9aafaab1e600613a8307a..7487ed28d1c0cd67c278641138beb74c4f72d393 100644 (file)
@@ -247,6 +247,10 @@ FilesystemInstance::~FilesystemInstance() {
 
 void FilesystemInstance::FileCreateSync(const picojson::value& args, picojson::object& out) {
   ScopeLogger();
+  LoggerW(
+      "DEPRECATION WARNING: File.createFile() is deprecated since Tizen 5.0. Use "
+      "FileSystemManager.openFile() instead.");
+
   CHECK_PRIVILEGE_ACCESS(kPrivilegeFilesystemWrite, &out);
   CHECK_EXIST(args, "location", out)
   const std::string& location = args.get("location").get<std::string>();
@@ -267,6 +271,10 @@ void FilesystemInstance::FileCreateSync(const picojson::value& args, picojson::o
 
 void FilesystemInstance::FileRename(const picojson::value& args, picojson::object& out) {
   ScopeLogger();
+  LoggerW(
+      "DEPRECATION WARNING: File.moveTo() is deprecated since Tizen 5.0. Use "
+      "FileSystemManager.moveFile() or FileSystemManager.moveDirectory() instead.");
+
   CHECK_PRIVILEGE_ACCESS(kPrivilegeFilesystemWrite, &out);
   CHECK_EXIST(args, "callbackId", out)
 
@@ -703,6 +711,10 @@ static std::vector<std::uint8_t> decode(const char* str, std::size_t len) {
 
 void FilesystemInstance::FileReadString(const picojson::value& args, picojson::object& out) {
   ScopeLogger();
+  LoggerW(
+      "DEPRECATION WARNING: This method is deprecated since Tizen 5.0.Use FileHandle.readString() "
+      "or FileHandle.readStringNonBlocking() instead.");
+
   CHECK_PRIVILEGE_ACCESS(kPrivilegeFilesystemRead, &out);
   CHECK_EXIST(args, "location", out)
   CHECK_EXIST(args, "offset", out)
@@ -733,6 +745,10 @@ void FilesystemInstance::FileReadString(const picojson::value& args, picojson::o
 
 void FilesystemInstance::FileReadBytes(const picojson::value& args, picojson::object& out) {
   ScopeLogger();
+  LoggerW(
+      "DEPRECATION WARNING: This method is deprecated since Tizen 5.0. Use FileHandle.readData() "
+      "or FileHandle.readDataNonBlocking() instead.");
+
   CHECK_PRIVILEGE_ACCESS(kPrivilegeFilesystemRead, &out);
   CHECK_EXIST(args, "location", out)
   CHECK_EXIST(args, "offset", out)
@@ -756,6 +772,10 @@ void FilesystemInstance::FileReadBytes(const picojson::value& args, picojson::ob
 
 void FilesystemInstance::FileWriteString(const picojson::value& args, picojson::object& out) {
   ScopeLogger();
+  LoggerW(
+      "DEPRECATION WARNING: FileStream.write() is deprecated since Tizen 5.0. Use "
+      "FileHandle.writeString() or FileHandle.writeStringNonBlocking() instead.");
+
   CHECK_PRIVILEGE_ACCESS(kPrivilegeFilesystemWrite, &out);
   CHECK_EXIST(args, "location", out)
   CHECK_EXIST(args, "data", out)
@@ -791,6 +811,10 @@ void FilesystemInstance::FileWriteString(const picojson::value& args, picojson::
 
 void FilesystemInstance::FileWriteBytes(const picojson::value& args, picojson::object& out) {
   ScopeLogger();
+  LoggerW(
+      "DEPRECATION WARNING: FileStream.writeBytes() is deprecated since Tizen 5.0. To read and Use "
+      "FileHandle.writeData() or FileHandle.writeDataNonBlocking() instead.");
+
   CHECK_PRIVILEGE_ACCESS(kPrivilegeFilesystemWrite, &out);
   CHECK_EXIST(args, "location", out)
   CHECK_EXIST(args, "data", out)
@@ -818,6 +842,11 @@ void FilesystemInstance::FileWriteBytes(const picojson::value& args, picojson::o
 
 void FilesystemInstance::FileWriteBase64(const picojson::value& args, picojson::object& out) {
   ScopeLogger();
+  LoggerW(
+      "DEPRECATION WARNING: FileStream.writeBase64() is deprecated since Tizen 5.0. Use "
+      "FileHandle.writeData() or FileHandle.writeDataNonBlocking() in combination with atob() and "
+      "btoa() functions instead.");
+
   CHECK_PRIVILEGE_ACCESS(kPrivilegeFilesystemWrite, &out);
   CHECK_EXIST(args, "location", out)
   CHECK_EXIST(args, "data", out)
@@ -1011,6 +1040,10 @@ void FilesystemInstance::FileSystemManagerMakeDirectory(const picojson::value& a
 void FilesystemInstance::FileSystemManagerMakeDirectorySync(const picojson::value& args,
                                                             picojson::object& out) {
   ScopeLogger();
+  LoggerW(
+      "DEPRECATION WARNING: File.createDirectory() is deprecated since Tizen 5.0. Use "
+      "FileSystemManager.createDirectory() instead.");
+
   CHECK_PRIVILEGE_ACCESS(kPrivilegeFilesystemWrite, &out);
   CHECK_EXIST(args, "location", out)
   const std::string& location = args.get("location").get<std::string>();
@@ -1029,6 +1062,10 @@ void FilesystemInstance::FileSystemManagerMakeDirectorySync(const picojson::valu
 
 void FilesystemInstance::ReadDir(const picojson::value& args, picojson::object& out) {
   ScopeLogger();
+  LoggerW(
+      "DEPRECATION WARNING: File.listFiles() is deprecated since Tizen 5.0. Use "
+      "FileSystemManager.listDirectory() instead.");
+
   CHECK_PRIVILEGE_ACCESS(kPrivilegeFilesystemRead, &out);
   CHECK_EXIST(args, "pathToDir", out)
   CHECK_EXIST(args, "callbackId", out)
@@ -1068,6 +1105,10 @@ void FilesystemInstance::ReadDir(const picojson::value& args, picojson::object&
 
 void FilesystemInstance::UnlinkFile(const picojson::value& args, picojson::object& out) {
   ScopeLogger();
+  LoggerW(
+      "DEPRECATION WARNING: File.deleteFile() is deprecated since Tizen 5.0. Use "
+      "FileSystemManager.deleteFile() instead.");
+
   CHECK_PRIVILEGE_ACCESS(kPrivilegeFilesystemWrite, &out);
   CHECK_EXIST(args, "pathToFile", out)
   double callback_id = args.get("callbackId").get<double>();
@@ -1100,6 +1141,10 @@ void FilesystemInstance::UnlinkFile(const picojson::value& args, picojson::objec
 
 void FilesystemInstance::RemoveDirectory(const picojson::value& args, picojson::object& out) {
   ScopeLogger();
+  LoggerW(
+      "DEPRECATION WARNING: File.deleteDirectory() is deprecated since Tizen 5.0. Use "
+      "FileSystemManager.deleteDirectory() instead.");
+
   CHECK_PRIVILEGE_ACCESS(kPrivilegeFilesystemWrite, &out);
   CHECK_EXIST(args, "pathToDelete", out)
   double callback_id = args.get("callbackId").get<double>();
@@ -1132,6 +1177,10 @@ void FilesystemInstance::RemoveDirectory(const picojson::value& args, picojson::
 
 void FilesystemInstance::CopyTo(const picojson::value& args, picojson::object& out) {
   ScopeLogger();
+  LoggerW(
+      "DEPRECATION WARNING: File.copyTo() is deprecated since Tizen 5.0. Use "
+      "FileSystemManager.CopyFile() or FileSystemManager.CopyDirectory() instead.");
+
   CHECK_PRIVILEGE_ACCESS(kPrivilegeFilesystemWrite, &out);
   CHECK_EXIST(args, "callbackId", out)
 
index d5d2d20d4696254443ed3c82663b5b9f297cdf81..990e42810b813c6c039ca0df110219478a89017d 100644 (file)
@@ -13,7 +13,7 @@
  *    See the License for the specific language governing permissions and
  *    limitations under the License.
  */
+
 function File(data) {
   function fileSizeGetter() {
     var _realPath = commonFS_.toRealPath(this.fullPath);
@@ -60,6 +60,9 @@ function File(data) {
 }
 
 function toURI() {
+  privUtils_.warn("DEPRECATION WARNING: File.toURI() is deprecated since Tizen 5.0. "
+                  + "Use FileSystemManager.toURI() instead.");
+
   xwalk.utils.checkPrivilegeAccess(xwalk.utils.privilege.FILESYSTEM_READ);
   return 'file://' + commonFS_.toRealPath(this.fullPath);
 }
@@ -162,6 +165,9 @@ function checkFile(file, fileFilter) {
 }
 
 function listFiles() {
+  privUtils_.warn("DEPRECATION WARNING: File.listFiles() is deprecated since Tizen 5.0. "
+                  + "Use FileSystemManager.listDirectory() instead.");
+
   var args = validator_.validateArgs(arguments, [
     {name: 'onsuccess', type: types_.FUNCTION},
     {name: 'onerror', type: types_.FUNCTION, optional: true, nullable: true},
@@ -243,6 +249,9 @@ function _checkEncoding(encoding) {
 }
 
 function openStream() {
+  privUtils_.warn("DEPRECATION WARNING: File.openStream() is deprecated since Tizen 5.0. "
+                  + "Use FileHandle interface to read/write operations instead.");
+
   var args = validator_.validateArgs(arguments, [
     {name: 'mode', type: types_.ENUM, values: ['r', 'rw', 'w', 'a']},
     {name: 'onsuccess', type: types_.FUNCTION},
@@ -294,6 +303,9 @@ File.prototype.openStream = function() {
 };
 
 function readAsText() {
+  privUtils_.warn("DEPRECATION WARNING: File.readAsText() is deprecated since Tizen 5.0. "
+                  + "Use FileHandle.readString() or FileHandle.readStringNonBlocking() instead.");
+
   var args = validator_.validateArgs(arguments, [
     {name: 'onsuccess', type: types_.FUNCTION},
     {name: 'onerror', type: types_.FUNCTION, optional: true, nullable: true},
@@ -346,6 +358,9 @@ File.prototype.readAsText = function() {
 };
 
 function copyTo() {
+  privUtils_.warn("DEPRECATION WARNING: File.copyTo() is deprecated since Tizen 5.0. "
+                  + "Use FileSystemManager.CopyFile() or FileSystemManager.CopyDirectory() instead.");
+
   var args = validator_.validateArgs(arguments, [
     {name: 'originFilePath', type: types_.STRING},
     {name: 'destinationFilePath', type: types_.STRING},
@@ -499,6 +514,9 @@ File.prototype.copyTo = function() {
 };
 
 function moveTo() {
+  privUtils_.warn("DEPRECATION WARNING: File.moveTo() is deprecated since Tizen 5.0. "
+                  + "Use FileSystemManager.moveFile() or FileSystemManager.moveDirectory() instead.");
+
   var args = validator_.validateArgs(arguments, [
     {name: 'originFilePath', type: types_.STRING},
     {name: 'destinationFilePath', type: types_.STRING},
@@ -615,6 +633,9 @@ File.prototype.moveTo = function() {
 };
 
 function createDirectory() {
+  privUtils_.warn("DEPRECATION WARNING: File.createDirectory() is deprecated since Tizen 5.0. "
+                  + "Use FileSystemManager.createDirectory() instead.");
+
   var args = validator_.validateArgs(arguments, [
     {name: 'dirPath', type: types_.STRING}
   ]);
@@ -679,6 +700,9 @@ File.prototype.createDirectory = function() {
 }
 
 function createFile() {
+  privUtils_.warn("DEPRECATION WARNING: File.createFile() is deprecated since Tizen 5.0. "
+                  + "Use FileSystemManager.createFile() instead.");
+
   var args = validator_.validateArgs(arguments, [
     {name: 'relativeFilePath', type: types_.STRING}
   ]);
@@ -735,6 +759,9 @@ File.prototype.createFile = function() {
 };
 
 function resolveFile() {
+  privUtils_.warn("DEPRECATION WARNING: File.resolve() is deprecated since Tizen 5.0. "
+                  + "Use FileHandle and FileSystemManager interfaces instead.");
+
   var args = validator_.validateArgs(arguments, [
     {name: 'filePath', type: types_.STRING}
   ]);
@@ -783,6 +810,9 @@ File.prototype.resolve = function() {
 };
 
 function deleteDirectory() {
+  privUtils_.warn("DEPRECATION WARNING: File.deleteDirectory() is deprecated since Tizen 5.0. "
+                  + "Use FileSystemManager.deleteDirectory() instead." );
+
   var args = validator_.validateArgs(arguments, [
     {name: 'directoryPath', type: types_.STRING},
     {name: 'recursive', type: types_.BOOLEAN},
@@ -883,6 +913,9 @@ File.prototype.deleteDirectory = function() {
 };
 
 function deleteFile() {
+  privUtils_.warn("DEPRECATION WARNING: File.deleteFile() is deprecated since Tizen 5.0. "
+                  + "Use FileSystemManager.deleteFile() instead.");
+
   var args = validator_.validateArgs(arguments, [
     {name: 'filePath', type: types_.STRING},
     {name: 'onsuccess', type: types_.FUNCTION, optional: true, nullable: true},
index 9d391bbdbb16dd054c871e424782886e809e1deb..89eed34a339e7f451f9486d9a79af3b4e9e8fa1f 100644 (file)
@@ -66,6 +66,9 @@ function _checkClosed(stream) {
 }
 
 function closeFileStream() {
+  privUtils_.warn("DEPRECATION WARNING: FileStream.close() is deprecated since Tizen 5.0. "
+                  + "Use FileHandle.close() instead.");
+
   this._closed = true;
 }
 
@@ -86,6 +89,9 @@ function _checkWriteAccess(mode) {
 }
 
 function read() {
+  privUtils_.warn("DEPRECATION WARNING: FileStream.read() is deprecated since Tizen 5.0. "
+                  + "Use FileHandle.readString() or FileHandle.readStringNonBlocking() instead.");
+
   var args = validator_.validateArgs(arguments, [{name: 'charCount', type: types_.LONG}]);
 
   _checkClosed(this);
@@ -177,10 +183,17 @@ function readBytes() {
 }
 
 FileStream.prototype.readBytes = function() {
+  privUtils_.warn("DEPRECATION WARNING: FileStream.readBytes() is deprecated since Tizen 5.0. "
+                  + "Use FileHandle.readData() or FileHandle.readDataNonBlocking() instead.");
+
   return readBytes.apply(this, arguments);
 };
 
 FileStream.prototype.readBase64 = function() {
+  privUtils_.warn("DEPRECATION WARNING: FileStream.readBase64() is deprecated since Tizen 5.0. "
+                  + "Use FileHandle.readData() or FileHandle.readDataNonBlocking() in combination "
+                  + "with atob() and btoa() functions instead.");
+
   return base64_encode(readBytes.apply(this, arguments));
 };
 
@@ -196,6 +209,9 @@ function check_characters_outside_latin1(str) {
 }
 
 function write() {
+  privUtils_.warn("DEPRECATION WARNING: FileStream.write() is deprecated since Tizen 5.0. "
+                  + "Use FileHandle.writeString() or FileHandle.writeStringNonBlocking() instead.");
+
   var args =
       validator_.validateArgs(arguments, [{name: 'stringData', type: types_.STRING}]);
 
@@ -235,6 +251,9 @@ FileStream.prototype.write = function() {
 };
 
 function writeBytes() {
+  privUtils_.warn("DEPRECATION WARNING: FileStream.writeBytes() is deprecated since Tizen 5.0. "
+                  + "Use FileHandle.writeData() or FileHandle.writeDataNonBlocking() instead.");
+
   var args = validator_.validateArgs(
       arguments, [{
         name: 'byteData',
@@ -274,6 +293,10 @@ FileStream.prototype.writeBytes = function() {
 };
 
 function writeBase64() {
+  privUtils_.warn("DEPRECATION WARNING: FileStream.writeBase64() is deprecated since Tizen 5.0. "
+                  + "Use FileHandle.writeData() or FileHandle.writeDataNonBlocking() in combination "
+                  + "with atob() and btoa() functions instead.");
+
   var args =
       validator_.validateArgs(arguments, [{name: 'base64Data', type: types_.STRING}]);
 
index 59fce182ef70460abc71d72e5b3a2739e6083e6f..cddcceb64486b6df0a04a8b097e527cc51729ef0 100644 (file)
@@ -527,6 +527,9 @@ FileSystemManager.prototype.getDirName = function() {
 };
 
 function resolve() {
+  privUtils_.warn("DEPRECATION WARNING: FileSystemManager.resolve() is deprecated since Tizen 5.0. "
+                  + "Use FileHandle and FileSystemManager interfaces instead.");
+
   var args = validator_.validateArgs(arguments, [
     {name: 'location', type: types_.STRING}, {name: 'onsuccess', type: types_.FUNCTION},
     {name: 'onerror', type: types_.FUNCTION, optional: true, nullable: true}, {