Downloads

From DTRulesWiki
Jump to: navigation, search

Contents

DTRules Releases

We are using Github.com to track our releases.

We have restructured the repository for DTRules. Now all the components for DTRules are kept in one repository, so downloading and setup is easier. In addition, we are putting our releases into maven. This has been a bit more difficult than expected, but we will keep you posted.

Maven

You need to install Java if you have not already.

You may also wish to install Eclipse (though if you are the type of Java programmer that doesn't use an IDE, you do not have to use Eclipse).

It is a good idea to install Git. This serves a couple of purposes. First of all, it gets you access to Git. Secondly, under Windows, installing Git in this fashion will also get you a Bash shell. You need this to build DTRules using maven.

Then you need to install maven. Once you have unzipped maven, follow the instructions in the README file. You have to set the path up properly, and set an environment variable JAVA_HOME to point to your JDK. Exactly what you need to do for maven is in the README file, so read it!


  • You can use Git to pull the DTRules/DTRules repository down using this command: 
 Git clone git://github.com/DTRules/DTRules.git
  • Or you can browse to the DTRules Repository and download a zip or tar of the source (your choice). You have the option of picking the branch or tag of the source you care to download. (See the Repository Overview below). Extract the source where you wish on your drive. You will get a DTRules folder with all the Rules Engine source and sampleprojects source.

Once you have the source in place, open up a Bash Shell (Git provides this for you, Windows Users!) and cd to the DTRules directory. Type: 

 mvn clean install

This should build cleanly. Then if you are going to use Eclipse, type: 

 mvn eclipse:eclipse

then fire up eclipse, and click: 

 File->import->General->Existing Projects into Workspace

You may need to define M2_REPO in eclipse. Pick one of the projects,

  • Right click on a project
  • properties -> Java Build Path -> Libraries -> Add Variable -> Configure Variables -> New
    • Name M2_REPO
    • Path -> click folder.
      • navigate to your .m2/repostory/
      • click ok
    • click ok

Binaries

DTRules 4.3 is available in the maven repo1 repositories. You can download binaries directly from the maven repository by selecting the dtrules jar and the compileutil jar.

Repository Overview

  1. Go to the DTRules.
  2. Click "Switch Tags" to view or select one of the current releases. At this time, the following releases are available:
    1. 2.0 -- The 2008 release, the first production release of DTRules
    2. 3.0 -- The 2010 release
    3. 4.1 -- The March 2011 release
    4. 4.2 -- Should be available soon, and is identical to 4.1 but with maven support
  3. Click "Switch branches" to view available development builds. The available development builds include
    1. 5.0-SNAPSHOT adds a number of features and is required for the CHIP and ChipApp examples. Also includes maven support

To Download

This section assumes that you just want to download the source for DTRules. Obviously you can use Git to clone the repository and go to town with whatever branch or tag you wish. However, many people just want to look at the examples and poke around with DTRules without messing with git. Luckily Github supports this sort of thing.

  1. Go to the DTRules.
  2. On the right hand side, select "Download Source".
  3. From here you can choose one of the releases to download, and you are done.
  4. Or you can select "view [n] other downloads" and pick a branch (such as 5.0-SNAPSHOT).
  5. You can select whether you want a Zip or Tar.
  6. Unzip or untar this file in your Eclipse workspace. This will include DTRules, the Compilers, and Sample projects.
  7. Have fun. In versions after 4.3 you may have to do your own configuring in Eclipse to get the projects up to snuff. Or use maven, as described above.

Useful Tools

The Decision Tables are maintained in spreadsheets, so any one of a number of spreadsheet programs will be necessary. (Excel, Google Docs, Open Office, etc. all work fine).

You may also want to use an XML editor. Under windows, I am fond of XML Marker as it makes nice tables of the XML without any effort on my part.

You will need Java. And for most of our examples, we assume you are working from Eclipse. In fact, Eclipse isn't really necessary, as we have not released any Eclipse plug-ins as of yet.


Download the Reservations example

  1. Go to the Paul Snow's Repositories and select the PaulSnow/Reservations repository.
  2. You can find the "Download Source" icon in the top right of the page.
  3. Select either Zip or Tar (your choice).
  4. Unzip or untar this file into your Eclipse workspace

Dependency Details

The Rules Engine runtime has no dependencies. This means you can deploy Decision Table based rules in your application using only the DTRules.jar. Nothing else is needed unless you intend to support modifying and compiling your Rules as part of your application.

For development, DTRules uses the following libraries:

Of course, Maven handles the dependencies for you, but if you are setting up your application by hand, your list of dependencies is pretty small.

Retrieved from "http://dtrules.com/wiki2/index.php?title=Downloads"
Personal tools