Merge remote-tracking branch 'origin/master' into release

Author: dynabic-billing-team

CHANGELOG.md

@@ -1,3 +1,11 @@
+## [21.7.0] - Aspose Words Cloud for Dart 21.7 Release Notes
+
+- ImlRenderingMode option introduced witch is used to determine how ink (InkML) objects are rendered
+- MaxCharactersPerLine option introduced which is used to specify the maximum number of characters per one line
+- Added new API method to get a RSA public key to encrypt document passwords
+- Added encryptedPassword common query option to pass an encrypted document password
+
+
 ## [21.6.0] - Aspose Words Cloud for Dart 21.6 Release Notes
 
 - Implemented beta version of CompareDocumentOnline feature with both document sending in request

README.md

@@ -27,7 +27,7 @@ Add this dependency to your *pubspec.yaml*:
 
 ```yaml
 dependencies:
-  aspose_words_cloud: 21.6.0
+  aspose_words_cloud: 21.7.0
 ```
 
 ## Getting Started

examples/AcceptAllRevisions.dart

@@ -8,8 +8,8 @@ final wordsApi = WordsApi(config);
 final fileName  = 'test_doc.docx';
 
 // Upload original document to cloud storage.
-final fileContentData = (await File(fileName).readAsBytes()).buffer.asByteData();
-final uploadFileRequest = UploadFileRequest(fileContentData, fileName);
+final requestFileContentData = (await File(fileName).readAsBytes()).buffer.asByteData();
+final uploadFileRequest = UploadFileRequest(requestFileContentData, fileName);
 await wordsApi.uploadFile(uploadFileRequest);
 
 // Calls AcceptAllRevisions method for document in cloud.

examples/AcceptAllRevisionsOnline.dart

@@ -5,8 +5,8 @@ final wordsApi = WordsApi(config);
 final fileName  = 'test_doc.docx';
 
 // Calls AcceptAllRevisionsOnline method for document in cloud.
