rizmDoc是最快速、最有品質(zhì)的HTML5文檔查看器，提供安全的、全定制化的查看和協(xié)作功能。它通過一個簡單部署的機制減少成本，降低安全風險和提高生產(chǎn)率。同時，它是基于服務(wù)器的查看器，消除了不必要的許可和下載。

PrizmDoc發(fā)布v12.2新版本，為Viewing客戶端和PrizmDoc服務(wù)器添加了新功能。

Viewing客戶端

• 現(xiàn)在，你可以在任何內(nèi)容顯示之前以編程的方式設(shè)置Viewing客戶端的初始縮放等級。

• addMarkFromSearchResult API已添加到ViewerControl，允許從搜索結(jié)果中添加文本標記。并將搜索結(jié)果快速轉(zhuǎn)換成標記。

• 我們已采取措施使Viewing客戶端中可以支持內(nèi)容安全策略（CSP）。有關(guān)其他詳細信息，請聯(lián)系客服。

• 電子簽名改進

  • 支持在文本框中添加輸入掩碼。你可以要求簽名者在文本框中填入特定信息，例如電話號碼、社會安全號碼、日期、郵政編碼或者型號。

  • 字段現(xiàn)在可以在Template Designer中標記為“只讀”。如果字段被標記為“只讀”，則無法在Signing Module中進行修改。這在數(shù)據(jù)以編程方式填充并且開發(fā)人員不希望用戶修改字段的情況下非常有用。

  • selectEditorText API已添加到ViewerControl中，以允許在標記的文本編輯器中選擇可編輯的文本。

  • 添加了允許在Signing Module中設(shè)置/獲取填寫數(shù)據(jù)的API。這可以讓你輕松地為特定場景設(shè)置這些數(shù)值。

PrizmDoc服務(wù)器

• 現(xiàn)在，你可以用編程方式取消長時間運行的搜索任務(wù)，例如在非常大的文檔中搜索。

• 內(nèi)容轉(zhuǎn)換服務(wù)現(xiàn)在支持轉(zhuǎn)換受密碼保護的PDF和Office文檔。

• 兩個新的中央配置參數(shù)現(xiàn)在可用于定義查看CAD文檔的背景顏色：

  • fidelity.vectorBackgroundColor.view.default - 可用于那些在文檔中未指定背景（除了DGN以外的大多數(shù)CAD文件）的CAD案例

  • fidelity.vectorBackgroundColor.view.override - 可以在想要忽略文檔中指定的背景顏色時使用

• 內(nèi)容轉(zhuǎn)換服務(wù)現(xiàn)在在轉(zhuǎn)換文檔時會報告更加詳細的“percentComplete”狀態(tài)（以前它只報告0％和100％）。

關(guān)于Accusoft

Accusoft為開發(fā)人員提供一個文檔和圖像工具的強勁組合。我們的api和軟件開發(fā)工具包是使用專利技術(shù)構(gòu)建的，提供高性能的文檔查看、高級搜索、圖像壓縮、轉(zhuǎn)換、條碼識別、光學字符識別（OCR）和其他用于應(yīng)用程序和web開發(fā)的圖像處理工具。

查看更新原文：PrizmDoc v12.2

TML5 文件上傳下載的實例代碼，WEBUPLOADER之大文件分段上傳、斷點續(xù)傳，HTML DOM INPUT FILE 大文件上傳源代碼，B/S大附件上傳，支持斷點續(xù)傳，VUE處理文件流實現(xiàn)上傳下載，VUE 上傳大型文件插件(VUE上傳視頻插件)

之前在網(wǎng)上也搜索過相關(guān)的資料，在論壇里面也與網(wǎng)絡(luò)交流過，但是給出的方案都不太令人滿意。一方面論壇里面的網(wǎng)頁都沒有真實的項目經(jīng)驗。幾乎大部分的網(wǎng)頁都是在紙上談兵，很多問題完全是憑想象在回答。也不能夠提供真實案例，基本上都沒有項目的實戰(zhàn)經(jīng)驗。

甚至有些學生也在里面不知道從哪里復(fù)制的一些代碼然后粘貼在上面。

后端PHP5,PHP6,PHP7,PHP8，ThinkPHP，

服務(wù)器支持Linux，Windows,macOS,CentOS,中標麒麟，銀河麒麟，統(tǒng)信，龍芯，華為鯤鵬，

數(shù)據(jù)庫支持MySQL，達夢數(shù)據(jù)庫，人大金倉

需要提供前端源碼，后端源碼，控件源碼

需要提供7*24小時技術(shù)支持，長期技術(shù)支持，長期維護服務(wù)

