JКоннектор (jc1c), Java

04.10.21

Разработка - Инструментарий разработчика

Приветствую коллеги! Данная библиотека призвана упростить и настроить быстрое и простое взаимодействия 1С и вашего скрипта на Java, далее по тексту просто - jar.

Скачать файлы

Наименование Файл Версия Размер
JКоннектор (jc1c)
.cf 7,62Mb
3
.cf 1.0.7 7,62Mb 3 Скачать

Общий принцип работы

Взаимодействие  и jar - это клиент-серверное взаимодействие по протоколу HTTP. В качестве клиента выступает 1С, а в качестве сервера выступает jar.

На стороне 1С вы храните двоичные данные вашего jar, и в момент икс(когда вам необходимо взаимодействие с Java), используя библиотека JКоннектор, передаете эти двоичные данные, библиотека все делает и вы начинаете обращаться к методам своего jar.

ПОНЯТИЯ:

(которые используются в описании и которые необходимо понимать ;-) )

  • jc1c - это библиотека используя которую необходимо писать ваш скрипт на Java(jar), о том как это сделать читайте на GitHub.
  • JКоннектор - это библиотека которую необходимо использовать на стороне 1С, для взаимодействия c вашим скриптом написанным на Java.

ВАЖНО.

Библиотека JКоннектор - это просто удобная обертка для выполнения HTTP запросов к вашему jar, можете делать это и сами, но не стоит...

Написание jar

О том, как писать свой скрипт на Java для того, чтобы было успешное взаимодействие 1С и Java, читайте на Github, там я описал принцип работы работы и взаимодействия со стороны Java.

Ссылка, для ознакомления с проектом - https://github.com/kaliuzhnyi/jc1c

А вот и простой пример как использовать этот проект на стороне Java - https://github.com/kaliuzhnyi/jc1c-examples

Компоненты:

Это компоненты написанные при использовании jc1c для работы через JКоннектор.

Данные компоненты также можно использовать как полноценный и рабочий пример, для написания своих скриптов.

Данные компоненты включены в поставку. Также в поставке присутствуют внешние обработки с примерами использования и работы с данными компонентами.

  • jc1c-qr - компонента на основе jc1c для создания и чтения qr кодов;
  • jc1c-barcode - компонента на основе jc1c для создания и чтения штрихкодов;
  • jc1c-pdf - компонента на основе jc1c для работы с PDF документами, компонента позволяет: преобразовать PDF документа в изображения(одна страница - одно изображение), извлечь текст из PDF документа, преобразовать PDF документ в HTML документ;

Описание использования методов JКоннектор, на стороне 1С

Порядок ваших действий:

  1. Следуя инструкции создаете и скомпилируете jar файл с вашей программой;
  2. Добавляете в 1С двоичные данные этого jar файла, например в макет.
  3. В 1С вызываем метод из библиотеки JКоннектор, и инициализируйте коннектор, вызовете необходимый метод, и остановите работу коннектора.

Пример использования (генерация QR-кода):

// Инициализируем сам объект коннектора	
ОбъектКоннектора = JКоннектор.Инициализировать(Обработки.JКоннекторQR.ПолучитьМакет("jc1c_qr"));

// Обратите внимание на этот метод. В нем мы указываем путь к 
// SDK которая должна быть установлена на сервере.
// Чтобы не указывать этот параметр и не вызывать этот метод, на сервере необходимо настроить Java,
// это очень просто. Просто загуглите "настроить JAVA_HOME", вот например первый попавший сайт
// который вам в этом поможет - https://coderoad.ru/52511778/%D0%9A%D0%B0%D0%BA-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%B8%D1%82%D1%8C-OpenJDK-11-%D0%BD%D0%B0-Windows
JКоннектор.УстановитьSDK(ОбъектКоннектора, "C:\Java\jdk-17\bin\java.exe");

// Запускаем коннектор, в этот момент происходит создание файла и т.д.
JКоннектор.Запустить(ОбъектКоннектора);
Если Не ОбъектКоннектора.РезультатЗапуска.Успешно Тогда
    ВызватьИсключение "JКоннектор: не удалось запустить.";	
КонецЕсли;

