LEADTOOLS HTML5文档浏览器demo源码介绍

概述

Document libraryJavaScript支持包含在Visual Studio解决方案中，源代码位于计算机的此位置中：

[LEADTOOLS安装根目录]\Examples\JS\Documents\DocumentViewer\DocumentViewer.sln

该解决方案包含多个带有HTML，CSS和JavaScript用户界面代码的客户端项目。这些项目可以在任何支持HTML5的桌面或移动Web浏览器上运行。每个客户端都包含Microsoft TypeScript版本和编译的JavaScript版本。包含完整的源代码，可以根据您的应用需求进行修改。

剩下的DocumentsService项目是一个ASP.NET Web API应用程序项目，它充当前面提到的客户端的服务器端代码。它可以在Windows机器上运行，并且DocumentsServiceJava可以在Windows或Linux机器上运行。使用任一服务，所有端点都配置到~/api/*目录。

Leadtools.Document.js用作.NET Document library类的JavaScript代理。此代理隐藏Web服务实现，并将 Document library公开为包含类和对象的本机JavaScript库。您的应用程序应使用这些类与服务器代码进行交互。

要开始使用DocumentViewer，只需DocumentViewer.sln在Visual Studio中打开，选择启动项目（必须同时选择要运行的客户端和服务器项目），然后按F5。这将使用VS中内置的IISExpress运行文档查看器。您可以根据需要在客户端JavaScript代码或服务器C＃代码中设置断点。

您可以随时在解决方案资源管理器中右键单击该项目，然后选择“部署”以在同一台计算机，单独的计算机或云中的IIS中承载应用程序。

在开发或部署期间，您可能希望修改local.config（或父级web.config）以更新服务器端选项，如缓存目录，OCR引擎类型或光栅编解码器选项（如果需要）。

该DocumentFactory类包含了需要设置客户端访问服务器代码以下特性：

组件	值描述
ServiceHost	服务主机的URL。默认值为null，这意味着使用与客户端相同的主机（例如，http://localhost:port对于IIS Express，http://localhost通常或http://current_ip_address）。将服务部署到另一台计算机或云中时，建议将服务器和客户端代码保留在同一主机上。否则，请务必在服务中配置CORS的实现。
ServicePath	从主机到应用程序根目录的路径。默认值为null，表示使用客户端的路径。默认情况下，项目设置为api endpoints directory（）与client（）目录略有不同。这意味着ServicePath的值将是。但是，ServiceApiPath属性存在，因此如果客户端和服务器主要位于同一路径上，则无需更改此属性。../path/to/application/api../path/to/application/app../path/to/application/app
ServiceApiPath	服务的api端点的路径。默认值为null如上所述，项目设置为api endpoints directory（）与client（）目录略有不同。这意味着ServicePath的值将是。要对文件夹进行适当调整，DocumentViewer客户端会将其设置为。这样，ServicePath不需要设置为显式值。../path/to/application/api../path/to/application/app../path/to/application/appapi../api
ServiceUri	获取服务的完整URL，连接ServiceHost（或客户端主机，如果为null），ServicePath（或客户端路径，如果为null）和ServiceApiPath。这意味着如果没有设置值，ServiceUri将成为客户端的完整路径; 如果我们将ServiceApiPath更改为../api，ServiceUri将成为api命名空间的默认位置。ServiceUri在构建时将删除不需要的尾部斜杠。

使用LEADTOOLS Documentlibrary JavaScript的应用程序必须在程序开头的DocumentFactory中设置值。这些值是全局的，可以从应用程序的任何部分访问。JavaScript代理的各种类，对象和命令将在需要时使用这些值来调用Web服务并获取结果。例如，您可以开始使用LoadFromUri从URL 创建新的Document对象，并开始在您的应用程序中使用它。

文档服务路由和数据结构

Leadtools.Document.js的lt.Documents中的许多方法都会向Web服务发送请求以在服务器上执行代码。通常，[DocumentFactory.ServiceUserData]可用于使用任何这些请求发送其他数据。[DocumentFactory.PrepareAjax]还允许在发送之前修改请求。

要确切了解每个请求将发送的其他属性，您可以检查.NET或Java服务的源代码。.NETWeb Api服务包括一个文档模块，允许开发人员通过运行服务并导航到查看API文档[service-uri]/help。例如，在线DocumentViewer .NET服务的最新在线版本的文档位于https://demo.leadtools.com/JavaScript_DocumentViewer_Service/help。

开发人员还可以通过打开LEADTOOLS安装中包含的TypeScript声明文件（特别是Leadtools.Document.d.ts）并查找lt.Documents.Service内部命名空间来查看这些相同的请求和响应类。