需要提供手機，QQ，微信，企業(yè)微信，電子郵箱等聯(lián)系方式

需要支持包含IE在內(nèi)的全部瀏覽器

終端需要支持Windows,macOS,Linux,信創(chuàng)國產(chǎn)化環(huán)境，中標麒麟，銀河麒麟，統(tǒng)信UOS，龍芯，華為

功能需要支持10G，50G,100G大文件上傳和斷點續(xù)傳，刷新續(xù)傳，重啟續(xù)傳

文件夾包含1W，10W，100W個文件和層級結(jié)構(gòu)

支持超大文件分片，分段，分塊，分割上傳下載，斷點續(xù)傳

支持文件夾上傳，下載斷點續(xù)傳，支持文件夾層級結(jié)構(gòu)，層級結(jié)構(gòu)信息保存到數(shù)據(jù)庫，下載的時候同樣保留層級結(jié)構(gòu)

支持加密上傳，下載加密，端到端加密，國密SM4加密算法，數(shù)據(jù)加密傳輸，傳輸過程中要保證數(shù)據(jù)是加密的。1.下載示例

https://gitee.com/xproer/up6-vue-cli

將up6組件復(fù)制到項目中

示例中已經(jīng)包含此目錄

1.引入up6組件

2.配置接口地址

接口地址分別對應(yīng)：文件初始化，文件數(shù)據(jù)上傳，文件進度，文件上傳完畢，文件刪除，文件夾初始化，文件夾刪除，文件列表

參考：http://www.ncmem.com/doc/view.aspx?id=e1f49f3e1d4742e19135e00bd41fa3de

3.處理事件

啟動測試

啟動成功

效果

數(shù)據(jù)庫

源碼工程文檔：https://drive.weixin.qq.com/s?k=ACoAYgezAAw1dWofra

源碼報價單：https://drive.weixin.qq.com/s?k=ACoAYgezAAwoiul8gl

OEM版報價單：https://drive.weixin.qq.com/s?k=ACoAYgezAAwuzp4W0a

控件源碼下載：https://drive.weixin.qq.com/s?k=ACoAYgezAAwbdKCskc

ips：喜歡的話可以關(guān)注小萌哦~~~

今天小萌給大家推薦的一個開源Java Restful API 文檔生成工具，一加【oneplus】、iflytek都在用。所以，自然差不了。

官方簡介

smart-doc 是一個 java restful api 文檔生成工具，smart-doc 顛覆了傳統(tǒng)類似 swagger 這種大量采用注解侵入來生成文檔的實現(xiàn)方法。 smart-doc 完全基于接口源碼分析來生成接口文檔，完全做到零注解侵入，你只需要按照java標準注釋的寫，smart-doc 就能幫你生成一個簡易明了的 Markdown、Html、AsciiDoc 文檔。

如果你已經(jīng)厭倦了 swagger 等文檔工具的無數(shù)注解和強侵入污染，smart-doc是不錯的選擇！

最新版本

smart-doc 1.7.7

開源地址

https://gitee.com/sunyurepository/smart-doc

快速入門

1、Getting started

# git clone https://gitee.com/sunyurepository/api-doc-test.git

你可以啟動這個Spring Boot的項目，然后訪問http://localhost:8080/doc/api.html來瀏覽smart-doc生成的接口文檔。

2、Dependency

<dependency>

 <groupId>com.github.shalousun</groupId>

 <artifactId>smart-doc</artifactId>

 <version>1.7.7</version>

 <scope>test</scope>

</dependency>

3、Create a unit test

通過運行一個單元測試來讓Smart-doc為你生成一個簡潔明了的api文檔。

public class ApiDocTest {

 /**

 * 包括設(shè)置請求頭，缺失注釋的字段批量在文檔生成期使用定義好的注釋

 */

 @Test