// Вызываем нужный нам метод, который мы описали в нашем jar.
ДанныеДляКодированияQR = "https://github.com/kaliuzhnyi/jc1c";
ФорматQR= "png";
ШиринаQR= 500;	
РезультатМетода = JКоннектор.ВызватьМетод(ОбъектКоннектора, "create", ДанныеДляКодированияQR, ФорматQR, ШиринаQR);

// Если не удалось выполнить метод то прерываемся и если мы прерываемся
// значит дальше ничего не будем делать с коннектором,
// а если ничего не будем делать с коннектором значит ОБЯЗАТЕЛЬНО останавливаем коннектор. 	
Если РезультатМетода = Неопределено Тогда
    JКоннектор.Остановить(ОбъектКоннектора);
    ВызватьИсключение "JКоннектор: не удалось выполнить метод.";	
КонецЕсли;

// Полачаем и выводим изображение нашего QR-кода
ИзображениеQR = ПоместитьВоВременноеХранилище(Base64Значение(РезультатМетода));

// ОБЯЗАТЕЛЬНО! Останавливаем работу коннектора,
// З.Ы. Останавливать работу коннектора необязательно после каждого вызова вашего метода в jar.
// Например - тут вы можете еще вызвать еще 100 раз тот же метода или другие методы, если вы их описывали в jar.
// И вот только потом завершать работу коннектора.
//
// Если вы не хотите сами останавливать коннектор, тогда при инициализации можно задать параметр,
// например 60 секунд и тогда коннектор сам выключится при бездействии 60 и более секунду,
// таким образом, чтобы не вызывать тут метод - JКоннектор.Остановить(), необходимо в самом начале делать
// инициализацию коннектора следующим образам:
// ОбъектКоннектора = JКоннектор.Инициализировать(Обработки.JКоннекторQR.ПолучитьМакет("jc1c_qr"),,,, 60)
//
JКоннектор.Остановить(ОбъектКоннектора);

 

Видео

Для большего понимания того как это все работает настоятельно рекомендую посмотреть несколько коротких видео-уроков.

  1. JКоннектор(jc1c), создание компоненты на стороне JAVA
  2. JКоннектор(jc1c), взаимодействие с компонентой на стороне 1С

 

Поставка

В комплект поставки входит конфигурация, в которой есть одна подсистема JКоннектор, собственно эту подсистему вам и нужно внедрять в свою информационную бузу.

Совместимость

Платформа:

  • должна работать на всех релизах 8.3
  • тестировалась на релизах:
    • 8.3.16.1224

Конфигурации:

  • Не имеет значения

См. также

Infostart Toolkit: Инструменты разработчика 1С 8.3 на управляемых формах

Инструментарий разработчика Роли и права Запросы СКД Платформа 1С v8.3 Управляемые формы Запросы Система компоновки данных Конфигурации 1cv8 Платные (руб)

Набор инструментов программиста и специалиста 1С для всех конфигураций на управляемых формах. В состав входят инструменты: Консоль запросов, Консоль СКД, Консоль кода, Редактор объекта, Анализ прав доступа, Метаданные, Поиск ссылок, Сравнение объектов, Все функции, Подписки на события и др. Редактор запросов и кода с раскраской и контекстной подсказкой. Доработанный конструктор запросов тонкого клиента. Продукт хорошо оптимизирован и обладает самым широким функционалом среди всех инструментов, представленных на рынке.

10000 руб.

02.09.2020    122290    673    389    

716

SALE! 25%

Infostart PrintWizard

Пакетная печать Печатные формы Инструментарий разработчика Платформа 1С v8.3 Запросы 1С:Зарплата и кадры бюджетного учреждения 1С:Конвертация данных 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 Платные (руб)

Инструмент, позволяющий абсолютно по-новому взглянуть на процесс разработки печатных форм. Благодаря конструктору можно значительно снизить затраты времени на разработку печатных форм, повысить качество и "прозрачность" разработки, а также навести порядок в многообразии корпоративных печатных форм.

18000 15300 руб.

06.10.2023    7326    22    6    

39

SALE! 20%

Infostart УДиФ: Управление данными и формами

Инструменты администратора БД Инструментарий разработчика Роли и права Платформа 1С v8.3 Конфигурации 1cv8 Россия Платные (руб)

Расширение позволяет без изменения кода конфигурации выполнять проверки при вводе данных, скрывать от пользователя недоступные ему данные, выполнять код в обработчиках. Не изменяет данные конфигурации, легко устанавливается практически на любую конфигурацию на управляемых формах.

