Welcome to Instant JChem plugin development!
Instant JChem (IJC) is an out-of-the-box tool that allows scientists to create, manage and analyse chemical structures and their data. It serves as a desktop application that provides a convenient and straight-forward approach to the analysis of chemical and biological data. IJC is a database-centric environment that supports query and sorting functionality, and handles large volumes of data (hundreds of thousands of structures).
IJC is extendable. As a customer or 3rd party developer, you can extend IJC and build higher level features on top of the core functionality. IJC provides much of the basic framework needed, as well as the hooks for extending it with new data types. No longer will the chemical spreadsheet need to be re-invented yet again. Instead, you are able to use the form builder, possibly with your own custom view widgets, without needing to worry about infrastructural details such as persistence, security, and import/export. Instead, you can extend IJC by adding any data types that might be specific to your needs and then build an application on top of these basic data types and tools.
This tutorial will guide you through the process of installing and setting up tools required for Instant JChem plugin development. It will also help you with building and running Instant JChem example plugins that you will download from Chemaxon's web site.
Instant JChem application itself is built on top of NetBeans Platform, which means that the application consists of many small modules (plugins) that each implement part of the application's functionality. All these plugins are bundled together alongside with NetBeans platform binaries in one application called Instant JChem.
Developing an Instant JChem plugin is simply a process of creating a new module and adding it to the existing Instant JChem application. In principle it is the same process as what IJC developers do to create Instant JChem application.
Since we are going to extend Instant JChem application in this tutorial by several example plugins that have been prepared in advance it comes with no surprise that we need to have Instant JChem application installed. If you have not done so, please install it now.
Instant JChem application can be downloaded from Chemaxon website's download area. Please download an installer appropriate for your operating system and follow its instructions.
For developing IJC plugins you can use any Integrated Development Environment (IDE) that supports java development and Ant, however, since IJC plugins are essentially NetBeans modules the NetBeans IDE is best suited for the task. It's also what all IJC developers use for developing Instant JChem. We recommend to use NetBeans IDE unless you are a seasoned java practitioner skilled in using Ant.
NetBeans IDE can be downloaded from here. The version we used in this tutorial was NetBeans IDE 9.0. Please follow the NetBeans documentation to install the NetBeans IDE.
Having both Instant JChem and NetBeans IDE installed the next thing we will need is the example plugins. Their sources in appropriate version is freely available for downloading from IJC download page.
ijc-api-examples.zip contains both sources in
sources folder and already built plugins as
.nbm files in
Please donwload the ZIP file and extract its contents somewhere on your local harddisk. After unzipping the file you will have
ijc-api-examples folder with subfolders
sources containing built plugins and their sources.
The IJC plugin examples are organized in several plugins (or modules in NetBeans IDE terminology) that are all part of one module suite called
api-examples-suite. We are now going to open this suite in NetBeans IDE.
If you haven't done so, please start NetBeans IDE that you installed. When it starts go to its main menu
File -> Open Project... and in the 'Open Project' dialog select the
api-examples-suite folder under the
sources that you've unzipped in the previous step and press
Open Project button.
Open Project dialog - select
api-examples-suite project and open it. When the
api-examples-suite opens your IDE will look like the one on the following screenshot.
NetBeans IDE 9.0 with
Since all IJC plugins that we develop will run as part of Instant JChem application, which we installed at the beginning of this tutorial. We will have to tell NetBeans IDE where our Instant JChem application is installed so that it could correctly compile and deploy our plugin projects.
In order to do that we will set up the Instant JChem application as a ' NetBeans Platform '. In general, any java application built on top of the original NetBeans Platform can be used as a basis for further development and as such can itself serve as another NetBeans Platform. Therefore the Instant JChem application that we installed at the beginning can be used as a new NetBeans Platform and can be extended by additional plugins.
Adding a new NetBeans Platform in the IDE is simple. Just go to the IDE's main menu
Tools -> NetBeans Platforms and in the 'NetBeans Platform Manager' click the
Add Platform... button. This will open a wizard that will guide you through the whole process.
In the first step select the folder where you installed your Instant JChem application. When selected you will be able to click
Next button and proceed to the next step, where you can specify your new platform's name. Please call your platform
IJC Platform in order to match the platform name used in the
api-examples-suite project. Click
Finish button to close the wizard and create the new NetBeans Platform. Close the NetBeans Platform Manager.
First step - select the folder where you installed Instant JChem application
Second step - choose
IJC Platform as a name for your NetBeans Platform
Now you should be able to build
api-examples-suite in NetBeans IDE:
Right click on the suite - choose
Clean and Build. Check
Output window for green
BUILD SUCCESSFUL message in the end:
Now you can open particular modules in the suite, experiment with its source code. You can also try to install pre-built '.nbm' plugins from the
plugins folder. See NetBeans plugin development page for more.
Finally, we are ready to run the IJC plugin examples. You can do so in 'Projects' explorer in NetBeans IDE by right clicking the
api-examples-suite project node and choosing
Run. Instant JChem application will start with the IJC example plugins available under the
Help -> IJC API Examples menu:
Congratulations! You have done first steps towards becoming IJC plugin developer. In this tutorial you have learned:
What development tools you need for developing Instant JChem plugins
How to install NetBeans IDE 9.0
How add existing Instant JChem application as a NetBeans Platform in the NetBeans IDE
How to open and explore IJC example plugins suite
There are many more tutorials available for IJC plugin developers. Your next step should be tutorials focused on exploring the source code and functionality provided by IJC example plugins that you have successfully compiled and installed to your Instant JChem application today. See the list of available tutorials.