Result Processing

The results from database read and write operations must be properly processed before being utilized in your application.

Return a Response

Methods such as Gql() and Uql() return a Response value. To serve the application, you need to first extract the DataItem from the Response value, and then transform it into an appropriate driver data struct.

A Response value includes the following fields:

Extract DataItem

To extract DataItem from a Response value, use the Get() or Alias() method.

A DataItem value includes the following fields:

Get()

Retrieves data by the alias index.

Parameters

• index: int: Index of the alias.

Returns

• DataItem: The returned data.

response, _ := driver.Gql("MATCH (n)-[e]->() RETURN n, e LIMIT 3", nil)
fmt.Println(response.Get(0))

The GQL query returns two aliases (n, e), and the Get() method gets the DataItem of the alias n at index 0.

&{ RESULT_TYPE_NODE node_table:{schemas:{schema_name:"User" properties:{property_name:"name" property_type:STRING} schema_id:2} entity_rows:{uuid:1080866109592174597 id:"U04" schema_name:"User" values:"mochaeach" schema_id:2} entity_rows:{uuid:1080866109592174597 id:"U04" schema_name:"User" values:"mochaeach" schema_id:2} entity_rows:{uuid:4179342653223075843 id:"U02" schema_name:"User" values:"Brainy" schema_id:2}} alias:"n"}

Alias()

Retrieves data by the alias name.

Parameters

• alias: string: Name of the alias.

Returns

• DataItem: The returned data.

response, _ := driver.Gql("MATCH (n)-[e]->() RETURN n, e LIMIT 3", nil)
fmt.Println(response.Alias("e"))

The GQL query returns two aliases (n, e), and the Alias() method gets DataItem of the alias e.

&{ RESULT_TYPE_EDGE edge_table:{schemas:{schema_name:"Follows" properties:{property_name:"createdOn" property_type:DATETIME} schema_id:2} schemas:{schema_name:"Joins" properties:{property_name:"memberNo" property_type:UINT32} schema_id:3} entity_rows:{uuid:2 schema_name:"Follows" from_uuid:1080866109592174597 to_uuid:4179342653223075843 from_id:"U04" to_id:"U02" values:"\x19\xb2\x94\x00\x00\x00\x00\x00" schema_id:2} entity_rows:{uuid:7 schema_name:"Joins" from_uuid:1080866109592174597 to_uuid:17870286619941011464 from_id:"U04" to_id:"C02" values:"\x00\x00\x00\t" schema_id:3} entity_rows:{uuid:3 schema_name:"Follows" from_uuid:4179342653223075843 to_uuid:12393908373546860548 from_id:"U02" to_id:"U03" values:"\x19\xb2\x82\x00\x00\x00\x00\x00" schema_id:2}} alias:"e"}

Transform DataItem

You should use a As<DataStructure>() method to convert the DataItem.Data into the corresponding driver data struct.

For example, the GQL query contained in the request below retrieves 3 nodes from the graph, the AsNodes() method is used to convert the DataItem associated with the alias n into a slice of pointers to Node structs:

response, _ := driver.Gql("MATCH (n) RETURN n LIMIT 3", nil)
nodeList, _, _ := response.Alias("n").AsNodes()
for _, node := range nodeList {
    println(node.GetID())
}

The following lists all the transformation methods available on DataItem. Please note the applicable DataItem.Type and DataItem.Alias of each method.

Return a ResponseWithExistCheck

Methods such as CreateGraphIfNotExist() return a ResponseWithExistCheck value.

A ResponseWithExistCheck value includes the following fields:

Return an InsertResponse

Some data insertion methods such as InsertNodesBatchBySchema() and InsertNodesBatchAuto() return an InsertResponse value.

An InsertResponse object includes the following fields:

Return a JobResponse

Methods such as CreateFullText() return a JobResponse object.

A JobResponse object includes the following fields:

Return Driver Data Structs

Some methods return either a single pointer or a slice of pointers to driver data structs, which can be used directly. For example:

• The GetGraph() method returns a pointers to a GraphSet struct.
• The ShowGraph() method returns a slice of pointers to GraphSet structs.