From a67425985a31a15db2331fc94ddc4776d02980fb Mon Sep 17 00:00:00 2001 From: "chaehee.hong" Date: Mon, 23 Sep 2024 10:29:34 +0900 Subject: [PATCH] [Content.Download] Update API document --- .../Tizen.Content.Download/CacheManager.cs | 5 +- .../Tizen.Content.Download/Notification.cs | 8 +-- .../Tizen.Content.Download/Request.cs | 64 +++++++++++-------- 3 files changed, 43 insertions(+), 34 deletions(-) diff --git a/src/Tizen.Content.Download/Tizen.Content.Download/CacheManager.cs b/src/Tizen.Content.Download/Tizen.Content.Download/CacheManager.cs index 65c49d3e0f4..08a10de2d80 100644 --- a/src/Tizen.Content.Download/Tizen.Content.Download/CacheManager.cs +++ b/src/Tizen.Content.Download/Tizen.Content.Download/CacheManager.cs @@ -20,14 +20,15 @@ namespace Tizen.Content.Download { /// - /// The CacheManager class provides the functions to manage cache properties. + /// The CacheManager class provides the functions to manage cache properties, + /// allowing downloaded content to be reused without redownloading. /// /// 11 public static class CacheManager { /// - /// Clears per app download cache. + /// Clears all cached data related to downloads, resetting the cache to its initial state. /// /// 11 /// http://tizen.org/privilege/download diff --git a/src/Tizen.Content.Download/Tizen.Content.Download/Notification.cs b/src/Tizen.Content.Download/Tizen.Content.Download/Notification.cs index 6a999889520..b11621ad023 100755 --- a/src/Tizen.Content.Download/Tizen.Content.Download/Notification.cs +++ b/src/Tizen.Content.Download/Tizen.Content.Download/Notification.cs @@ -33,7 +33,7 @@ internal Notification(int requestId) } /// - /// Title of the notification. + /// Title text that is set to be displayed in the download notification. /// If a user tries to get before the setting, an empty string is returned. /// /// 3 @@ -67,7 +67,7 @@ public string Title } /// - /// Description of the notification. + /// Description text to be displayed in the download notification. /// If a user tries to get before the setting, an empty string is returned. /// /// 3 @@ -101,8 +101,8 @@ public string Description } /// - /// Type of the notification. - /// If a user tries to get before the setting, the default NotificationType none is returned. + /// Type of notification to be displayed during the download process. + /// If a user tries to get before the setting, is returned. /// /// 3 /// http://tizen.org/privilege/download diff --git a/src/Tizen.Content.Download/Tizen.Content.Download/Request.cs b/src/Tizen.Content.Download/Tizen.Content.Download/Request.cs index 25e282804f5..d8ef258598c 100755 --- a/src/Tizen.Content.Download/Tizen.Content.Download/Request.cs +++ b/src/Tizen.Content.Download/Tizen.Content.Download/Request.cs @@ -37,7 +37,7 @@ public class Request : IDisposable private bool _disposed = false; /// - /// Creates a Request object. + /// Creates a Request object that can be used to control the download process. /// /// 3 /// The URL to download. @@ -66,12 +66,12 @@ public Request(string url) } /// - /// Creates a Request object. + /// Creates a Request object, taking parameters to specify the URL, download location, file name, and network type. /// /// 3 /// The URL to download - /// The directory path where downloaded file is stored. - /// The name of the downloaded file. + /// The directory path where the downloaded file will be saved. + /// The desired file name for the downloaded content. /// The network type which the download request must adhere to. /// http://tizen.org/privilege/download /// http://tizen.org/feature/network.wifi @@ -122,11 +122,12 @@ public Request(string url, string destinationPath, string fileName, NetworkType } /// - /// Creates a Request object. + /// Creates a Request object, taking parameters to specify the URL, + /// download location, file name, network type and any additional HTTP headers required for the request. /// /// 3 /// The URL to download. - /// The directory path where the downloaded file is stored. + /// The directory path where the downloaded file will be saved. /// The name of the downloaded file. /// The network type which the download request must adhere to. /// HTTP header fields for the download request. @@ -187,7 +188,7 @@ public Request(string url, string destinationPath, string fileName, NetworkType } /// - /// An event that occurs when the download state changes. + /// An event that occurs when the download state changes, such as when the download starts, pauses, completes, or fails. /// /// 3 /// http://tizen.org/privilege/download @@ -215,7 +216,7 @@ public event EventHandler StateChanged } /// - /// An event that occurs when the download progress changes. + /// An event that occurs when the download progress changes to track the progress of the download. /// /// 3 /// http://tizen.org/privilege/download @@ -243,7 +244,7 @@ public event EventHandler ProgressChanged } /// - /// The absolute path where the file will be downloaded. + /// The absolute file path of the downloaded content. /// If you try to get this property value before calling Start(), an empty string is returned. /// /// 3 @@ -294,7 +295,7 @@ public string MimeType } /// - /// The current state of the download. + /// The current state of the download, such as whether it is in progress, paused, canceled, or completed. /// /// 3 /// http://tizen.org/privilege/download @@ -318,7 +319,7 @@ public DownloadState State /// /// The content name of the downloaded file. - /// This can be defined with reference of the HTTP response header data. The content name can be received when the HTTP response header is received. + /// This can be received when HTTP response header is received. /// If you try to get this property value before calling Start(), an empty string is returned. /// /// 3 @@ -342,7 +343,7 @@ public string ContentName } /// - /// The total size of the downloaded content. + /// The size of the content being downloaded. /// This information is received from the server. If the server does not send the total size of the content, the content size is set to zero. /// If you try to get this property value before calling Start(), 0 is returned. /// @@ -367,13 +368,13 @@ public ulong ContentSize } /// - /// The HTTP status code when a download exception occurs. + /// The HTTP status code when the download exception occurs. /// If you try to get this property value before calling Start(), 0 is returned. /// /// 3 /// http://tizen.org/privilege/download /// - /// The state of the download request must be DownlodState.Failed. + /// The state of the download request must be . /// /// Thrown when it is failed due to an invalid parameter. /// Thrown when it is failed due to an invalid operation. @@ -394,13 +395,14 @@ public int HttpStatus } /// - /// The ETag value from the HTTP response header when making a HTTP request for resume. + /// The ETag (Entity Tag) from the server response for the download request when making a HTTP request for resume. /// If you try to get this property value before calling Start() or if any other error occurs, an empty string is returned. /// /// 3 /// http://tizen.org/privilege/download /// - /// The ETag value is either available or not dependent on the web server. If not available, then, on getting the property, a null value is returned. + /// The ETag is a unique identifier assigned by the server to the content, which can be used to check for updates or changes to the file. + /// It is either available or not dependent on the web server. If not available, then, on getting the property, a null value is returned. /// After the download is started, it can get the ETag value. /// /// Thrown when it is failed due to an invalid parameter. @@ -441,7 +443,7 @@ public Notification NotificationProperties } /// - /// The full path of the temporary file stores the downloaded content. + /// The temporary file path where the downloaded content is being stored. /// /// 3 /// http://tizen.org/privilege/download @@ -467,7 +469,7 @@ public string TemporaryPath } /// - /// The URL to download. + /// The URL for the file to be downloaded. /// /// 3 /// http://tizen.org/privilege/download @@ -502,9 +504,10 @@ public string Url } /// - /// The allowed network type for downloading the file. + /// The allowed network type that is set for the download. /// The file will be downloaded only under the allowed network. - /// If you try to get this property value before setting or if any other error occurs, the default value NetworkType All is returned. + /// If you try to get this property value before setting or if any other error occurs, + /// is returned. /// /// 3 /// http://tizen.org/privilege/download @@ -542,7 +545,9 @@ public NetworkType AllowedNetworkType } /// - /// The file will be downloaded to the set the destination file path. The downloaded file is saved to an auto-generated file name in the destination. If the destination is not specified, the file will be downloaded to the default storage. + /// The file path where the downloaded content will be saved on the device. + /// The downloaded file is saved to an auto-generated file name in the destination. + /// If the destination is not specified, the file will be downloaded to the default storage. /// If you try to get this property value before setting or if any other error occurs, an empty string is returned. /// /// 3 @@ -577,7 +582,9 @@ public string DestinationPath } /// - /// The file will be saved in the specified destination or the default storage with the set file name. If the file name is not specified, the downloaded file will be saved with an auto-generated file name in the destination. + /// The name to be used for the downloaded content. + /// The file will be saved in the specified destination or the default storage. + /// If the file name is not specified, the downloaded content will be saved with an auto-generated file name in the destination. /// If you try to get this property value before setting or if any other error occurs, an empty string is returned. /// /// 3 @@ -612,8 +619,9 @@ public string FileName } /// - /// Enables or disables auto download. - /// If this option is enabled, the previous downloading item is restarted automatically as soon as the download daemon is restarted. The download progress continues after the client process is terminated. + /// Enables or disables automatic downloading of the file. + /// If this option is enabled, the previous downloading item is restarted automatically as soon as the download daemon is restarted. + /// The download progress continues after the client process is terminated. /// If you try to get this property value before setting, the default value false is returned. /// /// 3 @@ -648,7 +656,7 @@ public bool AutoDownload } /// - /// The HTTP header field and value pairs to the download request. + /// The HTTP header field and value pairs that was added to the download request. /// The HTTP header <field,value> pair is the <key,value> pair in the dictionary HttpHeaders. /// The given HTTP header field will be included with the HTTP request of the download request. /// If you try to get this property value before setting, an empty dictionary is returned. @@ -720,7 +728,7 @@ public void Start() } /// - /// Pauses the download request. + /// Pauses an ongoing download. /// /// 3 /// http://tizen.org/privilege/download @@ -740,7 +748,7 @@ public void Pause() } /// - /// Cancels the download request. + /// Cancels an active download. /// /// 3 /// http://tizen.org/privilege/download @@ -846,7 +854,7 @@ private void UnregisterProgressChangedEvent() } /// - /// Enabled state of the cache feature. + /// Enables or disables the use of cache for the download. /// /// 11 /// http://tizen.org/privilege/download