-final documentData = (await File(fileName).readAsBytes()).buffer.asByteData();
-final request = AcceptAllRevisionsOnlineRequest(documentData);
+final requestDocumentData = (await File(fileName).readAsBytes()).buffer.asByteData();
+final request = AcceptAllRevisionsOnlineRequest(requestDocumentData);
 final acceptAllRevisionsOnlineResult = await wordsApi.acceptAllRevisionsOnline(request);
 await File('test_result.docx').writeAsBytes(
     acceptAllRevisionsOnlineResult.document.buffer.asUint8List(acceptAllRevisionsOnlineResult.document.offsetInBytes, acceptAllRevisionsOnlineResult.document.lengthInBytes)

lib/aspose_words_cloud.dart

@@ -182,6 +182,7 @@ export 'src/models/protection_data.dart';
 export 'src/models/protection_data_response.dart';
 export 'src/models/protection_request.dart';
 export 'src/models/ps_save_options_data.dart';
+export 'src/models/public_key_response.dart';
 export 'src/models/range_document.dart';
 export 'src/models/range_document_dto.dart';
 export 'src/models/range_text_response.dart';
@@ -419,6 +420,7 @@ export 'src/requests/get_paragraph_tab_stops_online_request.dart';
 export 'src/requests/get_paragraph_tab_stops_request.dart';
 export 'src/requests/get_paragraphs_online_request.dart';
 export 'src/requests/get_paragraphs_request.dart';
+export 'src/requests/get_public_key_request.dart';
 export 'src/requests/get_range_text_online_request.dart';
 export 'src/requests/get_range_text_request.dart';
 export 'src/requests/get_run_font_online_request.dart';

lib/src/api_client.dart

@@ -433,7 +433,7 @@ class ApiClient {
 
     var httpRequest = http.Request(requestData.method, Uri.parse(requestData.url));
     httpRequest.headers['x-aspose-client'] = 'dart sdk';
-    httpRequest.headers['x-aspose-client-version'] = '21.6';
+    httpRequest.headers['x-aspose-client-version'] = '21.7';
     httpRequest.headers['Authorization'] = await _getAuthToken();
     if (requestData.headers != null) {
       httpRequest.headers.addAll(requestData.headers);

lib/src/models/public_key_response.dart

@@ -0,0 +1,75 @@
+/*
+ * --------------------------------------------------------------------------------
+ * <copyright company="Aspose" file="public_key_response.dart">
+ *   Copyright (c) 2021 Aspose.Words for Cloud
+ * </copyright>
+ * <summary>
+ *   Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ * 
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ * 
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ * </summary>
+ * --------------------------------------------------------------------------------
+ */
+
+library aspose_words_cloud;
+
+import '../../aspose_words_cloud.dart';
+
+/// REST response for RSA public key info.
+class PublicKeyResponse extends WordsResponse {
+  /// Gets or sets RSA key exponent as Base64 string.
+  String exponent;
+
+  /// Gets or sets RSA key modulus as Base64 string.
+  String modulus;
+
+  @override
+  void deserialize(Map<String, dynamic> json) {
+    if (json == null) {
+      throw ApiException(400, 'Failed to deserialize PublicKeyResponse data model.');
+    }
+
+    super.deserialize(json);
+    if (json.containsKey('Exponent')) {
+      exponent = json['Exponent'] as String;
+    } else {
+      exponent = null;
+    }
+
+    if (json.containsKey('Modulus')) {
+      modulus = json['Modulus'] as String;
+    } else {
+      modulus = null;
+    }
+  }
+
+  @override
+  Map<String, dynamic> serialize() {
+    var _result = <String, dynamic>{};
+    _result.addAll(super.serialize());
+    if (exponent != null) {
+      _result['Exponent'] = exponent;
+    }
+
+    if (modulus != null) {
+      _result['Modulus'] = modulus;
+    }
+    return _result;
+  }
+}
+
+

lib/src/models/save_options_data.dart

@@ -50,6 +50,9 @@ class SaveOptionsData implements ModelBase {
   /// Gets or sets the name of destination file.
   String fileName;
 
+  /// Gets or sets the value determining how ink (InkML) objects are rendered.
+  String imlRenderingMode;
+
   /// Gets or sets the format of save.
   String saveFormat;
 
@@ -120,6 +123,12 @@ class SaveOptionsData implements ModelBase {
       fileName = null;
     }
 
+    if (json.containsKey('ImlRenderingMode')) {
+      imlRenderingMode = json['ImlRenderingMode'] as String;
+    } else {
+      imlRenderingMode = null;
+    }
+
     if (json.containsKey('SaveFormat')) {
       saveFormat = json['SaveFormat'] as String;
     } else {
@@ -194,6 +203,10 @@ class SaveOptionsData implements ModelBase {
       _result['FileName'] = fileName;
     }
 
+    if (imlRenderingMode != null) {
+      _result['ImlRenderingMode'] = imlRenderingMode;
+    }
+
     if (saveFormat != null) {
       _result['SaveFormat'] = saveFormat;
     }

lib/src/models/text_save_options_data.dart

@@ -35,6 +35,10 @@ class TextSaveOptionsData extends TxtSaveOptionsBaseData {
   /// The default value is true.
   bool addBidiMarks;
 
+  /// Gets or sets an integer value that specifies the maximum number of characters per one line.
+  /// The default value is 0, that means no limit.
+  int maxCharactersPerLine;
+
   /// Gets or sets a value indicating whether the program should attempt to preserve layout of tables when saving in the plain text format.
   bool preserveTableLayout;
 
@@ -54,6 +58,12 @@ class TextSaveOptionsData extends TxtSaveOptionsBaseData {
       addBidiMarks = null;
     }
 
+    if (json.containsKey('MaxCharactersPerLine')) {
+      maxCharactersPerLine = json['MaxCharactersPerLine'] as int;
+    } else {
+      maxCharactersPerLine = null;
+    }
+
     if (json.containsKey('PreserveTableLayout')) {
       preserveTableLayout = json['PreserveTableLayout'] as bool;
     } else {
@@ -75,6 +85,10 @@ class TextSaveOptionsData extends TxtSaveOptionsBaseData {
       _result['AddBidiMarks'] = addBidiMarks;
     }
 
+    if (maxCharactersPerLine != null) {
+      _result['MaxCharactersPerLine'] = maxCharactersPerLine;
+    }
+
     if (preserveTableLayout != null) {
       _result['PreserveTableLayout'] = preserveTableLayout;
     }

lib/src/requests/append_document_online_request.dart

@@ -35,7 +35,7 @@ import '../api_request_part.dart';
 
 /// Request model for AppendDocumentOnline operation.
 class AppendDocumentOnlineRequest implements RequestBase {
-  /// The document.
+  /// Original document.
   final ByteData document;
 
   /// <see cref="DocumentEntryList"/> with a list of documents to append.