Merge pull request #335 from ONLYOFFICE/release/1.5.0

Release/1.5.0

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Change Log
 
+## 1.5.0
+- nodejs: added wopi putRelativeFile action
+- nodejs: wopi editnew action for exisiting file
+- nodejs: fix wopi actions after restart
+- setting an unavailable language
+- description in the tooltip on the main page
+- nodejs: referenceData
+- option to send directUrl
+
 ## 1.4.0
 - nodejs: option to send directUrl
 - opening file on client by directUrl
@@ -34,6 +43,5 @@
 - creating docxf
 - opening docxf, oform
 
-
 ## 1.0.0
 - added java spring

web/documentserver-example/csharp-mvc/App_Start/BundleConfig.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/App_Start/FilterConfig.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/App_Start/RouteConfig.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/App_Start/WebApiConfig.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Content/editor.css

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Content/media.css

@@ -1,4 +1,22 @@
-@media (min-width: 1280px)  and (max-width: 1380px) {
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+ @media (min-width: 1280px)  and (max-width: 1380px) {
     .copy {
         margin-right: 6.5%;
     }

web/documentserver-example/csharp-mvc/Content/stylesheet.css

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -167,7 +167,7 @@ label .checkbox {
     background-image: url("images/file_docxf.svg");
 }
 
-.create-sample {
+.side-option {
     color: #666666;
     line-height: 24px;
 }
@@ -740,3 +740,28 @@ html {
 .user-descr > b {
     margin-left: 25px;
 }
+
+.tooltip {
+    background: #FFFFFF;
+    border-radius: 5px;
+    box-shadow: 0px 7px 25px rgba(85, 85, 85, 0.15);
+    color: #666666;
+    line-height: 160%;
+    max-width: 455px;
+    padding: 14px;
+    position: absolute;
+}
+
+.tooltip ul {
+    margin: 0;
+}
+
+.arrow {
+    border-top: 8px solid transparent;
+    border-bottom: 8px solid transparent;
+    border-right: 8px solid #FFFFFF;
+    left: -4px;
+    position: absolute;
+    top: 50%;
+    transform: translate(-50%, -50%);
+}

web/documentserver-example/csharp-mvc/Controllers/HomeController.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,6 +16,7 @@
  *
  */
 
+using System;
 using System.IO;
 using System.Web.Mvc;
 using OnlineEditorsExampleMVC.Helpers;
@@ -31,13 +32,14 @@ namespace OnlineEditorsExampleMVC.Controllers
         }
 
         // viewing file in the editor
-        public ActionResult Editor(string fileName, string editorsMode, string editorsType)
+        public ActionResult Editor(string fileName, string editorsMode, string editorsType, string directUrl)
         {
             var file = new FileModel
             {
                 Mode = editorsMode,  // editor mode: edit or view
                 Type = editorsType,  // editor type: desktop, mobile, embedded
-                FileName = Path.GetFileName(fileName)  // file name
+                FileName = Path.GetFileName(fileName),  // file name
+                IsEnabledDirectUrl = directUrl != null ? Convert.ToBoolean(directUrl) : false
             };
 
             return View("Editor", file);

web/documentserver-example/csharp-mvc/Global.asax.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Helpers/DocManagerHelper.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -442,5 +442,11 @@ namespace OnlineEditorsExampleMVC.Helpers
             }
             return languages;
         }
+
+        public static string GetDirectUrl()
+        {
+            string isEnabledDirectUrl = HttpUtility.ParseQueryString(HttpContext.Current.Request.Url.Query).Get("directUrl");
+            return isEnabledDirectUrl != null ? isEnabledDirectUrl : "false";
+        }
     }
 }

web/documentserver-example/csharp-mvc/Helpers/DocumentConverter.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -130,7 +130,7 @@ namespace OnlineEditorsExampleMVC.Helpers
                 var payloadToken = JwtManager.Encode(payload);  // encode the payload object to the payload token
                 var bodyToken = JwtManager.Encode(body);  // encode the body object to the body token
                 // create header token
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
                 request.Headers.Add(JWTheader, "Bearer " + payloadToken);
 
                 body.Add("token", bodyToken);

web/documentserver-example/csharp-mvc/Helpers/JwtManager.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Helpers/TrackManager.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -55,7 +55,7 @@ namespace OnlineEditorsExampleMVC.Helpers
             // check if the document token is enabled
             if (JwtManager.Enabled)
             {
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
                 string token = null;
 
@@ -92,15 +92,13 @@ namespace OnlineEditorsExampleMVC.Helpers
         // file saving process
         public static int processSave(Dictionary<string, object> fileData, string fileName, string userAddress)
         {
-            if (fileData["url"].Equals(null)) {
+            if (string.IsNullOrEmpty((string)fileData["url"])) {
                 throw new Exception("DownloadUrl is null");
             }
             var downloadUri = (string)fileData["url"];
             string curExt = Path.GetExtension(fileName).ToLower();  // get current file extension
 
-            var downloadExt = fileData.ContainsKey("filetype")
-                ? "." + (string)fileData["filetype"]
-                : Path.GetExtension(downloadUri).ToLower() ?? ""; // TODO: Delete in version 7.0 or higher. Support for versions below 7.0
+            var downloadExt = "." + (string)fileData["filetype"]; // get the extension of the downloaded file
 
             var newFileName = fileName;
 
@@ -169,16 +167,14 @@ namespace OnlineEditorsExampleMVC.Helpers
         // file force saving process
         public static int processForceSave(Dictionary<string, object> fileData, string fileName, string userAddress)
         {
-            if (fileData["url"].Equals(null)) {
+            if ( string.IsNullOrEmpty((string)fileData["url"])) {
                 throw new Exception("DownloadUrl is null");
             }
             var downloadUri = (string)fileData["url"];
 
             string curExt = Path.GetExtension(fileName).ToLower();  // get current file extension
 
-            var downloadExt = fileData.ContainsKey("filetype")
-                ? "." + (string)fileData["filetype"]
-                : Path.GetExtension(downloadUri).ToLower(); // TODO: Delete in version 7.0 or higher. Support for versions below 7.0
+            var downloadExt = "." + (string)fileData["filetype"];  // get the extension of the downloaded file
 
             Boolean newFileName = false;
 
@@ -228,7 +224,7 @@ namespace OnlineEditorsExampleMVC.Helpers
                     fileName = DocManagerHelper.GetCorrectName(Path.GetFileNameWithoutExtension(fileName) + downloadExt, userAddress);
                 }
                 forcesavePath = DocManagerHelper.ForcesavePath(fileName, userAddress, false);
-                if (forcesavePath.Equals(""))  // create forcesave path if it doesn't exist
+                if (string.IsNullOrEmpty(forcesavePath))  // create forcesave path if it doesn't exist
                 {
                     forcesavePath = DocManagerHelper.ForcesavePath(fileName, userAddress, true);
                 }
@@ -279,7 +275,7 @@ namespace OnlineEditorsExampleMVC.Helpers
 
                 var payloadToken = JwtManager.Encode(payload);  // encode a payload object into a header token
                 var bodyToken = JwtManager.Encode(body);  // encode body into a body token
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
                 request.Headers.Add(JWTheader, "Bearer " + payloadToken);  // add a header Authorization with a header token and Authorization prefix in it
 
                 body.Add("token", bodyToken);
@@ -321,6 +317,7 @@ namespace OnlineEditorsExampleMVC.Helpers
             if (string.IsNullOrEmpty(path)) throw new ArgumentException("path");  // file isn't specified
 
             var req = (HttpWebRequest)WebRequest.Create(url);
+            req.Timeout = 5000;
             using (var stream = req.GetResponse().GetResponseStream())  // get input stream of the file information from the url
             {
                 if (stream == null) throw new Exception("stream is null");

web/documentserver-example/csharp-mvc/Helpers/Users.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Helpers/Utils.cs

@@ -1,4 +1,22 @@
-using System.Web;
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+using System.Web;
 
 namespace OnlineEditorsExampleMVC.Helpers
 {

web/documentserver-example/csharp-mvc/Models/FileModel.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -33,6 +33,7 @@ namespace OnlineEditorsExampleMVC.Models
     {
         public string Mode { get; set; }  // editor mode
         public string Type { get; set; }  // editor type
+        public bool IsEnabledDirectUrl { get; set; }  // is enabled direct url
 
         // get file url for Document Server
         public string FileUri
@@ -126,7 +127,7 @@ namespace OnlineEditorsExampleMVC.Models
                             {
                                 { "title", FileName },
                                 { "url", DownloadUrl },
-                                { "directUrl", directUrl },
+                                { "directUrl", IsEnabledDirectUrl ? directUrl : "" },
                                 { "fileType", ext.Trim('.') },
                                 { "key", Key },
                                 {
@@ -286,7 +287,10 @@ namespace OnlineEditorsExampleMVC.Models
                     }
 
                     dataObj.Add("url", prevFileUrl);
-                    dataObj.Add("directUrl", directPrevFileUrl);
+                    if (IsEnabledDirectUrl)
+                    {
+                        dataObj.Add("directUrl", directPrevFileUrl);
+                    }
                     dataObj.Add("version", i);
                     if (i > 1)  // check if the version number is greater than 1 (the file was modified)
                     {
@@ -304,11 +308,15 @@ namespace OnlineEditorsExampleMVC.Models
                         obj.Add("user", change.Count > 0 ? change["user"] : null);
 
                         var prev = (Dictionary<string, object>)histData[(i - 2).ToString()];  // get the history data from the previous file version
-                        dataObj.Add("previous", new Dictionary<string, object>() {  // write information about previous file version to the data object
+                        dataObj.Add("previous", IsEnabledDirectUrl ? new Dictionary<string, object>() {  // write information about previous file version to the data object with direct url
                             { "fileType", prev["fileType"] },
                             { "key", prev["key"] },  // write key and url information about previous file version
                             { "url", prev["url"] },
                             { "directUrl", prev["directUrl"] },
+                        } : new Dictionary<string, object>() {  // write information about previous file version to the data object without direct url
+                            { "fileType", prev["fileType"] },
+                            { "key", prev["key"] },  // write key and url information about previous file version
+                            { "url", prev["url"] },
                         });
                         // write the path to the diff.zip archive with differences in this file version
                         var changesUrl = DocManagerHelper.GetHistoryDownloadUrl(FileName, (i - 1).ToString(), "diff.zip");
@@ -359,10 +367,14 @@ namespace OnlineEditorsExampleMVC.Models
             var dataCompareFile = new Dictionary<string, object>
             {
                 { "fileType", "docx" },
-                { "url", compareFileUrl.ToString() },
-                { "directUrl", directCompareFileUrl.ToString()}
+                { "url", compareFileUrl.ToString() }
             };
 
+            if (IsEnabledDirectUrl)
+            {
+                dataCompareFile.Add("directUrl", directCompareFileUrl.ToString());
+            }
+
             if (JwtManager.Enabled)  // if the secret key to generate token exists
             {
                 var compareFileToken = JwtManager.Encode(dataCompareFile);  // encode the dataCompareFile object into the token
@@ -396,10 +408,14 @@ namespace OnlineEditorsExampleMVC.Models
             var logoConfig = new Dictionary<string, object>
             {
                 { "fileType", "png"},
-                { "url", mailMergeUrl.ToString()},
-                { "directUrl", directMailMergeUrl.ToString()}
+                { "url", mailMergeUrl.ToString()}
             };
 
+            if (IsEnabledDirectUrl)
+            {
+                logoConfig.Add("directUrl", directMailMergeUrl.ToString());
+            }
+
             if (JwtManager.Enabled)  // if the secret key to generate token exists
             {
                 var token = JwtManager.Encode(logoConfig);  // encode logoConfig into the token
@@ -437,10 +453,14 @@ namespace OnlineEditorsExampleMVC.Models
             var mailMergeConfig = new Dictionary<string, object>
             {
                 { "fileType", "csv" },
-                { "url", mailMergeUrl.ToString()},
-                { "directUrl", directMailMergeUrl.ToString()}
+                { "url", mailMergeUrl.ToString()}
             };
 
+            if (IsEnabledDirectUrl)
+            {
+                mailMergeConfig.Add("directUrl", directMailMergeUrl.ToString());
+            }
+
             if (JwtManager.Enabled)  // if the secret key to generate token exists
             {
                 var mailmergeToken = JwtManager.Encode(mailMergeConfig);  // encode mailMergeConfig into the token

web/documentserver-example/csharp-mvc/Models/FileUtility.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Properties/AssemblyInfo.cs

@@ -7,7 +7,7 @@ using System.Runtime.InteropServices;
 [assembly: AssemblyConfiguration("")]
 [assembly: AssemblyCompany("Ascensio System SIA")]
 [assembly: AssemblyProduct("OnlineEditorsExampleMVC")]
-[assembly: AssemblyCopyright("Ascensio System SIA 2021")]
+[assembly: AssemblyCopyright("Ascensio System SIA 2023")]
 [assembly: AssemblyTrademark("")]
 [assembly: AssemblyCulture("")]
 

web/documentserver-example/csharp-mvc/Scripts/jquery.dropdownToggle.js

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Scripts/jscript.js

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,11 +16,24 @@
  *
  */
 
+var directUrl;
+
 if (typeof jQuery != "undefined") {
     jq = jQuery.noConflict();
 
+    directUrl = getUrlVars()["directUrl"] == "true";
+
     mustReload = false;
 
+    if (directUrl)
+        jq("#directUrl").prop("checked", directUrl);
+    else
+        directUrl = jq("#directUrl").prop("checked");
+
+    jq("#directUrl").change(function () {
+        window.location = "?directUrl=" + jq(this).prop("checked");
+    });
+
     jq(function () {
         jq('#fileupload').fileupload({
             dataType: 'json',
@@ -219,7 +232,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginEdit:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = UrlEditor + "?fileName=" + fileId;
+        var url = UrlEditor + "?fileName=" + fileId + "&directUrl=" + directUrl;
         window.open(url, "_blank");
         jq('#hiddenFileName').val("");
         jq.unblockUI();
@@ -227,7 +240,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginView:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = UrlEditor + "?editorsMode=view&fileName=" + fileId;
+        var url = UrlEditor + "?editorsMode=view&fileName=" + fileId + "&directUrl=" + directUrl;
         window.open(url, "_blank");
         jq('#hiddenFileName').val("");
         jq.unblockUI();
@@ -235,7 +248,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginEmbedded:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = UrlEditor + "?editorsType=embedded&editorsMode=embedded&fileName=" + fileId;
+        var url = UrlEditor + "?editorsType=embedded&editorsMode=embedded&fileName=" + fileId + "&directUrl=" + directUrl;
 
         jq("#mainProgress").addClass("embedded");
         jq("#beginEmbedded").addClass("disable");
@@ -289,6 +302,17 @@ if (typeof jQuery != "undefined") {
         }
     };
 
+    function getUrlVars() {
+        var vars = [], hash;
+        var hashes = window.location.href.slice(window.location.href.indexOf('?') + 1).split('&');
+        for (var i = 0; i < hashes.length; i++) {
+            hash = hashes[i].split('=');
+            vars.push(hash[0]);
+            vars[hash[0]] = hash[1];
+        }
+        return vars;
+    };
+
     var fileList = jq("tr.tableRow");
 
     var mouseIsOverTooltip = false;
@@ -299,12 +323,12 @@ if (typeof jQuery != "undefined") {
                 if (hideTooltipTimeout != null) {
                     clearTimeout(hideTooltipTimeout);
                 }
-                jq(".info").on("touchend", function () {
+                jq("#info").on("touchend", function () {
                     showUserTooltip(true);
                 });
             }
     } else {
-        jq(".info").mouseover(function (event) {
+        jq("#info").mouseover(function (event) {
             if (fileList.length > 0) {
                 if (hideTooltipTimeout != null) {
                     clearTimeout(hideTooltipTimeout);
@@ -328,4 +352,18 @@ if (typeof jQuery != "undefined") {
             }, 500);
         });
     }
+
+    jq(".info-tooltip").mouseover(function (event) {
+        var target = event.target;
+        var id = target.dataset.id ? target.dataset.id : target.id;
+        var tooltip = target.dataset.tooltip;
+
+        jq("<div class='tooltip'>" + tooltip + "<div class='arrow'></div></div>").appendTo("body");
+
+        var top = jq("#" + id).offset().top + jq("#" + id).outerHeight() / 2 - jq("div.tooltip").outerHeight() / 2;
+        var left = jq("#" + id).offset().left + jq("#" + id).outerWidth() + 20;
+        jq("div.tooltip").css({ "top": top, "left": left });
+    }).mouseout(function () {
+        jq("div.tooltip").remove();
+    });
 }

web/documentserver-example/csharp-mvc/Views/Home/Editor.aspx

@@ -14,7 +14,7 @@
     <meta name="mobile-web-app-capable" content="yes" />
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/Views/Home/Index.aspx

@@ -15,7 +15,7 @@
     <meta name="viewport" content="width=device-width" />
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
@@ -70,7 +70,7 @@
                                             <a class="try-editor form" data-type="docxf">Form template</a>
                                         </li>
                                     </ul>
-                                    <label class="create-sample">
+                                    <label class="side-option">
                                         <input id="createSample" class="checkbox" type="checkbox" />With sample content
                                     </label>
                                 </div>
@@ -86,7 +86,7 @@
                                     <tr>
                                         <td valign="middle">
                                             <span class="select-user">Username</span>
-                                             <img class="info" src="content/images/info.svg" />
+                                             <img id="info" class="info" src="content/images/info.svg" />
                                              <select class="select-user" id="user">
                                             <% foreach (User user in Users.getAllUsers())
                                                { %>
@@ -97,7 +97,10 @@
                                     </tr>
                                     <tr>
                                         <td valign="middle">
-                                            <span class="select-user">Language editors interface</span>
+                                            <span class="select-user">Language</span>
+                                            <img class="info info-tooltip" data-id="language"
+                                                 data-tooltip="Choose the language for ONLYOFFICE editors interface"
+                                                 src="content/images/info.svg" />
                                             <select class="select-user" id="language">
                                                 <% Dictionary<string, string> languages = DocManagerHelper.GetLanguages(); 
                                                 foreach (var lang in languages)
@@ -107,6 +110,14 @@
                                             </select>
                                         </td>
                                     </tr>
+                                    <tr>
+                                        <td valign="middle">
+                                            <label class="side-option">
+                                                <input id="directUrl" type="checkbox" class="checkbox" />Try opening on client
+                                                <img id="directUrlInfo" class="info info-tooltip" data-id="directUrlInfo" data-tooltip="Some files can be opened in the user's browser without connecting to the document server." src="content/images/info.svg" />
+                                            </label>
+                                        </td>
+                                    </tr>
                                 </tbody>
                             </table>
                         </div>
@@ -156,7 +167,8 @@
                                             <tbody>
                                             <% foreach (var storedFile in storedFiles)
                                                {
-                                                    var editUrl = "doceditor.aspx?fileID=" + HttpUtility.UrlEncode(storedFile.Name);
+                                                            var isEnabledDirectUrl = DocManagerHelper.GetDirectUrl();
+                                                            var editUrl = "doceditor.aspx?fileID=" + HttpUtility.UrlEncode(storedFile.Name);
                                                             var docType = FileUtility.GetFileType(storedFile.Name).ToString().ToLower();
                                                             var ext = Path.GetExtension(storedFile.Name).ToLower();
                                                             var canEdit = DocManagerHelper.EditedExts.Contains(ext);
@@ -165,42 +177,42 @@
 
                                                             <tr class="tableRow" title="<%= storedFile.Name %> [<%= DocManagerHelper.GetFileVersion(storedFile.Name, HttpContext.Current.Request.UserHostAddress.Replace(':', '_')) %>]">
                                                                 <td class="contentCells">
-                                                                    <a class="stored-edit <%= docType %>" href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name }) %>" target="_blank">
+                                                                    <a class="stored-edit <%= docType %>" href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                         <span><%= storedFile.Name %></span>
                                                                     </a>
                                                                 </td>
                                                                 <% if (canEdit) { %>
                                                                     <td class="contentCells contentCells-icon">
-                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "edit" }) %>" target="_blank">
+                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "edit", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                             <img src="content/images/desktop.svg" alt="Open in editor for full size screens" title="Open in editor for full size screens"/>
                                                                         </a>
                                                                     </td>
                                                                     <td class="contentCells contentCells-icon">
-                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "edit" }) %>" target="_blank">
+                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "edit", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                             <img src="content/images/mobile.svg" alt="Open in editor for mobile devices" title="Open in editor for mobile devices"/>
                                                                         </a>
                                                                     </td>
                                                                     <td class="contentCells contentCells-icon">
-                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "comment" }) %>" target="_blank">
+                                                                        <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "comment", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                             <img src="content/images/comment.svg" alt="Open in editor for comment" title="Open in editor for comment"/>
                                                                         </a>
                                                                     </td>
                                                                     <% if (docType == "word") { %>
                                                                         <td class="contentCells contentCells-icon">
-                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "review" }) %>" target="_blank">
+                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "review", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                                 <img src="content/images/review.svg" alt="Open in editor for review" title="Open in editor for review"/>
                                                                             </a>
                                                                         </td>
                                                                     <% } else if (docType == "cell") { %>
                                                                         <td class="contentCells contentCells-icon">
-                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "filter" }) %>" target="_blank">
+                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "filter", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                                 <img src="content/images/filter.svg" alt="Open in editor without access to change the filter" title="Open in editor without access to change the filter" />
                                                                             </a>
                                                                          </td>
                                                                     <% } %>
                                                                     <% if (docType == "word") { %>
                                                                         <td class="contentCells contentCells-icon">
-                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "blockcontent" }) %>" target="_blank">
+                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "blockcontent", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                                 <img src="content/images/block-content.svg" alt="Open in editor without content control modification" title="Open in editor without content control modification"/>
                                                                             </a>
                                                                         </td>
@@ -212,7 +224,7 @@
                                                                     <% } %>
                                                                     <% if (isFillFormDoc) { %>
                                                                         <td class="contentCells contentCells-shift contentCells-icon firstContentCellShift">
-                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "fillForms" }) %>" target="_blank">
+                                                                            <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "fillForms", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                                 <img src="content/images/fill-forms.svg" alt="Open in editor for filling in forms" title="Open in editor for filling in forms"/>
                                                                             </a>
                                                                         </td>
@@ -222,7 +234,7 @@
                                                                 <% } else if (isFillFormDoc) { %>
                                                                     <td class="contentCells contentCells-icon "></td>
                                                                     <td class="contentCells contentCells-icon">
-                                                                       <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "fillForms" }) %>" target="_blank">
+                                                                       <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "fillForms", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                            <img src="content/images/mobile-fill-forms.svg" alt="Open in editor for filling in forms for mobile devices" title="Open in editor for filling in forms for mobile devices"/>
                                                                        </a>
                                                                     </td>
@@ -230,7 +242,7 @@
                                                                     <td class="contentCells contentCells-icon "></td>
                                                                     <td class="contentCells contentCells-icon "></td>
                                                                     <td class="contentCells contentCells-shift contentCells-icon firstContentCellShift">
-                                                                       <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "fillForms" }) %>" target="_blank">
+                                                                       <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "fillForms", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                            <img src="content/images/fill-forms.svg" alt="Open in editor for filling in forms" title="Open in editor for filling in forms"/>
                                                                        </a>
                                                                     </td>
@@ -238,17 +250,17 @@
                                                                     <td class="contentCells contentCells-shift contentCells-icon contentCellsEmpty" colspan="6"></td>
                                                                 <% } %>
                                                                 <td class="contentCells contentCells-icon firstContentCellViewers">
-                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "view" }) %>" target="_blank">
+                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "desktop", editorsMode = "view", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                         <img src="content/images/desktop.svg" alt="Open in viewer for full size screens" title="Open in viewer for full size screens"/>
                                                                     </a>
                                                                 </td>
                                                                 <td class="contentCells contentCells-icon">
-                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "view" }) %>" target="_blank">
+                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "mobile", editorsMode = "view", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                         <img src="content/images/mobile.svg" alt="Open in viewer for mobile devices" title="Open in viewer for mobile devices"/>
                                                                     </a>
                                                                 </td>
                                                                 <td class="contentCells contentCells-icon contentCells-shift">
-                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "embedded", editorsMode = "embedded" }) %>" target="_blank">
+                                                                    <a href="<%= Url.Action("Editor", "Home", new { fileName = storedFile.Name, editorsType = "embedded", editorsMode = "embedded", directUrl = isEnabledDirectUrl }) %>" target="_blank">
                                                                         <img src="content/images/embeded.svg" alt="Open in embedded mode" title="Open in embedded mode"/>
                                                                     </a>
                                                                 </td>

