File Management Subsystem Changelog

cl.filemanagement.1 fileio API Changes

Deprecated the fileio APIs, which do not return error codes; added APIs that return error codes.

Change Impact

For applications developed based on earlier versions, pay attention to the iterative update of deprecated APIs. The specifications of the new APIs are slightly adjusted. Pay attention to the usage of the new APIs.

Key API/Component Changes

The APIs of @ohos.fileio do not support error code handling and are deprecated. New APIs with minor changes in parameters are added in @ohos.file.fs to support unified error code handling. The functionalities of the APIs remain unchanged.

Adaptation Guide

1. Change the module to import.

   Change import fileio from '@ohos.fileio' to import fs from '@ohos.file.fs'.

2. Change the exception handling method.

   Sample code for exception handling in a synchronous API:

   import fs from '@ohos.file.fs'
   
   try {
       let file = fs.openSync(path, fs.OpenMode.READ_ONLY);
   } catch (err) {
       console.error("openSync errCode:" + err.code + ", errMessage:" + err.message);
   }
   

   Sample code for exception handling in an asynchronous API (promise):

   import fs from '@ohos.file.fs'
   
   try {
       let file = await fs.open(path, fs.OpenMode.READ_ONLY);
   } catch (err) {
       console.error("open promise errCode:" + err.code + ", errMessage:" + err.message);
   }
   
   

   Sample code for exception handling in an asynchronous API (callback):

   import fs from '@ohos.file.fs'
   
   try {
       fs.open(path, fs.OpenMode.READ_ONLY, function(e, file){ // Asynchronous thread errors (such as a syscall error) are obtained via a callback.
           if (e) {
               console.error("open in async errCode:" + e.code + ", errMessage:" + e.message);
           }
       });
   } catch (err) {// Main thread errors (such as invalid parameters) are obtained by try catch.
       console.error("open callback errCode:" + err.code + ", errMessage:" + err.message);
   }