 public void testBuilderControllersApi() {

 ApiConfig config=new ApiConfig();

 config.setServerUrl("http://localhost:8080");

 //true會嚴格要求注釋，推薦設(shè)置true

 config.setStrict(true);

 //true會將文檔合并導(dǎo)出到一個markdown

 config.setAllInOne(false);

 //生成html時加密文檔名不暴露controller的名稱

 config.setMd5EncryptedHtmlName(true);

 //指定文檔輸出路徑

 //@since 1.7 版本開始，選擇生成靜態(tài)html doc文檔可使用該路徑：DocGlobalConstants.HTML_DOC_OUT_PATH;

 config.setOutPath(DocGlobalConstants.HTML_DOC_OUT_PATH);

 // @since 1.2,如果不配置該選項，則默認匹配全部的controller,

 // 如果需要配置有多個controller可以使用逗號隔開

 config.setPackageFilters("com.power.doc.controller");

 //不指定SourcePaths默認加載代碼為項目src/main/java下的,如果項目的某一些實體來自外部代碼可以一起加載

 config.setSourceCodePaths(

 //自1.7.0版本開始，在此處可以不設(shè)置本地代碼路徑，單獨添加外部代碼路徑即可

// SourceCodePath.path().setDesc("本項目代碼").setPath("src/main/java"),

 SourceCodePath.path().setDesc("加載項目外代碼").setPath("E:\ApplicationPower\ApplicationPower\Common-util\src\main\java")

 );

 //since 1.7.5

 //如果該選項的值為false,則smart-doc生成allInOne.md文件的名稱會自動添加版本號

 config.setCoverOld(true);

 //since 1.7.5

 //設(shè)置項目名(非必須)，如果不設(shè)置會導(dǎo)致在使用一些自動添加標題序號的工具顯示的序號不正常

 config.setProjectName("搶購系統(tǒng)");

 //設(shè)置請求頭，如果沒有請求頭，可以不用設(shè)置

 config.setRequestHeaders(

 ApiReqHeader.header().setName("access_token").setType("string").setDesc("Basic auth credentials"),

 ApiReqHeader.header().setName("user_uuid").setType("string").setDesc("User Uuid key")

 );

 //對于外部jar的類，編譯后注釋會被擦除，無法獲取注釋，但是如果量比較多請使用setSourcePaths來加載外部代碼

 //如果有這種場景，則自己添加字段和注釋，api-doc后期遇到同名字段則直接給相應(yīng)字段加注釋

 config.setCustomResponseFields(

 CustomRespField.field().setName("success").setDesc("成功返回true,失敗返回false"),

 CustomRespField.field().setName("message").setDesc("接口響應(yīng)信息"),

 CustomRespField.field().setName("data").setDesc("接口響應(yīng)數(shù)據(jù)"),

 CustomRespField.field().setName("code").setValue("00000").setDesc("響應(yīng)代碼")

 );

 //設(shè)置項目錯誤碼列表，設(shè)置自動生成錯誤列表,

 List<ApiErrorCode> errorCodeList=new ArrayList<>();

 for (ErrorCodeEnum codeEnum : ErrorCodeEnum.values()) {

 ApiErrorCode errorCode=new ApiErrorCode();

 errorCode.setValue(codeEnum.getCode()).setDesc(codeEnum.getDesc());

 errorCodeList.add(errorCode);

 }

 //如果沒需要可以不設(shè)置

 config.setErrorCodes(errorCodeList);

 //非必須只有當setAllInOne設(shè)置為true時文檔變更記錄才生效，https://gitee.com/sunyurepository/ApplicationPower/issues/IPS4O

 config.setRevisionLogs(

 RevisionLog.getLog().setRevisionTime("2018/12/15").setAuthor("chen").setRemarks("測試").setStatus("創(chuàng)建").setVersion("V1.0"),

 RevisionLog.getLog().setRevisionTime("2018/12/16").setAuthor("chen2").setRemarks("測試2").setStatus("修改").setVersion("V2.0")

 );

 //since 1.7.5

 //文檔添加數(shù)據(jù)字典

 config.setDataDictionaries(

 ApiDataDictionary.dict().setTitle("訂單狀態(tài)").setEnumClass(OrderEnum.class).setCodeField("code").setDescField("desc"),

 ApiDataDictionary.dict().setTitle("訂單狀態(tài)1").setEnumClass(OrderEnum.class).setCodeField("code").setDescField("desc")

 );

 long start=System.currentTimeMillis();

 ApiDocBuilder.builderControllersApi(config);

 //@since 1.7+版本開始，smart-doc支持生成帶書簽的html文檔，html文檔可選擇下面額方式

 //HtmlApiDocBuilder.builderControllersApi(config);

 //@since 1.7+版本開始，smart-doc支撐生成AsciiDoc文檔，你可以把AsciiDoc轉(zhuǎn)成HTML5的格式。

 //@see https://gitee.com/sunyurepository/api-doc-test

 //AdocDocBuilder.builderControllersApi(config);

 long end=System.currentTimeMillis();

 DateTimeUtil.printRunTime(end, start);

 }

}

4、接口頭部效果圖

5、請求參數(shù)示例效果圖

6、響應(yīng)參數(shù)示例效果圖

給使用者的建議

評價

看過示例之后是不是想要有替換swagger的沖動？別著急，swagger雖然耦合很嚴重，但是這個也直接避免了一些懶惰的開發(fā)人員改接口不改注釋的習慣。