Difference between revisions of "JavaQM-API"

From ScarletDME
Jump to navigation Jump to search
(Added support)
(→‎Commercial Support: updated Tesson weblink)
 
(4 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
All you need is QMClient running on the server, the IP address, a valid username and password and the Account you want to access.
 
All you need is QMClient running on the server, the IP address, a valid username and password and the Account you want to access.
  
==Features==
+
==Download==
Currently the API supports almost all of the Documented QMClient commands. Access to them is controlled by the main class QMConnection.
+
Binary (Jar) download is available here: [http://www.scarletdme.org/downloads/JavaQMConnect-0.8.jar JavaQMConnect-0.8.jar]
 +
 
 +
To use simply download the Jar file and place it in the ClassPath or same directory as your own Java Program. See the example below for more details.
 +
 
 +
===Source code===
 +
LGPL licenced source code for this library are available in the following locations:
  
==Download==
+
The latest Source is available from the subversion repo [https://scarletdme.org/svn/qmvdb/JavaQMClient https://ScarletDME.org/svn/qmvdb/JavaQMClient]
For now, until we comb the code and put the LGPL into effect for the source a prevew Binary download is avaliable here: [http://www.scarletdme.org/downloads/JavaQMConnect-Preview.jar JavaQMConnect-Preview.jar]
+
  svn checkout https://scarletdme.org/svn/qmvdb/JavaQMClient/trunk
 +
 
 +
Or as a source tar ball if you don't want to use Subversion [http://www.scarletdme.org/downloads/JavaQMConnect-0.8.tar.gz JavaQMConnect-0.8.tar.gz]
 +
 
 +
Both of the above are structured by Netbeans IDE. It is not necessary to use Netbeans if you don't want to, thought I do recommend it. A simple text editor and the Ant build utility would be enough. Or other IDE's like Eclipse will import this structure fine.
  
 
==Commercial Support==
 
==Commercial Support==
For commercial support or new features Contact Adrian Tesson Associates (http://Tesson.co.uk)
+
For commercial support or new features Contact Adrian Tesson Associates ([http://www.tesson.co.uk/products/java-to-openqm-a-scarletdme http://www.Tesson.co.uk])
 +
 
 +
==Supported Protocol Features==
 +
For a full list of supported features Click [[JavaQM-API_SuportedFeatures | here]]
  
 
==Example==
 
==Example==

Latest revision as of 15:31, 16 October 2009

This Java API library is a native Java library, which allows you to access QM via the QMClient network interface.

All you need is QMClient running on the server, the IP address, a valid username and password and the Account you want to access.

Download

Binary (Jar) download is available here: JavaQMConnect-0.8.jar

To use simply download the Jar file and place it in the ClassPath or same directory as your own Java Program. See the example below for more details.

Source code

LGPL licenced source code for this library are available in the following locations:

The latest Source is available from the subversion repo https://ScarletDME.org/svn/qmvdb/JavaQMClient

 svn checkout https://scarletdme.org/svn/qmvdb/JavaQMClient/trunk

Or as a source tar ball if you don't want to use Subversion JavaQMConnect-0.8.tar.gz

Both of the above are structured by Netbeans IDE. It is not necessary to use Netbeans if you don't want to, thought I do recommend it. A simple text editor and the Ant build utility would be enough. Or other IDE's like Eclipse will import this structure fine.

Commercial Support

For commercial support or new features Contact Adrian Tesson Associates (http://www.Tesson.co.uk)

Supported Protocol Features

For a full list of supported features Click here

Example

Here is an example of how to use the JavaQM API Lib. Simply place the Jar in the library path or same directory as your classes or Jar file.

import com.openqm.qmconnect.*;

/** Example program that accesses QM with the Java API */
public class Example {
    Example() {
        try {
           
            /* Initialise the connection */
           QmConnection connection = QmConnection.create("localhost",4243);        
           
           /* Tell it to log in */
           connection.connect("testuser", "password", "QMSYS");
           
           /* Open Up the VOC file as an example */
           QmFile vocFile = connection.open("VOC");
           
           /* Read from the Opened VOC file */
           String record = connection.read(vocFile, "MESSAGES");

           System.out.println("This is the MESSAGES Record from the VOC file: " + record);
                   
           
        } catch (QMException e) {
            System.err.println("Error occurred connecting to QM");
        }
    }
}