|
| 1 | + |
| 2 | +# GroupDocs.Conversion for Java Dropwizard Example |
| 3 | +GroupDocs.Conversion for Java Dropwizard UI Example |
| 4 | +###### version 0.0.8 |
| 5 | + |
| 6 | +[](https://travis-ci.org/groupdocs-Conversion/GroupDocs.Conversion-for-Java-Dropwizard) |
| 7 | +[](https://codeclimate.com/github/groupdocs-conversion/GroupDocs.Conversion-for-Java-Dropwizard/maintainability) |
| 8 | +[](https://github.com/groupdocs-Conversion/GroupDocs.Conversion-for-Java-Dropwizard/blob/master/LICENSE) |
| 9 | + |
| 10 | +## System Requirements |
| 11 | +- Java 8 (JDK 1.8) |
| 12 | +- Maven 3 |
| 13 | + |
| 14 | + |
| 15 | +## Document converter with Java API |
| 16 | + |
| 17 | +**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. |
| 18 | + |
| 19 | +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. |
| 20 | + |
| 21 | +**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). |
| 22 | + |
| 23 | +| Document family | Supported formats | Supported conversions | |
| 24 | +| ------------------------ | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | |
| 25 | +| 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` | |
| 26 | +| 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` | |
| 27 | +| Portable Document Format | `Pdf` | `Pdf to Word`,`Pdf to Epub`,`Pdf to Html`,`Pdf to Image`,`Pdf to Cells`,`Pdf to Slides` | |
| 28 | +| 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` | |
| 29 | +| 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` | |
| 30 | +| 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` | |
| 31 | +| HTML | `Html` | `Html to Word`,`Html to Pdf`,`Html to Epub`,`Html to Cells`,`Html to Slides` | |
| 32 | +| 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` | |
| 33 | + |
| 34 | + |
| 35 | +## Demo Video |
| 36 | + |
| 37 | +<p align="center"> |
| 38 | + <a title="Document conversion for JAVA " href="https://www.youtube.com/watch?v=QC6P3EbF04o"> |
| 39 | + <img src="https://raw.githubusercontent.com/groupdocs-conversion/groupdocs-conversion.github.io/master/resources/image/conversion.gif" width="100%" style="width:100%;"> |
| 40 | + </a> |
| 41 | +</p> |
| 42 | + |
| 43 | + |
| 44 | +## Features |
| 45 | + |
| 46 | +- Clean, modern and intuitive design |
| 47 | +- Easily switchable colour theme (create your own colour theme in 5 minutes) |
| 48 | +- Responsive design |
| 49 | +- Convert individual documents |
| 50 | +- Batch convert multiple documents |
| 51 | +- Mobile support (open application on any mobile device) |
| 52 | +- HTML and image modes |
| 53 | +- Drag and Drop support |
| 54 | +- Upload documents |
| 55 | +- Cross-browser support (Safari, Chrome, Opera, Firefox) |
| 56 | +- Cross-platform support (Windows, Linux, MacOS) |
| 57 | + |
| 58 | +## How to run |
| 59 | + |
| 60 | +You can run this sample by one of following methods |
| 61 | + |
| 62 | +#### Build from source |
| 63 | + |
| 64 | +Download [source code](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java-Dropwizard/archive/master.zip) from github or clone this repository. |
| 65 | + |
| 66 | +```bash |
| 67 | +git clone https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java-Dropwizard |
| 68 | +cd GroupDocs.Conversion-for-Java-Dropwizard |
| 69 | +mvn clean compile exec:java |
| 70 | +## Open http://localhost:8080/conversion/ in your favorite browser. |
| 71 | +``` |
| 72 | + |
| 73 | +#### Binary release (with all dependencies) |
| 74 | + |
| 75 | +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). |
| 76 | + |
| 77 | +**Note**: This method is **recommended** for running this sample behind firewall. |
| 78 | + |
| 79 | +```bash |
| 80 | +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 |
| 81 | +tar -xvzf release.tar.gz |
| 82 | +cd release |
| 83 | +java -jar conversion-dropwizard-0.0.8.jar configuration.yaml |
| 84 | +## Open http://localhost:8080/conversion/ in your favorite browser. |
| 85 | +``` |
| 86 | + |
| 87 | +#### Docker image |
| 88 | +Use [docker](https://hub.docker.com/u/groupdocs) image. |
| 89 | + |
| 90 | +```bash |
| 91 | +mkdir DocumentSamples |
| 92 | +mkdir Licenses |
| 93 | +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 |
| 94 | +## Open http://localhost:8080/conversion/ in your favorite browser. |
| 95 | +``` |
| 96 | + |
| 97 | +## Configuration |
| 98 | +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`. |
| 99 | + |
| 100 | +### Conversion configuration options |
| 101 | + |
| 102 | +| Option | Type | Default value | Description | |
| 103 | +| ---------------------------------- | ------- |:-----------------:|:-------------------------------------------------------------------------------------------------------------------------------------------- | |
| 104 | +| **`filesDirectory`** | String | `DocumentSamples` | Files directory path. Indicates where uploaded and predefined files are stored. It can be absolute or relative path | |
| 105 | +| **`resultDirectory`** | String | | Absolute path to result files directory | |
| 106 | + |
| 107 | + |
| 108 | +## License |
| 109 | +The MIT License (MIT). |
| 110 | + |
| 111 | +Please have a look at the LICENSE.md for more details |
| 112 | + |
| 113 | +## GroupDocs Conversion on other platforms & frameworks |
| 114 | + |
| 115 | +- [Document converter](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-Java-Spring) with JAVA Spring |
| 116 | +- [Document converter](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET-MVC) with .NET MVC |
| 117 | +- [Document converter](https://github.com/groupdocs-conversion/GroupDocs.Conversion-for-.NET-WebForms) with .NET WebForms |
| 118 | + |
| 119 | + |
| 120 | +[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) |
0 commit comments