In this post I will be covering all main details regarding the development of my entry for the Neo4j Challenge.

The main objective of this challenge is to create a Heroku-ready template or demo application using Neo4j. So, I thought to myself: – what kind of application would be nice to show up in this contest?

After many ideas, here it is! 

In short, the application is a Stock Exchange symbol lookup using Neo4j and your voice.

Ok! Let me explain what I did.

My mainly objective was try to combine all the joy of Ruby programming, with the power and ease of use provided by the awesome Spring Data Neo4j, Spring Framework and JVM, to this amazing piece of software called Neo4j which let me curious since 2011 in the Jim Webber talk at QCONSP conference of that year.

So, to start things up, JRuby comes in as a perfect fit. It also allowed me to use Sinatra to easily develop the user interface (both, voice interface and GUI). I choose Sinatra in this case because of it’s simplicity and as long the application stay small, it beat Rails (as said by @DHH).

Jetty is another very nice (and old) project, which provides a Web server and javax.servlet container, plus support for Web Sockets, OSGi, JMX, JNDI, JASPI, AJP and many other integrations, and can be used to develop self contained applications. In this article from Heroku blog we have a nice introduction to create a Java Web Application using Jetty. Its integration with Maven was also another motivation point.

Talking about Maven, possibly in POM.xml resides one of the trickiest parts of the application.

After configuring all the dependencies, aspectj-maven-plugin, jetty-maven-plugin, let’s look to configuration of appassembler-maven-plugin and jruby-rake-plugin:

jruby-rake-plugin:

<executions>
    <execution>
        <id>install-bundler</id>
        <phase>process-resources</phase>
        <goals>
            <goal>jruby</goal>
        </goals>
        <configuration>
            <args>-S gem install bundler --no-ri --no-rdoc --install-dir vendor/bundle</args>
        </configuration>
    </execution>
    <execution>
        <id>bundle-install</id>
        <phase>process-resources</phase>
        <goals>
            <goal>jruby</goal>
        </goals>
        <configuration>
            <args>script/bundle install --without development:test</args>
        </configuration>
    </execution>
</executions>

As we can see, the plugin execution is responsible for download and install Bundler, then next execute the specified script witch lives in application script folder. This script basically starts Bundler client (pre-configuring ENV['GEM_HOME'], ENV['GEM_PATH'] and ENV['BUNDLE_GEMFILE']), and following the parameters, all gems except the ones for development and test, are installed.

Last, but not least, the appassembler-maven-plugin:

<configuration>
    <assembleDirectory>target</assembleDirectory>
    <extraJvmArguments>-Djruby.native.enabled=false -Djruby.cext.enabled=false -Djruby.compat.version=1.9 -Xmx256m -Xss2048k</extraJvmArguments>
    <programs>
        <program>
            <mainClass>org.jruby.Main</mainClass>
            <name>jruby</name>
        </program>
    </programs>
</configuration>

Above we have the configuration for the assemble goal execution. The trick here is to generate the executable with JRuby (org.jruby.Main) as main class. And you can also set extra JVM arguments, like the version of Ruby language to use.

After this brief look into POM.xml, let’s see how Heroku starts Jetty. This is defined in the Procfile:

web: sh target/bin/jruby -S config/jetty.rb

So, that’s it! Now our app is running on Heroku Cloud! For more details take a look into /config/jetty.rb to see how Jetty is being started up and /src/main/webapp/WEB-INF/web.xml to see the JRuby-Rack configuration. Other technical details you can find at application readme file.

Now, let’s talk about Neo4j.

Your life is a huge graph.

(…) and I think it can be handled by Neo4j. Back to 2011, Jim Webber let me very

Ok... not quite a graph. But you get the idea!

interested in Neo4j with his talk at QCONSP 2011. Maybe because in that year I was working on my final graduation project – a recommender system to support fundamental analysis of the Stock Market using natural language processing, and I never forgot of one thing that he said. More or less like this: “MapReduce processing between http requests can be very expensive! Some problems cannot be resolved with this approach.”. Well, I did this. And I must confess: a graph database would have changed a lot my project.

So, when I discovered this challenge, I decided “- ok, now is the time to take a closer look on Neo4j.”

First thing I did: accessed Neo4j download page and downloaded the 1.6 Community version.

After that, the server installation. It is super easy. Just follow this instructions.

So, what’s next step? Learn, learn and learn!

I was able to make some initial experiments very fast after a dynamic reading of this *superb* online resource: Good Relationships: The Spring Data Neo4j Guide Book. Thank’s to Michael Hunger, David Montag, Andreas Kollegger by this material.

Also, I learned a lot from the following links:

• https://github.com/SpringSource/spring-data-neo4j
• https://github.com/SpringSource/spring-data-neo4j/tree/master/spring-data-neo4j-examples
• http://static.springsource.org/spring-data/data-neo4j/docs/2.0.0.RELEASE/reference/html/#reference

