Instructions

U.are.U SDK - Developer Guide 29
The JAVA API
THIS CHAPTER DESCRIBES HOW TO USE THE JAVA API.
The Java API is built as a wrapper to the C/C++ API. The Java API is available for Linux, Android and Windows. This
chapter provides an overview of the API. For details of using the API on a specific reader platform, consult the
appropriate Platform Guide.
The Java API is considerably simpler to use than the C/C++ APIs and therefore generally results in:
• Easier data management
• Easier enrollment
• Faster development
Importing the U.are.U Java package
The U.are.U Java library classes and interfaces are aggregated into dpuaru.jar. To use the U.are.U Java library
functionality import the com.Crossmatch.uareu.* package, and make sure to include dpuareu.jar into
your classpath.
Getting Detailed Documentation
This chapter provides an overview of the main methods in the Java API. For a complete description of method
parameters, the Javadoc documentation for the Java libraries is provided. Consult the platform guide for details of
where the Javadoc files are located.
Using the Package
Main Access Point
The main access point to the U.are.U Java library is the UareUGlobal class. This is a static class, which allows you
to acquire references to the classes related to fingerprint readers and to the FingerJet Engine:
• To acquire a reference to ReaderCollection use the GetReaderCollection() method. To destroy
ReaderCollection, (release all system resources associated with readers and make readers available for other
processes) use the DestroyReaderCollection() method.
• To acquire a reference(s) to individual readers, use the ReaderCollection object, which is a collection of
objects of type Reader.
• To acquire a reference to the FingerJet Engine use the GetEngine() method. The engine does not use or
allocate any system resources except memory and does not have to be destroyed explicitly.
UareUException
The UareUException interface describes exceptions specific to the U.are.U SDK.
Getting a List of Available Readers
The ReaderCollection interface provides a list of the readers connected to the machine. A list of available
readers can be acquired any time with GetReaders() method.