Обычно все современные приложения, так или иначе, способны общаться с внешним миром, а особо продвинутые могут общаться через веб-технологии. Как оказалось, даже такую, устаревшую по современным меркам платформу, как 1С:Предприятие 7.7 возможно научить работать с полноценными Http запросами. Здесь я приведу пример внедрения максимально простого варианта REST сервиса для того чтобы понять сам принцип его запуска и работы. В целом система состоит из следующих компонент:
- сервер приложений Apache-Tomcat, он принимает http запрос и запускает сервлет
- сервлет, написанный на Java, который при получении http запроса запускает 1С через COM-объект, получает выборку данных, форматирует ответ в формате JSON и отправляет назад
- Java-библиотека для обращения сервлета к 1С — Jawin
- 1С:Предприятие 7.7, в конфигурацию необходимо внести дополнения — функции, через которые сервлет будет получать данные и выполнять нужные операции
Постараюсь описать по шагам, как заставить всё это работать вместе.
Установка Java Runtime Environment (JRE)
Для работы сервлета и самого сервера приложений понадобится среда Java, установщик можно скачать с сайта Oracle: ссылка. Разрядность Java, как и других программ далее, выбирал 32-битную, т.к. имеем дело с 1С 7.7, которая иначе работать не будет.
Установка Tomcat
С веб-сервером всё просто, я использовал версию 8.5.32. Для удобства настройки качайте Windows Installer, во время установки будет предложено выбрать порт, имя и пароль пользователя с доступом к публикации приложений. Рекомендую сразу задать логин и надежный пароль, т.к. наша задача предполагает включение доступа к серверу из Интернета. Также можно выбрать каталог установки по-проще, например «C:\tomcat». Установщик попросит указать путь к JRE, если на предыдущем этапе ставили по умолчанию, путь будет примерно таким:
c:\Program Files (x86)\Java\jre1.8.0_181\После завершения установки начальная страница сервера должна отображаться по адресу http://localhost:8080 или на том порту, который вы назначили сами.
Пишем Java-сервлет в IDEA Community
Для написания кода сервлета я использовал бесплатную среду разработки JetBrains IDEA Community Edition 2018.2.1, скачать можно с официального сайта: ссылка. Хотя в описании версий сказано, что только Ultimate версия поддерживает разработку веб-приложений, можете не переживать, для наших целей подойдет и Community. Установку можно сделать с параметрами по умолчанию, только в конце выбрать опцию «32-bit launcher».
Создаем новый проект Maven — используя архетип org.apache.maven.archetypes:maven-archetype-webapp, название проекта лучше сразу задать в нижнем регистре одним словом — потом это будет именем веб-приложения и соответственно частью url для вызова сервиса
Добавляем зависимости для работы сервлета и работы с JSON в pom.xml
<dependency>
<groupId>org.glassfish.jersey.containers</groupId>
<artifactId>jersey-container-servlet</artifactId>
<version>2.26</version>
</dependency>
<dependency>
<groupId>org.glassfish.jersey.inject</groupId>
<artifactId>jersey-hk2</artifactId>
<version>2.26</version>
</dependency>
<dependency>
<groupId>com.googlecode.json-simple</groupId>
<artifactId>json-simple</artifactId>
<version>1.1.1</version>
</dependency>Пишем конфигурацию сервлета в web.xml, здесь вместо «ua.com.programmer.webapp» должен быть идентификатор вашего приложения, а ключ «url-pattern» задает путь к методам вебсервиса
<servlet>
<servlet-name>jersey-servlet</servlet-name>
<servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
<init-param>
<param-name>jersey.config.server.provider.packages</param-name>
<param-value>ua.com.programmer.webapp</param-value>
<load-on-startup>1</load-on-startup>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>jersey-servlet</servlet-name>
<url-pattern>/hs/*</url-pattern>
</servlet-mapping>Добавляем библиотеку Jawin.
В загруженном архиве будет несколько папок, нам нужна jawin.jar, её нужно положить в любое удобное место, например в папку lib внутри проекта и подключить в свойствах проекта:
Потом из архива нужно скопировать jawin.dll в каталог bin JRE, примерно такой: c:\Program Files (x86)\Java\jre1.8.0_181\bin\
Добавляем Java-class обработчик запросов сервера.
package ua.com.programmer.webapp;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.core.Response;
@Path("/dex")
public class DataLoadService {
@GET
@Path("/documents/{type}/{period}")
public Response getDocumentsData(@PathParam("type") String dataType, @PathParam("period") String period){
Connector connector = new Connector();
String output = connector.getDocumentsData(dataType);
return Response.status(200).entity(output).build();
}
}В заголовке класса параметр @Path(«/dex») задает путь к методам этого класса, потом у процедуры, аналогичный параметр @Path(«/documents/{type}/{period}») задает путь для конкретного метода и его входные параметры. Учитывая путь который был задан в web.xml, для процедуры getDocumentsData() получим полный путь: /hs/dex/documents/… и тут уже будут параметры.
Теперь можем делать стыковку с 1С, добавляем Java-class для связи с базой данных. Пара фрагментов из модуля класса:
private final String init = "enterprise /D\"D:\\1S_Base" /N\"Odmin\" /P123";
private DispatchPtr app;
private boolean openConnection(){
try {
Ole32.CoInitialize();
app = new DispatchPtr("V77.Application");
app.invoke("Initialize",app.get("RMTrade"),init,"NO_SPLASH_SHOW");
return true;
}catch (Exception ex){
System.out.println("Connection error: "+ex.toString());
}
return false;
}
String getDocumentsData(String docType){
String result;
JSONObject jsonObject = new JSONObject();
JSONArray resultArray = new JSONArray();
if (openConnection()){
try {
DispatchPtr docItems = (DispatchPtr) app.invoke("ВыборкаДокументов", docType, period);
while ((Double) docItems.invoke("GetDocument") > 0.0){
DispatchPtr item = (DispatchPtr) docItems.invoke("CurrentDocument");
readDocumentItemData(item, resultArray);
}
}catch (Exception ex) {
System.out.println("Error: " + ex.toString());
jsonObject.put("error", ex.toString());
}finally {
closeConnection();
}
}
app = null;
jsonObject.put("result", resultArray);
result = jsonObject.toString();
return result;
}Функция openConnection запускает подключение к 1С, строка запуска в переменной init, там прописан путь к базе, имя и пароль пользователя. Функция getDocumentsData возвращает выборку документов в виде текста в JSON формате. В ней вызывается функция из глобального модуля 1С: ВыборкаДокументов и потом происходит обычный перебор выборки с записью данных шапки в массив, процедура readDocumentItemData. Принцип простой, если нам нужно вызвать метод, используем invoke(«ИмяМетода», Параметр1, Параметр2….), когда нужен атрибут, используем get(«ИмяАтрибута»).
Код класса полностью:
Выглядит громоздко, просто тут уже добавлена ещё и выборка справочников.
Публикация на веб-сервер
Для запуска веб-сервиса нужно опубликовать его на сервере, для Tomcat понадобится war-файл, это делается с помощью мавен-плагина. Перед генерацией не забываем сделать билд проекта.
Готовый файл будет лежать в директории target в каталоге проекта.
Теперь открываем Tomcat — Manager App, логин и пароль для перехода на эту страницу — это те, которые были заданы при установке. Загружаем файл на сервер, если всё сделано как надо, приложение появится в списке и будет уже запущено.
Изменения в конфигурации 1С
Остается добавить в конфигурацию функции, которые будет вызывать сервис, в этом примере их легко заметить в коде по кириллическим названиям. Функции должны располагаться в Глобальном модуле и обозначены как экспортируемые.
Функция выборки данных должна вернуть указатель выборки, вот пример получения данных по документам за последние пол года :
Также, в коде класса можно заметить несколько служебных функций: ИдентификаторЭлемента, ДатаДокумента, СуммаДокумента, с ними логика простая — всё что может понадобиться в модуле сервиса и что хоть как-то зависит от конфигурации, пишем и вычисляем на стороне 1С.
Проверка работы сервиса
Для того чтобы убедиться в работоспособности сервиса достаточно открыть браузер и ввести нужный адрес. Путь составляем так:
адрес_сервера:порт/имя_приложения/корневой_путь_приложения/путь_класса/путь_процедуры/параметры...
Если сервис работает верно, увидим ответ в виде текста в JSONформате. Можно не пугаться нечитаемой кириллицы, если цель сервиса не отображение данных в браузере — при передаче такого текста например в Андроид-приложение, все данные в порядке.
Ну, вот и всё.
Рабочий проект с примером кода для 1С доступен на GitHub: ссылка.