And that’s it. This is the magic of open-source software. Have a doubt of how one given thing work? Go to source code and read it! All you need to get started with Neo4j is this. Trust me ; )

Giving voice to a graph

I used Arbor.js library to display the Neo4j data to the user. But how differently the information can be visualized? Through voice interfaces of course!

As I already worked with Voice Interfaces some years ago (in 2008 actually, when I won the Sun Students Contest. More info here and here), this was not a mystery. Again I used VoiceXML markup language, and the free service provided by Voxeo. Refer to the links above for more information about VoiceXML.

Sinatra eased this part even more, through it’s easiness of building API’s like applications. All vxml interfaces and grammars are bellow /app/views/voice folder, and there are only two voice routes in application.rb.

To use the Voxeo service, is simple. You only need to create an account, and after that, set up a new application through Voxeo Application Manager, informing the voice entry point of your application (the full URL to your route. In my case to the get ‘/voice/index.vxml’ route).

Note that your application need to be accessible by Voxeo server. So don’t forget to git push heroku master, before setting up your app on Voxeo.

Finishing, you’ll get the numbers to your application. I always tested with Skype VoIP number. Works very well here in Brazil and is totally free.

You can try calling to NeoQuotes! This is the Skype VoIP number: +990009369996189207 (to see all available numbers for NeoQuotes access the application and click on the respective top nav bar link).

Important: When you spell the stock symbol, say one letter, and wait the voice repeat what you just said. And go on. When you finish, you can say “Okay!”, “Go!” or “Search!” for example. If your desired symbol have an ‘.‘ you have to say “dot”. The voice will not repeat this (will stay in silence). Just continue with the letters or numbers.

Summing up

This demo application contains an interesting stack of technologies, providing an environment to develop robust and testable Neo4j applications, with a lot of fun. Certainly much more can be done and improved. And you can help filling issues and submitting pull requests!

Please, help voting in this application at Gensen repository or help with a Tweet!

Thank you Neo4j for running this challenge! It was very fun to participate.

The one absolutely solid place to store your capital today — if you know how to do it –  is in software developers’ wallets.

Source: http://www.forbes.com/sites/venkateshrao/2011/12/05/the-rise-of-developeronomics/
and you might also read: http://blog.8thlight.com/angelique-martin/2012/01/19/8-thing-you-ought-to-know.html

$ git branch -D branchname

But how to delete this branch in your remotes?

From Pro Git by Scott Chacon, we have:

Deleting Remote Branches

Suppose you’re done with a remote branch — say, you and your collaborators are finished with a feature and have merged it into your remote’s master branch (or whatever branch your stable codeline is in). You can delete a remote branch using the rather obtuse syntax git push [remotename] :[branch]. If you want to delete your serverfix branch from the server, you run the following:

$ git push origin :serverfix
To git@github.com:schacon/simplegit.git
 - [deleted]         serverfix

Boom. No more branch on your server. You may want to dog-ear this page, because you’ll need that command, and you’ll likely forget the syntax. A way to remember this command is by recalling the git push [remotename] [localbranch]:[remotebranch] syntax that we went over a bit earlier. If you leave off the [localbranch] portion, then you’re basically saying, “Take nothing on my side and make it be [remotebranch].”

That’s it!

Source: http://progit.org/book/ch3-5.html

At times we are too smart for our own good. We attempt add value to situations by adding unnecessary complexity. This can be a great way to demonstrate our intelligence, but it’s rarely the best solution to the problem.

Complicating a Situation Doesn’t Usually Make it Better

When things seem to be getting too complicated, cut through the fog by bringing things back to the most basic functionality and obvious facts.

~ and this: ~

Today’s Solution vs. the Best Solution (Startup Daily #270)

When solving problems or making changes, people often attempt to create the most sustainable solution possible. But nothing is permanent. Finding and implementing a permanent solution is not always a good use of resources.

Don’t Be Afraid to Use Quick, Temporary Solutions

Both the problem and the solution are likely to evolve over time. Solving the problem quickly is often more important than creating a sustainable solution.

“Do or do not, there is no try.” (Yoda)

Master, in this case, wrong you are!

There is a try, try is the opposite of hiding.

Check this interview with Seth Godin.

source: http://mashable.com/2011/12/07/seth-godin-video/

source: “Triumph of the Nerds: The Rise of Accidental Empires” documentary.

~ Albert Einstein.

So, no more, no less. Turn the page to continue…

(…)

Totally worth see it.

http://continuous-delivery.thoughtworks.com/events/introduction-continuous-delivery

Edit your Gemfile and change the line:

gem 'sqlite3'

To this:

group :production do
  gem 'pg'
end
group :development, :test do
  gem 'sqlite3'
end

And re-install your dependencies on your local development machine by running:

$ bundle install --without production

via http://devcenter.heroku.com/articles/how-do-i-use-sqlite3-for-development