https://github.com/payneteasy/libreoffice-api-wrapper
Java wrapper of Libreoffice API
https://github.com/payneteasy/libreoffice-api-wrapper
Last synced: 11 months ago
JSON representation
Java wrapper of Libreoffice API
- Host: GitHub
- URL: https://github.com/payneteasy/libreoffice-api-wrapper
- Owner: payneteasy
- Created: 2019-10-21T11:04:24.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2025-01-27T13:06:56.000Z (over 1 year ago)
- Last Synced: 2025-04-02T06:05:44.268Z (over 1 year ago)
- Language: Java
- Homepage:
- Size: 127 KB
- Stars: 3
- Watchers: 12
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# libreoffice-api-wrapper
Java wrapper of Libreoffice API
## Параметры http-сервера:
* ```SERVER_PORT``` - порт, на который будут приниматься входящие HTTP запросы. По умолчанию ```8080```
* ```SERVER_SERVLET_CONTEXT``` - контекст сервера приложений. По умолчанию ```/converter```
* ```SERVER_SERVLET_PATH``` - путь запроса для конвертации документов. По умочанию ```/convert```
## Параметры сервиса libreoffice
* ```LIBREOFFICE_HOST``` - адрес хоста, на котором разрвернут сервис libreoffice. По умолчанию ```localhost```
* ```LIBREOFFICE_PORT``` - порт, на который сервис libreoffice принимает соединения. По умолчанию ```8100```
Пераметры http-сервера и сервиса libreoffice можно задать, например, через переменные среды. Также возможно задать параметры через system properties.
## Пример команды запуска сервера
```bash
java -jar libreoffice-api-wrapper-server-1.0-jar-with-dependencies.jar
```
```bash
java -DSERVER_PORT=8081 -jar libreoffice-api-wrapper-server-1.0-jar-with-dependencies.jar
```
## Формат http запроса для конвертации документов
* Метод запроса - ```POST```
* Параметр ```inputFormat``` - формат входного документа (поддерживаемые форматы: ```csv```,```doc```,```docx```,```xls```,```xlsx```)
* Параметр ```outputFormat``` - формат выходного документа (поддерживаемые форматы: ```pdf```)
* В теле запроса передается содержимое документа для конвертации
## Релиз пакета в гитхаб
* Настроить .m2/settings.xml для github https://help.github.com/en/packages/using-github-packages-with-your-projects-ecosystem/configuring-apache-maven-for-use-with-github-packages#authenticating-with-the-github_token
* Выполнить локально команды:
```bash
mvn -Dmaven.test.skip=true clean package
```
Далее необходимо запустить libreoffice-api-wrapper-server.jar и докер для тестов:
```bash
java -jar libreoffice-api-wrapper-server/target/libreoffice-api-wrapper-server-{current_version}-jar-with-dependencies.jar
```
```bash
docker run -t --name libreoffice -p 8100:8100 hdejager/libreoffice-api
```
```bash
mvn test
```
Релизить только, если тесты прошли успешно
```bash
mvn build-helper:parse-version versions:set -DnewVersion=\${parsedVersion.majorVersion}.\${parsedVersion.minorVersion}.\${parsedVersion.nextIncrementalVersion} versions:commit
```
```bash
mvn deploy
```
Сделай коммит после деплоя!!!!