Developing Bindaas with Any IDE with Maven Integration

Leveraging Maven plugins, Bindaas offers easy integration with multiple IDEs such as IntelliJ IDEA, Eclipse, and all the Java IDEs that support Maven projects.

 

Given below is a detailed transcript of what is executed in the above screencast on checking out, building, running, and developing Bindaas with Git, Maven, and IntelliJ IDEA. Please note that at the time of this screencast, the master branch was still tightly coupled with Eclipse IDE, and we had a separate branch maven-restructure to support all the IDEs. However, currently, the changes are already in the master branch.

 

Create Project in Bindaas

 

Get the source code

$ git clone https://{user-name}@bitbucket.org/BMI/bindaas.git

$ cd bindaas

 

 Build the source code

$ mvn clean install

 

The binaries directory consists of the Bindaas binary built from the source as a .tar.gz archive.

$ cd binaries

 

Run Bindaas

Extract the relevant Bindaas binary distribution (either that is downloaded as binary, or that is built from the source following step 1).

Change to the bin directory of the Bindaas distribution,

$ cd bin

$ ./startup.sh

 

This starts Bindaas using nohup. Logs could be found at log/bindaas.log. You may stop the program later by running the shutdown.sh script.

 

If you rather like to have the logs in the foreground in the terminal itself, instead of using the start up script, you may run the java command directly.

 

$  java -Dpid=BINDAAS_INSTANCE -Xmx1024m -jar org.eclipse.osgi_3.8.2.v20130124-134944.jar

 

Now, you may connect to the dashboard at http://localhost:8080/dashboard/ using the user name and password, "admin", "password".

 

Make sure to have the trailing "/" at the end of URL as shown above.

 

Once you have created a project using the "Create Project" command, you may define the data providers for the project at http://localhost:8080/dashboard/workspace/{project\_name}

 

You may choose a database such as a MySQL or MongoDB databases, or use an HTTP provider.

 

Once the data provider is defined, queries could be created from the respective listing page of the data provider, 

http://localhost:8080/dashboard/{project\_name}/{data\_provider\_name}/createQueryEndpoint.action

 

The query could be a simple sql query such as,

select * from states

 

"Try Me" on a simple mysql data provider.

 

 

 

Created queries could be viewed from http://localhost:8080/dashboard/{project\_name}/{data\_provider\_name}/query/{query\_name} 

 

"Try Me" option could be used to view the outputs of the query.

 

Developing Bindaas

Once you have built Bindaas with Maven as explained above, just open the pom.xml of the root directory of bindaas source through the IDE. This will open the entire source hierarchy along with the dependencies properly loaded from the maven repository. The entire project will be ready to develop with just one click!