Веб сервисы VintaSoft Imaging
В этом разделе
VintaSoft Imaging .NET SDK предоставляет
VintaSoft Imaging JavaScript API
, который содержит JavaScript-классы и JavaScript UI-контролы, которые могут быть использованы на клиентской стороне веб-приложения.
Также VintaSoft Imaging .NET SDK предоставляет
Веб сервисы VintaSoft Imaging
, которые содержат 4 типа веб сервисов: готовые к использованию независимые от платформы веб-сервисы; ASP.NET Core Web API контроллеры; ASP.NET Web API контроллеры; ASP.NET HTTP обработчики.
VintaSoft Imaging JavaScript API
использует
Веб сервисы VintaSoft Imaging
когда необходима работа на стороне сервера (загрузка документов, рендеринг изображений/страниц, обработка изображений, преобразование файлов, сохранение документов, ...).
Какие готовые к использованию веб сервисы VintaSoft Imaging я могу использовать в ASP.NET Core Web приложении?
VintaSoft Imaging .NET SDK предоставляет следующие контроллеры ASP.NET Core Web API для использования в ASP.NET Core Web приложении:
- VintasoftFileApiController - ASP.NET Core API-контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет манипулировать файлами на сервере.
- VintasoftFileConverterApiController - ASP.NET Core API-контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет конвертировать файлы изображений/документов.
- VintasoftImageApiController - ASP.NET Core API-контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет получать информацию о изображении или рендерить миниатюру/тайл изображения.
- VintasoftImageCollectionApiController - ASP.NET Core API-контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет управлять коллекцией изображений.
- VintasoftImageProcessingApiController - ASP.NET Core API-контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет обрабатывать изображения.
- VintasoftImageProcessingDocCleanupApiController - ASP.NET Core API-контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет обрабатывать изображения документов.
- VintasoftAnnotationCollectionApiController - ASP.NET Core API-контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет аннотировать изображения.
- VintasoftPdfApiController - ASP.NET Core API-контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет работать с PDF-документами.
- VintasoftOfficeApiController - ASP.NET Core API-контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет работать с офисными документами.
- VintasoftDicomApiController - ASP.NET Core API-контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет работать с файлами DICOM.
Какие готовые к использованию веб сервисы VintaSoft Imaging я могу использовать в ASP.NET MVC5 Web приложении?
VintaSoft Imaging .NET SDK предоставляет следующие контроллеры ASP.NET Core Web API для использования в ASP.NET Core Web приложении:
- VintasoftFileApi2Controller - ASP.NET Web API2 контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет манипулировать файлами на сервере.
- VintasoftFileConverterApi2Controller - ASP.NET Web API2 контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет конвертировать файлы изображений/документов.
- VintasoftImageApi2Controller - ASP.NET Web API2 контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет получать информацию о изображении или рендерить миниатюру/тайл изображения.
- VintasoftImageCollectionApi2Controller - ASP.NET Web API2 контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет управлять коллекцией изображений.
- VintasoftImageProcessingApi2Controller - ASP.NET Web API2 контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет обрабатывать изображения.
- VintasoftImageProcessingDocCleanupApi2Controller - ASP.NET Web API2 контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет обрабатывать изображение документа.
- VintasoftAnnotationCollectionApi2Controller - ASP.NET Web API2 контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет аннотировать изображения.
- VintasoftPdfApi2Controller - ASP.NET Web API2 контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет работать с PDF-документами.
- VintasoftOfficeApi2Controller - ASP.NET Web API2 контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет работать с офисными документами.
- VintasoftDicomApi2Controller - ASP.NET Web API2 контроллер, который обрабатывает HTTP-запросы от клиентов и позволяет работать с файлами DICOM.
Какие готовые к использованию веб сервисы VintaSoft Imaging я могу использовать в ASP.NET WebForms Web приложении?
VintaSoft Imaging .NET SDK предоставляет следующие контроллеры ASP.NET Core Web API для использования в ASP.NET Core Web приложении:
- VintasoftFileHandler - ASP.NET HTTP-обработчик, который обрабатывает HTTP-запросы от клиентов и позволяет манипулировать файлами на сервере.
- VintasoftFileConverterHandler - ASP.NET HTTP-обработчик, который обрабатывает HTTP-запросы от клиентов и позволяет конвертировать файл изображения/документа.
- VintasoftImageHandler - ASP.NET HTTP-обработчик, который обрабатывает HTTP-запросы от клиентов и позволяет получать информацию о изображении или рендерить миниатюру/тайл изображения.
- VintasoftImageCollectionHandler - ASP.NET HTTP-обработчик, который обрабатывает HTTP-запросы от клиентов и позволяет управлять коллекцией изображений.
- VintasoftImageProcessingHandler - ASP.NET HTTP-обработчик, который обрабатывает HTTP-запросы от клиентов и позволяет обрабатывать изображение.
- VintasoftImageProcessingDocCleanupHandler - ASP.NET HTTP-обработчик, который обрабатывает HTTP-запросы от клиентов и позволяет обрабатывать изображение документа.
- VintasoftAnnotationCollectionHandler - ASP.NET HTTP-обработчик, который обрабатывает HTTP-запросы от клиентов и позволяет аннотировать изображения.
- VintasoftPdfHandler - ASP.NET HTTP-обработчик, который обрабатывает HTTP-запросы от клиентов и позволяет работать с PDF-документами.
- VintasoftOfficeHandler - ASP.NET HTTP-обработчик, который обрабатывает HTTP-запросы от клиентов и позволяет работать с офисными документами.
- VintasoftDicomHandler - ASP.NET HTTP-обработчик, который обрабатывает HTTP-запросы от клиентов и позволяет работать с файлами DICOM.
Что такое независимый от платформы веб сервис VintaSoft Imaging?
Независимый от платформы веб сервис VintaSoft Imaging - это 100% управляемый .NET сервис, который не зависит ни от какой веб-платформы.
VintaSoft Imaging веб сервис, который не зависит от платформы, используется в качестве ядра для VintaSoft Imaging веб сервиса, зависящего от платформы (ASP.NET Core Web API контроллер API; ASP.NET Web API контроллер API; ASP.NET HTTP-обработчик).
Ниже приведен список VintaSoft Imaging веб сервисов, не зависящих от платформы:
- VintasoftFileWebService - независимый от платформы веб-сервис, который обрабатывает HTTP-запросы от клиентов и позволяет манипулировать файлами на сервере.
- VintasoftFileConverterWebService - независимый от платформы веб-сервис, который обрабатывает HTTP-запросы от клиентов и позволяет конвертировать файл изображения/документа.
- VintasoftImageWebService - независимый от платформы веб-сервис, который обрабатывает HTTP-запросы от клиентов и позволяет получать информацию о изображении или рендерит миниатюру/тайл изображения.
- VintasoftImageCollectionWebService - независимый от платформы веб-сервис, который обрабатывает HTTP-запросы от клиентов и позволяет управлять коллекцией изображений.
- VintasoftImageProcessingWebService - независимый от платформы веб-сервис, который обрабатывает HTTP-запросы от клиентов и позволяет обрабатывать изображения.
- VintasoftImageProcessingDocCleanupWebService - независимый от платформы веб-сервис, который обрабатывает HTTP-запросы от клиентов и позволяет обрабатывать изображение документа.
- VintasoftAnnotationCollectionWebService - независимый от платформы веб-сервис, который обрабатывает HTTP-запросы от клиентов и позволяет аннотировать изображения.
- VintasoftPdfWebService - независимый от платформы веб-сервис, который обрабатывает HTTP-запросы от клиентов и позволяет работать с PDF-документами.
- VintasoftOfficeWebService - независимый от платформы веб-сервис, который обрабатывает HTTP-запросы от клиентов и позволяет работать с офисными документами.
- VintasoftDicomWebService - независимый от платформы веб-сервис, который обрабатывает HTTP-запросы от клиентов и позволяет работать с файлами DICOM.
Где VintaSoft Imaging веб сервис хранит файлы?
По умолчанию каждый VintaSoft Imaging веб сервис хранит файлы в следующих каталогах:
- Загруженные файлы хранятся в каталоге "{WebAppRoot}/UploadedImageFiles/{SessionID}".
- Файлы кэша хранятся в каталоге "{WebAppRoot}/VintasoftCache/{SessionID}".
- Файлы ресурсов хранятся в каталоге "{WebAppRoot}/Resources}".
Файлы хранятся в корневом каталоге веб-приложения, поскольку некоторые файлы должны иметь публичный доступ, например, отрендеренный тайл изображения должен быть доступен веб-браузеру (на стороне клиента).
Где VintaSoft Imaging веб сервис хранит загруженные файлы?
Загруженные файлы - это исходные файлы, которые копируются или загружаются пользователем и используются в текущей веб-сессии.
По умолчанию каждый VintaSoft Imaging веб сервис хранит загруженные файлы в каталоге "{WebAppRoot}/UploadedImageFiles/{SessionID}".
Где VintaSoft Imaging веб сервис хранит файлы кэша?
Файлы кэша - это временные файлы, которые создаются VintaSoft Imaging веб сервисом и используются для целей кэширования.
По умолчанию каждый VintaSoft Imaging веб сервис хранит файлы кэша в каталоге "{WebAppRoot}/VintasoftCache":
- Кэш тайлов изображений хранится в каталоге "{WebAppRoot}/VintasoftCache/{SessionID}/Tiles".
- Кэш миниатюр хранится в каталоге "{WebAppRoot}/VintasoftCache/{SessionID}/Thumbnails".
- Кэш аннотаций хранится в каталоге "{WebAppRoot}/VintasoftCache/{SessionID}/Annotations".
- Кэш сериализованных документов хранится в каталоге "{WebAppRoot}/VintasoftCache/{SessionID}/SerializedDocuments".
- Кэш сконвертированных файлов хранится в каталоге "{WebAppRoot}/VintasoftCache/{SessionID}/ConvertedFiles".
Где VintaSoft Imaging веб сервис хранит файлы ресурсов?
Файлы ресурсов - это файлы, содержащие ресурсы, которые используются VintaSoft Imaging веб сервисом. Файлы ресурсов подготавливаются разработчиком приложения.
По умолчанию каждый VintaSoft Imaging веб сервис хранит файлы ресурсов в каталоге "{WebAppRoot}/Resources".
Могу ли я сохранить все загруженные файлы VintaSoft Imaging веб сервиса в каталоге "{WebAppRoot}/UploadedImageFiles"?
Да, вы можете хранить все загруженные файлы VintaSoft Imaging веб сервиса в каталоге "{WebAppRoot}/UploadedImageFiles". Пожалуйста, выполните следующие действия:
-
Укажите, что вы хотите использовать пустой идентификатор сеанса.
Вот необходимый код на JavaScript/TypeScript: Vintasoft.Общий.WebImagingEnviromentJS.set_SessionId(");
-
Укажите, что VintaSoft Imaging веб сервис позволяет использовать пустую сессию.
Это можно сделать с помощью свойства IsEmptySessionSupported в VintaSoft Imaging веб сервиса, например, с помощью свойства VintasoftImageApiController.IsEmptySessionSupported.
Могу ли я использовать один и тот же пользовательский каталог для загружаемых файлов для всех VintaSoft Imaging веб сервисов?
Да, это возможно. Пожалуйста, выполните следующие действия:
Могу ли я использовать один и тот же пользовательский каталог для файлов кэша для всех VintaSoft Imaging веб сервисов?
Да, это возможно. Свойство
WebServicesGlobalSettings.DataDirectoryDefaultPath позволяет задать путь к каталогу, в котором все VintaSoft Imaging веб сервисы будут хранить файлы данных.
Если путь указывает на каталог в корневом каталоге веб-приложения, никаких дополнительных действий не требуется.
Если путь указывает на каталог за пределами корневого каталога веб-приложения, необходимы следующие дополнительные действия:
-
Укажите, что веб просмотрщик изображений должен использовать base64-изображения для тайлов изображений. Это необходимо, поскольку веб-браузер не может получить доступ к файлам тайлов изображений вне корневого каталога веб-приложения.
Вот необходимый код на JavaScript/TypeScript: imageViewer1.set_TilesFormat("Base64");
-
Укажите, что просмотршик миниатюр должен использовать base64-изображения для создания миниатюр. Это необходимо, поскольку веб-браузер не может получить доступ к файлам миниатюр вне корневого каталога веб-приложения.
Вот необходимый код на JavaScript/TypeScript: thumbnailViewer1.set_ThumbnailsFormat("Base64");
Могу ли я использовать один и тот же пользовательский каталог для файлов ресурсов для всех VintaSoft Imaging веб сервисов?
Да, это возможно. Пожалуйста, выполните следующие действия: