UDJrb is a set of classes and extensions to make it easier to work with the UniData Java API. UDJrb includes a copy of asjava.jar
, and loads it automatically when you require the library. So, all you need to get start is to install UDJrb via gem install udjrb
and require it with require 'udjrb'
.
UDJrb::Session
To connect to a UniData database, use the UDJrb::Session
object.
session = UDJrb::Session.new "username", "password", "host", "account"
This will automatically connect you to the database. Once you're connected, there are a few methods available to you:
session.unijava
- returns the underlyingasjava.uniobjects.UniJava
object.session.session
- returns the underlyingUniSession
object.session.disconnect
- disconnect cleanly from the database (usesUniJava#closeSession()
).
Any other method you call will be passed through to the underlying UniSession
object, which means you can open files, etc. just by calling the method you would normally call on a UniSession
instance:
person = session.open "PERSON"
person.set_record_id "0123456"
puts "First Name: #{person.read_named_field 'FIRST.NAME'}"
puts "Last Name: #{person.read_named_field 'LAST.NAME'}"
UniFile Extensions
The following extensions have been added to UniFile
:
file.data(field)
- convienence method forfile.read_named_field(field)
.
UniDynArray Extensions
The following extensions have been added to UniDynArray
:
each
- returns each value from the first field in the array (to_s
is called on each element).include Enumerable
- gives access to the Enumerable methods by way ofeach
.