README.md
# GroupDocs.Conversion for Java Dropwizard Example
GroupDocs.Conversion for Java Dropwizard UI Example
###### version 0.0.8
[](https://github.com/groupdocs-Conversion/GroupDocs.Conversion-for-Java-Dropwizard/blob/master/LICENSE)
:warning: **This repository has moved to https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java/tree/master/Demos/Dropwizard**
## System Requirements
- Java 8 (JDK 1.8)
- Maven 3
## Document converter with Java API
**GroupDocs.Conversion for Java API** is a library that allows you to **convert word to PDF, PNG, JPG** and to many other document or image formats supported by the library. Using powerful and flexible GroupDocs.Conversion API you will be able to convert multitude document formats with a wide set of different options.
This web application allows you to convert documents between different formats using simple modern UI. While it can be used as a standalone application it also can be integrated as part of your project.
**Note:** without a license application will run in trial mode, purchase [GroupDocs.Conversion for Java license](https://purchase.groupdocs.com/order-online-step-1-of-8.aspx) or request [GroupDocs.Conversion for Java temporary license](https://purchase.groupdocs.com/temporary-license).
| Document family | Supported formats | Supported conversions |
| ------------------------ | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Microsoft Word | `Doc`,`Docm`,`Docx`,`Dot`,`Dotm`,`Dotx`,`Rtf`,`Txt`,`Odt`,`Ott` | `Word to Rtf`,`Word to Txt`,`Word to Html`,`Word to Odt`,`Word to Ott`,`Word to Epub`,`Word to Pdf`,`Word to Image`,`Word to Cells`,`Word to Slides` |
| Microsoft Excel | `Xls`,`Xls2003`,`Xlsb`,`Xlsm`,`Xlsx` | `Excel to Word`,`Excel to Pdf`,`Excel to Epub`,`Excel to Html`,`Excel to Image`,`Excel to Slides` |
| Portable Document Format | `Pdf` | `Pdf to Word`,`Pdf to Epub`,`Pdf to Html`,`Pdf to Image`,`Pdf to Cells`,`Pdf to Slides` |
| Microsoft PowerPoint | `Ppt`,`Pps`,`Pptx`,`Ppsx`,`Odp` | `Slides to Word`,`Slides to Pdf`,`Slides to Epub`,`Slides to Html`,`Slides to Image`,`Slides to Excel` |
| Microsoft Visio | `Vsd`,`Vsdx`,`Vss`,`Vst`,`Vsx`,`Vtx`,`Vdw`,`Vdx`,`Svg` | `Visio to Word`,`Visio to Pdf`,`Visio to Epub`,`Visio to Html`,`Visio to Image`,`Visio to Excel`,`Visio to Slides` |
| Microsoft Project | `Mpt`,`Mpp` | `Tasks to Word`,`Tasks to Pdf`,`Tasks to Epub`,`Tasks to Html`,`Tasks to Image`,`Tasks to Excel`,`Tasks to Slides` |
| HTML | `Html` | `Html to Word`,`Html to Pdf`,`Html to Epub`,`Html to Cells`,`Html to Slides` |
| Images | `Xps`,`Tiff`,`Tif`,`Jpeg`,`Jpg`,`Png`,`Gif`,`Bmp`,`Ico`,`Dxf`,`Dwg`,`Psd` | `Image to Word`,`Image to Pdf`,`Image to Epub`,`Image to Html`,`Image to Image`,`Image to Cells`,`Image to Slides` |
## Demo Video
<p align="center">
<a title="Document conversion for JAVA " href="https://www.youtube.com/watch?v=QC6P3EbF04o">
<img src="https://raw.githubusercontent.com/groupdocs-conversion/groupdocs-conversion.github.io/master/resources/image/conversion.gif" width="100%" style="width:100%;">
</a>
</p>
## Features
- Clean, modern and intuitive design
- Easily switchable colour theme (create your own colour theme in 5 minutes)
- Responsive design
- Convert individual documents
- Batch convert multiple documents
- Mobile support (open application on any mobile device)
- HTML and image modes
- Drag and Drop support
- Upload documents
- Cross-browser support (Safari, Chrome, Opera, Firefox)
- Cross-platform support (Windows, Linux, MacOS)
## How to run
You can run this sample by one of following methods
#### Build from source
Download [source code](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java-Dropwizard/archive/master.zip) from github or clone this repository.
```bash
git clone https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java-Dropwizard
cd GroupDocs.Conversion-for-Java-Dropwizard
mvn clean compile exec:java
## Open http://localhost:8080/conversion/ in your favorite browser.
```
#### Binary release (with all dependencies)
Download [latest release](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java-Dropwizard/releases/latest) from [releases page](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java-Dropwizard/releases).
**Note**: This method is **recommended** for running this sample behind firewall.
```bash
curl -J -L -o release.tar.gz https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java-Dropwizard/releases/download/0.0.8/release.tar.gz
tar -xvzf release.tar.gz
cd release
java -jar conversion-dropwizard-0.0.8.jar configuration.yaml
## Open http://localhost:8080/conversion/ in your favorite browser.
```
#### Docker image
Use [docker](https://hub.docker.com/u/groupdocs) image.
```bash
mkdir DocumentSamples
mkdir Licenses
docker run -p 8080:8080 --env application.hostAddress=localhost -v `pwd`/DocumentSamples:/home/groupdocs/app/DocumentSamples -v `pwd`/Licenses:/home/groupdocs/app/Licenses groupdocs/conversion
## Open http://localhost:8080/conversion/ in your favorite browser.
```
## Configuration
For all methods above you can adjust settings in `configuration.yml`. By default in this sample will lookup for license file in `./Licenses` folder, so you can simply put your license file in that folder or specify relative/absolute path by setting `licensePath` value in `configuration.yml`.
### Conversion configuration options
| Option | Type | Default value | Description |
| ---------------------------------- | ------- |:-----------------:|:-------------------------------------------------------------------------------------------------------------------------------------------- |
| **`filesDirectory`** | String | `DocumentSamples` | Files directory path. Indicates where uploaded and predefined files are stored. It can be absolute or relative path |
| **`resultDirectory`** | String | | Absolute path to result files directory |
## License
The MIT License (MIT).
Please have a look at the LICENSE.md for more details
## GroupDocs Conversion on other platforms & frameworks
- [Document converter](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java-Spring) with JAVA Spring
- [Document converter](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET-MVC) with .NET MVC
- [Document converter](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET-WebForms) with .NET WebForms
[Home](https://www.groupdocs.com/) | [Product Page](https://products.groupdocs.com/conversion/java) | [Documentation](https://docs.groupdocs.com/conversion/java/) | [Demos](https://products.groupdocs.app/conversion/family) | [API Reference](https://apireference.groupdocs.com/java/conversion) | [Examples](https://github.com/groupdocs-conversion/GroupDocs.conversion-for-Java/tree/master/Examples) | [Blog](https://blog.groupdocs.com/category/annotation/) | [Free Support](https://forum.groupdocs.com/c/conversion) | [Temporary License](https://purchase.groupdocs.com/temporary-license)