How to Run the Examples

Download from GitHub

All examples of Aspose.Words for Java are hosted on Github. You can either clone the repository using your favorite Github client or download the ZIP file from here.

Extract the contents of ZIP file to any folder on your computer. All the examples are located in the Examples folder.

The project uses Maven build system. Any modern IDE can easily open or import the project and its dependencies. Below we show you how to use popular IDEs to build and run the examples.

IntelliJ IDEA

Click on the File menu and choose Open. Browse to the project folder and select the pom.xml file.

It will open the project and download the dependencies automatically. From the Project tab, browse the examples in src/main/java folder. To run an example, just right click on the file and choose “Run ..”, the example will be executed and the output will be shown in the built in console output window.

Eclipse

Click on File menu and choose Import. Select Maven - Existing Maven Projects.

Browse to the folder that you cloned or downloaded from GitHub and select pom.xml file.

It will open the project and download the dependencies automatically. From the Package Explorer tab, browse the examples in src/main/java folder. To run an example, just right click on the file and choose Run As - Java Application, the example will be executed and the output will be shown in the built in console output window.

NetBeans

Click on the File menu and choose Open Project. Browse to the folder that you cloned or downloaded from GitHub. The icon of Examples folder will show that its a Maven project. Select Examples and open it.

It will open the project and download the dependencies automatically. From the Projects tab, browse the examples in source packages. To run an example, just right click on the file and choose Run File, the example will be executed and the output will be shown in the built in console output window.

Contribute

If you like to add or improve an example, we encourage you to contribute to the project. All examples and showcase projects in this repository are open source and can be freely used in your own applications.

To contribute, you can fork the repository, edit the source code and create a pull request. We will review the changes and include it in the repository if found helpful.

---

FAQ

1. Q: How can I build and run the Aspose.Words for Java examples from the command line?
   A: Open a terminal in the root folder of the cloned repository and execute mvn clean compile exec:java -Dexec.mainClass=com.aspose.words.examples.<ExampleClass>. Maven will download all required dependencies, compile the sources, and launch the specified example class.

2. Q: Which Java Development Kit (JDK) version is required for the examples?
   A: The examples target JDK 8 or higher. Using a recent JDK (e.g., 11, 17) is recommended to avoid compatibility warnings and to benefit from the latest language features.

3. Q: Do I need a license file to run the example projects?
   A: A license is not mandatory for running the examples; they work in evaluation mode with limited functionality (e.g., watermarks). To test full features, place a valid Aspose.Words.Java.lic file in the project’s root or set the license programmatically as shown in the “Licensing” example.

4. Q: How do I run a specific example in IntelliJ IDEA, Eclipse, or NetBeans?
   A: Locate the Java class that contains the main method for the desired example (under src/main/java/com/aspose/words/examples). Right‑click the class and choose Run (IntelliJ/Eclipse) or Run File (NetBeans). The IDE will compile the class and display the console output.

5. Q: Can I run the examples on Linux or macOS without an IDE?
   A: Yes. After installing Maven and a compatible JDK, use the same command‑line approach described above. Ensure that the JAVA_HOME environment variable points to your JDK installation, then execute the Maven command to run any example.