mariosotil / river-framework Goto Github PK

It is an Object-Document Mapper Framework for NoSQL databases at development stage. Here you will find about the development itself: current and next features, known issues, dependencies, binaries, Maven artifacts, demos, and, of course, the source code :-) You will find a presentation about the project at its website

This library is being redesigned in the version 0.3. The original plan of support Couchbase, MongoDB, CouchDB, and Neo4J is still standing; but support to IBM Notes will be stopped, at least at the beginning. I was so in love with IBM Notes, that the design was completely focused on it, resolving Notes' particular situations. I lose sight of the other NoSQL databases.

To date (2018-04-15), the version 0.3 is still a Work In Progress. You can follow it in the branch version-0.3.x.

The current version 0.2.11's source code is still in this Github repo, and its binaries are in Maven Central Repository and OpenNTF. They could still be used to access IBM Notes.

Query a IBM Notes database with River Framework looks like this.

//Opening a session
Session session = River.getSession(River.LOTUS_DOMINO, "server", "username", "password");
Database database = session.getDatabase(AddressBook.class, "server", "example.nsf");

// Creating a new person document
database.createDocument(Person.class)
  .setField("Name", "John Doe")
  .setField("Age", 35)
  .generateId()
  .save();

// Searching people with name "John Doe"              
DocumentIterator it = database.search("Name=\"John Doe\"");

// Iterating
for(Document doc: it)   {
  System.out.println("Found " + doc.getId());
  System.out.println("Name: " + doc.getFieldAsString("Name"));
  System.out.println("Age: " + doc.getFieldAsInteger("Age"));
}

session.close();

• Compiled for Java 1.6+
• Support IBM Notes
• Java Logging API
• Controls six basic elements:
  • Session
  • Database
  • Document
  • Views or collections
  • Document iterator
  • Document indexes and unique IDs
• Has two layers of control:
  • The wrapper layer, that connects directly to the database using its native classes.
  • The core layer, that provides a unique interface to be able to use any wrapper library written for this framework.

• It's stable
• Supports only five basic elements to work with a Notes database (session, database, document, view, iterator)
• Anyway, you can still use the native Java library to do things like modify the ACL or work with RichText items.
• Supports local and remote sessions (DIIOP)
• Auto recycling of Notes objects
• Supports field size > 32K
• Has an object cache
• To reduce impact on replication, if you set a field with a new value, it checks if it is different before change it.
• Good to develop standalone Java programs, Servlets or XPages programs

• It's stable
• Takes advantage of this great library developed by OpenNTF
• The auto recycling is managed by OpenNTF Domino API
• Supports field size > 32K
• Good to develop standalone Java programs, Servlets or XPages programs

Please, follow the instructions from this link.

Demos as Maven projects for Eclipse, of stand-alone Java programs are in this GitHub repo.

You can download the binaries as Jar libraries from the OpenNTF website.

To load the artifacts from Maven, you can add one of these dependencies to your pom.xml file:

• To use the original lotus.domino package from IBM Notes

    <dependency>
        <groupId>org.riverframework</groupId>
        <artifactId>river-lotus-domino</artifactId>
        <version>0.2.11</version>
    </dependency>

• To use the org.openntf.domino package from OpenNTF

    <dependency>
        <groupId>org.riverframework</groupId>
        <artifactId>river-org-openntf-domino</artifactId>
        <version>0.2.11</version>
    </dependency>

In both cases, you have to add to your classpath the Notes.jar library. For the last one, you will need to add the org.openntf.domino.jar library too.

If you need to report an issue, please use the GitHub issues page.

mario.sotil [at] gmail.com

Java, ODM, NoSQL, Couchbase, MongoDB, IBM Notes, Neo4J, Lotus Notes, SSJS, ORM, Framework