Saturday, February 25, 2012

Domino Java Syncer Documentation version 2.0

Domino Java Syncer - © Andriy Kuba


documentation v2.0

    Ant file



About

Domino Java Syncer is a stand alone Java application. It can export Java libraries from Domino database to Eclipse projects and import Eclipse projects in Domino Java libraries.

 

System Requirements

Lotus Notes client 8.5.*.

 

Installation

Unzip application package. Application ready to run from command line.

 

Uninstallation

Delete application folder.

 

Guide

Domino Java Syncer export java libraries from Domino database to Eclipse projects and back.


Application have command line interface. Ant and Bat files included in to the package. This files could be used as example for your own configuration.



Exporting Java libraries from Domino to Eclipse

Exporting java libraries from Domino database to Eclipse projects.


Command (in one line ofc)
java
        domino-java-syncer.jar;classpath
        aku.domino.transformer.Main
        eclipse
        server:database
        toDirectory
        JvmName
        NotesJarPath
        NotesIdPassword(optional)

Live Example
java
        -cp
                domino-java-syncer.jar;
                "C:\Program Files (x86)\IBM\Lotus\Notes\jvm\lib\ext\Notes.jar";
                "C:\Program Files (x86)\IBM\Lotus\Notes\jvm\lib\ext\websvc.jar";
                "C:\Program Files (x86)\IBM\Lotus\Notes\jvm\lib\tools.jar" 
        aku.domino.transformer.Main
        eclipse
       ":applications\demo\Application1.nsf"
        "C:\Temp"
        "Domino"
        "C:\Program Files (x86)\IBM\Lotus\Notes\jvm\lib\ext"
        "*****"
Log showing export process


Application creates Eclipse project for each library. All that you need to do is to import existent project in to the Eclipse workspace



Importing Java libraries to Domino from Eclipse

Importing java libraries to Domino database from Eclipse projects.


Command (in one line ofc)
java
        domino-java-syncer.jar;classpath
        aku.domino.transformer.Main
        lotus
        server:database
        fromDirectory
        Projects
        NotesIdPassword(optional)

Live Example
java
        -cp
                domino-java-syncer.jar;
                "C:\Program Files (x86)\IBM\Lotus\Notes\jvm\lib\ext\Notes.jar";
                "C:\Program Files (x86)\IBM\Lotus\Notes\jvm\lib\ext\websvc.jar";
                "C:\Program Files (x86)\IBM\Lotus\Notes\jvm\lib\tools.jar" 
        aku.domino.transformer.Main
        lotus
        ":applications\demo\Application1.nsf"
        "C:\Temp"
        "ApplicationBase;Application1Logic"
        "*****"

Configuration

 

Ant file

 


All libraries necessary for DXL are situated in the Notes jvm folder.

 

JVM configuration in Eclipse

 


 

Advanced

Domino Java Libraries and Eclipse Project have different “module dependency” rules



So you could have an errors in Eclipse that show you problems with Java Build Path. You could resolve it by adding required project directly in Eclipse, or in Domino Java Libraries.


You will not have problems in Domino Java Libraries but you will have no problems in Eclipse also. And you will receive correct export process. So this is the recommended way - add required library in Domino Java libraries.

 

Restrictions

  1. Creating library does not supports
  2. Deleting library does not supports
  3. Renaming library does not supports

No comments: