This writing illustrates how to import the open-source esProc into Eclipse using Git for software development.

Getting esProc for Eclipse using Git

Open Eclipse and click File -> Import:

Select Projects from Git(with smart import) under Git and click Next:

Note: If there isn’t the Git folder, you need to install the Git plugin.

Select Clone URI and click Next:

Enter URI: https://github.com/SPLWare/esProc.git

Host and Repository path will be automatically filled in.

User: Your Git account username

Password: Your Git account password

Select branches and click Next:

Set Directory and click Next:

Wait while the object is downloading:

A Maven project is automatically created after the object is successfully downloaded. Its structure is as follows:

Note: the source code of com.scudata.ide module is located in ide directory, and you need to add its corresponding folder under “Source folders”:

The open-source esProc project includes esProc IDE designer, command line functionality, ODBC service and HTTP service.

Start IDE designer

Startup class: com.scudata.ide.spl.SPL

In SPL.java window, click【Run】to start the designer interface:

Use the command line tool

Startup class: com.scudata.ide.spl.Esprocx

Configure【Program arguments】and【VM arguments】under【Debug Configurations】. Find more rules about command lines in Tutorial - Command Line.

Start HTTP/ODBC service

Startup class: com.scudata.ide.spl.ServerConsole

Configure【VM arguments】under【Debug Configurations】:

Click【Debug】to pop up the HTTP/ODBC service interface.

Configure options in【Program arguments】-【Program arguments】to start the non-GUI service:
-o, for starting non-GUI ODBC service;
-h, for starting non-GUI HTTP service;
-a, for starting non-GUI ODBC and HTTP services;
-x, for closing non-GUI ODBC and HTTP services.

Frequently encountered problem:

Fail to connect Git from Eclipse

Execute ping github.com in command window to test whether Git can be reached or not:

• If Git can be reached, verify the content entered for URI, User and Password on Source Git Repository to see if they are correct;

• If Git cannot be reached, add the following two lines at the end of file C:\Windows\System32\drivers\etc\hosts:

  140.82.114.4 github.com 
  
  199.232.69.194 github.global.ssl.fastly.net
  

  After saving and updating the hosts file, execute ipconfig /flushdns in command window to refresh DNS and reconnect Git again.

Note:

1. A too old Eclipse version often fails to connect to Git. In this essay we use Eclipse 4.21 version.

2. JDK 1.8 or above versions are required for running the open-source esProc.