10000 8000 руб.

10.11.2023    3583    11    1    

34

SALE! 30%

PowerTools

Инструментарий разработчика Инструменты администратора БД Платформа 1С v8.3 Управляемые формы Конфигурации 1cv8 Россия Платные (руб)

Универсальный инструмент программиста для администрирования конфигураций. Сборник наиболее часто используемых обработок под единым интерфейсом.

3600 2520 руб.

14.01.2013    177773    1074    0    

849

Многопоточность. Универсальный «Менеджер потоков» 2.1

Инструментарий разработчика Платформа 1С v8.3 Конфигурации 1cv8 Россия Платные (руб)

Восстановление партий или взаиморасчетов, расчет зарплаты, пакетное формирование документов или отчетов - теперь все это стало доступнее. * Есть желание повысить скорость работы медленных алгоритмов! Но... * Нет времени думать о реализации многопоточности? * о запуске и остановке потоков? * о поддержании потоков в рабочем состоянии? * о передаче данных в потоки и как получить ответ из потока? * об организации последовательности? Тогда ЭТО - то что надо!!!

5000 руб.

07.02.2018    99365    239    97    

296

[ЕХТ] Фреймворк для Расширений 1С

Инструментарий разработчика Платформа 1С v8.3 Управляемые формы Платные (руб)

"Фреймворк для Расширений 1С" это универсальное и многофункциональное решение, упрощающее разработку и поддержку создаваемых Расширений. Поставляется в виде комплекта из нескольких Расширений с открытым исходным кодом. Работает в любых Конфигурациях в режиме Управляемого приложения с режимом совместимости 8.3.12 и выше без необходимости внесения изменений в Конфигурацию.

3000 руб.

27.08.2019    18130    6    8    

40

1С HTML Шаблоны / HTML Templates

Инструментарий разработчика Платформа 1С v8.3 Конфигурации 1cv8 Платные (руб)

Быстрая и удобная обработка для работы с шаблонами HTML. Позволяет легко и быстро формировать код HTML.

2040 руб.

27.12.2017    28115    3    10    

15

Выполнение произвольного кода или запроса с параметрами через Web-сервис (замена COM-подключений)

Инструментарий разработчика Обмен между базами 1C Платформа 1С v8.3 Платные (руб)

В процессе работы в 1С часто возникает потребность получить данные из другой базы.  Обычно это делается через COM-соединение, и время выполнения запроса при этом оставляет желать лучшего. В данной публикации представлено универсальное решение, позволяющее практически моментально выполнить произвольный код или запрос с параметрами в другой информационной базе через Web-сервис.

2400 руб.

24.09.2019    23605    15    15    

32
Комментарии
В избранное Подписаться на ответы Сортировка: Древо развёрнутое
Свернуть все
1. nbeliaev 828 04.10.21 12:41 Сейчас в теме
Скажите, пожалуйста, зачем Вам кастомные аннотации? Я наверное пропустил место, где Вы работаете с рефлексией, но зато в билдере JServer явно нужно указывать класс хэндлера.

В целом, рекомендую взглянуть на Spring Web, Можно много чего сделать проще с помощью этого фреймворка.

Тем не менее спасибо за то, что расшарили свое решение!
2. kaliuzhnyi 135 04.10.21 12:56 Сейчас в теме
(1) Добрый день. Спасибо за подсказку, Spring потехоньку изучаю.
По поводу аннотаций:
- в видео я не показывал как устроен класс JServer и другие, видео больше для 1С-ников которым интересна Java(но знания пока на минимуме), отчасти и наверное и меня пока можно к таким отнести ;)
- аннотация @JHandlerControllers на данном этапе пока пока не имеет назначения, но есть планы на будущее.
- а вот аннотация @JHandler важна именно по ней и происходит поиск методов, таким образам в классе(помеченным аннотаций @JHandlerControllers) может быть множество методов, но вызвать из 1с можно только методы помеченный аннотацией @JHandler.
- рефлексия происходит в классе JContextHandler
3. nbeliaev 828 04.10.21 13:45 Сейчас в теме
(2) Спасибо за ответ! Удачи в изучении!
4. pashamak 268 05.10.21 09:50 Сейчас в теме
Оставьте свое сообщение