Add References and Set a License - Java

This tutorial shows how to get started with the LEADTOOLS SDK in a Java application. Before functionality from the SDK can be leveraged, a valid runtime license will have to be set. For instructions on how to obtain a runtime license refer to Obtaining a License.

Overview
Summary This tutorial covers how to set a license in a Java application.
Completion Time 30 minutes
Visual Studio Project Download tutorial project (1 KB)
Platform Java Application
IDE Visual Studio 2017, 2019
Runtime License Download LEADTOOLS

Create the Project

Launch Eclipse and select File -> New -> Java Project, then add the project name and click Finish.

Create a new java project and name it

In the new window it will ask to create a new module-info.java file, select Don't Create. Once the project is created, right-click the project and select New -> Package. Add a package name and click Finish.

Create a new java package and name it

Add a new class to the package by right-clicking the package and selecting New -> Class. Add a name for the class and click Finish.

Create a new java class and name it

Add LEADTOOLS References

To leverage the LEADTOOLS SDK in a Java project, references to the LEADTOOLS JAR files will be need.

Right-click on the Java project in the Package Explorer and select Properties. Select Java Build Path, and click on the Libraries tab. Select Classpath, then click Add External JARs....

Adding external JARs

Navigate to this path: <INSTALLATION DIR>\LEADTOOLS21\Bin\Java

The following JAR file is required for this tutorial.

Select Open, then click Apply and Close

Add the leadtools.jar to the project

Open the _Main.java class in the Package Explorer. Add the following import statements to the import block at the top.

Java
import java.io.IOException; 
import java.nio.file.*; 
import leadtools.*; 

Inside the main() method add the following to set the library path to where the CDLL files are located, as well as load the LEADTOOLS library that was previously imported.

Java
public static void main(String[] args) throws IOException 
{ 
	Platform.setLibPath("C:\\LEADTOOLS21\\Bin\\CDLL\\x64"); 
	Platform.loadLibrary(LTLibrary.LEADTOOLS); 
} 

Add the Set License Code

With the project created and the references add, the set license code can be added.

In the _Main class add a new method called SetLicense() and call the method at the bottom of the main() method. Add the following code to properly set the LEADTOOLS license.

Java
static void SetLicense() throws IOException 
{ 
	String licenseFile = "C:\\LEADTOOLS21\\Support\\Common\\License\\LEADTOOLS.LIC"; 
	String developerKey = Files.readString(Paths.get("C:\\LEADTOOLS21\\Support\\Common\\License\\LEADTOOLS.LIC.KEY")); 
	RasterSupport.setLicense(licenseFile, developerKey); 
	if(RasterSupport.getKernelExpired()) 
		System.out.println("License file invalid or expired."); 
	else 
		System.out.println("License file set successfully."); 
} 

Run the Project

Run the project by selecting Run -> Run.

If the steps were followed correctly, a message in the Console window will show License file set successfully.

Output message to the console

Wrap-up

This tutorial showed how to create a new Java Project, add LEADTOOLS JAR and DLL references, and set the license.

This is the basis for all Java applications leveraging the LEADTOOLS SDK. All functionality in the SDK is unlocked via setting a license. The SetLicense method must be called before calling any other LEADTOOLS SDK methods.

Once the SDK is purchased, the evaluation license can be replaced with a valid runtime license to disable the Nag Message.

See Also

Help Version 21.0.2020.9.15
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.