Easysoft Blog

Wed, 27 March 2018

Connecting to Lotus Notes from Java

Before you can connect your Java application to Lotus Notes by using the JDBC-ODBC Bridge, you need to configure a NotesSQL ODBC driver data source. An ODBC data source stores the connection details for the target database (e.g. Notes) and the ODBC driver that is required to connect to it (e.g. the NotesSQL ODBC driver).

Note We recommend that you install version 8.0 of the NotesSQL ODBC driver, which is fully ODBC compliant (albeit to an earlier ODBC specification than later versions of the driver, which are partially ODBC 3.5 compliant).

  1. Start ODBC Administrator. To do this, in the Windows Run dialog box, type:
  2. In the ODBC Administrator, choose the System DSN tab, and then choose Add.
  3. In the Create New Data Source dialog box, choose NotesSQL ODBC Driver, and then choose Finish.
  4. Complete the NotesSQL ODBC Driver configuration dialog box.
  5. Download the Easysoft JDBC-ODBC Bridge. (Registration required.)
  6. Install and license the Easysoft JDBC-ODBC Bridge on the machine where you created the data source.

    For installation instructions, see the Easysoft JDBC-ODBC Bridge documentation.

Connecting to Lotus Notes from Java

  1. In the JDBC-ODBC Bridge Web Administrator, in the Configuration page, enable the MultiProcess option.
  2. Copy EJOB.jar to a machine where you have a Java Development Kit installed.

    If the Easysoft JDBC-ODBC Bridge is already installed on this machine, skip this step.

    EJOB.jar is installed in the following location on the machine where you install the Easysoft JDBC-ODBC Bridge:


    The default location for <easysoft_install> is <drive>:\Program Files (x86)\Easysoft Limited\Easysoft JDBC-ODBC Bridge.

  3. Add this Java code to a file named ConnectToNotes.java:
    import easysoft.sql.*;
    import java.sql.*;
    import java.util.Calendar;
    import java.util.Date;
    public class ConnectToNotes {
      public static void main(String[] args) throws Exception {
            String[] szTableTypes;
            szTableTypes = new String[100];
            String[] szTableNames;
            szTableNames = new String[1000];
            int[]  szTypeCount;
            szTypeCount = new int[100];
            int intTableTypes;
        try {
          easysoft.sql.jobDriver driver = (easysoft.sql.jobDriver)Class.forName("easysoft.sql.jobDriver").newInstance();
          String jobUrl= "jdbc:easysoft://localhost/My32bitNotesSQLSystemDSN:logonuser=mywindowsuser:logonpassword=mywindowspassword";
          Connection con = DriverManager.getConnection(jobUrl, "mynotesuser", "mynotespassword");
          System.out.println(" ");
          System.out.println("------------------ Method Summary ------------------");
          try {
              int i;
              boolean bl;
              String st;
              DatabaseMetaData dbMD = null;
              dbMD = con.getMetaData();
              try {
                  ResultSet rt = dbMD.getTableTypes();
                  while (rt.next()) {
                  for (i=0; i<intTableTypes; i++)
                      st=st + szTableTypes[i] + "; ";
                  System.out.println("Table types (" + intTableTypes + ") : "+ st );
                  // Go get the tables e.t.c.
                  try {
                      int x;
                      ResultSet rs = dbMD.getTables( null, null, "%", null );
                      while (rs.next()) {
                          for (x=0; x<intTableTypes; x++)
                              System.out.println("TABLE_CAT : " + rs.getString(1));
                              System.out.println("TABLE_SCHEM : " + rs.getString(2));
                              System.out.println("TABLE_NAME : " + rs.getString(3));
                              System.out.println("TABLE_TYPE : " + rs.getString(4));
                              System.out.println("REMARKS  : " + rs.getString(5));
                  } catch (Exception e) {
                      System.out.println("getTables error : " + e );
              } catch (Exception e) {
                  System.out.println("getTableTypes error : " + e );
          }  catch(Exception e) {
              System.out.println("db Meta Data exception: " + e);
        } catch(Exception e){
                System.out.println("Java code error : " + e);
  4. In a command window, add EJOB.jar to the Java class path. For example:
    set CLASSPATH="%CLASSPATH%;C:\Program Files (x86)\Easysoft Limited\Easysoft JDBC-ODBC Bridge\Jars\EJOB.jar"
  5. cd to the directory where ConnectToNotes.java is located, and compile and run the Java file. For example:
    "C:\Program Files\Java\jdk1.8.0_144\bin\javac.exe" ConnectToNotes.java
    java ConnectToNotes