web/documentserver-example/csharp-mvc/Views/Shared/Error.aspx

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width" />
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.

web/documentserver-example/csharp-mvc/WebEditor.ashx.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -463,13 +463,13 @@ namespace OnlineEditorsExampleMVC
 
                 if (JwtManager.Enabled && isEmbedded == null)
                 {
-                    string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                    string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
                     if (context.Request.Headers.AllKeys.Contains(JWTheader, StringComparer.InvariantCultureIgnoreCase))
                     {
                         var headerToken = context.Request.Headers.Get(JWTheader).Substring("Bearer ".Length);
                         string token = JwtManager.Decode(headerToken);
-                        if (token == null || token.Equals(""))
+                        if (string.IsNullOrEmpty(token))
                         {
                             context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
                             context.Response.Write("JWT validation failed");
@@ -479,7 +479,7 @@ namespace OnlineEditorsExampleMVC
                 }
 
                 var filePath = DocManagerHelper.ForcesavePath(fileName, userAddress, false);  // get the path to the force saved document version
-                if (filePath.Equals(""))
+                if (string.IsNullOrEmpty(filePath))
                 {
                     filePath = DocManagerHelper.StoragePath(fileName, userAddress);  // or to the original document
                 }
@@ -520,14 +520,14 @@ namespace OnlineEditorsExampleMVC
 
                 if (JwtManager.Enabled)
                 {
-                    string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                    string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
                     if (context.Request.Headers.AllKeys.Contains(JWTheader, StringComparer.InvariantCultureIgnoreCase))
                     {
                         var headerToken = context.Request.Headers.Get(JWTheader).Substring("Bearer ".Length);
                         string token = JwtManager.Decode(headerToken);
 
-                        if (token == null || token.Equals(""))
+                        if (string.IsNullOrEmpty(token))
                         {
                             context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
                             context.Response.Write("JWT validation failed");

web/documentserver-example/csharp-mvc/web.appsettings.config

@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <appSettings>
   <clear />
-  <add key="version" value="1.4.0"/>
+  <add key="version" value="1.5.0"/>
 
   <add key="filesize-max" value="52428800"/>
   <add key="storage-path" value=""/>
@@ -16,7 +16,7 @@
 
   <add key="files.docservice.verify-peer-off" value="true"/>
 
-  <add key="files.docservice.languages" value="en:English|hy:Armenian|az:Azerbaijani|eu:Basque|be:Belarusian|bg:Bulgarian|ca:Catalan|zh:Chinese (People's Republic of China)|zh-TW:Chinese (Traditional, Taiwan)|cs:Czech|da:Danish|nl:Dutch|fi:Finnish|fr:French|gl:Galego|de:German|el:Greek|hu:Hungarian|id:Indonesian|it:Italian|ja:Japanese|ko:Korean|lv:Latvian|lo:Lao|ms:Malay (Malaysia)|nb:Norwegian|pl:Polish|pt:Portuguese (Brazil)|pt-PT:Portuguese (Portugal)|ro:Romanian|ru:Russian|sk:Slovak|sl:Slovenian|es:Spanish|sv:Swedish|tr:Turkish|uk:Ukrainian|vi:Vietnamese"/>
+  <add key="files.docservice.languages" value="en:English|hy:Armenian|az:Azerbaijani|eu:Basque|be:Belarusian|bg:Bulgarian|ca:Catalan|zh:Chinese (People's Republic of China)|zh-TW:Chinese (Traditional, Taiwan)|cs:Czech|da:Danish|nl:Dutch|fi:Finnish|fr:French|gl:Galego|de:German|el:Greek|hu:Hungarian|id:Indonesian|it:Italian|ja:Japanese|ko:Korean|lv:Latvian|lo:Lao|ms:Malay (Malaysia)|nb:Norwegian|pl:Polish|pt:Portuguese (Brazil)|pt-PT:Portuguese (Portugal)|ro:Romanian|ru:Russian|sk:Slovak|sl:Slovenian|es:Spanish|sv:Swedish|tr:Turkish|uk:Ukrainian|vi:Vietnamese|aa-AA: Test Language"/>
 
   <add key="files.docservice.url.site" value="http://documentserver/"/>
 

web/documentserver-example/csharp/App_Themes/media.css

@@ -1,4 +1,22 @@
-@media (min-width: 1280px)  and (max-width: 1380px) {
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+ @media (min-width: 1280px)  and (max-width: 1380px) {
     .copy {
         margin-right: 6.5%;
     }

web/documentserver-example/csharp/App_Themes/stylesheet.css

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -167,7 +167,7 @@ label .checkbox {
     background-image: url("images/file_docxf.svg");
 }
 
-.create-sample {
+.side-option {
     color: #666666;
     line-height: 24px;
 }
@@ -744,3 +744,28 @@ html {
 .user-descr > b {
     margin-left: 25px;
 }
+
+.tooltip {
+    background: #FFFFFF;
+    border-radius: 5px;
+    box-shadow: 0px 7px 25px rgba(85, 85, 85, 0.15);
+    color: #666666;
+    line-height: 160%;
+    max-width: 455px;
+    padding: 14px;
+    position: absolute;
+}
+
+    .tooltip ul {
+        margin: 0;
+    }
+
+.arrow {
+    border-top: 8px solid transparent;
+    border-bottom: 8px solid transparent;
+    border-right: 8px solid #FFFFFF;
+    left: -4px;
+    position: absolute;
+    top: 50%;
+    transform: translate(-50%, -50%);
+}

web/documentserver-example/csharp/Default.aspx

@@ -16,7 +16,7 @@
     <title>ONLYOFFICE</title>
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.
@@ -73,7 +73,7 @@
                                                 <a class="try-editor form" data-type="docxf">Form template</a>
                                             </li>
                                         </ul>
-                                        <label class="create-sample">
+                                        <label class="side-option">
                                             <input id="createSample" class="checkbox" type="checkbox" />With sample content
                                         </label>
                                     </div>
@@ -88,7 +88,7 @@
                                         <tr>
                                             <td valign="middle">
                                                 <span class="select-user">Username</span>
-                                                <img class="info" src="app_themes/images/info.svg" />
+                                                <img id="info" class="info" src="app_themes/images/info.svg" />
                                                 <select class="select-user" id="user">
                                                     <% foreach (User user in Users.getAllUsers())
                                                        { %>
@@ -99,7 +99,10 @@
                                         </tr>
                                         <tr>
                                             <td valign="middle">
-                                                <span class="select-user">Language editors interface</span>
+                                                <span class="select-user">Language</span>
+                                            <img class="info info-tooltip" data-id="language"
+                                                 data-tooltip="Choose the language for ONLYOFFICE editors interface"
+                                                 src="app_themes/images/info.svg" />
                                                 <select class="select-user" id="language">
                                                     <% Dictionary<string, string> languages = GetLanguages(); 
                                                     foreach (var lang in languages)
@@ -109,6 +112,14 @@
                                                 </select>
                                             </td>
                                         </tr>
+                                        <tr>
+                                        <td valign="middle">
+                                            <label class="side-option">
+                                                <input id="directUrl" type="checkbox" class="checkbox" />Try opening on client
+                                                <img id="directUrlInfo" class="info info-tooltip" data-id="directUrlInfo" data-tooltip="Some files can be opened in the user's browser without connecting to the document server." src="app_themes/images/info.svg" />
+                                            </label>
+                                        </td>
+                                    </tr>
                                     </tbody>
                                 </table>
                             </div>
@@ -158,7 +169,8 @@
                                                 <tbody>
                                                 <%  foreach (var storedFile in storedFiles)
                                                     {
-                                                        var editUrl = "doceditor.aspx?fileID=" + HttpUtility.UrlEncode(storedFile.Name);
+                                                        var directUrlParam = GetDirectUrlParam();
+                                                        var editUrl = "doceditor.aspx?fileID=" + HttpUtility.UrlEncode(storedFile.Name) + directUrlParam;
                                                         var ext = Path.GetExtension(storedFile.Name).ToLower();
                                                         var docType = DocumentType(storedFile.Name);
                                                         var canEdit = EditedExts.Contains(ext);

web/documentserver-example/csharp/Default.aspx.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -626,5 +626,11 @@ namespace OnlineEditorsExample
             }
             return languages;
         }
+
+        public static string GetDirectUrlParam()
+        {
+            string isEnabledDirectUrl = HttpUtility.ParseQueryString(HttpContext.Current.Request.Url.Query).Get("directUrl");
+            return "&directUrl=" + (isEnabledDirectUrl != null ? isEnabledDirectUrl : "false");
+        }
     }
 }

web/documentserver-example/csharp/DocEditor.aspx

@@ -15,7 +15,7 @@
     <title>ONLYOFFICE</title>
     <!--
     *
-    * (c) Copyright Ascensio System SIA 2021
+    * (c) Copyright Ascensio System SIA 2023
     *
     * Licensed under the Apache License, Version 2.0 (the "License");
     * you may not use this file except in compliance with the License.

web/documentserver-example/csharp/DocEditor.aspx.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -195,7 +195,7 @@ namespace OnlineEditorsExample
                             {
                                 { "title", FileName },
                                 { "url", getDownloadUrl(FileName) },
-                                { "directUrl", directUrl },
+                                { "directUrl", IsEnabledDirectUrl() ? directUrl : "" },
                                 { "fileType", ext.Trim('.') },
                                 { "key", Key },
                                 {
@@ -377,7 +377,12 @@ namespace OnlineEditorsExample
                     }
 
                     dataObj.Add("url", prevFileUrl);  // write file url to the data object
-                    dataObj.Add("directUrl", directPrevFileUrl);  // write direct url to the data object
+
+                    if (IsEnabledDirectUrl())
+                    {
+                        dataObj.Add("directUrl", directPrevFileUrl); // write direct url to the data object
+                    } 
+
                     dataObj.Add("version", i);
                     if (i > 1)  // check if the version number is greater than 1 (the file was modified)
                     {
@@ -395,12 +400,19 @@ namespace OnlineEditorsExample
                         obj.Add("user", change.Count > 0 ? change["user"] : null);
 
                         var prev = (Dictionary<string, object>)histData[(i - 2).ToString()];  // get the history data from the previous file version
-                        dataObj.Add("previous", new Dictionary<string, object>() {  // write information about previous file version to the data object
+
+                        Dictionary<string, object> dataPrev = new Dictionary<string, object>() {  // write information about previous file version to the data object
                             { "fileType", prev["fileType"] },
                             { "key", prev["key"] },  // write key and url information about previous file version
-                            { "url", prev["url"] },
-                            { "directUrl", prev["directUrl"] },
-                        });
+                            { "url", prev["url"] }
+                        };
+
+                        if (IsEnabledDirectUrl())
+                        {
+                            dataPrev.Add("directUrl", prev["directUrl"]);
+                        }
+
+                        dataObj.Add("previous", dataPrev);
                         // write the path to the diff.zip archive with differences in this file version
                         var changesUrl = MakePublicHistoryUrl(FileName, (i - 1).ToString(), "diff.zip");
                         dataObj.Add("changesUrl", changesUrl);
@@ -442,10 +454,14 @@ namespace OnlineEditorsExample
             Dictionary<string, object> logoConfig = new Dictionary<string, object>
                 {
                     { "fileType", "png"},
-                    { "url", InsertImageUrl.ToString()},
-                    { "directUrl", DirectImageUrl.ToString()}
+                    { "url", InsertImageUrl.ToString()}
                 };
 
+            if (IsEnabledDirectUrl())
+            {
+                logoConfig.Add("directUrl", DirectImageUrl.ToString());
+            }
+
             if (JwtManager.Enabled)  // if the secret key to generate token exists
             {
                 var insImageToken = JwtManager.Encode(logoConfig);  // encode logoConfig into the token
@@ -475,10 +491,14 @@ namespace OnlineEditorsExample
             Dictionary<string, object> dataCompareFile = new Dictionary<string, object>
                 {
                     { "fileType", "docx" },
-                    { "url", compareFileUrl.ToString() },
-                    { "directUrl", DirectFileUrl.ToString() }
+                    { "url", compareFileUrl.ToString() }
                 };
 
+            if (IsEnabledDirectUrl())
+            {
+                dataCompareFile.Add("directUrl", DirectFileUrl.ToString());
+            }
+
             if (JwtManager.Enabled)  // if the secret key to generate token exists
             {
                 var compareFileToken = JwtManager.Encode(dataCompareFile);  // encode the dataCompareFile object into the token
@@ -510,10 +530,14 @@ namespace OnlineEditorsExample
             Dictionary<string, object> mailMergeConfig = new Dictionary<string, object>
                 {
                     { "fileType", "csv" },
-                    { "url", mailmergeUrl.ToString() },
-                    { "directUrl", DirectMailMergeUrl.ToString() }
+                    { "url", mailmergeUrl.ToString() }
                 };
 
+            if (IsEnabledDirectUrl())
+            {
+                mailMergeConfig.Add("directUrl", DirectMailMergeUrl.ToString());
+            }
+
             if (JwtManager.Enabled)  // if the secret key to generate token exists
             {
                 var mailmergeToken = JwtManager.Encode(mailMergeConfig);  // encode mailMergeConfig into the token
@@ -615,5 +639,12 @@ namespace OnlineEditorsExample
                 { "name", uname }
             }));
         }
+
+        // get direct url flag
+        private static bool IsEnabledDirectUrl()
+        {
+            string isEnabledDirectUrl = HttpUtility.ParseQueryString(HttpContext.Current.Request.Url.Query).Get("directUrl");
+            return isEnabledDirectUrl != null ? Convert.ToBoolean(isEnabledDirectUrl) : false;
+        }
     }
 }

web/documentserver-example/csharp/DocumentConverter.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -132,7 +132,7 @@ namespace ASC.Api.DocumentConverter
                 var payloadToken =  JwtManager.Encode(payload);  // encode the payload object to the payload token
                 var bodyToken = JwtManager.Encode(body);  // encode the body object to the body token
                 // create header token
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
                 request.Headers.Add(JWTheader, "Bearer " + payloadToken);  // and add it to the request headers with the Bearer prefix
 
                 body.Add("token", bodyToken);

web/documentserver-example/csharp/JwtManager.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp/Properties/AssemblyInfo.cs

@@ -7,7 +7,7 @@ using System.Runtime.InteropServices;
 [assembly: AssemblyConfiguration("")]
 [assembly: AssemblyCompany("Ascensio System SIA")]
 [assembly: AssemblyProduct("OnlineEditorsExample")]
-[assembly: AssemblyCopyright("Ascensio System SIA 2021")]
+[assembly: AssemblyCopyright("Ascensio System SIA 2023")]
 [assembly: AssemblyTrademark("")]
 [assembly: AssemblyCulture("")]
 

web/documentserver-example/csharp/TrackManager.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -57,7 +57,7 @@ namespace OnlineEditorsExample
             // check if the document token is enabled
             if (JwtManager.Enabled)
             {
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
                 string token = null;
 
@@ -76,7 +76,7 @@ namespace OnlineEditorsExample
                     context.Response.Write("{\"error\":1,\"message\":\"JWT expected\"}");
                 }
 
-                if (token != null && !token.Equals(""))  // invalid signature error
+                if (!string.IsNullOrEmpty(token))  // invalid signature error
                 {
                     fileData = jss.Deserialize<Dictionary<string, object>>(token);
                     if (fileData.ContainsKey("payload"))
@@ -100,9 +100,7 @@ namespace OnlineEditorsExample
             var downloadUri = (string)fileData["url"];
             var curExt = Path.GetExtension(fileName).ToLower();  // get current file extension
 
-            var downloadExt = fileData.ContainsKey("filetype")
-                ? "." + (string)fileData["filetype"]
-                : Path.GetExtension(downloadUri).ToLower() ?? ""; // TODO: Delete in version 7.0 or higher. Support for versions below 7.0
+            var downloadExt = "." + (string)fileData["filetype"];  // get the extension of the downloaded file
 
             var newFileName = fileName;
 
@@ -160,7 +158,7 @@ namespace OnlineEditorsExample
             File.WriteAllText(Path.Combine(versionDir, "key.txt"), (string)fileData["key"]);  // write the key value to the key.txt file
 
             string forcesavePath = _Default.ForcesavePath(newFileName, userAddress, false);  // get the path to the forcesaved file version
-            if (!forcesavePath.Equals(""))  // if the forcesaved file version exists
+            if (!string.IsNullOrEmpty(forcesavePath))  // if the forcesaved file version exists
             {
                 File.Delete(forcesavePath);  // remove it
             }
@@ -178,9 +176,7 @@ namespace OnlineEditorsExample
 
             string curExt = Path.GetExtension(fileName).ToLower();  // get current file extension
 
-            var downloadExt = fileData.ContainsKey("filetype")
-                ? "." + (string)fileData["filetype"]
-                : Path.GetExtension(downloadUri).ToLower(); // TODO: Delete in version 7.0 or higher. Support for versions below 7.0
+            var downloadExt = "." + (string)fileData["filetype"];  // get the extension of the downloaded file
 
             Boolean newFileName = false;
 
@@ -231,7 +227,7 @@ namespace OnlineEditorsExample
                 }
 
                 forcesavePath = _Default.ForcesavePath(fileName, userAddress, false);
-                if (forcesavePath.Equals(""))  // create forcesave path if it doesn't exist
+                if (string.IsNullOrEmpty(forcesavePath))  // create forcesave path if it doesn't exist
                 {
                     forcesavePath = _Default.ForcesavePath(fileName, userAddress, true);
                 }
@@ -282,7 +278,7 @@ namespace OnlineEditorsExample
 
                 var payloadToken = JwtManager.Encode(payload);  // encode a payload object into a header token
                 var bodyToken = JwtManager.Encode(body);  // encode body into a body token
-                string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
                 request.Headers.Add(JWTheader, "Bearer " + payloadToken);  // add a header Authorization with a header token and Authorization prefix in it
 
                 body.Add("token", bodyToken);
@@ -324,6 +320,7 @@ namespace OnlineEditorsExample
             if (string.IsNullOrEmpty(path)) throw new ArgumentException("path");  // file isn't specified
 
             var req = (HttpWebRequest)WebRequest.Create(url);
+            req.Timeout = 5000;
             using (var stream = req.GetResponse().GetResponseStream())  // get input stream of the file information from the url
             {
                 if (stream == null) throw new Exception("stream is null");

web/documentserver-example/csharp/Users.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp/Utils.cs

@@ -1,4 +1,22 @@
-using System.Web;
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+using System.Web;
 
 namespace OnlineEditorsExample
 {

web/documentserver-example/csharp/WebEditor.ashx.cs

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -283,14 +283,14 @@ namespace OnlineEditorsExample
 
                 if (JwtManager.Enabled && isEmbedded == null)
                 {
-                    string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                    string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
                     if (context.Request.Headers.AllKeys.Contains(JWTheader, StringComparer.InvariantCultureIgnoreCase))
                     {
                         var headerToken = context.Request.Headers.Get(JWTheader).Substring("Bearer ".Length);
                         string token = JwtManager.Decode(headerToken);
 
-                        if (token == null || token.Equals(""))
+                        if (string.IsNullOrEmpty(token))
                         {
                             context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
                             context.Response.Write("JWT validation failed");
@@ -300,7 +300,7 @@ namespace OnlineEditorsExample
                 }
 
                 var filePath = _Default.ForcesavePath(fileName, userAddress, false);  // get the path to the force saved document version
-                if (filePath.Equals(""))
+                if (string.IsNullOrEmpty(filePath))
                 {
                     filePath = _Default.StoragePath(fileName, userAddress);  // or to the original document
                 }
@@ -340,14 +340,14 @@ namespace OnlineEditorsExample
 
                 if (JwtManager.Enabled)
                 {
-                    string JWTheader = WebConfigurationManager.AppSettings["files.docservice.header"].Equals("") ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
+                    string JWTheader = string.IsNullOrEmpty(WebConfigurationManager.AppSettings["files.docservice.header"]) ? "Authorization" : WebConfigurationManager.AppSettings["files.docservice.header"];
 
                     if (context.Request.Headers.AllKeys.Contains(JWTheader, StringComparer.InvariantCultureIgnoreCase))
                     {
                         var headerToken = context.Request.Headers.Get(JWTheader).Substring("Bearer ".Length);
                         string token = JwtManager.Decode(headerToken);
 
-                        if (token == null || token.Equals(""))
+                        if (string.IsNullOrEmpty(token))
                         {
                             context.Response.StatusCode = (int)HttpStatusCode.Forbidden;
                             context.Response.Write("JWT validation failed");

web/documentserver-example/csharp/script/jquery.dropdownToggle.js

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/csharp/script/jscript.js

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,11 +16,24 @@
  *
  */
 
+var directUrl;
+
 if (typeof jQuery != "undefined") {
     jq = jQuery.noConflict();
 
+    directUrl = getUrlVars()["directUrl"] == "true";
+
     mustReload = false;
 
+    if (directUrl)
+        jq("#directUrl").prop("checked", directUrl);
+    else
+        directUrl = jq("#directUrl").prop("checked");
+
+    jq("#directUrl").change(function () {
+        window.location = "?directUrl=" + jq(this).prop("checked");
+    });
+
     jq(function () {
         jq('#fileupload').fileupload({
             dataType: 'json',
@@ -219,7 +232,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginEdit:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = "doceditor.aspx?fileID=" + fileId;
+        var url = "doceditor.aspx?fileID=" + fileId + "&directUrl=" + directUrl;
         window.open(url, "_blank");
         jq('#hiddenFileName').val("");
         jq.unblockUI();
@@ -227,7 +240,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginView:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = "doceditor.aspx?editorsMode=view&fileID=" + fileId;
+        var url = "doceditor.aspx?editorsMode=view&fileID=" + fileId + "&directUrl=" + directUrl;
         window.open(url, "_blank");
         jq('#hiddenFileName').val("");
         jq.unblockUI();
@@ -235,7 +248,7 @@ if (typeof jQuery != "undefined") {
 
     jq(document).on("click", "#beginEmbedded:not(.disable)", function () {
         var fileId = encodeURIComponent(jq('#hiddenFileName').val());
-        var url = "doceditor.aspx?editorsType=embedded&editorsMode=embedded&fileID=" + fileId;
+        var url = "doceditor.aspx?editorsType=embedded&editorsMode=embedded&fileID=" + fileId + "&directUrl=" + directUrl;
 
         jq("#mainProgress").addClass("embedded");
         jq("#beginEmbedded").addClass("disable");
@@ -288,6 +301,17 @@ if (typeof jQuery != "undefined") {
         }
     };
 
+    function getUrlVars() {
+        var vars = [], hash;
+        var hashes = window.location.href.slice(window.location.href.indexOf('?') + 1).split('&');
+        for (var i = 0; i < hashes.length; i++) {
+            hash = hashes[i].split('=');
+            vars.push(hash[0]);
+            vars[hash[0]] = hash[1];
+        }
+        return vars;
+    };
+
     var fileList = jq("tr.tableRow");
 
     var mouseIsOverTooltip = false;
@@ -298,12 +322,12 @@ if (typeof jQuery != "undefined") {
                 if (hideTooltipTimeout != null) {
                     clearTimeout(hideTooltipTimeout);
                 }
-                jq(".info").on("touchend", function () {
+                jq("#info").on("touchend", function () {
                     showUserTooltip(true);
                 });
             }
     } else {
-        jq(".info").mouseover(function (event) {
+        jq("#info").mouseover(function (event) {
             if (fileList.length > 0) {
                 if (hideTooltipTimeout != null) {
                     clearTimeout(hideTooltipTimeout);
@@ -327,4 +351,18 @@ if (typeof jQuery != "undefined") {
             }, 500);
         });
     }
+
+    jq(".info-tooltip").mouseover(function (event) {
+        var target = event.target;
+        var id = target.dataset.id ? target.dataset.id : target.id;
+        var tooltip = target.dataset.tooltip;
+
+        jq("<div class='tooltip'>" + tooltip + "<div class='arrow'></div></div>").appendTo("body");
+
+        var top = jq("#" + id).offset().top + jq("#" + id).outerHeight() / 2 - jq("div.tooltip").outerHeight() / 2;
+        var left = jq("#" + id).offset().left + jq("#" + id).outerWidth() + 20;
+        jq("div.tooltip").css({ "top": top, "left": left });
+    }).mouseout(function () {
+        jq("div.tooltip").remove();
+    });
 }

web/documentserver-example/csharp/settings.config

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <appSettings>
   <clear />
-  <add key="version" value="1.4.0"/>
+  <add key="version" value="1.5.0"/>
 
   <add key="filesize-max" value="52428800"/>
   <add key="storage-path" value=""/>
@@ -15,7 +15,7 @@
   <add key="files.docservice.header" value="Authorization" />
   <add key="files.docservice.verify-peer-off" value="true"/>
 
-  <add key="files.docservice.languages" value="en:English|hy:Armenian|az:Azerbaijani|eu:Basque|be:Belarusian|bg:Bulgarian|ca:Catalan|zh:Chinese (People's Republic of China)|zh-TW:Chinese (Traditional, Taiwan)|cs:Czech|da:Danish|nl:Dutch|fi:Finnish|fr:French|gl:Galego|de:German|el:Greek|hu:Hungarian|id:Indonesian|it:Italian|ja:Japanese|ko:Korean|lv:Latvian|lo:Lao|ms:Malay (Malaysia)|nb:Norwegian|pl:Polish|pt:Portuguese (Brazil)|pt-PT:Portuguese (Portugal)|ro:Romanian|ru:Russian|sk:Slovak|sl:Slovenian|es:Spanish|sv:Swedish|tr:Turkish|uk:Ukrainian|vi:Vietnamese"/>
+  <add key="files.docservice.languages" value="en:English|hy:Armenian|az:Azerbaijani|eu:Basque|be:Belarusian|bg:Bulgarian|ca:Catalan|zh:Chinese (People's Republic of China)|zh-TW:Chinese (Traditional, Taiwan)|cs:Czech|da:Danish|nl:Dutch|fi:Finnish|fr:French|gl:Galego|de:German|el:Greek|hu:Hungarian|id:Indonesian|it:Italian|ja:Japanese|ko:Korean|lv:Latvian|lo:Lao|ms:Malay (Malaysia)|nb:Norwegian|pl:Polish|pt:Portuguese (Brazil)|pt-PT:Portuguese (Portugal)|ro:Romanian|ru:Russian|sk:Slovak|sl:Slovenian|es:Spanish|sv:Swedish|tr:Turkish|uk:Ukrainian|vi:Vietnamese|aa-AA: Test Language"/>
 
   <add key="files.docservice.url.site" value="http://documentserver/"/>
 

web/documentserver-example/java-spring/README.md

@@ -139,11 +139,11 @@ See the detailed guide to learn how to install Document Server [for Linux](https
     a) archive with Java-Spring:
 
     ```
-    wget https://api.onlyoffice.com/app_data/editor/Java-Spring%20Example.zip
+    wget https://api.onlyoffice.com/app_data/editor/Java%20Spring%20Example.zip
     ```
     
     ```
-    unzip Java-Spring\ Example.zip
+    unzip Java\ Spring\ Example.zip
     ```
     b) git repository:
     ```
@@ -156,7 +156,7 @@ See the detailed guide to learn how to install Document Server [for Linux](https
     a) from archive
 
     ```
-   cd Java-Spring\ Example/
+   cd Java\ Spring\ Example/
    ```
    b) from git repository 
     ```

web/documentserver-example/java-spring/checkstyle-suppressions.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0"?>
+<!DOCTYPE suppressions PUBLIC
+        "-//Checkstyle//DTD SuppressionFilter Configuration 1.0//EN"
+        "https://checkstyle.org/dtds/suppressions_1_0.dtd">
+
+<suppressions>
+    <suppress checks="HideUtilityClassConstructor" files="IntegrationApplication.java"/>
+    <suppress checks="DesignForExtension" files="."/>
+    <suppress checks="ParameterNumber" files="."/>
+    <suppress checks="JavadocPackage" files="."/>
+    <suppress checks="JavadocVariable" files="."/>
+    <suppress checks="MissingJavadocMethod" files="."/>
+</suppressions>

web/documentserver-example/java-spring/checkstyle.xml

@@ -0,0 +1,199 @@
+<?xml version="1.0"?>
+<!DOCTYPE module PUBLIC
+        "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+        "https://checkstyle.org/dtds/configuration_1_3.dtd">
+
+<!--
+
+  Checkstyle configuration that checks the sun coding conventions from:
+
+    - the Java Language Specification at
+      https://docs.oracle.com/javase/specs/jls/se11/html/index.html
+
+    - the Sun Code Conventions at https://www.oracle.com/java/technologies/javase/codeconventions-contents.html
+
+    - the Javadoc guidelines at
+      https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html
+
+    - the JDK Api documentation https://docs.oracle.com/en/java/javase/11/
+
+    - some best practices
+
+  Checkstyle is very configurable. Be sure to read the documentation at
+  https://checkstyle.org (or in your downloaded distribution).
+
+  Most Checks are configurable, be sure to consult the documentation.
+
+  To completely disable a check, just comment it out or delete it from the file.
+  To suppress certain violations please review suppression filters.
+
+  Finally, it is worth reading the documentation.
+
+-->
+
+<module name="Checker">
+    <!--
+        If you set the basedir property below, then all reported file
+        names will be relative to the specified directory. See
+        https://checkstyle.org/config.html#Checker
+
+        <property name="basedir" value="${basedir}"/>
+    -->
+    <property name="severity" value="error"/>
+
+    <property name="fileExtensions" value="java, properties, xml"/>
+
+    <!-- Excludes all 'module-info.java' files              -->
+    <!-- See https://checkstyle.org/config_filefilters.html -->
+    <module name="BeforeExecutionExclusionFileFilter">
+        <property name="fileNamePattern" value="module\-info\.java$"/>
+    </module>
+
+    <!-- https://checkstyle.org/config_filters.html#SuppressionFilter -->
+    <module name="SuppressionFilter">
+        <property name="file" value="${org.checkstyle.sun.suppressionfilter.config}"
+                  default="checkstyle-suppressions.xml" />
+        <property name="optional" value="true"/>
+    </module>
+
+    <!-- Checks that a package-info.java file exists for each package.     -->
+    <!-- See https://checkstyle.org/config_javadoc.html#JavadocPackage -->
+    <module name="JavadocPackage"/>
+
+    <!-- Checks whether files end with a new line.                        -->
+    <!-- See https://checkstyle.org/config_misc.html#NewlineAtEndOfFile -->
+    <module name="NewlineAtEndOfFile"/>
+
+    <!-- Checks that property files contain the same keys.         -->
+    <!-- See https://checkstyle.org/config_misc.html#Translation -->
+    <module name="Translation"/>
+
+    <!-- Checks for Size Violations.                    -->
+    <!-- See https://checkstyle.org/config_sizes.html -->
+    <module name="FileLength"/>
+    <module name="LineLength">
+        <property name="fileExtensions" value="java"/>
+        <property name="max" value="120"/>
+    </module>
+
+    <!-- Checks for whitespace                               -->
+    <!-- See https://checkstyle.org/config_whitespace.html -->
+    <module name="FileTabCharacter"/>
+
+    <!-- Miscellaneous other checks.                   -->
+    <!-- See https://checkstyle.org/config_misc.html -->
+    <module name="RegexpSingleline">
+        <property name="format" value="\s+$"/>
+        <property name="minimum" value="0"/>
+        <property name="maximum" value="0"/>
+        <property name="message" value="Line has trailing spaces."/>
+    </module>
+
+    <!-- Checks for Headers                                -->
+    <!-- See https://checkstyle.org/config_header.html   -->
+     <module name="Header">
+       <property name="headerFile" value="onlyoffice.header"/>
+       <property name="fileExtensions" value="java"/>
+     </module>
+
+    <module name="TreeWalker">
+
+        <!-- Checks for Javadoc comments.                     -->
+        <!-- See https://checkstyle.org/config_javadoc.html -->
+        <module name="InvalidJavadocPosition"/>
+        <module name="JavadocMethod"/>
+        <module name="JavadocType"/>
+        <module name="JavadocVariable"/>
+        <module name="JavadocStyle"/>
+        <module name="MissingJavadocMethod"/>
+
+        <!-- Checks for Naming Conventions.                  -->
+        <!-- See https://checkstyle.org/config_naming.html -->
+        <module name="ConstantName"/>
+        <module name="LocalFinalVariableName"/>
+        <module name="LocalVariableName"/>
+        <module name="MemberName"/>
+        <module name="MethodName"/>
+        <module name="PackageName"/>
+        <module name="ParameterName"/>
+        <module name="StaticVariableName"/>
+        <module name="TypeName"/>
+
+        <!-- Checks for imports                              -->
+        <!-- See https://checkstyle.org/config_imports.html -->
+        <module name="AvoidStarImport"/>
+        <module name="IllegalImport"/> <!-- defaults to sun.* packages -->
+        <module name="RedundantImport"/>
+        <module name="UnusedImports">
+            <property name="processJavadoc" value="false"/>
+        </module>
+
+        <!-- Checks for Size Violations.                    -->
+        <!-- See https://checkstyle.org/config_sizes.html -->
+        <module name="MethodLength"/>
+        <module name="ParameterNumber"/>
+
+        <!-- Checks for whitespace                               -->
+        <!-- See https://checkstyle.org/config_whitespace.html -->
+        <module name="EmptyForIteratorPad"/>
+        <module name="GenericWhitespace"/>
+        <module name="MethodParamPad"/>
+        <module name="NoWhitespaceAfter"/>
+        <module name="NoWhitespaceBefore"/>
+        <module name="OperatorWrap"/>
+        <module name="ParenPad"/>
+        <module name="TypecastParenPad"/>
+        <module name="WhitespaceAfter"/>
+        <module name="WhitespaceAround"/>
+
+        <!-- Modifier Checks                                    -->
+        <!-- See https://checkstyle.org/config_modifier.html -->
+        <module name="ModifierOrder"/>
+        <module name="RedundantModifier"/>
+
+        <!-- Checks for blocks. You know, those {}'s         -->
+        <!-- See https://checkstyle.org/config_blocks.html -->
+        <module name="AvoidNestedBlocks"/>
+        <module name="EmptyBlock"/>
+        <module name="LeftCurly"/>
+        <module name="NeedBraces"/>
+        <module name="RightCurly"/>
+
+        <!-- Checks for common coding problems               -->
+        <!-- See https://checkstyle.org/config_coding.html -->
+        <module name="EmptyStatement"/>
+        <module name="EqualsHashCode"/>
+        <module name="HiddenField"/>
+        <module name="IllegalInstantiation"/>
+        <module name="InnerAssignment"/>
+        <module name="MagicNumber"/>
+        <module name="MissingSwitchDefault"/>
+        <module name="MultipleVariableDeclarations"/>
+        <module name="SimplifyBooleanExpression"/>
+        <module name="SimplifyBooleanReturn"/>
+
+        <!-- Checks for class design                         -->
+        <!-- See https://checkstyle.org/config_design.html -->
+        <module name="DesignForExtension"/>
+        <module name="FinalClass"/>
+        <module name="HideUtilityClassConstructor"/>
+        <module name="InterfaceIsType"/>
+        <module name="VisibilityModifier"/>
+
+        <!-- Miscellaneous other checks.                   -->
+        <!-- See https://checkstyle.org/config_misc.html -->
+        <module name="ArrayTypeStyle"/>
+        <module name="FinalParameters"/>
+        <module name="TodoComment"/>
+        <module name="UpperEll"/>
+
+        <!-- https://checkstyle.org/config_filters.html#SuppressionXpathFilter -->
+        <module name="SuppressionXpathFilter">
+            <property name="file" value="${org.checkstyle.sun.suppressionxpathfilter.config}"
+                      default="checkstyle-xpath-suppressions.xml" />
+            <property name="optional" value="true"/>
+        </module>
+
+    </module>
+
+</module>

web/documentserver-example/java-spring/onlyoffice.header

@@ -0,0 +1,17 @@
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */

web/documentserver-example/java-spring/pom.xml

@@ -86,14 +86,13 @@
 			<plugin>
 				<groupId>org.apache.maven.plugins</groupId>
 				<artifactId>maven-checkstyle-plugin</artifactId>
-				<version>2.17</version>
+				<version>3.2.0</version>
 				<executions>
 					<execution>
 						<id>validate</id>
 						<phase>validate</phase>
 						<configuration>
-							<configLocation>google_checks.xml</configLocation>
-							<encoding>UTF-8</encoding>
+							<configLocation>checkstyle.xml</configLocation>
 							<failsOnError>true</failsOnError>
 							<failOnViolation>true</failOnViolation>
 							<logViolationsToConsole>true</logViolationsToConsole>

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/ExampleData.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -32,8 +32,9 @@ public class ExampleData {
     @Autowired
     private UserServices userService;
     @PostConstruct
-    public void init(){
-        List<String> description_user_0=List.of(  // the description for user 0
+    public void init() {
+        // the description for user 0
+        List<String> descriptionUserZero = List.of(
                 "The name is requested when the editor is opened",
                 "Doesn’t belong to any group",
                 "Can review all the changes",
@@ -46,7 +47,9 @@ public class ExampleData {
                 "Can't view chat",
                 "View file without collaboration"
         );
-        List<String> description_user_1 = List.of(  // the description for user 1
+
+        // the description for user 1
+        List<String> descriptionUserFirst = List.of(
                 "File author by default",
                 "He doesn’t belong to any of the groups",
                 "He can review all the changes",
@@ -56,19 +59,26 @@ public class ExampleData {
                 "Can see the information about all users",
                 "Can view chat"
         );
-        List<String> description_user_2 = List.of(  // the description for user 2
+
+        // the description for user 2
+        List<String> descriptionUserSecond = List.of(
                 "He belongs to Group2",
-                "He can review only his own changes or the changes made by the users who don’t belong to any of the groups",
-                "He can view every comment, edit his comments and the comments left by the users who don't belong to any of the groups and remove only his comments",
+                "He can review only his own changes or the changes made by the users who don’t belong"
+                        + " to any of the groups",
+                "He can view every comment, edit his comments and the comments left by the users "
+                        + "who don't belong to any of the groups and remove only his comments",
                 "This file is favorite",
                 "Can create a file from an editor",
                 "Can see the information about users from Group2 and users who don’t belong to any group",
                 "Can view chat"
         );
-        List<String> description_user_3 = List.of(  // the description for user 3
+
+        // the description for user 3
+        List<String> descriptionUserThird = List.of(
                 "He belongs to Group3",
                 "He can review only the changes made by the users from Group2",
-                "He can view the comments left by the users from Group2 and Group3 and edit the comments left by the users from Group2",
+                "He can view the comments left by the users from Group2 and Group3 and edit the comments left by "
+                        + "the users from Group2",
                 "This file isn’t favorite",
                 "He can’t copy data from the file into the clipboard",
                 "He can’t download the file",
@@ -77,24 +87,27 @@ public class ExampleData {
                 "Can see the information about Group2 users",
                 "Can view chat"
         );
-        userService.createUser("John Smith", "smith@example.com",  // create user 1 with the specified parameters
-                description_user_1, "", List.of(FilterState.NULL.toString()),
-                List.of(FilterState.NULL.toString()),
-                List.of(FilterState.NULL.toString()),
-                List.of(FilterState.NULL.toString()),
-                List.of(FilterState.NULL.toString()),
-                null, true);
-        userService.createUser("Mark Pottato", "pottato@example.com",  // create user 2 with the specified parameters
-                description_user_2, "group-2", List.of("","group-2"), List.of(FilterState.NULL.toString()),
-                List.of("group-2", ""), List.of("group-2"), List.of("group-2", ""), true,
-                true);
-        userService.createUser("Hamish Mitchell", "mitchell@example.com",  // create user 3 with the specified parameters
-                description_user_3, "group-3", List.of("group-2"), List.of("group-2", "group-3"),
-                List.of("group-2"), new ArrayList<>(), List.of("group-2"), false,
-                true);
-        userService.createUser("Anonymous",null,  // create user 0 with the specified parameters
-                description_user_0,"", List.of(FilterState.NULL.toString()), List.of(FilterState.NULL.toString()),
-                List.of(FilterState.NULL.toString()), List.of(FilterState.NULL.toString()), new ArrayList<>(),null,
-                false);
+
+        // create user 1 with the specified parameters
+        userService.createUser("John Smith", "smith@example.com", descriptionUserFirst,
+                "", List.of(FilterState.NULL.toString()), List.of(FilterState.NULL.toString()),
+                List.of(FilterState.NULL.toString()), List.of(FilterState.NULL.toString()),
+                List.of(FilterState.NULL.toString()), null, true);
+
+        // create user 2 with the specified parameters
+        userService.createUser("Mark Pottato", "pottato@example.com", descriptionUserSecond,
+                "group-2", List.of("", "group-2"), List.of(FilterState.NULL.toString()),
+                List.of("group-2", ""), List.of("group-2"), List.of("group-2", ""), true, true);
+
+        // create user 3 with the specified parameters
+        userService.createUser("Hamish Mitchell", "mitchell@example.com", descriptionUserThird,
+                "group-3", List.of("group-2"), List.of("group-2", "group-3"), List.of("group-2"),
+                new ArrayList<>(), List.of("group-2"), false, true);
+
+        // create user 0 with the specified parameters
+        userService.createUser("Anonymous", null, descriptionUserZero, "",
+                List.of(FilterState.NULL.toString()), List.of(FilterState.NULL.toString()),
+                List.of(FilterState.NULL.toString()), List.of(FilterState.NULL.toString()),
+                new ArrayList<>(), null, false);
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/IntegrationApplication.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -24,9 +24,9 @@ import org.springframework.boot.autoconfigure.SpringBootApplication;
 @SpringBootApplication
 public class IntegrationApplication {
 
-	// run the SpringApplication from the IntagrationApplication with the specified parameters
-	public static void main(String[] args) {
-		SpringApplication.run(IntegrationApplication.class, args);
-	}
+    // run the SpringApplication from the IntagrationApplication with the specified parameters
+    public static void main(final String[] args) {
+        SpringApplication.run(IntegrationApplication.class, args);
+    }
 
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/IntegrationConfiguration.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -48,39 +48,40 @@ public class IntegrationConfiguration {
     private SSLUtils ssl;
 
     @Bean
-    public ModelMapper mapper(){  // create the model mapper
+    public ModelMapper mapper() {  // create the model mapper
         ModelMapper mapper = new ModelMapper();
         mapper.getConfiguration()  // get the mapper configuration and set new parameters to it
                 .setMatchingStrategy(MatchingStrategies.STRICT)  // specify the STRICT matching strategy
                 .setFieldMatchingEnabled(true)  // define if the field matching is enabled or not
                 .setSkipNullEnabled(true)  // define if null value will be skipped or not
-                .setFieldAccessLevel(org.modelmapper.config.Configuration.AccessLevel.PRIVATE);  // specify the PRIVATE field access level
+                .setFieldAccessLevel(org.modelmapper.config.Configuration.AccessLevel.PRIVATE);  /* specify
+                 the PRIVATE field access level */
         return mapper;
     }
 
     @Bean
-    public JSONParser jsonParser(){  // create JSON parser
+    public JSONParser jsonParser() {  // create JSON parser
         return new JSONParser();
     }
 
     @PostConstruct
-    public void init(){  // initialize the storage path builder
+    public void init() {  // initialize the storage path builder
         storagePathBuilder.configure(storageAddress.isBlank() ? null : storageAddress);
-        if(!verifyPerrOff.isEmpty()) {
-            try{
-                if(verifyPerrOff.equals("true")) {
+        if (!verifyPerrOff.isEmpty()) {
+            try {
+                if (verifyPerrOff.equals("true")) {
                     ssl.turnOffSslChecking(); //the certificate will be ignored
                 } else {
                     ssl.turnOnSslChecking(); //the certificate will be verified
                 }
-            } catch(Exception e) {
+            } catch (Exception e) {
                 e.printStackTrace();
             }
         }
     }
 
     @Bean
-    public ObjectMapper objectMapper(){  // create the object mapper
+    public ObjectMapper objectMapper() {  // create the object mapper
         return new ObjectMapper();
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/controllers/EditorController.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -40,7 +40,16 @@ import org.springframework.web.bind.annotation.CookieValue;
 import org.springframework.web.bind.annotation.CrossOrigin;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
-import java.util.*;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Optional;
+
+import static com.onlyoffice.integration.documentserver.util.Constants.ANONYMOUS_USER_ID;
 
 @CrossOrigin("*")
 @Controller
@@ -75,19 +84,25 @@ public class EditorController {
 
     @GetMapping(path = "${url.editor}")
     // process request to open the editor page
-    public String index(@RequestParam("fileName") String fileName,
-                        @RequestParam(value = "action", required = false) String actionParam,
-                        @RequestParam(value = "type", required = false) String typeParam,
-                        @RequestParam(value = "actionLink", required = false) String actionLink,
-                        @CookieValue(value = "uid") String uid,
-                        @CookieValue(value = "ulang") String lang,
-                        Model model) throws JsonProcessingException {
+    public String index(@RequestParam("fileName") final String fileName,
+                        @RequestParam(value = "action", required = false) final String actionParam,
+                        @RequestParam(value = "type", required = false) final String typeParam,
+                        @RequestParam(value = "actionLink", required = false) final String actionLink,
+                        @RequestParam(value = "directUrl", required = false,
+                                defaultValue = "false") final Boolean directUrl,
+                        @CookieValue(value = "uid") final String uid,
+                        @CookieValue(value = "ulang") final String lang,
+                        final Model model) throws JsonProcessingException {
         Action action = Action.edit;
         Type type = Type.desktop;
         Locale locale = new Locale("en");
 
-        if(actionParam != null) action = Action.valueOf(actionParam);
-        if(typeParam != null) type = Type.valueOf(typeParam);
+        if (actionParam != null) {
+            action = Action.valueOf(actionParam);
+        }
+        if (typeParam != null) {
+            type = Type.valueOf(typeParam);
+        }
 
         List<String> langsAndKeys = Arrays.asList(langs.split("\\|"));
         for (String langAndKey : langsAndKeys) {
@@ -101,7 +116,9 @@ public class EditorController {
         Optional<User> optionalUser = userService.findUserById(Integer.parseInt(uid));
 
         // if the user is not present, return the ONLYOFFICE start page
-        if(!optionalUser.isPresent()) return "index.html";
+        if (!optionalUser.isPresent()) {
+            return "index.html";
+        }
 
         User user = optionalUser.get();
 
@@ -115,27 +132,43 @@ public class EditorController {
                         .action(action)
                         .user(user)
                         .actionData(actionLink)
+                        .isEnableDirectUrl(directUrl)
                         .build()
         );
 
         // add attributes to the specified model
-        model.addAttribute("model", fileModel);  // add file model with the default parameters to the original model
-        model.addAttribute("fileHistory", historyManager.getHistory(fileModel.getDocument()));  // get file history and add it to the model
-        model.addAttribute("docserviceApiUrl",docserviceSite + docserviceApiUrl);  // create the document service api URL and add it to the model
-        model.addAttribute("dataInsertImage",  getInsertImage());  // get an image and add it to the model
-        model.addAttribute("dataCompareFile",  getCompareFile());  // get a document for comparison and add it to the model
-        model.addAttribute("dataMailMergeRecipients", getMailMerge());  // get recipients data for mail merging and add it to the model
-        model.addAttribute("usersForMentions", getUserMentions(uid));  // get user data for mentions and add it to the model
+        // add file model with the default parameters to the original model
+        model.addAttribute("model", fileModel);
+
+        // get file history and add it to the model
+        model.addAttribute("fileHistory", historyManager.getHistory(fileModel.getDocument()));
+
+        // create the document service api URL and add it to the model
+        model.addAttribute("docserviceApiUrl", docserviceSite + docserviceApiUrl);
+
+        // get an image and add it to the model
+        model.addAttribute("dataInsertImage",  getInsertImage(directUrl));
+
+        // get a document for comparison and add it to the model
+        model.addAttribute("dataCompareFile",  getCompareFile(directUrl));
+
+        // get recipients data for mail merging and add it to the model
+        model.addAttribute("dataMailMergeRecipients", getMailMerge(directUrl));
+
+        // get user data for mentions and add it to the model
+        model.addAttribute("usersForMentions", getUserMentions(uid));
         return "editor.html";
     }
 
-    private List<Mentions> getUserMentions(String uid){  // get user data for mentions
-        List<Mentions> usersForMentions=new ArrayList<>();
-        if(uid!=null && !uid.equals("4")) {
+    private List<Mentions> getUserMentions(final String uid) {  // get user data for mentions
+        List<Mentions> usersForMentions = new ArrayList<>();
+        if (uid != null && !uid.equals("4")) {
             List<User> list = userService.findAll();
             for (User u : list) {
-                if (u.getId()!=Integer.parseInt(uid) && u.getId()!=4) {
-                    usersForMentions.add(new Mentions(u.getName(),u.getEmail()));  // user data includes user names and emails
+                if (u.getId() != Integer.parseInt(uid) && u.getId() != ANONYMOUS_USER_ID) {
+
+                    // user data includes user names and emails
+                    usersForMentions.add(new Mentions(u.getName(), u.getEmail()));
                 }
             }
         }
@@ -144,45 +177,61 @@ public class EditorController {
     }
 
     @SneakyThrows
-    private String getInsertImage() {  // get an image that will be inserted into the document
+    private String getInsertImage(final Boolean directUrl) {  // get an image that will be inserted into the document
         Map<String, Object> dataInsertImage = new HashMap<>();
         dataInsertImage.put("fileType", "png");
         dataInsertImage.put("url", storagePathBuilder.getServerUrl(true) + "/css/img/logo.png");
-        dataInsertImage.put("directUrl", storagePathBuilder.getServerUrl(false) + "/css/img/logo.png");
-
-        // check if the document token is enabled
-        if(jwtManager.tokenEnabled()){
-            dataInsertImage.put("token", jwtManager.createToken(dataInsertImage));  // create token from the dataInsertImage object
+        if (directUrl) {
+            dataInsertImage.put("directUrl", storagePathBuilder
+                    .getServerUrl(false) + "/css/img/logo.png");
         }
 
-        return objectMapper.writeValueAsString(dataInsertImage).substring(1, objectMapper.writeValueAsString(dataInsertImage).length()-1);
+        // check if the document token is enabled
+        if (jwtManager.tokenEnabled()) {
+
+            // create token from the dataInsertImage object
+            dataInsertImage.put("token", jwtManager.createToken(dataInsertImage));
+        }
+
+        return objectMapper.writeValueAsString(dataInsertImage)
+                .substring(1, objectMapper.writeValueAsString(dataInsertImage).length() - 1);
     }
 
+    // get a document that will be compared with the current document
     @SneakyThrows
-    private String getCompareFile(){  // get a document that will be compared with the current document
+    private String getCompareFile(final Boolean directUrl) {
         Map<String, Object> dataCompareFile = new HashMap<>();
         dataCompareFile.put("fileType", "docx");
         dataCompareFile.put("url", storagePathBuilder.getServerUrl(true) + "/assets?name=sample.docx");
-        dataCompareFile.put("directUrl", storagePathBuilder.getServerUrl(false) + "/assets?name=sample.docx");
+        if (directUrl) {
+            dataCompareFile.put("directUrl", storagePathBuilder
+                    .getServerUrl(false) + "/assets?name=sample.docx");
+        }
 
         // check if the document token is enabled
-        if(jwtManager.tokenEnabled()){
-            dataCompareFile.put("token", jwtManager.createToken(dataCompareFile));  // create token from the dataCompareFile object
+        if (jwtManager.tokenEnabled()) {
+
+            // create token from the dataCompareFile object
+            dataCompareFile.put("token", jwtManager.createToken(dataCompareFile));
         }
 
         return objectMapper.writeValueAsString(dataCompareFile);
     }
 
     @SneakyThrows
-    private String getMailMerge(){
+    private String getMailMerge(final Boolean directUrl) {
         Map<String, Object> dataMailMergeRecipients = new HashMap<>();  // get recipients data for mail merging
         dataMailMergeRecipients.put("fileType", "csv");
         dataMailMergeRecipients.put("url", storagePathBuilder.getServerUrl(true) + "/csv");
-        dataMailMergeRecipients.put("directUrl", storagePathBuilder.getServerUrl(false) + "/csv");
+        if (directUrl) {
+            dataMailMergeRecipients.put("directUrl", storagePathBuilder.getServerUrl(false) + "/csv");
+        }
 
         // check if the document token is enabled
-        if(jwtManager.tokenEnabled()){
-            dataMailMergeRecipients.put("token", jwtManager.createToken(dataMailMergeRecipients));  // create token from the dataMailMergeRecipients object
+        if (jwtManager.tokenEnabled()) {
+
+            // create token from the dataMailMergeRecipients object
+            dataMailMergeRecipients.put("token", jwtManager.createToken(dataMailMergeRecipients));
         }
 
         return objectMapper.writeValueAsString(dataMailMergeRecipients);

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/controllers/FileController.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -41,16 +41,26 @@ import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;
 import org.springframework.stereotype.Controller;
 import org.springframework.ui.Model;
-import org.springframework.web.bind.annotation.*;
+import org.springframework.web.bind.annotation.CookieValue;
+import org.springframework.web.bind.annotation.CrossOrigin;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.ResponseBody;
 import org.springframework.web.multipart.MultipartFile;
 
 import javax.servlet.http.HttpServletRequest;
-import java.io.*;
+import java.io.IOException;
+import java.io.InputStream;
 import java.net.URL;
 import java.net.URLEncoder;
 import java.nio.charset.StandardCharsets;
 import java.nio.file.Path;
-import java.util.*;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Optional;
 
 @CrossOrigin("*")
 @Controller
@@ -90,10 +100,10 @@ public class FileController {
     private CallbackManager callbackManager;
 
     // create user metadata
-    private String createUserMetadata(String uid, String fullFileName) {
+    private String createUserMetadata(final String uid, final String fullFileName) {
         Optional<User> optionalUser = userService.findUserById(Integer.parseInt(uid));  // find a user by their ID
         String documentType = fileUtility.getDocumentType(fullFileName).toString().toLowerCase();  // get document type
-        if(optionalUser.isPresent()){
+        if (optionalUser.isPresent()) {
             User user = optionalUser.get();
             storageMutator.createMeta(fullFileName,  // create meta information with the user ID and name specified
                     String.valueOf(user.getId()), user.getName());
@@ -102,33 +112,39 @@ public class FileController {
     }
 
     // download data from the specified file
-    private ResponseEntity<Resource> downloadFile(String fileName){
+    private ResponseEntity<Resource> downloadFile(final String fileName) {
         Resource resource = storageMutator.loadFileAsResource(fileName);  // load the specified file as a resource
         String contentType = "application/octet-stream";
 
         // create a response with the content type, header and body with the file data
         return ResponseEntity.ok()
                 .contentType(MediaType.parseMediaType(contentType))
-                .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + resource.getFilename() + "\"")
+                .header(HttpHeaders.CONTENT_DISPOSITION,
+                        "attachment; filename=\"" + resource.getFilename() + "\"")
                 .body(resource);
     }
 
     // download data from the specified history file
-    private ResponseEntity<Resource> downloadFileHistory(String fileName, String version, String file){
-        Resource resource = storageMutator.loadFileAsResourceHistory(fileName,version,file);  // load the specified file as a resource
+    private ResponseEntity<Resource> downloadFileHistory(final String fileName,
+                                                         final String version,
+                                                         final String file) {
+
+        // load the specified file as a resource
+        Resource resource = storageMutator.loadFileAsResourceHistory(fileName, version, file);
         String contentType = "application/octet-stream";
 
         // create a response with the content type, header and body with the file data
         return ResponseEntity.ok()
                 .contentType(MediaType.parseMediaType(contentType))
-                .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + resource.getFilename() + "\"")
+                .header(HttpHeaders.CONTENT_DISPOSITION,
+                        "attachment; filename=\"" + resource.getFilename() + "\"")
                 .body(resource);
     }
 
     @PostMapping("/upload")
     @ResponseBody
-    public String upload(@RequestParam("file") MultipartFile file,  // upload a file
-                             @CookieValue("uid") String uid){
+    public String upload(@RequestParam("file") final MultipartFile file,  // upload a file
+                             @CookieValue("uid") final String uid) {
         try {
             String fullFileName = file.getOriginalFilename();  // get file name
             String fileExtension = fileUtility.getFileExtension(fullFileName);  // get file extension
@@ -136,17 +152,19 @@ public class FileController {
             byte[] bytes = file.getBytes();  // get file in bytes
 
             // check if the file size exceeds the maximum file size or is less than 0
-            if(fileUtility.getMaxFileSize() < fileSize || fileSize <= 0){
+            if (fileUtility.getMaxFileSize() < fileSize || fileSize <= 0) {
                 return "{ \"error\": \"File size is incorrect\"}";  // if so, write an error message to the response
             }
 
             // check if file extension is supported by the editor
-            if(!fileUtility.getFileExts().contains(fileExtension)){
-                return "{ \"error\": \"File type is not supported\"}";  // if not, write an error message to the response
+            if (!fileUtility.getFileExts().contains(fileExtension)) {
+
+                // if not, write an error message to the response
+                return "{ \"error\": \"File type is not supported\"}";
             }
 
             String fileNamePath = storageMutator.updateFile(fullFileName, bytes);  // update a file
-            if (fileNamePath.isBlank()){
+            if (fileNamePath.isBlank()) {
                 throw new IOException("Could not update a file");  // if the file cannot be updated, an error occurs
             }
 
@@ -156,31 +174,46 @@ public class FileController {
         } catch (Exception e) {
             e.printStackTrace();
         }
-        return "{ \"error\": \"Something went wrong when uploading the file.\"}";  // if the operation of file uploading is unsuccessful, an error occurs
+
+        // if the operation of file uploading is unsuccessful, an error occurs
+        return "{ \"error\": \"Something went wrong when uploading the file.\"}";
     }
 
     @PostMapping(path = "${url.converter}")
     @ResponseBody
-    public String convert(@RequestBody Converter body,  // convert a file
-                          @CookieValue("uid") String uid, @CookieValue("ulang") String lang){
-        String fileName = body.getFileName();  // get file name
-        String fileUri = documentManager.getDownloadUrl(fileName, true);  // get URL for downloading a file with the specified name
-        String filePass = body.getFilePass() != null ? body.getFilePass() : null;  // get file password if it exists
-        String fileExt = fileUtility.getFileExtension(fileName);  // get file extension
-        DocumentType type = fileUtility.getDocumentType(fileName);  // get document type (word, cell or slide)
-        String internalFileExt = fileUtility.getInternalExtension(type);  // get an editor internal extension (".docx", ".xlsx" or ".pptx")
+    public String convert(@RequestBody final Converter body,  // convert a file
+                          @CookieValue("uid") final String uid, @CookieValue("ulang") final String lang) {
+        // get file name
+        String fileName = body.getFileName();
 
-        try{
-            if(fileUtility.getConvertExts().contains(fileExt)){  // check if the file with such an extension can be converted
+        // get URL for downloading a file with the specified name
+        String fileUri = documentManager.getDownloadUrl(fileName, true);
+
+        // get file password if it exists
+        String filePass = body.getFilePass() != null ? body.getFilePass() : null;
+
+        // get file extension
+        String fileExt = fileUtility.getFileExtension(fileName);
+
+        // get document type (word, cell or slide)
+        DocumentType type = fileUtility.getDocumentType(fileName);
+
+        // get an editor internal extension (".docx", ".xlsx" or ".pptx")
+        String internalFileExt = fileUtility.getInternalExtension(type);
+
+        try {
+            // check if the file with such an extension can be converted
+            if (fileUtility.getConvertExts().contains(fileExt)) {
                 String key = serviceConverter.generateRevisionId(fileUri);  // generate document key
                 String newFileUri = serviceConverter  // get the URL to the converted file
                         .getConvertedUri(fileUri, fileExt, internalFileExt, key, filePass, true, lang);
 
-                if(newFileUri.isEmpty()){
+                if (newFileUri.isEmpty()) {
                     return "{ \"step\" : \"0\", \"filename\" : \"" + fileName + "\"}";
                 }
 
-                // get a file name of an internal file extension with an index if the file with such a name already exists
+                /* get a file name of an internal file extension with an index if the file
+                 with such a name already exists */
                 String nameWithInternalExt = fileUtility.getFileNameWithoutExtension(fileName) + internalFileExt;
                 String correctedName = documentManager.getCorrectName(nameWithInternalExt);
 
@@ -188,7 +221,7 @@ public class FileController {
                 java.net.HttpURLConnection connection = (java.net.HttpURLConnection) url.openConnection();
                 InputStream stream = connection.getInputStream();  // get input stream of the converted file
 
-                if (stream == null){
+                if (stream == null) {
                     connection.disconnect();
                     throw new RuntimeException("Input stream is null");
                 }
@@ -200,87 +233,101 @@ public class FileController {
 
             // create meta information about the converted file with the user ID and name specified
             return createUserMetadata(uid, fileName);
-        }catch (Exception e) {
+        } catch (Exception e) {
             e.printStackTrace();
         }
-        return "{ \"error\": \"" + "The file can't be converted.\"}";  // if the operation of file converting is unsuccessful, an error occurs
+        // if the operation of file converting is unsuccessful, an error occurs
+        return "{ \"error\": \"" + "The file can't be converted.\"}";
     }
 
     @PostMapping("/delete")
     @ResponseBody
-    public String delete(@RequestBody Converter body){  // delete a file
-        try
-        {
+    public String delete(@RequestBody final Converter body) {  // delete a file
+        try {
             String fullFileName = fileUtility.getFileName(body.getFileName());  // get full file name
-            boolean fileSuccess = storageMutator.deleteFile(fullFileName);  // delete a file from the storage and return the status of this operation (true or false)
-            boolean historySuccess = storageMutator.deleteFileHistory(fullFileName);  // delete file history and return the status of this operation (true or false)
 
-            return "{ \"success\": \""+ (fileSuccess && historySuccess) +"\"}";
-        }
-        catch (Exception e)
-        {
-            return "{ \"error\": \"" + e.getMessage() + "\"}";  // if the operation of file deleting is unsuccessful, an error occurs
+            // delete a file from the storage and return the status of this operation (true or false)
+            boolean fileSuccess = storageMutator.deleteFile(fullFileName);
+
+            // delete file history and return the status of this operation (true or false)
+            boolean historySuccess = storageMutator.deleteFileHistory(fullFileName);
+
+            return "{ \"success\": \"" + (fileSuccess && historySuccess) + "\"}";
+        } catch (Exception e) {
+            // if the operation of file deleting is unsuccessful, an error occurs
+            return "{ \"error\": \"" + e.getMessage() + "\"}";
         }
     }
 
     @GetMapping("/downloadhistory")
-    public ResponseEntity<Resource> downloadHistory(HttpServletRequest request,// download a file
-                                             @RequestParam("fileName") String fileName,
-                                             @RequestParam("ver") String version,
-                                             @RequestParam("file") String file){ // history file
-        try{
+    public ResponseEntity<Resource> downloadHistory(final HttpServletRequest request, // download a file
+                                             @RequestParam("fileName") final String fileName,
+                                             @RequestParam("ver") final String version,
+                                             @RequestParam("file") final String file) { // history file
+        try {
             // check if a token is enabled or not
-            if(jwtManager.tokenEnabled()){
+            if (jwtManager.tokenEnabled()) {
                 String header = request.getHeader(documentJwtHeader == null  // get the document JWT header
                         || documentJwtHeader.isEmpty() ? "Authorization" : documentJwtHeader);
-                if(header != null && !header.isEmpty()){
-                    String token = header.replace("Bearer ", "");  // token is the header without the Bearer prefix
+                if (header != null && !header.isEmpty()) {
+                    String token = header
+                            .replace("Bearer ", "");  // token is the header without the Bearer prefix
                     jwtManager.readToken(token);  // read the token
-                }else {
+                } else {
                     return null;
                 }
             }
-            return downloadFileHistory(fileName,version,file);  // download data from the specified file
-        } catch(Exception e){
+            return downloadFileHistory(fileName, version, file);  // download data from the specified file
+        } catch (Exception e) {
             return null;
         }
     }
 
     @GetMapping(path = "${url.download}")
-    public ResponseEntity<Resource> download(HttpServletRequest request,  // download a file
-                                             @RequestParam("fileName") String fileName){
-        try{
+    public ResponseEntity<Resource> download(final HttpServletRequest request,  // download a file
+                                             @RequestParam("fileName") final String fileName) {
+        try {
             // check if a token is enabled or not
-            if(jwtManager.tokenEnabled()){
+            if (jwtManager.tokenEnabled()) {
                 String header = request.getHeader(documentJwtHeader == null  // get the document JWT header
                         || documentJwtHeader.isEmpty() ? "Authorization" : documentJwtHeader);
-                if(header != null && !header.isEmpty()){
-                    String token = header.replace("Bearer ", "");  // token is the header without the Bearer prefix
+                if (header != null && !header.isEmpty()) {
+                    String token = header
+                            .replace("Bearer ", "");  // token is the header without the Bearer prefix
                     jwtManager.readToken(token);  // read the token
                 }
             }
             return downloadFile(fileName);  // download data from the specified file
-        } catch(Exception e){
+        } catch (Exception e) {
             return null;
         }
     }
 
     @GetMapping("/create")
-    public String create(@RequestParam("fileExt") String fileExt,  // create a sample file of the specified extension
-                         @RequestParam(value = "sample", required = false) Optional<Boolean> isSample,
-                         @CookieValue(value = "uid", required = false) String uid,
-                         Model model){
-        Boolean sampleData = (isSample.isPresent() && !isSample.isEmpty()) && isSample.get();  // specify if the sample data exists or not
-        if(fileExt != null){
-            try{
+    public String create(@RequestParam("fileExt")
+                             final String fileExt, // create a sample file of the specified extension
+                         @RequestParam(value = "sample", required = false) final Optional<Boolean> isSample,
+                         @CookieValue(value = "uid", required = false) final String uid,
+                         final Model model) {
+        // specify if the sample data exists or not
+        Boolean sampleData = (isSample.isPresent() && !isSample.isEmpty()) && isSample.get();
+        if (fileExt != null) {
+            try {
                 Optional<User> user = userService.findUserById(Integer.parseInt(uid));  // find a user by their ID
-                if (!user.isPresent()) throw new RuntimeException("Could not fine any user with id = "+uid);  // if the user with the specified ID doesn't exist, an error occurs
-                String fileName = documentManager.createDemo(fileExt, sampleData, uid, user.get().getName());  // create a demo document with the sample data
+                if (!user.isPresent()) {
+                    // if the user with the specified ID doesn't exist, an error occurs
+                    throw new RuntimeException("Could not fine any user with id = " + uid);
+                }
+                String fileName = documentManager.createDemo(fileExt,
+                        sampleData,
+                        uid,
+                        user.get().getName());  // create a demo document with the sample data
                 if (fileName.isBlank() || fileName == null) {
                     throw new RuntimeException("You must have forgotten to add asset files");
                 }
-                return "redirect:editor?fileName=" + URLEncoder.encode(fileName, StandardCharsets.UTF_8);  // redirect the request
-            }catch (Exception ex){
+                return "redirect:editor?fileName=" + URLEncoder
+                        .encode(fileName, StandardCharsets.UTF_8);  // redirect the request
+            } catch (Exception ex) {
                 model.addAttribute("error", ex.getMessage());
                 return "error.html";
             }
@@ -289,33 +336,35 @@ public class FileController {
     }
 
     @GetMapping("/assets")
-    public ResponseEntity<Resource> assets(@RequestParam("name") String name)  // get sample files from the assests
-    {
+    public ResponseEntity<Resource> assets(@RequestParam("name")
+                                               final String name) {  // get sample files from the assests
         String fileName = Path.of("assets", "sample", fileUtility.getFileName(name)).toString();
         return downloadFile(fileName);
     }
 
     @GetMapping("/csv")
-    public ResponseEntity<Resource> csv()  // download a csv file
-    {
+    public ResponseEntity<Resource> csv() {  // download a csv file
         String fileName = Path.of("assets", "sample", "csv.csv").toString();
         return downloadFile(fileName);
     }
 
     @GetMapping("/files")
     @ResponseBody
-    public ArrayList<Map<String, Object>> files(@RequestParam(value = "fileId", required = false) String fileId){  // get files information
+    public ArrayList<Map<String, Object>> files(@RequestParam(value = "fileId", required = false)
+                                                    final String fileId) {  // get files information
         return fileId == null ? documentManager.getFilesInfo() : documentManager.getFilesInfo(fileId);
     }
 
     @PostMapping(path = "${url.track}")
     @ResponseBody
-    public String track(HttpServletRequest request,  // track file changes
-                        @RequestParam("fileName") String fileName,
-                        @RequestParam("userAddress") String userAddress,
-                        @RequestBody Track body){
+    public String track(final HttpServletRequest request,  // track file changes
+                        @RequestParam("fileName") final String fileName,
+                        @RequestParam("userAddress") final String userAddress,
+                        @RequestBody final Track body) {
+        Track track;
         try {
-            String bodyString = objectMapper.writeValueAsString(body);  // write the request body to the object mapper as a string
+            String bodyString = objectMapper
+                    .writeValueAsString(body);  // write the request body to the object mapper as a string
             String header = request.getHeader(documentJwtHeader == null  // get the request header
                     || documentJwtHeader.isEmpty() ? "Authorization" : documentJwtHeader);
 
@@ -324,20 +373,20 @@ public class FileController {
             }
 
             JSONObject bodyCheck = jwtManager.parseBody(bodyString, header);  // parse the request body
-            body = objectMapper.readValue(bodyCheck.toJSONString(), Track.class);  // read the request body
+            track = objectMapper.readValue(bodyCheck.toJSONString(), Track.class);  // read the request body
         } catch (Exception e) {
             e.printStackTrace();
             return e.getMessage();
         }
 
-        int error = callbackHandler.handle(body, fileName);
+        int error = callbackHandler.handle(track, fileName);
 
-        return"{\"error\":" + error + "}";
+        return "{\"error\":" + error + "}";
     }
 
     @PostMapping("/saveas")
     @ResponseBody
-    public String saveAs(@RequestBody JSONObject body, @CookieValue("uid") String uid) {
+    public String saveAs(@RequestBody final JSONObject body, @CookieValue("uid") final String uid) {
         String title = (String) body.get("title");
         String saveAsFileUrl = (String) body.get("url");
 
@@ -368,17 +417,17 @@ public class FileController {
 
     @PostMapping("/rename")
     @ResponseBody
-    public String rename(@RequestBody JSONObject body) {
+    public String rename(@RequestBody final JSONObject body) {
         String newfilename = (String) body.get("newfilename");
         String dockey = (String) body.get("dockey");
         String origExt = "." + (String) body.get("ext");
         String curExt = newfilename;
 
-        if(newfilename.indexOf(".") != -1) {
+        if (newfilename.indexOf(".") != -1) {
             curExt = (String) fileUtility.getFileExtension(newfilename);
         }
 
-        if(origExt.compareTo(curExt) != 0) {
+        if (origExt.compareTo(curExt) != 0) {
             newfilename += origExt;
         }
 

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/controllers/IndexController.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,16 +21,25 @@ package com.onlyoffice.integration.controllers;
 import com.onlyoffice.integration.documentserver.storage.FileStorageMutator;
 import com.onlyoffice.integration.documentserver.storage.FileStoragePathBuilder;
 import com.onlyoffice.integration.documentserver.util.Misc;
-import com.onlyoffice.integration.entities.*;
-import com.onlyoffice.integration.services.UserServices;
 import com.onlyoffice.integration.documentserver.util.file.FileUtility;
+import com.onlyoffice.integration.entities.User;
+import com.onlyoffice.integration.services.UserServices;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.stereotype.Controller;
 import org.springframework.ui.Model;
-import org.springframework.web.bind.annotation.*;
+import org.springframework.web.bind.annotation.CrossOrigin;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.ResponseBody;
 
-import java.util.*;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
 import java.util.stream.Collectors;
 
 @CrossOrigin("*")
@@ -68,7 +77,8 @@ public class IndexController {
     private String langs;
 
     @GetMapping("${url.index}")
-    public String index(Model model){
+    public String index(@RequestParam(value = "directUrl", required = false) final Boolean directUrl,
+                        final Model model) {
         java.io.File[] files = storageMutator.getStoredFiles();  // get all the stored files from the storage
         List<String> docTypes = new ArrayList<>();
         List<Boolean> filesEditable = new ArrayList<>();
@@ -86,39 +96,49 @@ public class IndexController {
         List<User> users = userService.findAll();  // get a list of all the users
 
         String tooltip = users.stream()  // get the tooltip with the user descriptions
-                .map(user -> mistUtility.convertUserDescriptions(user.getName(), user.getDescriptions()))  // convert user descriptions to the specified format
+                .map(user -> mistUtility.convertUserDescriptions(user.getName(),
+                        user.getDescriptions()))  // convert user descriptions to the specified format
                 .collect(Collectors.joining());
 
-        for(java.io.File file:files){  // run through all the files
+        for (java.io.File file:files) {  // run through all the files
             String fileName = file.getName();  // get file name
-            docTypes.add(fileUtility.getDocumentType(fileName).toString().toLowerCase());  // add a document type of each file to the list
-            filesEditable.add(fileUtility.getEditedExts().contains(fileUtility.getFileExtension(fileName)));  // specify if a file is editable or not
-            versions.add(" ["+storagePathBuilder.getFileVersion(fileName, true)+"]");  // add a file version to the list
+            docTypes.add(fileUtility
+                    .getDocumentType(fileName)
+                    .toString()
+                    .toLowerCase());  // add a document type of each file to the list
+            filesEditable.add(fileUtility.getEditedExts()
+                    .contains(fileUtility.getFileExtension(fileName)));  // specify if a file is editable or not
+            versions.add(" [" + storagePathBuilder.
+                    getFileVersion(fileName, true) + "]");  // add a file version to the list
             isFillFormDoc.add(fileUtility.getFillExts().contains(fileUtility.getFileExtension(fileName)));
         }
 
         // add all the parameters to the model
         model.addAttribute("isFillFormDoc", isFillFormDoc);
-        model.addAttribute("versions",versions);
+        model.addAttribute("versions", versions);
         model.addAttribute("files", files);
         model.addAttribute("docTypes", docTypes);
         model.addAttribute("filesEditable", filesEditable);
-        model.addAttribute("datadocs", docserviceSite+docservicePreloader);
+        model.addAttribute("datadocs", docserviceSite + docservicePreloader);
         model.addAttribute("tooltip", tooltip);
         model.addAttribute("users", users);
         model.addAttribute("languages", languages);
+        model.addAttribute("directUrl", directUrl);
 
         return "index.html";
     }
 
     @PostMapping("/config")
     @ResponseBody
-    public HashMap<String, String> configParameters(){  // get configuration parameters
+    public HashMap<String, String> configParameters() {  // get configuration parameters
         HashMap<String, String> configuration = new HashMap<>();
 
-        configuration.put("FillExtList", String.join(",", fileUtility.getFillExts()));  // put a list of the extensions that can be filled to config
-        configuration.put("ConverExtList", String.join(",", fileUtility.getConvertExts()));  // put a list of the extensions that can be converted to config
-        configuration.put("EditedExtList", String.join(",", fileUtility.getEditedExts()));  // put a list of the extensions that can be edited to config
+        configuration.put("FillExtList", String.join(",", fileUtility
+                .getFillExts()));  // put a list of the extensions that can be filled to config
+        configuration.put("ConverExtList", String.join(",", fileUtility
+                .getConvertExts()));  // put a list of the extensions that can be converted to config
+        configuration.put("EditedExtList", String.join(",", fileUtility
+                .getEditedExts()));  // put a list of the extensions that can be edited to config
         configuration.put("UrlConverter", urlConverter);
         configuration.put("UrlEditor", urlEditor);
 

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/callbacks/Callback.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -26,7 +26,7 @@ public interface Callback {
     int handle(Track body, String fileName);  // handle the callback
     int getStatus();  // get document status
     @Autowired
-    default void selfRegistration(CallbackHandler callbackHandler){  // register a callback handler
+    default void selfRegistration(CallbackHandler callbackHandler) {  // register a callback handler
         callbackHandler.register(getStatus(), this);
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/callbacks/CallbackHandler.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -33,14 +33,14 @@ public class CallbackHandler {
 
     private Map<Integer, Callback> callbackHandlers = new HashMap<>();
 
-    public void register(int code, Callback callback){  // register a callback handler
+    public void register(final int code, final Callback callback) {  // register a callback handler
         callbackHandlers.put(code, callback);
     }
 
-    public int handle(Track body, String fileName){  // handle a callback
+    public int handle(final Track body, final String fileName) {  // handle a callback
         Callback callback = callbackHandlers.get(body.getStatus());
-        if (callback == null){
-            logger.warn("Callback status "+body.getStatus()+" is not supported yet");
+        if (callback == null) {
+            logger.warn("Callback status " + body.getStatus() + " is not supported yet");
            return 0;
         }
 

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/callbacks/Status.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -26,10 +26,10 @@ public enum Status {
     MUST_FORCE_SAVE(6),  // 6 - document is being edited, but the current document state is saved
     CORRUPTED_FORCE_SAVE(7);  // 7 - error has occurred while force saving the document
     private int code;
-    Status(int code){
-        this.code = code;
+    Status(final int codeParam) {
+        this.code = codeParam;
     }
-    public int getCode(){  // get document status
+    public int getCode() {  // get document status
         return this.code;
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/callbacks/implementations/EditCallback.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -31,15 +31,18 @@ public class EditCallback implements Callback {
     @Autowired
     private CallbackManager callbackManager;
     @Override
-    public int handle(Track body, String fileName) {  // handle the callback when the document is being edited
+    public int handle(final Track body,
+                      final String fileName) {  // handle the callback when the document is being edited
         int result = 0;
         Action action =  body.getActions().get(0);  // get the user ID who is editing the document
-        if (action.getType().equals(com.onlyoffice.integration.documentserver.models.enums.Action.edit)) {  // if this value is not equal to the user ID
+        if (action.getType().equals(com.onlyoffice.integration.documentserver.models.enums
+                .Action.edit)) {  // if this value is not equal to the user ID
             String user =  action.getUserid();  // get user ID
             if (!body.getUsers().contains(user)) {  // if this user is not specified in the body
                 String key = body.getKey();  // get document key
                 try {
-                    callbackManager.commandRequest("forcesave", key, null);  // create a command request to forcibly save the document being edited without closing it
+                    // create a command request to forcibly save the document being edited without closing it
+                    callbackManager.commandRequest("forcesave", key, null);
                 } catch (Exception e) {
                     e.printStackTrace();
                     result = 1;

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/callbacks/implementations/ForcesaveCallback.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -30,7 +30,8 @@ public class ForcesaveCallback implements Callback {
     @Autowired
     private CallbackManager callbackManager;
     @Override
-    public int handle(Track body, String fileName) {  // handle the callback when the force saving request is performed
+    public int handle(final Track body,
+                      final String fileName) {  // handle the callback when the force saving request is performed
         int result = 0;
         try {
             callbackManager.processForceSave(body, fileName);  // file force saving process
@@ -43,6 +44,7 @@ public class ForcesaveCallback implements Callback {
 
     @Override
     public int getStatus() {  // get document status
-        return Status.MUST_FORCE_SAVE.getCode();  // return status 6 - document is being edited, but the current document state is saved
+        // return status 6 - document is being edited, but the current document state is saved
+        return Status.MUST_FORCE_SAVE.getCode();
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/callbacks/implementations/SaveCallback.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -30,7 +30,8 @@ public class SaveCallback implements Callback {
     @Autowired
     private CallbackManager callbackManager;
     @Override
-    public int handle(Track body, String fileName) {  // handle the callback when the saving request is performed
+    public int handle(final Track body,
+                      final String fileName) {  // handle the callback when the saving request is performed
         int result = 0;
         try {
             callbackManager.processSave(body, fileName);  // file saving process

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/callback/CallbackManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/callback/DefaultCallbackManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -32,17 +32,23 @@ import org.json.simple.JSONObject;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Primary;
+import org.springframework.http.HttpStatus;
 import org.springframework.stereotype.Component;
 
-import java.io.*;
+import java.io.File;
+import java.io.InputStream;
+import java.io.OutputStream;
 import java.net.URL;
 import java.nio.charset.StandardCharsets;
-import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
-import java.util.*;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
 
-//TODO: Refactoring
+import static com.onlyoffice.integration.documentserver.util.Constants.FILE_SAVE_TIMEOUT;
+
+// todo: Refactoring
 @Component
 @Primary
 public class DefaultCallbackManager implements CallbackManager {
@@ -70,14 +76,25 @@ public class DefaultCallbackManager implements CallbackManager {
     private ServiceConverter serviceConverter;
 
     // save file information from the URL to the file specified
-    private void downloadToFile(String url, Path path) throws Exception {
-        if (url == null || url.isEmpty()) throw new RuntimeException("Url argument is not specified");  // URL isn't specified
-        if (path == null) throw new RuntimeException("Path argument is not specified");  // file isn't specified
+    private void downloadToFile(final String url, final Path path) throws Exception {
+        if (url == null || url.isEmpty()) {
+            throw new RuntimeException("Url argument is not specified");  // URL isn't specified
+        }
+        if (path == null) {
+            throw new RuntimeException("Path argument is not specified");  // file isn't specified
+        }
 
         URL uri = new URL(url);
         java.net.HttpURLConnection connection = (java.net.HttpURLConnection) uri.openConnection();
+        connection.setConnectTimeout(FILE_SAVE_TIMEOUT);
         InputStream stream = connection.getInputStream();  // get input stream of the file information from the URL
 
+        int statusCode = connection.getResponseCode();
+        if (statusCode != HttpStatus.OK.value()) {  // checking status code
+            connection.disconnect();
+            throw new RuntimeException("Document editing service returned status: " + statusCode);
+        }
+
         if (stream == null) {
             connection.disconnect();
             throw new RuntimeException("Input stream is null");
@@ -87,7 +104,7 @@ public class DefaultCallbackManager implements CallbackManager {
     }
 
     @SneakyThrows
-    public void processSave(Track body, String fileName) {  // file saving process
+    public void processSave(final Track body, final String fileName) {  // file saving process
         String downloadUri = body.getUrl();
         String changesUri = body.getChangesurl();
         String key = body.getKey();
@@ -96,46 +113,56 @@ public class DefaultCallbackManager implements CallbackManager {
         String curExt = fileUtility.getFileExtension(fileName);  // get current file extension
         String downloadExt = "." + body.getFiletype(); // get an extension of the downloaded file
 
-        // Todo [Delete in version 7.0 or higher]
-        if (downloadExt != "." + null) downloadExt = fileUtility.getFileExtension(downloadUri); // Support for versions below 7.0
-
-        //TODO: Refactoring
-        if (!curExt.equals(downloadExt)) {  // convert downloaded file to the file with the current extension if these extensions aren't equal
+        // todo: Refactoring
+        // convert downloaded file to the file with the current extension if these extensions aren't equal
+        if (!curExt.equals(downloadExt)) {
             try {
-                String newFileUri = serviceConverter.getConvertedUri(downloadUri, downloadExt, curExt, serviceConverter.generateRevisionId(downloadUri), null, false, null);  // convert a file and get URL to a new file
+                String newFileUri = serviceConverter
+                        .getConvertedUri(downloadUri, downloadExt, curExt,
+                                serviceConverter.generateRevisionId(downloadUri), null, false,
+                                null);  // convert a file and get URL to a new file
                 if (newFileUri.isEmpty()) {
                     newFileName = documentManager
-                            .getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + downloadExt);  // get the correct file name if it already exists
+                            .getCorrectName(fileUtility.getFileNameWithoutExtension(fileName)
+                                    + downloadExt);  // get the correct file name if it already exists
                 } else {
                     downloadUri = newFileUri;
                 }
-            } catch (Exception e){
-                newFileName = documentManager.getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + downloadExt);
+            } catch (Exception e) {
+                newFileName = documentManager
+                        .getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + downloadExt);
             }
         }
 
         String storagePath = storagePathBuilder.getFileLocation(newFileName);  // get the path to a new file
-        Path lastVersion = Paths.get(storagePathBuilder.getFileLocation(fileName));  // get the path to the last file version
+        Path lastVersion = Paths.get(storagePathBuilder
+                .getFileLocation(fileName));  // get the path to the last file version
 
         if (lastVersion.toFile().exists()) {  // if the last file version exists
             Path histDir = Paths.get(storagePathBuilder.getHistoryDir(storagePath));  // get the history directory
             storageMutator.createDirectory(histDir);  // and create it
 
-            String versionDir = documentManager.versionDir(histDir.toAbsolutePath().toString(),  // get the file version directory
-                    storagePathBuilder.getFileVersion(histDir.toAbsolutePath().toString(), false), true);
+            String versionDir = documentManager
+                    .versionDir(histDir.toAbsolutePath().toString(),  // get the file version directory
+                    storagePathBuilder
+                            .getFileVersion(histDir.toAbsolutePath().toString(), false), true);
 
             Path ver = Paths.get(versionDir);
             Path toSave = Paths.get(storagePath);
 
             storageMutator.createDirectory(ver);  // create the file version directory
-            storageMutator.moveFile(lastVersion, Paths.get(versionDir + File.separator + "prev" + curExt));  // move the last file version to the file version directory with the "prev" postfix
+
+            // move the last file version to the file version directory with the "prev" postfix
+            storageMutator.moveFile(lastVersion, Paths.get(versionDir + File.separator + "prev" + curExt));
 
             downloadToFile(downloadUri, toSave);  // save file to the storage path
-            downloadToFile(changesUri, Path.of(versionDir + File.separator + "diff.zip"));  // save file changes to the diff.zip archive
+            downloadToFile(changesUri, Path
+                    .of(versionDir + File.separator + "diff.zip"));  // save file changes to the diff.zip archive
 
             JSONObject jsonChanges = new JSONObject();  // create a json object for document changes
             jsonChanges.put("changes", body.getHistory().getChanges());  // put the changes to the json object
-            jsonChanges.put("serverVersion", body.getHistory().getServerVersion());  // put the server version to the json object
+            jsonChanges.put("serverVersion", body.getHistory()
+                    .getServerVersion());  // put the server version to the json object
             String history = objectMapper.writeValueAsString(jsonChanges);
 
             if (history == null && body.getHistory() != null) {
@@ -143,20 +170,26 @@ public class DefaultCallbackManager implements CallbackManager {
             }
 
             if (history != null && !history.isEmpty()) {
-                storageMutator.writeToFile(versionDir + File.separator + "changes.json", history);  // write the history changes to the changes.json file
+                // write the history changes to the changes.json file
+                storageMutator.writeToFile(versionDir + File.separator + "changes.json", history);
             }
 
-            storageMutator.writeToFile(versionDir + File.separator + "key.txt", key);  // write the key value to the key.txt file
-            storageMutator.deleteFile(storagePathBuilder.getForcesavePath(newFileName, false));  // get the path to the forcesaved file version and remove it
+            // write the key value to the key.txt file
+            storageMutator.writeToFile(versionDir + File.separator + "key.txt", key);
+
+            // get the path to the forcesaved file version and remove it
+            storageMutator.deleteFile(storagePathBuilder.getForcesavePath(newFileName, false));
         }
     }
 
-    //TODO: Replace (String method) with (Enum method)
+    // todo: Replace (String method) with (Enum method)
     @SneakyThrows
-    public void commandRequest(String method, String key, HashMap meta) {  // create a command request
-        String DocumentCommandUrl = docserviceUrlSite + docserviceUrlCommand;
+    public void commandRequest(final String method,
+                               final String key,
+                               final HashMap meta) {  // create a command request
+        String documentCommandUrl = docserviceUrlSite + docserviceUrlCommand;
 
-        URL url = new URL(DocumentCommandUrl);
+        URL url = new URL(documentCommandUrl);
         java.net.HttpURLConnection connection = (java.net.HttpURLConnection) url.openConnection();
 
         HashMap<String, Object> params = new HashMap<String, Object>();
@@ -168,12 +201,14 @@ public class DefaultCallbackManager implements CallbackManager {
         }
 
         String headerToken;
-        if (jwtManager.tokenEnabled())  // check if a secret key to generate token exists or not
-        {
+        if (jwtManager.tokenEnabled()) {  // check if a secret key to generate token exists or not
             Map<String, Object> payloadMap = new HashMap<>();
             payloadMap.put("payload", params);
             headerToken = jwtManager.createToken(payloadMap);  // encode a payload object into a header token
-            connection.setRequestProperty(documentJwtHeader.equals("") ? "Authorization" : documentJwtHeader, "Bearer " + headerToken);  // add a header Authorization with a header token and Authorization prefix in it
+
+            // add a header Authorization with a header token and Authorization prefix in it
+            connection.setRequestProperty(documentJwtHeader.equals("")
+                    ? "Authorization" : documentJwtHeader, "Bearer " + headerToken);
 
             String token = jwtManager.createToken(params);  // encode a payload object into a body token
             params.put("token", token);
@@ -184,7 +219,8 @@ public class DefaultCallbackManager implements CallbackManager {
         byte[] bodyByte = bodyString.getBytes(StandardCharsets.UTF_8);
 
         connection.setRequestMethod("POST");  // set the request method
-        connection.setRequestProperty("Content-Type", "application/json; charset=UTF-8");  // set the Content-Type header
+        connection
+                .setRequestProperty("Content-Type", "application/json; charset=UTF-8");  // set the Content-Type header
         connection.setDoOutput(true);  // set the doOutput field to true
         connection.connect();
 
@@ -194,76 +230,81 @@ public class DefaultCallbackManager implements CallbackManager {
 
         InputStream stream = connection.getInputStream();  // get input stream
 
-        if (stream == null) throw new RuntimeException("Could not get an answer");
+        if (stream == null) {
+            throw new RuntimeException("Could not get an answer");
+        }
 
         String jsonString = serviceConverter.convertStreamToString(stream);  // convert stream to json string
         connection.disconnect();
 
         JSONObject response = serviceConverter.convertStringToJSON(jsonString);  // convert json string to json object
-        //TODO: Add errors ENUM
+        // todo: Add errors ENUM
         String responseCode = response.get("error").toString();
-        switch(responseCode) {
+        switch (responseCode) {
             case "0":
-            case "4": {
+            case "4":
                 break;
-            }
-            default: {
+            default:
                 throw new RuntimeException(response.toJSONString());
-            }
         }
     }
 
     @SneakyThrows
-    public void processForceSave(Track body, String fileName) {  // file force saving process
+    public void processForceSave(final Track body, final String fileNameParam) {  // file force saving process
 
         String downloadUri = body.getUrl();
+        String fileName = fileNameParam;
 
         String curExt = fileUtility.getFileExtension(fileName);  // get current file extension
-        String downloadExt = "."+body.getFiletype();  // get an extension of the downloaded file
+        String downloadExt = "." + body.getFiletype();  // get an extension of the downloaded file
 
-        // Todo [Delete in version 7.0 or higher]
-        if (downloadExt != "."+null) downloadExt = fileUtility.getFileExtension(downloadUri);    // Support for versions below 7.0
-        
         Boolean newFileName = false;
 
         // convert downloaded file to the file with the current extension if these extensions aren't equal
-        //TODO: Extract function
+        // todo: Extract function
         if (!curExt.equals(downloadExt)) {
             try {
-                String newFileUri = serviceConverter.getConvertedUri(downloadUri, downloadExt,
-                        curExt, serviceConverter.generateRevisionId(downloadUri), null, false, null);  // convert file and get URL to a new file
+                // convert file and get URL to a new file
+                String newFileUri = serviceConverter
+                        .getConvertedUri(downloadUri, downloadExt, curExt, serviceConverter
+                                .generateRevisionId(downloadUri), null, false, null);
                 if (newFileUri.isEmpty()) {
                     newFileName = true;
                 } else {
                     downloadUri = newFileUri;
                 }
-            } catch (Exception e){
+            } catch (Exception e) {
                 newFileName = true;
             }
         }
 
         String forcesavePath = "";
 
-        //TODO: Use ENUMS
-        //TODO: Pointless toString conversion
+        // todo: Use ENUMS
+        // todo: Pointless toString conversion
         boolean isSubmitForm = body.getForcesavetype().toString().equals("3");
 
-        //TODO: Extract function
+        // todo: Extract function
         if (isSubmitForm) {  // if the form is submitted
-            if (newFileName){
+            if (newFileName) {
+                // get the correct file name if it already exists
                 fileName = documentManager
-                        .getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + "-form" + downloadExt);  // get the correct file name if it already exists
+                        .getCorrectName(fileUtility
+                                .getFileNameWithoutExtension(fileName) + "-form" + downloadExt);
             } else {
-                fileName = documentManager.getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + "-form" + curExt);
+                fileName = documentManager
+                        .getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + "-form" + curExt);
             }
             forcesavePath = storagePathBuilder.getFileLocation(fileName);  // create forcesave path if it doesn't exist
             List<Action> actions =  body.getActions();
             Action action = actions.get(0);
             String user = action.getUserid();  // get the user ID
-            storageMutator.createMeta(fileName, user, "Filling Form");  // create meta data for the forcesaved file
+            // create meta data for the forcesaved file
+            storageMutator.createMeta(fileName, user, "Filling Form");
         } else {
-            if (newFileName){
-                fileName = documentManager.getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + downloadExt);
+            if (newFileName) {
+                fileName = documentManager
+                        .getCorrectName(fileUtility.getFileNameWithoutExtension(fileName) + downloadExt);
             }
 
             forcesavePath = storagePathBuilder.getForcesavePath(fileName, false);

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/document/DefaultDocumentManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -27,8 +27,9 @@ import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Primary;
 import org.springframework.stereotype.Component;
 
-import java.io.*;
 import java.io.File;
+import java.io.InputStream;
+import java.io.UnsupportedEncodingException;
 import java.math.BigDecimal;
 import java.math.RoundingMode;
 import java.net.InetAddress;
@@ -37,7 +38,12 @@ import java.net.UnknownHostException;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
-import java.util.*;
+import java.util.ArrayList;
+import java.util.Date;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+import static com.onlyoffice.integration.documentserver.util.Constants.KILOBYTE_SIZE;
 
 @Component
 @Primary
@@ -62,23 +68,23 @@ public class DefaultDocumentManager implements DocumentManager {
     private ServiceConverter serviceConverter;
 
     // get URL to the created file
-    public String getCreateUrl(String fileName, Boolean sample){
-        String fileExt = fileName.substring(fileName.length() - 4);
-        String url = storagePathBuilder.getServerUrl(true) + "/create?fileExt=" + fileExt + "&sample=" + sample;
+    public String getCreateUrl(final String fileName, final Boolean sample) {
+        String fileExt = fileUtility.getFileExtension(fileName).replace(".", "");
+        String url = storagePathBuilder.getServerUrl(true)
+                + "/create?fileExt=" + fileExt + "&sample=" + sample;
         return url;
     }
 
     // get a file name with an index if the file with such a name already exists
-    public String getCorrectName(String fileName)
-    {
+    public String getCorrectName(final String fileName) {
         String baseName = fileUtility.getFileNameWithoutExtension(fileName);  // get file name without extension
         String ext = fileUtility.getFileExtension(fileName);  // get file extension
         String name = baseName + ext;  // create a full file name
 
         Path path = Paths.get(storagePathBuilder.getFileLocation(name));
 
-        for (int i = 1; Files.exists(path); i++)  // run through all the files with such a name in the storage directory
-        {
+        // run through all the files with such a name in the storage directory
+        for (int i = 1; Files.exists(path); i++) {
             name = baseName + " (" + i + ")" + ext;  // and add an index to the base name
             path = Paths.get(storagePathBuilder.getFileLocation(name));
         }
@@ -87,101 +93,94 @@ public class DefaultDocumentManager implements DocumentManager {
     }
 
     // get file URL
-    public String getFileUri(String fileName, Boolean forDocumentServer)
-    {
-        try
-        {
+    public String getFileUri(final String fileName, final Boolean forDocumentServer) {
+        try {
             String serverPath = storagePathBuilder.getServerUrl(forDocumentServer);  // get server URL
             String hostAddress = storagePathBuilder.getStorageLocation();  // get the storage directory
             String filePathDownload = !fileName.contains(InetAddress.getLocalHost().getHostAddress()) ? fileName
-                    : fileName.substring(fileName.indexOf(InetAddress.getLocalHost().getHostAddress()) + InetAddress.getLocalHost().getHostAddress().length() + 1);
+                    : fileName.substring(fileName.indexOf(InetAddress.getLocalHost()
+                    .getHostAddress()) + InetAddress.getLocalHost().getHostAddress().length() + 1);
             if (!filesStorage.isEmpty() && filePathDownload.contains(filesStorage)) {
                 filePathDownload = filePathDownload.substring(filesStorage.length() + 1);
             }
 
-            String filePath = serverPath + "/download?fileName=" + URLEncoder.encode(filePathDownload, java.nio.charset.StandardCharsets.UTF_8.toString())
-                    + "&userAddress" + URLEncoder.encode(hostAddress, java.nio.charset.StandardCharsets.UTF_8.toString());
+            String filePath = serverPath + "/download?fileName=" + URLEncoder
+                    .encode(filePathDownload, java.nio.charset.StandardCharsets.UTF_8.toString()) + "&userAddress"
+                    + URLEncoder.encode(hostAddress, java.nio.charset.StandardCharsets.UTF_8.toString());
             return filePath;
-        }
-        catch (UnsupportedEncodingException | UnknownHostException e)
-        {
+        } catch (UnsupportedEncodingException | UnknownHostException e) {
             return "";
         }
     }
 
     // get file URL
-    public String getHistoryFileUrl(String fileName, Integer version, String file, Boolean forDocumentServer)
-    {
-        try
-        {
+    public String getHistoryFileUrl(final String fileName, final Integer version, final String file,
+                                    final Boolean forDocumentServer) {
+        try {
             String serverPath = storagePathBuilder.getServerUrl(forDocumentServer);  // get server URL
             String hostAddress = storagePathBuilder.getStorageLocation();  // get the storage directory
             String filePathDownload = !fileName.contains(InetAddress.getLocalHost().getHostAddress()) ? fileName
-                    : fileName.substring(fileName.indexOf(InetAddress.getLocalHost().getHostAddress()) + InetAddress.getLocalHost().getHostAddress().length() + 1);
-            String userAddress = forDocumentServer ? "&userAddress" + URLEncoder.encode(hostAddress, java.nio.charset.StandardCharsets.UTF_8.toString()) : "";
-            String filePath = serverPath + "/downloadhistory?fileName=" + URLEncoder.encode(filePathDownload, java.nio.charset.StandardCharsets.UTF_8.toString())
-                + "&ver=" + version + "&file="+file
+                    : fileName.substring(fileName.indexOf(InetAddress.getLocalHost().getHostAddress())
+                    + InetAddress.getLocalHost().getHostAddress().length() + 1);
+            String userAddress = forDocumentServer ? "&userAddress" + URLEncoder
+                    .encode(hostAddress, java.nio.charset.StandardCharsets.UTF_8.toString()) : "";
+            String filePath = serverPath + "/downloadhistory?fileName=" + URLEncoder
+                    .encode(filePathDownload, java.nio.charset.StandardCharsets.UTF_8.toString())
+                + "&ver=" + version + "&file=" + file
                 + userAddress;
             return filePath;
-        }
-        catch (UnsupportedEncodingException | UnknownHostException e)
-        {
+        } catch (UnsupportedEncodingException | UnknownHostException e) {
             return "";
         }
     }
 
     // get the callback URL
-    public String getCallback(String fileName)
-    {
+    public String getCallback(final String fileName) {
         String serverPath = storagePathBuilder.getServerUrl(true);
         String storageAddress = storagePathBuilder.getStorageLocation();
-        try
-        {
-            String query = trackUrl+"?fileName="+
-                    URLEncoder.encode(fileName, java.nio.charset.StandardCharsets.UTF_8.toString())
-                    + "&userAddress=" + URLEncoder.encode(storageAddress, java.nio.charset.StandardCharsets.UTF_8.toString());
+        try {
+            String query = trackUrl + "?fileName="
+                    + URLEncoder.encode(fileName, java.nio.charset.StandardCharsets.UTF_8.toString())
+                    + "&userAddress=" + URLEncoder
+                    .encode(storageAddress, java.nio.charset.StandardCharsets.UTF_8.toString());
             return serverPath + query;
-        }
-        catch (UnsupportedEncodingException e)
-        {
+        } catch (UnsupportedEncodingException e) {
             return "";
         }
     }
 
     // get URL to download a file
-    public String getDownloadUrl(String fileName, Boolean isServer) {
+    public String getDownloadUrl(final String fileName, final Boolean isServer) {
         String serverPath = storagePathBuilder.getServerUrl(isServer);
         String storageAddress = storagePathBuilder.getStorageLocation();
-        try
-        {
-            String userAddress = isServer ? "&userAddress=" + URLEncoder.encode(storageAddress, java.nio.charset.StandardCharsets.UTF_8.toString()) : "";
-            String query = downloadUrl+"?fileName="
+        try {
+            String userAddress = isServer ? "&userAddress=" + URLEncoder
+                    .encode(storageAddress, java.nio.charset.StandardCharsets.UTF_8.toString()) : "";
+            String query = downloadUrl + "?fileName="
                     + URLEncoder.encode(fileName, java.nio.charset.StandardCharsets.UTF_8.toString())
                     + userAddress;
 
             return serverPath + query;
-        }
-        catch (UnsupportedEncodingException e)
-        {
+        } catch (UnsupportedEncodingException e) {
             return "";
         }
     }
 
     // get file information
-    public ArrayList<Map<String, Object>> getFilesInfo(){
+    public ArrayList<Map<String, Object>> getFilesInfo() {
         ArrayList<Map<String, Object>> files = new ArrayList<>();
 
         // run through all the stored files
-        for(File file : storageMutator.getStoredFiles()){
+        for (File file : storageMutator.getStoredFiles()) {
             Map<String, Object> map = new LinkedHashMap<>();  // write all the parameters to the map
             map.put("version", storagePathBuilder.getFileVersion(file.getName(), false));
             map.put("id", serviceConverter
-                    .generateRevisionId(storagePathBuilder.getStorageLocation() +
-                            "/" + file.getName() + "/"
+                    .generateRevisionId(storagePathBuilder.getStorageLocation()
+                            + "/" + file.getName() + "/"
                             + Paths.get(storagePathBuilder.getFileLocation(file.getName()))
                             .toFile()
                             .lastModified()));
-            map.put("contentLength", new BigDecimal(String.valueOf((file.length()/1024.0)))
+            map.put("contentLength", new BigDecimal(String.valueOf((file.length() / Double.valueOf(KILOBYTE_SIZE))))
                     .setScale(2, RoundingMode.HALF_UP) + " KB");
             map.put("pureContentLength", file.length());
             map.put("title", file.getName());
@@ -193,11 +192,11 @@ public class DefaultDocumentManager implements DocumentManager {
     }
 
     // get file information by its ID
-    public ArrayList<Map<String, Object>> getFilesInfo(String fileId){
+    public ArrayList<Map<String, Object>> getFilesInfo(final String fileId) {
         ArrayList<Map<String, Object>> file = new ArrayList<>();
 
-        for (Map<String, Object> map : getFilesInfo()){
-            if (map.get("id").equals(fileId)){
+        for (Map<String, Object> map : getFilesInfo()) {
+            if (map.get("id").equals(fileId)) {
                 file.add(map);
                 break;
             }
@@ -207,26 +206,33 @@ public class DefaultDocumentManager implements DocumentManager {
     }
 
     // get the path to the file version by the history path and file version
-    public String versionDir(String path, Integer version, boolean historyPath) {
-        if (!historyPath){
+    public String versionDir(final String path, final Integer version, final boolean historyPath) {
+        if (!historyPath) {
             return storagePathBuilder.getHistoryDir(storagePathBuilder.getFileLocation(path)) + version;
         }
         return path + File.separator + version;
     }
 
     // create demo document
-    public String createDemo(String fileExt,Boolean sample,String uid,String uname) {
-        String demoName = (sample ? "sample." : "new.") + fileExt;  // create sample or new template file with the necessary extension
-        String demoPath = "assets" + File.separator  + (sample ? "sample" : "new") + File.separator + demoName;  // get the path to the sample document
-        String fileName = getCorrectName(demoName);  // get a file name with an index if the file with such a name already exists
+    public String createDemo(final String fileExt, final Boolean sample, final String uid, final String uname) {
+        String demoName = (sample ? "sample." : "new.")
+                + fileExt;  // create sample or new template file with the necessary extension
+        String demoPath = "assets" + File.separator  + (sample ? "sample" : "new")
+                + File.separator + demoName;  // get the path to the sample document
+
+        // get a file name with an index if the file with such a name already exists
+        String fileName = getCorrectName(demoName);
 
         InputStream stream = Thread.currentThread()
                                     .getContextClassLoader()
                                     .getResourceAsStream(demoPath);  // get the input file stream
 
-        if (stream == null) return null;
+        if (stream == null) {
+            return null;
+        }
 
-        storageMutator.createFile(Path.of(storagePathBuilder.getFileLocation(fileName)), stream);  // create a file in the specified directory
+        storageMutator.createFile(Path.of(storagePathBuilder
+                .getFileLocation(fileName)), stream);  // create a file in the specified directory
         storageMutator.createMeta(fileName, uid, uname);  // create meta information of the demo file
 
         return fileName;

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/document/DocumentManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -23,14 +23,20 @@ import java.util.Map;
 
 // specify the document manager functions
 public interface DocumentManager {
-    String getCorrectName(String fileName);  // get a file name with an index if the file with such a name already exists
+
+    // get a file name with an index if the file with such a name already exists
+    String getCorrectName(String fileName);
     String getFileUri(String fileName, Boolean forDocumentServer);  // get file URL
     String getHistoryFileUrl(String fileName, Integer version, String file, Boolean forDocumentServer);  // get file URL
     String getCallback(String fileName);  // get the callback URL
     String getDownloadUrl(String fileName, Boolean forDocumentServer);  // get URL to download a file
     ArrayList<Map<String, Object>> getFilesInfo();  // get file information
     ArrayList<Map<String, Object>> getFilesInfo(String fileId);  // get file information by its ID
-    String versionDir(String path, Integer version, boolean historyPath);  // get the path to the file version by the history path and file version
-    String createDemo(String fileExt,Boolean sample,String uid,String uname) throws Exception;  // create demo document
+
+    //  get the path to the file version by the history path and file version
+    String versionDir(String path, Integer version, boolean historyPath);
+
+    // create demo document
+    String createDemo(String fileExt, Boolean sample, String uid, String uname) throws Exception;
     String getCreateUrl(String fileName, Boolean sample);  // get URL to the created file
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/history/DefaultHistoryManager.java

@@ -1,17 +1,19 @@
 /**
- * (c) Copyright Ascensio System SIA 2021
+ *
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
- * http://www.apache.org/licenses/LICENSE-2.0
+ *     http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
+ *
  */
 
 package com.onlyoffice.integration.documentserver.managers.history;
@@ -32,9 +34,13 @@ import org.springframework.stereotype.Component;
 
 import java.io.File;
 import java.io.FileInputStream;
-import java.util.*;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Scanner;
 
-//TODO: Rebuild completely
+// todo: Rebuild completely
 @Component
 public class DefaultHistoryManager implements HistoryManager {
 
@@ -56,10 +62,12 @@ public class DefaultHistoryManager implements HistoryManager {
     @Autowired
     private ObjectMapper objectMapper;
 
-    //TODO: Refactoring
+    // todo: Refactoring
     @SneakyThrows
-    public String[] getHistory(Document document) {  // get document history
-        String histDir = storagePathBuilder.getHistoryDir(storagePathBuilder.getFileLocation(document.getTitle()));  // get history directory
+    public String[] getHistory(final Document document) {  // get document history
+
+        // get history directory
+        String histDir = storagePathBuilder.getHistoryDir(storagePathBuilder.getFileLocation(document.getTitle()));
         Integer curVer = storagePathBuilder.getFileVersion(histDir, false);  // get current file version
 
         if (curVer > 0) {  // check if the current file version is greater than 0
@@ -69,14 +77,17 @@ public class DefaultHistoryManager implements HistoryManager {
             for (Integer i = 1; i <= curVer; i++) {  // run through all the file versions
                 Map<String, Object> obj = new HashMap<String, Object>();
                 Map<String, Object> dataObj = new HashMap<String, Object>();
-                String verDir = documentManager.versionDir(histDir, i, true);  // get the path to the given file version
+                String verDir = documentManager
+                        .versionDir(histDir, i, true);  // get the path to the given file version
 
-                String key = i == curVer ? document.getKey() : readFileToEnd(new File(verDir + File.separator + "key.txt"));  // get document key
+                String key = i == curVer ? document.getKey() : readFileToEnd(new File(verDir
+                        + File.separator + "key.txt"));  // get document key
                 obj.put("key", key);
                 obj.put("version", i);
 
                 if (i == 1) {  // check if the version number is equal to 1
-                    String createdInfo = readFileToEnd(new File(histDir + File.separator + "createdInfo.json"));  // get file with meta data
+                    String createdInfo = readFileToEnd(new File(histDir
+                            + File.separator + "createdInfo.json"));  // get file with meta data
                     JSONObject json = (JSONObject) parser.parse(createdInfo);  // and turn it into json object
 
                     // write meta information to the object (user information and creation date)
@@ -87,17 +98,23 @@ public class DefaultHistoryManager implements HistoryManager {
                     obj.put("user", user);
                 }
 
-                dataObj.put("fileType", fileUtility.getFileExtension(document.getTitle()).replace(".", ""));
+                dataObj.put("fileType", fileUtility
+                        .getFileExtension(document.getTitle()).replace(".", ""));
                 dataObj.put("key", key);
-                dataObj.put("url", i == curVer ? document.getUrl() :
-                        documentManager.getHistoryFileUrl(document.getTitle(), i, "prev" + fileUtility.getFileExtension(document.getTitle()), true));
-                dataObj.put("directUrl", i == curVer ? document.getDirectUrl() :
-                        documentManager.getHistoryFileUrl(document.getTitle(), i, "prev" + fileUtility.getFileExtension(document.getTitle()), false));
+                dataObj.put("url", i == curVer ? document.getUrl()
+                        : documentManager.getHistoryFileUrl(document.getTitle(), i, "prev" + fileUtility
+                        .getFileExtension(document.getTitle()), true));
+                if (!document.getDirectUrl().equals("")) {
+                    dataObj.put("directUrl", i == curVer ? document.getDirectUrl()
+                            : documentManager.getHistoryFileUrl(document.getTitle(), i, "prev" + fileUtility
+                            .getFileExtension(document.getTitle()), false));
+                }
                 dataObj.put("version", i);
 
                 if (i > 1) {  //check if the version number is greater than 1
                     // if so, get the path to the changes.json file
-                    JSONObject changes = (JSONObject) parser.parse(readFileToEnd(new File(documentManager.versionDir(histDir, i - 1, true) + File.separator + "changes.json")));
+                    JSONObject changes = (JSONObject) parser.parse(readFileToEnd(new File(documentManager
+                            .versionDir(histDir, i - 1, true) + File.separator + "changes.json")));
                     JSONObject change = (JSONObject) ((JSONArray) changes.get("changes")).get(0);
 
                     // write information about changes to the object
@@ -106,19 +123,27 @@ public class DefaultHistoryManager implements HistoryManager {
                     obj.put("created", change.get("created"));
                     obj.put("user", change.get("user"));
 
-                    Map<String, Object> prev = (Map<String, Object>) histData.get(Integer.toString(i - 2));  // get the history data from the previous file version
+                    // get the history data from the previous file version
+                    Map<String, Object> prev = (Map<String, Object>) histData.get(Integer.toString(i - 2));
                     Map<String, Object> prevInfo = new HashMap<String, Object>();
                     prevInfo.put("fileType", prev.get("fileType"));
                     prevInfo.put("key", prev.get("key"));  // write key and URL information about previous file version
                     prevInfo.put("url", prev.get("url"));
-                    prevInfo.put("directUrl", prev.get("directUrl"));
-                    dataObj.put("previous", prevInfo);  // write information about previous file version to the data object
+                    if (!document.getDirectUrl().equals("")) {
+                        prevInfo.put("directUrl", prev.get("directUrl"));
+                    }
+
+                    // write information about previous file version to the data object
+                    dataObj.put("previous", prevInfo);
                     // write the path to the diff.zip archive with differences in this file version
                     Integer verdiff = i - 1;
-                    dataObj.put("changesUrl", documentManager.getHistoryFileUrl(document.getTitle(), verdiff, "diff.zip", true));
+                    dataObj.put("changesUrl", documentManager
+                            .getHistoryFileUrl(document.getTitle(), verdiff, "diff.zip", true));
                 }
 
-                if (jwtManager.tokenEnabled()) dataObj.put("token", jwtManager.createToken(dataObj));
+                if (jwtManager.tokenEnabled()) {
+                    dataObj.put("token", jwtManager.createToken(dataObj));
+                }
 
                 hist.add(obj);
                 histData.put(Integer.toString(i - 1), dataObj);
@@ -130,7 +155,8 @@ public class DefaultHistoryManager implements HistoryManager {
             histObj.put("history", hist);
 
             try {
-                return new String[]{objectMapper.writeValueAsString(histObj), objectMapper.writeValueAsString(histData)};
+                return new String[]{objectMapper.writeValueAsString(histObj),
+                        objectMapper.writeValueAsString(histData)};
             } catch (JsonProcessingException e) {
                 e.printStackTrace();
             }
@@ -139,7 +165,7 @@ public class DefaultHistoryManager implements HistoryManager {
     }
 
     // read a file
-    private String readFileToEnd(File file) {
+    private String readFileToEnd(final File file) {
         String output = "";
         try {
             try (FileInputStream is = new FileInputStream(file)) {

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/history/HistoryManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/jwt/DefaultJwtManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -43,7 +43,7 @@ public class DefaultJwtManager implements JwtManager {
     private JSONParser parser;
 
     // create document token
-    public String createToken(Map<String, Object> payloadClaims) {
+    public String createToken(final Map<String, Object> payloadClaims) {
         try {
             // build a HMAC signer using a SHA-256 hash
             Signer signer = HMACSigner.newSHA256Signer(tokenSecret);
@@ -63,18 +63,20 @@ public class DefaultJwtManager implements JwtManager {
     }
 
     // read document token
-    public JWT readToken(String token) {
+    public JWT readToken(final String token) {
         try {
             // build a HMAC verifier using the token secret
             Verifier verifier = HMACVerifier.newVerifier(tokenSecret);
-            return JWT.getDecoder().decode(token, verifier);  // verify and decode the encoded string JWT to a rich object
+
+            // verify and decode the encoded string JWT to a rich object
+            return JWT.getDecoder().decode(token, verifier);
         } catch (Exception exception) {
             return null;
         }
     }
 
     // parse the body
-    public JSONObject parseBody(String payload, String header) {
+    public JSONObject parseBody(final String payload, final String header) {
         JSONObject body;
         try {
             Object obj = parser.parse(payload);  // get body parameters by parsing the payload
@@ -86,7 +88,9 @@ public class DefaultJwtManager implements JwtManager {
             String token = (String) body.get("token");  // get token from the body
             if (token == null) {  // if token is empty
                 if (header != null && !header.isBlank()) {  // and the header is defined
-                    token = header.startsWith("Bearer ") ? header.substring(7) : header;  // get token from the header (it is placed after the Bearer prefix if it exists)
+
+                    // get token from the header (it is placed after the Bearer prefix if it exists)
+                    token = header.startsWith("Bearer ") ? header.substring("Bearer ".length()) : header;
                 }
             }
             if (token == null || token.isBlank()) {
@@ -100,7 +104,7 @@ public class DefaultJwtManager implements JwtManager {
             if (jwt.getObject("payload") != null) {  // get payload from the token and check if it is not empty
                 try {
                     @SuppressWarnings("unchecked") LinkedHashMap<String, Object> jwtPayload =
-                            (LinkedHashMap<String, Object>)jwt.getObject("payload");
+                            (LinkedHashMap<String, Object>) jwt.getObject("payload");
 
                     jwt.claims = jwtPayload;
                 } catch (Exception ex) {

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/jwt/JwtManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/template/SampleTemplateManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -42,24 +42,27 @@ public class SampleTemplateManager implements TemplateManager {
     private FileUtility fileUtility;
 
     // create a template document with the specified name
-    public List<Template> createTemplates(String fileName){
+    public List<Template> createTemplates(final String fileName) {
         List<Template> templates = List.of(
-                new Template("", "Blank", documentManager.getCreateUrl(fileName, false)),  // create a blank template
-                new Template(getTemplateImageUrl(fileName), "With sample content", documentManager.getCreateUrl(fileName, true))  // create a template with sample content using the template image
+                new Template("", "Blank", documentManager
+                        .getCreateUrl(fileName, false)),  // create a blank template
+                new Template(getTemplateImageUrl(fileName), "With sample content", documentManager
+                        .getCreateUrl(fileName,
+                                true))  // create a template with sample content using the template image
         );
 
         return templates;
     }
 
     // get the template image URL for the specified file
-    public String getTemplateImageUrl(String fileName){
+    public String getTemplateImageUrl(final String fileName) {
         DocumentType fileType = fileUtility.getDocumentType(fileName);  // get the file type
         String path = storagePathBuilder.getServerUrl(true);  // get server URL
-        if(fileType.equals(DocumentType.word)){  // get URL to the template image for the word document type
+        if (fileType.equals(DocumentType.word)) {  // get URL to the template image for the word document type
             return path + "/css/img/file_docx.svg";
-        } else if(fileType.equals(DocumentType.slide)){  // get URL to the template image for the slide document type
+        } else if (fileType.equals(DocumentType.slide)) {  // get URL to the template image for the slide document type
             return path + "/css/img/file_pptx.svg";
-        } else if(fileType.equals(DocumentType.cell)){  // get URL to the template image for the cell document type
+        } else if (fileType.equals(DocumentType.cell)) {  // get URL to the template image for the cell document type
             return path + "/css/img/file_xlsx.svg";
         }
         return path + "/css/img/file_docx.svg";  // get URL to the template image for the default document type (word)

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/managers/template/TemplateManager.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/AbstractModel.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/configurations/Customization.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -28,21 +28,26 @@ import org.springframework.stereotype.Component;
 @Scope("prototype")
 @Getter
 @Setter
-public class Customization {  // the parameters which allow to customize the editor interface so that it looked like your other products (if there are any) and change the presence or absence of the additional buttons, links, change logos and editor owner details
+/* The parameters which allow to customize the editor interface so that it looked like your
+ other products (if there are any) and change the presence or absence of the additional buttons,
+  links, change logos and editor owner details. */
+public class Customization {
     @Autowired
     private Logo logo;  // the image file at the top left corner of the Editor header
     @Autowired
     private Goback goback;  // the settings for the Open file location menu button and upper right corner button
     private Boolean autosave = true;  // if the Autosave menu option is enabled or disabled
     private Boolean comments = true;  // if the Comments menu button is displayed or hidden
-    private Boolean compactHeader = false;  // if the additional action buttons are displayed in the upper part of the editor window header next to the logo (false) or in the toolbar (true)
+    private Boolean compactHeader = false;  /* if the additional action buttons are displayed
+    in the upper part of the editor window header next to the logo (false) or in the toolbar (true) */
     private Boolean compactToolbar = false;  // if the top toolbar type displayed is full (false) or compact (true)
     private Boolean compatibleFeatures = false;  // the use of functionality only compatible with the OOXML format
-    private Boolean forcesave = false;  // add the request for the forced file saving to the callback handler when saving the document within the document editing service
+    private Boolean forcesave = false;  /* add the request for the forced file saving to the callback handler
+     when saving the document within the document editing service */
     private Boolean help = true;  //  if the Help menu button is displayed or hidden
     private Boolean hideRightMenu = false;  // if the right menu is displayed or hidden on first loading
     private Boolean hideRulers = false;  // if the editor rulers are displayed or hidden
     private Boolean submitForm = false;  // if the Submit form button is displayed or hidden
     private Boolean about = true;
-    private Boolean feedback =true;
+    private Boolean feedback = true;
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/configurations/Embedded.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -28,9 +28,13 @@ import org.springframework.stereotype.Component;
 @Scope("prototype")
 @Getter
 @Setter
-public class Embedded {  // the parameters which allow to change the settings which define the behavior of the buttons in the embedded mode
-    private String embedUrl;  // the absolute URL to the document serving as a source file for the document embedded into the web page
-    private String saveUrl;  // the absolute URL that will allow the document to be saved onto the user personal computer
+/* The parameters which allow to change the settings
+ which define the behavior of the buttons in the embedded mode */
+public class Embedded {
+    private String embedUrl;  /* the absolute URL to the document serving as a source file for the document embedded
+     into the web page */
+    private String saveUrl;  /* the absolute URL that will allow the document to be saved
+     onto the user personal computer */
     private String shareUrl;  // the absolute URL that will allow other users to share this document
     private ToolbarDocked toolbarDocked;  // the place for the embedded viewer toolbar, can be either top or bottom
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/configurations/Goback.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -38,7 +38,8 @@ public class Goback {  // the settings for the Open file location menu button an
     private String indexMapping;
 
     @Getter
-    private String url;  // the absolute URL to the website address which will be opened when clicking the Open file location menu button
+    private String url;  /* the absolute URL to the website address which will be opened
+    when clicking the Open file location menu button */
 
     @PostConstruct
     private void init() {

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/configurations/Info.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -31,7 +31,9 @@ import java.util.Locale;
 @Scope("prototype")
 @Getter
 @Setter
-public class Info {  // the additional parameters for the document (document owner, folder where the document is stored, uploading date, sharing settings)
+/* The additional parameters for the document (document owner, folder where the document is stored,
+ uploading date, sharing settings) */
+public class Info {
     private String owner = "Me";  // the name of the document owner/creator
     private Boolean favorite = null;  // the highlighting state of the Favorite icon
     private String uploaded = getDate();  // the document uploading date

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/configurations/Logo.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/enums/Action.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/enums/ConvertErrorType.java

@@ -0,0 +1,48 @@
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+package com.onlyoffice.integration.documentserver.models.enums;
+
+public enum ConvertErrorType {
+    EMPTY_ERROR(0, ""),
+    CONVERTATION_UNKNOWN(-1, "Error convertation unknown"),
+    CONVERTATION_TIMEOUT(-2, "Error convertation timeout"),
+    CONVERTATION_ERROR(-3, "Error convertation error"),
+    DOWNLOAD_ERROR(-4, "Error download error"),
+    UNEXPECTED_GUID_ERROR(-5, "Error unexpected guid"),
+    DATABASE_ERROR(-6, "Error database"),
+    DOCUMENT_REQUEST_ERROR(-7, "Error document request"),
+    DOCUMENT_VKEY_ERROR(-8, "Error document VKey");
+
+    private final int code;
+    private final String label;
+
+    ConvertErrorType(final int codeParam, final String labelParam) {
+        this.code = codeParam;
+        this.label = labelParam;
+    }
+
+    public static String labelOfCode(final int code) {
+        for (ConvertErrorType convertErrorType : values()) {
+            if (convertErrorType.code == code) {
+                return convertErrorType.label;
+            }
+        }
+        return "ErrorCode = " + code;
+    }
+}

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/enums/DocumentType.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/enums/Mode.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/enums/ToolbarDocked.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/enums/Type.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/filemodel/CommentGroup.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/filemodel/Document.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -31,13 +31,16 @@ import org.springframework.stereotype.Component;
 @Setter
 public class Document {  // the parameters pertaining to the document (title, url, file type, etc.)
     @Autowired
-    private Info info;  // additional parameters for the document (document owner, folder where the document is stored, uploading date, sharing settings)
+    private Info info;  /* additional parameters for the document (document owner, folder where the document is stored,
+     uploading date, sharing settings) */
     @Autowired
     private Permission permissions;  // the permission for the document to be edited and downloaded or not
     private String fileType;  //  the file type for the source viewed or edited document
     private String key;  // the unique document identifier used by the service to recognize the document
-    private String urlUser;  // the absolute URL that will allow the document to be saved onto the user personal computer
-    private String title;  // the desired file name for the viewed or edited document which will also be used as file name when the document is downloaded
+    private String urlUser;  /* the absolute URL that will allow the document to be saved
+    onto the user personal computer */
+    private String title;  /* the desired file name for the viewed or edited document which will also be used
+    as file name when the document is downloaded */
     private String url;  // the absolute URL where the source viewed or edited document is stored
     private String directUrl;
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/filemodel/EditorConfig.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,7 +21,9 @@ package com.onlyoffice.integration.documentserver.models.filemodel;
 import com.onlyoffice.integration.documentserver.models.configurations.Customization;
 import com.onlyoffice.integration.documentserver.models.configurations.Embedded;
 import com.onlyoffice.integration.documentserver.models.enums.Mode;
-import lombok.*;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.context.annotation.Scope;
 import org.springframework.stereotype.Component;
@@ -34,18 +36,24 @@ import java.util.List;
 @Data
 @NoArgsConstructor
 @AllArgsConstructor
-public class EditorConfig {  // the parameters pertaining to the editor interface: opening mode (viewer or editor), interface language, additional buttons, etc.
-    private HashMap<String, Object> actionLink = null;  // the data which contains the information about the action in the document that will be scrolled to
+public class EditorConfig {  /* the parameters pertaining to the editor interface: opening mode (viewer or editor),
+ interface language, additional buttons, etc. */
+    private HashMap<String, Object> actionLink = null;  /* the data which contains the information about the
+    action in the document that will be scrolled to */
     private String callbackUrl;  // the absolute URL to the document storage service
     private HashMap<String, Object> coEditing = null;
     private String createUrl;  // the absolute URL of the document where it will be created and available after creation
     @Autowired
-    private Customization customization;  // the parameters which allow to customize the editor interface so that it looked like your other products (if there are any) and change the presence or absence of the additional buttons, links, change logos and editor owner details
+    private Customization customization;  /* the parameters which allow to customize the editor interface
+     so that it looked like your other products (if there are any) and change the presence or absence
+      of the additional buttons, links, change logos and editor owner details */
     @Autowired
-    private Embedded embedded;  // the parameters which allow to change the settings which define the behavior of the buttons in the embedded mode
+    private Embedded embedded;  /* the parameters which allow to change the settings which define
+     the behavior of the buttons in the embedded mode */
     private String lang;  // the editor interface language
     private Mode mode;  // the editor opening mode
     @Autowired
     private User user;  // the user currently viewing or editing the document
-    private List<Template> templates;  // the presence or absence of the templates in the <b>Create New...</b> menu option
+    private List<Template> templates;  /* the presence or absence
+     of the templates in the <b>Create New...</b> menu option */
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/filemodel/FileModel.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -30,12 +30,15 @@ import org.springframework.stereotype.Component;
 @Scope("prototype")
 @Getter
 @Setter
-public class FileModel {  // the file base parameters which include the platform type used, document display size (width and height) and type of the document opened
+/* the file base parameters which include the platform type used,
+ document display size (width and height) and type of the document opened */
+public class FileModel {
     @Autowired
     private Document document;  // the parameters pertaining to the document (title, url, file type, etc.)
     private DocumentType documentType;  // the document type to be opened
     @Autowired
-    private EditorConfig editorConfig;  //  the parameters pertaining to the editor interface: opening mode (viewer or editor), interface language, additional buttons, etc.
+    private EditorConfig editorConfig;  /*  the parameters pertaining to the
+     editor interface: opening mode (viewer or editor), interface language, additional buttons, etc. */
     private String token;  // the encrypted signature added to the Document Server config
     private Type type;  // the platform type used to access the document
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/filemodel/Permission.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -40,7 +40,8 @@ public class Permission extends AbstractModel {  // the permission for the docum
     private Boolean edit = true;  // if the document can be edited or only viewed
     private Boolean print = true;  // if the document can be printed or not
     private Boolean fillForms = true;  // if the forms can be filled
-    private Boolean modifyFilter = true;  // if the filter can applied globally (true) affecting all the other users, or locally (false)
+    private Boolean modifyFilter = true;  /* if the filter can applied globally (true) affecting all the
+     other users, or locally (false) */
     private Boolean modifyContentControl = true;  // if the content control settings can be changed
     private Boolean review = true;  // if the document can be reviewed or not
     private Boolean chat = true;  // if a chat can be used

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/filemodel/Template.java

@@ -1,3 +1,21 @@
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
 package com.onlyoffice.integration.documentserver.models.filemodel;
 
 import lombok.AllArgsConstructor;

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/models/filemodel/User.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -34,9 +34,9 @@ public class User extends AbstractModel {
     private String group;
 
     // the user configuration parameters
-    public void configure(int id, String name, String group){
-        this.id = "uid-"+id;  // the user id
-        this.name = name;  // the user name
-        this.group = group;  // the group the user belongs to
+    public void configure(final int idParam, final String nameParam, final String groupParam) {
+        this.id = "uid-" + idParam;  // the user id
+        this.name = nameParam;  // the user name
+        this.group = groupParam;  // the group the user belongs to
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/serializers/FilterState.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/serializers/SerializerFilter.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -22,13 +22,17 @@ import java.util.List;
 
 public class SerializerFilter {
     @Override
-    public boolean equals(Object obj) {
+    public boolean equals(final Object obj) {
         if (obj instanceof List) {
-            if(((List<?>) obj).size() == 1 && ((List<?>) obj).get(0) == FilterState.NULL.toString()){
+            if (((List<?>) obj).size() == 1 && ((List<?>) obj).get(0) == FilterState.NULL.toString()) {
                 return true;
             }
             return false;
         }
         return false;
     }
+    @Override
+    public int hashCode() {
+        return super.hashCode();
+    }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/storage/FileStorageMutator.java

@@ -1,3 +1,21 @@
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
 package com.onlyoffice.integration.documentserver.storage;
 
 import org.springframework.core.io.Resource;
@@ -16,7 +34,7 @@ public interface FileStorageMutator {
     boolean writeToFile(String pathName, String payload);  // write the payload to the file
     boolean moveFile(Path source, Path destination);  // move a file to the specified destination
     Resource loadFileAsResource(String fileName);  // load file as a resource
-    Resource loadFileAsResourceHistory(String fileName,String version,String file);  // load file as a resource
+    Resource loadFileAsResourceHistory(String fileName, String version, String file);  // load file as a resource
     File[] getStoredFiles();  // get a collection of all the stored files
     void createMeta(String fileName, String uid, String uname);  // create the file meta information
     boolean createOrUpdateFile(Path path, InputStream stream);  // create or update a file

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/storage/FileStoragePathBuilder.java

@@ -1,3 +1,21 @@
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
 package com.onlyoffice.integration.documentserver.storage;
 
 // specify the file storage path builder functions
@@ -8,5 +26,6 @@ public interface FileStoragePathBuilder {
     String getServerUrl(Boolean forDocumentServer);  // get the server URL
     String getHistoryDir(String fileName);  // get the history directory
     int getFileVersion(String historyPath, Boolean ifIndexPage);  // get the file version
-    String getForcesavePath(String fileName, Boolean create);  // get the path where all the forcely saved file versions are saved or create it
+    String getForcesavePath(String fileName, Boolean create);  /* get the path where all the
+    forcely saved file versions are saved or create it */
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/storage/LocalFileStorage.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -31,8 +31,15 @@ import org.springframework.stereotype.Component;
 import org.springframework.util.FileSystemUtils;
 
 import javax.servlet.http.HttpServletRequest;
-import java.io.*;
-import java.net.*;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.FileWriter;
+import java.io.IOException;
+import java.io.InputStream;
+import java.net.InetAddress;
+import java.net.MalformedURLException;
+import java.net.URLDecoder;
+import java.net.UnknownHostException;
 import java.nio.charset.StandardCharsets;
 import java.nio.file.Files;
 import java.nio.file.Path;
@@ -43,7 +50,9 @@ import java.util.Date;
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
-//TODO: Refactoring
+import static com.onlyoffice.integration.documentserver.util.Constants.KILOBYTE_SIZE;
+
+// todo: Refactoring
 @Component
 @Primary
 public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuilder {
@@ -69,12 +78,12 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
     /*
         This Storage configuration method should be called whenever a new storage folder is required
      */
-    public void configure(String address) {
+    public void configure(final String address) {
         this.storageAddress = address;
-        if(this.storageAddress == null){
-            try{
+        if (this.storageAddress == null) {
+            try {
                 this.storageAddress = InetAddress.getLocalHost().getHostAddress();
-            } catch (UnknownHostException e){
+            } catch (UnknownHostException e) {
                 this.storageAddress = "unknown_storage";
             }
         }
@@ -83,7 +92,7 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
     }
 
     // get the storage directory
-    public String getStorageLocation(){
+    public String getStorageLocation() {
         String serverPath = System.getProperty("user.dir");  // get the path to the server
         String directory;  // create the storage directory
         if (Paths.get(this.storageAddress).isAbsolute()) {
@@ -102,7 +111,7 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
     }
 
     // get the directory of the specified file
-    public String getFileLocation(String fileName){
+    public String getFileLocation(final String fileName) {
         if (fileName.contains(File.separator)) {
             return getStorageLocation() + fileName;
         }
@@ -110,8 +119,10 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
     }
 
     // create a new directory if it does not exist
-    public void createDirectory(Path path){
-        if (Files.exists(path)) return;
+    public void createDirectory(final Path path) {
+        if (Files.exists(path)) {
+            return;
+        }
         try {
             Files.createDirectories(path);
         } catch (IOException e) {
@@ -120,18 +131,16 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
     }
 
     // create a new file if it does not exist
-    public boolean createFile(Path path, InputStream stream){
-        if (Files.exists(path)){
+    public boolean createFile(final Path path, final InputStream stream) {
+        if (Files.exists(path)) {
             return true;
         }
         try {
             File file = Files.createFile(path).toFile();  // create a new file in the specified path
-            try (FileOutputStream out = new FileOutputStream(file))
-            {
+            try (FileOutputStream out = new FileOutputStream(file)) {
                 int read;
-                final byte[] bytes = new byte[1024];
-                while ((read = stream.read(bytes)) != -1)
-                {
+                final byte[] bytes = new byte[KILOBYTE_SIZE];
+                while ((read = stream.read(bytes)) != -1) {
                     out.write(bytes, 0, read);  // write bytes to the output stream
                 }
                 out.flush();  // force write data to the output stream that can be cached in the current thread
@@ -143,38 +152,59 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
     }
 
     // delete a file
-    public boolean deleteFile(String fileName){
-        fileName = URLDecoder.decode(fileName, StandardCharsets.UTF_8);  // decode a x-www-form-urlencoded string
-        if (fileName.isBlank()) return false;
+    public boolean deleteFile(final String fileNameParam) {
+        String fileName = URLDecoder
+                .decode(fileNameParam, StandardCharsets.UTF_8);  // decode a x-www-form-urlencoded string
+        if (fileName.isBlank()) {
+            return false;
+        }
 
-        String filenameWithoutExt = fileUtility.getFileNameWithoutExtension(fileName);  // get file name without extension
+        String filenameWithoutExt = fileUtility
+                .getFileNameWithoutExtension(fileName);  // get file name without extension
 
-        Path filePath = fileName.contains(File.separator) ? Paths.get(fileName) : Paths.get(getFileLocation(fileName));  // get the path to the file
-        Path filePathWithoutExt = fileName.contains(File.separator) ? Paths.get(filenameWithoutExt) : Paths.get(getStorageLocation() + filenameWithoutExt);  // get the path to the file without extension
+        Path filePath = fileName.contains(File.separator)
+                ? Paths.get(fileName) : Paths.get(getFileLocation(fileName));  // get the path to the file
+        Path filePathWithoutExt = fileName.contains(File.separator)
+                ? Paths.get(filenameWithoutExt) : Paths
+                .get(getStorageLocation() + filenameWithoutExt);  // get the path to the file without extension
 
-        boolean fileDeleted = FileSystemUtils.deleteRecursively(filePath.toFile());  // delete the specified file; for directories, recursively delete any nested directories or files as well
-        boolean fileWithoutExtDeleted = FileSystemUtils.deleteRecursively(filePathWithoutExt.toFile());  // delete the specified file without extension; for directories, recursively delete any nested directories or files as well
+        // delete the specified file; for directories, recursively delete any nested directories or files as well
+        boolean fileDeleted = FileSystemUtils.deleteRecursively(filePath.toFile());
+        /* delete the specified file without extension; for directories,
+         recursively delete any nested directories or files as well */
+        boolean fileWithoutExtDeleted = FileSystemUtils.deleteRecursively(filePathWithoutExt.toFile());
 
         return fileDeleted && fileWithoutExtDeleted;
     }
 
     // delete file history
-    public boolean deleteFileHistory(String fileName) {
-        fileName = URLDecoder.decode(fileName, StandardCharsets.UTF_8);  // decode a x-www-form-urlencoded string
-        if (fileName.isBlank()) return false;
+    public boolean deleteFileHistory(final String fileNameParam) {
+        String fileName = URLDecoder
+                .decode(fileNameParam, StandardCharsets.UTF_8);  // decode a x-www-form-urlencoded string
+        if (fileName.isBlank()) {
+            return false;
+        }
 
-        Path fileHistoryPath = Paths.get(getStorageLocation() + getHistoryDir(fileName));  // get the path to the history file
-        Path fileHistoryPathWithoutExt = Paths.get(getStorageLocation() + getHistoryDir(fileUtility.getFileNameWithoutExtension(fileName)));  // get the path to the history file without extension
+        Path fileHistoryPath = Paths
+                .get(getStorageLocation() + getHistoryDir(fileName));  // get the path to the history file
+        Path fileHistoryPathWithoutExt = Paths.get(getStorageLocation() + getHistoryDir(fileUtility
+                .getFileNameWithoutExtension(fileName)));  // get the path to the history file without extension
 
-        boolean historyDeleted = FileSystemUtils.deleteRecursively(fileHistoryPath.toFile());  // delete the specified history file; for directories, recursively delete any nested directories or files as well
-        boolean historyWithoutExtDeleted = FileSystemUtils.deleteRecursively(fileHistoryPathWithoutExt.toFile());  // delete the specified history file without extension; for directories, recursively delete any nested directories or files as well
+        /* delete the specified history file; for directories,
+         recursively delete any nested directories or files as well */
+        boolean historyDeleted = FileSystemUtils.deleteRecursively(fileHistoryPath.toFile());
+
+        /* delete the specified history file without extension; for directories,
+         recursively delete any nested directories or files as well */
+        boolean historyWithoutExtDeleted = FileSystemUtils.deleteRecursively(fileHistoryPathWithoutExt.toFile());
 
         return historyDeleted || historyWithoutExtDeleted;
     }
 
     // update a file
-    public String updateFile(String fileName, byte[] bytes) {
-        Path path = fileUtility.generateFilepath(getStorageLocation(), fileName);  // generate the path to the specified file
+    public String updateFile(final String fileName, final byte[] bytes) {
+        Path path = fileUtility
+                .generateFilepath(getStorageLocation(), fileName);  // generate the path to the specified file
         try {
             Files.write(path, bytes);  // write new information in the bytes format to the file
             return path.getFileName().toString();
@@ -185,7 +215,7 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
     }
 
     // move a file to the specified destination
-    public boolean moveFile(Path source, Path destination){
+    public boolean moveFile(final Path source, final Path destination) {
         try {
             Files.move(source, destination,
                     new StandardCopyOption[]{StandardCopyOption.REPLACE_EXISTING});
@@ -197,7 +227,7 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
     }
 
     // write the payload to the file
-    public boolean writeToFile(String pathName, String payload){
+    public boolean writeToFile(final String pathName, final String payload) {
         try (FileWriter fw = new FileWriter(pathName)) {
             fw.write(payload);
             return true;
@@ -208,16 +238,20 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
     }
 
     // get the path where all the forcely saved file versions are saved or create it
-    public String getForcesavePath(String fileName, Boolean create) {
+    public String getForcesavePath(final String fileName, final Boolean create) {
         String directory = getStorageLocation();
 
         Path path = Paths.get(directory);  // get the storage directory
-        if (!Files.exists(path)) return "";
+        if (!Files.exists(path)) {
+            return "";
+        }
 
         directory = getFileLocation(fileName) + historyPostfix + File.separator;
 
         path = Paths.get(directory);   // get the history file directory
-        if (!create && !Files.exists(path)) return "";
+        if (!create && !Files.exists(path)) {
+            return "";
+        }
 
         createDirectory(path);  // create a new directory where all the forcely saved file versions will be saved
 
@@ -231,29 +265,35 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
     }
 
     // load file as a resource
-    public Resource loadFileAsResource(String fileName){
-        String fileLocation = getForcesavePath(fileName, false);  // get the path where all the forcely saved file versions are saved
-        if (fileLocation.isBlank()){  // if file location is empty
+    public Resource loadFileAsResource(final String fileName) {
+        String fileLocation = getForcesavePath(fileName,
+                false);  // get the path where all the forcely saved file versions are saved
+        if (fileLocation.isBlank()) {  // if file location is empty
             fileLocation = getFileLocation(fileName);  // get it by the file name
         }
         try {
             Path filePath = Paths.get(fileLocation);  // get the path to the file location
             Resource resource = new UrlResource(filePath.toUri());  // convert the file path to URL
-            if(resource.exists()) return resource;
+            if (resource.exists()) {
+                return resource;
+            }
         } catch (MalformedURLException e) {
             e.printStackTrace();
         }
         return null;
     }
 
-    public Resource loadFileAsResourceHistory(String fileName,String version,String file){
+    public Resource loadFileAsResourceHistory(final String fileName, final String version, final String file) {
 
-        String fileLocation = getStorageLocation() + fileName + "-hist" + File.separator + version + File.separator + file;  // get it by the file name
+        String fileLocation = getStorageLocation() + fileName + "-hist" + File.separator + version
+                + File.separator + file;  // get it by the file name
 
         try {
             Path filePath = Paths.get(fileLocation);  // get the path to the file location
             Resource resource = new UrlResource(filePath.toUri());  // convert the file path to URL
-            if(resource.exists()) return resource;
+            if (resource.exists()) {
+                return resource;
+            }
         } catch (MalformedURLException e) {
             e.printStackTrace();
         }
@@ -261,14 +301,15 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
     }
 
     // get a collection of all the stored files
-    public File[] getStoredFiles()
-    {
+    public File[] getStoredFiles() {
         File file = new File(getStorageLocation());
         return file.listFiles(pathname -> pathname.isFile());
     }
 
     @SneakyThrows
-    public void createMeta(String fileName, String uid, String uname) {  // create the file meta information
+    public void createMeta(final String fileName,
+                           final String uid,
+                           final String uname) {  // create the file meta information
         String histDir = getHistoryDir(getFileLocation(fileName));  // get the history directory
 
         Path path = Paths.get(histDir);  // get the path to the history directory
@@ -276,25 +317,28 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
 
         // create the json object with the file metadata
         JSONObject json = new JSONObject();
-        json.put("created", new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()));  // put the file creation date to the json object
+        json.put("created", new SimpleDateFormat("yyyy-MM-dd HH:mm:ss")
+                .format(new Date()));  // put the file creation date to the json object
         json.put("id", uid);  // put the user ID to the json object
         json.put("name", uname);  // put the user name to the json object
 
-        File meta = new File(histDir + File.separator + "createdInfo.json");  // create the createdInfo.json file with the file meta information
+        File meta = new File(histDir + File.separator
+                + "createdInfo.json");  // create the createdInfo.json file with the file meta information
         try (FileWriter writer = new FileWriter(meta)) {
             json.writeJSONString(writer);
-        } catch (IOException ex){
+        } catch (IOException ex) {
             ex.printStackTrace();
         }
     }
 
     // create or update a file
-    public boolean createOrUpdateFile(Path path, InputStream stream) {
-        if (!Files.exists(path)){ // if the specified file does not exist
+    public boolean createOrUpdateFile(final Path path, final InputStream stream) {
+        if (!Files.exists(path)) { // if the specified file does not exist
             return createFile(path, stream);  // create it in the specified directory
         } else {
             try {
-                Files.write(path, stream.readAllBytes());  // otherwise, write new information in the bytes format to the file
+                Files.write(path, stream
+                        .readAllBytes());  // otherwise, write new information in the bytes format to the file
                 return true;
             } catch (IOException e) {
                 e.printStackTrace();
@@ -304,37 +348,41 @@ public class LocalFileStorage implements FileStorageMutator, FileStoragePathBuil
     }
 
     // get the server URL
-    public String getServerUrl(Boolean forDocumentServer) {
+    public String getServerUrl(final Boolean forDocumentServer) {
         if (forDocumentServer && !docserviceUrlExample.equals("")) {
             return docserviceUrlExample;
         } else {
-            return request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort() + request.getContextPath();
+            return request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort()
+                    + request.getContextPath();
         }
     }
 
     // get the history directory
-    public String getHistoryDir(String path)
-    {
+    public String getHistoryDir(final String path) {
         return path + historyPostfix;
     }
 
     // get the file version
-    public int getFileVersion(String historyPath, Boolean ifIndexPage)
-    {
+    public int getFileVersion(final String historyPath, final Boolean ifIndexPage) {
         Path path;
         if (ifIndexPage) {  // if the start page is opened
-            path = Paths.get(getStorageLocation() + getHistoryDir(historyPath));  // get the storage directory and add the history directory to it
+            path = Paths.get(getStorageLocation()
+                    + getHistoryDir(historyPath));  // get the storage directory and add the history directory to it
         } else {
             path = Paths.get(historyPath);  // otherwise, get the path to the history directory
-            if (!Files.exists(path)) return 1;  // if the history directory does not exist, then the file version is 1
+            if (!Files.exists(path)) {
+                return 1;  // if the history directory does not exist, then the file version is 1
+            }
         }
 
-        try (Stream<Path> stream = Files.walk(path, 1)) {  // run through all the files in the history directory
+        // run through all the files in the history directory
+        try (Stream<Path> stream = Files.walk(path, 1)) {
             return stream
                     .filter(file -> Files.isDirectory(file))  // take only directories from the history folder
                     .map(Path::getFileName)  // get file names
                     .map(Path::toString)  // and convert them into strings
-                    .collect(Collectors.toSet()).size();  // convert stream into set and get its size which specifies the file version
+                    .collect(Collectors.toSet()).size();  /* convert stream into set
+                     and get its size which specifies the file version */
         } catch (IOException e) {
             e.printStackTrace();
             return 0;

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/util/Constants.java

@@ -0,0 +1,33 @@
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+package com.onlyoffice.integration.documentserver.util;
+
+public final class Constants {
+    public static final Integer MAX_FILE_SIZE = 5 * 1024 * 1024;
+    public static final Integer CONVERT_TIMEOUT_MS = 120000;
+    public static final String CONVERTATION_ERROR_MESSAGE_TEMPLATE = "Error occurred in the ConvertService: ";
+    public static final Long FULL_LOADING_IN_PERCENT = 100L;
+    public static final Integer FILE_SAVE_TIMEOUT = 5000;
+    public static final Integer MAX_KEY_LENGTH = 20;
+    public static final Integer ANONYMOUS_USER_ID = 4;
+    public static final Integer KILOBYTE_SIZE = 1024;
+
+    private Constants() { }
+}
+

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/util/Misc.java

@@ -1,3 +1,21 @@
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
 package com.onlyoffice.integration.documentserver.util;
 
 import org.springframework.stereotype.Component;
@@ -7,9 +25,11 @@ import java.util.stream.Collectors;
 
 @Component
 public class Misc {
-    public String convertUserDescriptions(String username, List<String> description){  // cenvert user descriptions to the specified format
-        String result = "<div class=\"user-descr\"><b>"+username+"</b><br/><ul>"+description.
-                stream().map(text -> "<li>"+text+"</li>")
+
+    // convert user descriptions to the specified format
+    public String convertUserDescriptions(final String username, final List<String> description) {
+        String result = "<div class=\"user-descr\"><b>" + username + "</b><br/><ul>" + description.
+                stream().map(text -> "<li>" + text + "</li>")
                 .collect(Collectors.joining()) + "</ul></div>";
         return result;
     }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/util/SSLUtils.java

@@ -1,3 +1,21 @@
+/**
+ *
+ * (c) Copyright Ascensio System SIA 2023
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
 package com.onlyoffice.integration.documentserver.util;
 
 import java.security.KeyManagementException;
@@ -23,20 +41,21 @@ public final class SSLUtils {
     private final HostnameVerifier jvmHostnameVerifier = HttpsURLConnection.getDefaultHostnameVerifier();
 
     private final HostnameVerifier trivialHostnameVerifier = new HostnameVerifier() {
-        public boolean verify(String hostname, SSLSession sslSession) {
+        public boolean verify(final String hostname, final SSLSession sslSession) {
             return true;
         }
     };
 
-    private final TrustManager[] UNQUESTIONING_TRUST_MANAGER = new TrustManager[] { new X509TrustManager() {
+    private final TrustManager[] unquestioningTrustManager = new TrustManager[] {
+            new X509TrustManager() {
         public java.security.cert.X509Certificate[] getAcceptedIssuers() {
             return null;
         }
 
-        public void checkClientTrusted(X509Certificate[] certs, String authType) {
+        public void checkClientTrusted(final X509Certificate[] certs, final String authType) {
         }
 
-        public void checkServerTrusted(X509Certificate[] certs, String authType) {
+        public void checkServerTrusted(final X509Certificate[] certs, final String authType) {
         }
     } };
 
@@ -44,7 +63,7 @@ public final class SSLUtils {
         HttpsURLConnection.setDefaultHostnameVerifier(trivialHostnameVerifier);
         // Install the all-trusting trust manager
         SSLContext sc = SSLContext.getInstance("SSL");
-        sc.init(null, UNQUESTIONING_TRUST_MANAGER, null);
+        sc.init(null, unquestioningTrustManager, null);
         HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());
     }
 
@@ -56,4 +75,4 @@ public final class SSLUtils {
         HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());
     }
 
-}
+}

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/util/file/DefaultFileUtility.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,7 +19,6 @@
 package com.onlyoffice.integration.documentserver.util.file;
 
 import com.onlyoffice.integration.documentserver.models.enums.DocumentType;
-import lombok.SneakyThrows;
 import org.springframework.beans.factory.annotation.Qualifier;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.stereotype.Component;
@@ -31,6 +30,8 @@ import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
 
+import static com.onlyoffice.integration.documentserver.util.Constants.MAX_FILE_SIZE;
+
 @Component
 @Qualifier("default")
 public class DefaultFileUtility implements FileUtility {
@@ -50,7 +51,7 @@ public class DefaultFileUtility implements FileUtility {
     private String docserviceFillDocs;
 
     // document extensions
-    private List<String> ExtsDocument = Arrays.asList(
+    private List<String> extsDocument = Arrays.asList(
                             ".doc", ".docx", ".docm",
                             ".dot", ".dotx", ".dotm",
                             ".odt", ".fodt", ".ott", ".rtf", ".txt",
@@ -58,42 +59,45 @@ public class DefaultFileUtility implements FileUtility {
                             ".pdf", ".djvu", ".fb2", ".epub", ".xps", ".oform");
 
     // spreadsheet extensions
-    private List<String> ExtsSpreadsheet = Arrays.asList(
+    private List<String> extsSpreadsheet = Arrays.asList(
                             ".xls", ".xlsx", ".xlsm", ".xlsb",
                             ".xlt", ".xltx", ".xltm",
                             ".ods", ".fods", ".ots", ".csv");
 
     // presentation extensions
-    private List<String> ExtsPresentation = Arrays.asList(
+    private List<String> extsPresentation = Arrays.asList(
                             ".pps", ".ppsx", ".ppsm",
                             ".ppt", ".pptx", ".pptm",
                             ".pot", ".potx", ".potm",
                             ".odp", ".fodp", ".otp");
 
     // get the document type
-    public DocumentType getDocumentType(String fileName)
-    {
+    public DocumentType getDocumentType(final String fileName) {
         String ext = getFileExtension(fileName).toLowerCase();  // get file extension from its name
         // word type for document extensions
-        if (ExtsDocument.contains(ext))
+        if (extsDocument.contains(ext)) {
             return DocumentType.word;
+        }
 
         // cell type for spreadsheet extensions
-        if (ExtsSpreadsheet.contains(ext))
+        if (extsSpreadsheet.contains(ext)) {
             return DocumentType.cell;
+        }
 
         // slide type for presentation extensions
-        if (ExtsPresentation.contains(ext))
+        if (extsPresentation.contains(ext)) {
             return DocumentType.slide;
+        }
 
         // default file type is word
         return DocumentType.word;
     }
 
     // get file name from its URL
-    public String getFileName(String url)
-    {
-        if (url == null) return "";
+    public String getFileName(final String url) {
+        if (url == null) {
+            return "";
+        }
 
         // get file name from the last part of URL
         String fileName = url.substring(url.lastIndexOf('/') + 1);
@@ -102,62 +106,62 @@ public class DefaultFileUtility implements FileUtility {
     }
 
     // get file name without extension
-    public String getFileNameWithoutExtension(String url)
-    {
+    public String getFileNameWithoutExtension(final String url) {
         String fileName = getFileName(url);
-        if (fileName == null) return null;
+        if (fileName == null) {
+            return null;
+        }
         String fileNameWithoutExt = fileName.substring(0, fileName.lastIndexOf('.'));
         return fileNameWithoutExt;
     }
 
     // get file extension from URL
-    public String getFileExtension(String url)
-    {
+    public String getFileExtension(final String url) {
         String fileName = getFileName(url);
-        if (fileName == null) return null;
+        if (fileName == null) {
+            return null;
+        }
         String fileExt = fileName.substring(fileName.lastIndexOf("."));
         return fileExt.toLowerCase();
     }
 
     // get an editor internal extension
-    public String getInternalExtension(DocumentType type)
-    {
+    public String getInternalExtension(final DocumentType type) {
         // .docx for word file type
-        if (type.equals(DocumentType.word))
+        if (type.equals(DocumentType.word)) {
             return ".docx";
+        }
 
         // .xlsx for cell file type
-        if (type.equals(DocumentType.cell))
+        if (type.equals(DocumentType.cell)) {
             return ".xlsx";
+        }
 
         // .pptx for slide file type
-        if (type.equals(DocumentType.slide))
+        if (type.equals(DocumentType.slide)) {
             return ".pptx";
+        }
 
         // the default file type is .docx
         return ".docx";
     }
 
-    public List<String> getFillExts()
-    {
+    public List<String> getFillExts() {
         return Arrays.asList(docserviceFillDocs.split("\\|"));
     }
 
     // get file extensions that can be viewed
-    public List<String> getViewedExts()
-    {
+    public List<String> getViewedExts() {
         return Arrays.asList(docserviceViewedDocs.split("\\|"));
     }
 
     // get file extensions that can be edited
-    public List<String> getEditedExts()
-    {
+    public List<String> getEditedExts() {
         return Arrays.asList(docserviceEditedDocs.split("\\|"));
     }
 
     // get file extensions that can be converted
-    public List<String> getConvertExts()
-    {
+    public List<String> getConvertExts() {
         return Arrays.asList(docserviceConvertDocs.split("\\|"));
     }
 
@@ -174,23 +178,26 @@ public class DefaultFileUtility implements FileUtility {
     }
 
     // generate the file path from file directory and name
-    public Path generateFilepath(String directory, String fullFileName){
+    public Path generateFilepath(final String directory, final String fullFileName) {
         String fileName = getFileNameWithoutExtension(fullFileName);  // get file name without extension
         String fileExtension = getFileExtension(fullFileName);  // get file extension
-        Path path = Paths.get(directory+fullFileName);  // get the path to the files with the specified name
+        Path path = Paths.get(directory + fullFileName);  // get the path to the files with the specified name
 
-        for(int i = 1; Files.exists(path); i++){  // run through all the files with the specified name
-            fileName = getFileNameWithoutExtension(fullFileName) + "("+i+")";  // get a name of each file without extension and add an index to it
-            path = Paths.get(directory+fileName+fileExtension);  // create a new path for this file with the correct name and extension
+        for (int i = 1; Files.exists(path); i++) {  // run through all the files with the specified name
+            // get a name of each file without extension and add an index to it
+            fileName = getFileNameWithoutExtension(fullFileName) + "(" + i + ")";
+
+            // create a new path for this file with the correct name and extension
+            path = Paths.get(directory + fileName + fileExtension);
         }
 
-        path = Paths.get(directory+fileName+fileExtension);
+        path = Paths.get(directory + fileName + fileExtension);
         return path;
     }
 
     // get maximum file size
-    public long getMaxFileSize(){
+    public long getMaxFileSize() {
         long size = Long.parseLong(filesizeMax);
-        return size > 0 ? size : 5 * 1024 * 1024;
+        return size > 0 ? size : MAX_FILE_SIZE;
     }
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/util/file/FileUtility.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -35,6 +35,7 @@ public interface FileUtility {
     List<String> getViewedExts();  // get file extensions that can be viewed
     List<String> getEditedExts();  // get file extensions that can be edited
     List<String> getConvertExts();  // get file extensions that can be converted
-    Path generateFilepath(String directory, String fullFileName);  // generate the file path from file directory and name
+    Path generateFilepath(String directory, String fullFileName);  /* generate the file path
+     from file directory and name */
     long getMaxFileSize();  // get maximum file size
 }

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/util/service/DefaultServiceConverter.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -20,6 +20,7 @@ package com.onlyoffice.integration.documentserver.util.service;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.onlyoffice.integration.documentserver.managers.jwt.JwtManager;
+import com.onlyoffice.integration.documentserver.models.enums.ConvertErrorType;
 import com.onlyoffice.integration.documentserver.util.file.FileUtility;
 import com.onlyoffice.integration.dto.Convert;
 import lombok.SneakyThrows;
@@ -27,20 +28,28 @@ import org.json.simple.JSONObject;
 import org.json.simple.parser.JSONParser;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.beans.factory.annotation.Value;
+import org.springframework.http.HttpStatus;
 import org.springframework.stereotype.Component;
 
 import javax.annotation.PostConstruct;
-import java.io.*;
+import java.io.BufferedReader;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.io.OutputStream;
 import java.net.URL;
 import java.nio.charset.StandardCharsets;
 import java.util.HashMap;
 import java.util.Map;
 import java.util.UUID;
 
-//TODO: Refactoring
+import static com.onlyoffice.integration.documentserver.util.Constants.CONVERTATION_ERROR_MESSAGE_TEMPLATE;
+import static com.onlyoffice.integration.documentserver.util.Constants.CONVERT_TIMEOUT_MS;
+import static com.onlyoffice.integration.documentserver.util.Constants.FULL_LOADING_IN_PERCENT;
+import static com.onlyoffice.integration.documentserver.util.Constants.MAX_KEY_LENGTH;
+
+// todo: Refactoring
 @Component
-public class DefaultServiceConverter implements ServiceConverter
-{
+public class DefaultServiceConverter implements ServiceConverter {
     @Value("${files.docservice.header}")
     private String documentJwtHeader;
     @Value("${files.docservice.url.site}")
@@ -49,7 +58,7 @@ public class DefaultServiceConverter implements ServiceConverter
     private String docServiceUrlConverter;
     @Value("${files.docservice.timeout}")
     private String docserviceTimeout;
-    private int convertTimeout = 120000;
+    private int convertTimeout;
 
     @Autowired
     private JwtManager jwtManager;
@@ -61,23 +70,24 @@ public class DefaultServiceConverter implements ServiceConverter
     private ObjectMapper objectMapper;
 
     @PostConstruct
-    public void init(){
+    public void init() {
         int timeout = Integer.parseInt(docserviceTimeout);  // parse the dcoument service timeout value
-        if (timeout > 0) convertTimeout = timeout;
+        convertTimeout = timeout > 0 ? timeout : CONVERT_TIMEOUT_MS;
     }
 
     @SneakyThrows
-    private String postToServer(Convert body, String headerToken){  // send the POST request to the server
-        String bodyString = objectMapper.writeValueAsString(body);  // write the body request to the object mapper in the string format
+    private String postToServer(final Convert body, final String headerToken) {  // send the POST request to the server
+        String bodyString = objectMapper
+                .writeValueAsString(body);  // write the body request to the object mapper in the string format
         URL url = null;
         java.net.HttpURLConnection connection = null;
         InputStream response = null;
         String jsonString = null;
 
         byte[] bodyByte = bodyString.getBytes(StandardCharsets.UTF_8);  // convert body string into bytes
-        try{
+        try {
             // set the request parameters
-            url = new URL(docServiceUrl+docServiceUrlConverter);
+            url = new URL(docServiceUrl + docServiceUrlConverter);
             connection = (java.net.HttpURLConnection) url.openConnection();
             connection.setRequestMethod("POST");
             connection.setDoOutput(true);
@@ -87,14 +97,20 @@ public class DefaultServiceConverter implements ServiceConverter
             connection.setConnectTimeout(convertTimeout);
 
             // check if the token is enabled
-            if (jwtManager.tokenEnabled())
-            {
+            if (jwtManager.tokenEnabled()) {
                 // set the JWT header to the request
-                connection.setRequestProperty(documentJwtHeader.isBlank() ?
-                        "Authorization" : documentJwtHeader, "Bearer " + headerToken);
+                connection.setRequestProperty(documentJwtHeader.isBlank()
+                        ? "Authorization" : documentJwtHeader, "Bearer " + headerToken);
             }
 
             connection.connect();
+
+            int statusCode = connection.getResponseCode();
+            if (statusCode != HttpStatus.OK.value()) {  // checking status code
+                connection.disconnect();
+                throw new RuntimeException("Convertation service returned status: " + statusCode);
+            }
+
             try (OutputStream os = connection.getOutputStream()) {
                 os.write(bodyByte);  // write bytes to the output stream
                 os.flush();  // force write data to the output stream that can be cached in the current thread
@@ -109,37 +125,37 @@ public class DefaultServiceConverter implements ServiceConverter
     }
 
     // get the URL to the converted file
-    public String getConvertedUri(String documentUri, String fromExtension,
-                                  String toExtension, String documentRevisionId,
-                                  String filePass, Boolean isAsync, String lang)
-    {
+    public String getConvertedUri(final String documentUri, final String fromExtension,
+                                  final String toExtension, final String documentRevisionId,
+                                  final String filePass, final Boolean isAsync, final String lang) {
         // check if the fromExtension parameter is defined; if not, get it from the document url
-        fromExtension = fromExtension == null || fromExtension.isEmpty() ?
-                fileUtility.getFileExtension(documentUri) : fromExtension;
+        String fromExt = fromExtension == null || fromExtension.isEmpty()
+                ? fileUtility.getFileExtension(documentUri) : fromExtension;
 
         // check if the file name parameter is defined; if not, get random uuid for this file
         String title = fileUtility.getFileName(documentUri);
         title = title == null || title.isEmpty() ? UUID.randomUUID().toString() : title;
 
-        documentRevisionId = documentRevisionId == null || documentRevisionId.isEmpty() ? documentUri : documentRevisionId;
+        String documentRevId = documentRevisionId == null || documentRevisionId.isEmpty()
+                ? documentUri : documentRevisionId;
 
-        documentRevisionId = generateRevisionId(documentRevisionId);  // create document token
+        documentRevId = generateRevisionId(documentRevId);  // create document token
 
         // write all the necessary parameters to the body object
         Convert body = new Convert();
         body.setLang(lang);
         body.setUrl(documentUri);
         body.setOutputtype(toExtension.replace(".", ""));
-        body.setFiletype(fromExtension.replace(".", ""));
+        body.setFiletype(fromExt.replace(".", ""));
         body.setTitle(title);
-        body.setKey(documentRevisionId);
+        body.setKey(documentRevId);
         body.setFilePass(filePass);
-        if (isAsync)
+        if (isAsync) {
             body.setAsync(true);
+        }
 
         String headerToken = "";
-        if (jwtManager.tokenEnabled())
-        {
+        if (jwtManager.tokenEnabled()) {
             HashMap<String, Object> map = new HashMap<String, Object>();
             map.put("region", lang);
             map.put("url", body.getUrl());
@@ -148,8 +164,9 @@ public class DefaultServiceConverter implements ServiceConverter
             map.put("title", body.getTitle());
             map.put("key", body.getKey());
             map.put("password", body.getFilePass());
-            if (isAsync)
+            if (isAsync) {
                 map.put("async", body.getAsync());
+            }
 
             // add token to the body if it is enabled
             String token = jwtManager.createToken(map);
@@ -166,98 +183,64 @@ public class DefaultServiceConverter implements ServiceConverter
     }
 
     // generate document key
-    public String generateRevisionId(String expectedKey)
-    {
-        if (expectedKey.length() > 20)  // if the expected key length is greater than 20
-            expectedKey = Integer.toString(expectedKey.hashCode());  // the expected key is hashed and a fixed length value is stored in the string format
+    public String generateRevisionId(final String expectedKey) {
+        /* if the expected key length is greater than 20
+        then he expected key is hashed and a fixed length value is stored in the string format */
+        String formatKey = expectedKey.length() > MAX_KEY_LENGTH
+                ? Integer.toString(expectedKey.hashCode()) : expectedKey;
+        String key = formatKey.replace("[^0-9-.a-zA-Z_=]", "_");
 
-        String key = expectedKey.replace("[^0-9-.a-zA-Z_=]", "_");
-
-        return key.substring(0, Math.min(key.length(), 20));  // the resulting key length is 20 or less
+        return key.substring(0, Math.min(key.length(), MAX_KEY_LENGTH));  // the resulting key length is 20 or less
     }
 
-    //TODO: Replace with a registry (callbacks package for reference)
-    private void processConvertServiceResponceError(int errorCode)  // create an error message for an error code
-    {
-        String errorMessage = "";
-        String errorMessageTemplate = "Error occurred in the ConvertService: ";
-
-        // add the error message to the error message template depending on the error code
-        switch (errorCode)
-        {
-            case -8:
-                errorMessage = errorMessageTemplate + "Error document VKey";
-                break;
-            case -7:
-                errorMessage = errorMessageTemplate + "Error document request";
-                break;
-            case -6:
-                errorMessage = errorMessageTemplate + "Error database";
-                break;
-            case -5:
-                errorMessage = errorMessageTemplate + "Error unexpected guid";
-                break;
-            case -4:
-                errorMessage = errorMessageTemplate + "Error download error";
-                break;
-            case -3:
-                errorMessage = errorMessageTemplate + "Error convertation error";
-                break;
-            case -2:
-                errorMessage = errorMessageTemplate + "Error convertation timeout";
-                break;
-            case -1:
-                errorMessage = errorMessageTemplate + "Error convertation unknown";
-                break;
-            case 0:  // if the error code is equal to 0, the error message is empty
-                break;
-            default:
-                errorMessage = "ErrorCode = " + errorCode;  // default value for the error message
-                break;
-        }
+    // todo: Replace with a registry (callbacks package for reference)
+    // create an error message for an error code
+    private void processConvertServiceResponceError(final int errorCode) {
+        String errorMessage = CONVERTATION_ERROR_MESSAGE_TEMPLATE + ConvertErrorType.labelOfCode(errorCode);
 
         throw new RuntimeException(errorMessage);
     }
 
+    // get the response URL
     @SneakyThrows
-    private String getResponseUri(String jsonString)  // get the response URL
-    {
+    private String getResponseUri(final String jsonString) {
         JSONObject jsonObj = convertStringToJSON(jsonString);
 
         Object error = jsonObj.get("error");
-        if (error != null)  // if an error occurs
-            processConvertServiceResponceError(Math.toIntExact((long)error));  // then get an error message
+        if (error != null) {  // if an error occurs
+            processConvertServiceResponceError(Math.toIntExact((long) error));  // then get an error message
+        }
 
         // check if the conversion is completed and save the result to a variable
         Boolean isEndConvert = (Boolean) jsonObj.get("endConvert");
 
-        Long resultPercent = 0l;
+        Long resultPercent = 0L;
         String responseUri = null;
 
-        if (isEndConvert)  // if the conversion is completed
-        {
-            resultPercent = 100l;
+        if (isEndConvert) {  // if the conversion is completed
+            resultPercent = FULL_LOADING_IN_PERCENT;
             responseUri = (String) jsonObj.get("fileUrl");  // get the file URL
-        }
-        else  // if the conversion isn't completed
-        {
+        } else {  // if the conversion isn't completed
             resultPercent = (Long) jsonObj.get("percent");
-            resultPercent = resultPercent >= 100l ? 99l : resultPercent;  // get the percentage value of the conversion process
+
+            // get the percentage value of the conversion process
+            resultPercent = resultPercent >= FULL_LOADING_IN_PERCENT ? FULL_LOADING_IN_PERCENT - 1 : resultPercent;
         }
 
-        return resultPercent >= 100l ? responseUri : "";
+        return resultPercent >= FULL_LOADING_IN_PERCENT ? responseUri : "";
     }
 
+    // convert stream to string
     @SneakyThrows
-    public String convertStreamToString(InputStream stream)  // convert stream to string
-    {
+    public String convertStreamToString(final InputStream stream) {
         InputStreamReader inputStreamReader = new InputStreamReader(stream);  // create an object to get incoming stream
         StringBuilder stringBuilder = new StringBuilder();  // create a string builder object
-        BufferedReader bufferedReader = new BufferedReader(inputStreamReader);  // create an object to read incoming streams
+
+        // create an object to read incoming streams
+        BufferedReader bufferedReader = new BufferedReader(inputStreamReader);
         String line = bufferedReader.readLine();  // get incoming streams by lines
 
-        while (line != null)
-        {
+        while (line != null) {
             stringBuilder.append(line);  // concatenate strings using the string builder
             line = bufferedReader.readLine();
         }
@@ -267,12 +250,12 @@ public class DefaultServiceConverter implements ServiceConverter
         return result;
     }
 
+    // convert string to json
     @SneakyThrows
-    public JSONObject convertStringToJSON(String jsonString)  // convert string to json
-    {
+    public JSONObject convertStringToJSON(final String jsonString) {
         Object obj = parser.parse(jsonString);  // parse json string
         JSONObject jsonObj = (JSONObject) obj;  // and turn it into a json object
 
         return jsonObj;
     }
-}
+}

web/documentserver-example/java-spring/src/main/java/com/onlyoffice/integration/documentserver/util/service/ServiceConverter.java

@@ -1,6 +1,6 @@
 /**
  *
- * (c) Copyright Ascensio System SIA 2021
+ * (c) Copyright Ascensio System SIA 2023
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,9 +19,6 @@
 package com.onlyoffice.integration.documentserver.util.service;
 
 import org.json.simple.JSONObject;
-import org.json.simple.parser.ParseException;
-
-import java.io.IOException;
 import java.io.InputStream;