Evaluation Limitations and Licensing
Evaluation version limitations
You can easily download GroupDocs.Watermark for evaluation. The evaluation download is the same as the purchased download. The evaluation version simply becomes licensed when you add a few lines of code to apply the license. You will face following limitations while using the API without the license.
API Feature | Limitation |
---|---|
Document loading | Only 10 documents can be loaded per application run. |
Watermark search/removing | Removing/replacing of document parts is not allowed in evaluation mode. |
Watermark adding | Only 1 watermark can be added to a document per editing session. |
Document saving | Evaluation warning watermark will be added to a document. |
Licensing
The license file contains details such as the product name, number of developers it is licensed to, subscription expiry date and so on. It contains the digital signature, so don’t modify the file. Even inadvertent addition of an extra line break into the file will invalidate it. You need to set a license before utilizing GroupDocs.Watermark API if you want to avoid its evaluation limitations.
The license can be loaded from a file or stream object.
Setting license from file
The code below will explain how to set product license from a file.
// For complete examples and data files, please go to https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Java
//initialize License
License lic = new License();
//Set license
lic.setLicense("GroupDocs.Watermark.lic");
Setting license from stream
The following example shows how to load a license from a stream.
// For complete examples and data files, please go to https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Java
Path fileLocation = Paths.get("GroupDocs.Watermark.lic");
try {
byte[] data = Files.readAllBytes(fileLocation);
ByteArrayInputStream inputStream = new ByteArrayInputStream(data);
License lic = new License();
lic.setLicense(inputStream);
} catch (IOException e) {
System.out.println(e.getMessage());
}
Setting metered license
You can also set Metered license as an alternative to license file. It is a new licensing mechanism that will be used along with existing licensing method. It is useful for the customers who want to be billed based on the usage of the API features. For more details, please refer to Metered Licensing FAQ section. Here are the simple steps to use the Metered class.
- Create an instance of Metered class.
- Pass public & private keys to setMeteredKey method.
- Do processing (perform task).
- Call method getConsumptionQuantity of the Metered class.
- It will return the amount/quantity of API requests that you have consumed so far.
- Call method getConsumptionCredit of the Metered class.
- It will return the credit that you have consumed so far.
Following is the sample code demonstrating how to set metered public and private keys.
// For complete examples and data files, please go to https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Java
string PublicKey = ""; // Your public license key
string PrivateKey = ""; // Your private license key
Metered metered = new Metered();
try {
metered.setMeteredKey(PublicKey, PrivateKey);
} catch (Exception e) {
System.out.println(e.getMessage());
}
// Get amount (MB) consumed
double amountConsumed = Metered.getConsumptionQuantity();
// Get count of credits consumed
double creditsConsumed = Metered.getConsumptionCredit();