diff --git a/driver/src/main/javadoc/overview.html b/driver/src/main/javadoc/overview.html index d067847d91..63b7176589 100644 --- a/driver/src/main/javadoc/overview.html +++ b/driver/src/main/javadoc/overview.html @@ -9,7 +9,7 @@

Example

-
import org.neo4j.driver.v1.*;
+
import org.neo4j.driver.*;
 
 import static org.neo4j.driver.Values.parameters;
 
@@ -28,13 +28,11 @@ 

Example

// Sessions are lightweight and disposable connection wrappers. try (Session session = driver.session()) { - // Wrapping Cypher in an unmanaged transaction provides atomicity + // Wrapping a Cypher Query in a Managed Transaction provides atomicity // and makes handling errors much easier. - try (Transaction tx = session.beginTransaction()) - { - tx.run("MERGE (a:Person {name: $x})", parameters("x", name)); - tx.success(); // Mark this write as successful. - } + // Use `session.writeTransaction` for writes and `session.readTransaction` for reading data. + // These methods are also able to handle connection problems and transient errors using an automatic retry mechanism. + session.writeTransaction(tx -> tx.run("MERGE (a:Person {name: $x})", parameters("x", name))); } } @@ -42,7 +40,9 @@

Example

{ try (Session session = driver.session()) { - // Auto-commit transactions are a quick and easy way to wrap a read. + // A Managed Transaction transactions are a quick and easy way to wrap a Cypher Query. + // The `session.run` method will run the specified Query. + // This simpler method does not use any automatic retry mechanism. Result result = session.run( "MATCH (a:Person) WHERE a.name STARTS WITH $x RETURN a.name AS name", parameters("x", initial));