Vikadata™ Java SDK (vika.java)<br />Java Client Library for the Vika OpenAPI

Vika Java SDK

Vikadata™ Java API (vika.java) provides a full featured and easy to consume Java library for working with vikadata via the Vikadata OpenAPI.<br/>

Usage

Java Version Requirement

Java 8+ is required to use sdk. not support Java 8 below

Getting Started

Installation

Maven


<dependency>
    <groupId>cn.vika</groupId>
    <artifactId>vika-client</artifactId>
    <version>1.0.4</version>
</dependency>

Gradle

dependencies {
  ... ...
  implementation('cn.vika:vika-client:1.0.4')
}

Usage Example

vika java sdk is quite simple to use, you don't need to set api url, all you need is the Personal Api Key from your vika account settings page. Once you have that info it is as simple as:

First, you need to set api credential which belong your personal api key.

ApiCredential credential = new ApiCredential("Your API Key");

Then, Init client instance

VikaApiClient vikaApiClient = new VikaApiClient(credential);

By default, the API client has been added for setting connect and read timeouts, you can also change:

// Set the connect timeout to 8 second and the read timeout to 9 seconds
VikaApiClient vikaApiClient = new VikaApiClient(credential)
        .withRequestTimeout(80000)
        .withReadTimeout(90000);

As private deployment user, you can also change host url

VikaApiClient vikaApiClient = new VikaApiClient("http://ip:port", credential);

Query Record

Most simple usage for query record quickly

// Get 10 records on first page
List<Record> records = vikaApiClient.getRecordApi().getRecords("datasheetId", 1, 10);

Pager Resulting

API client provides an easy way to use paging mechanism to page through lists of results from the Open API. Below code are a couple of examples on how to use the Pager:

// Get a Pager instance that will page through the records with 100 record per page
Pager<Record> pager = vikaApiClient.getRecordApi().getRecords("datasheet_id", 100);

// Iterate through the pages and print out the per record detail
while (pager.hasNext()) {
    for (Record record : pager.next()) {
        System.out.println(record.getRecordId() + " -: " + record.getFields());
    }
}

you can also fetch all the items as a single list using a Pager instance:

// Get a Pager instance so we can load all the records into a single list, 100 record at a time:
Pager<Record> pager = vikaApiClient.getRecordApi().getRecords("datasheet_id", 100);
List<Record> records = pager.all();

Java 8 Stream Support

also provide method that returns a Java 8 Stream.

// Pager as stream,support forEach、Group、Filter operation
Stream<Record> records = vikaApiClient.getRecordApi().getRecordsAsStream("datasheet_id");

// ex: extract record id to a list
records.map(Record::getRecordId).collect(Collectors.toList());

Advance Query

// build query condition
ApiQueryParam queryParam = new ApiQueryParam(1, 50)
            .withView("viewId")
            .withFields(Arrays.asList("fieldName"))
            .withRecordIds(Arrays.asList("recordId"))
            .withSort("fieldName", Order.DESC).withSort("fieldName", Order.ASC)
            .withFilter("{fieldName}>1");
// query return pager result
Pager<Record> pager = vikaApiClient.getRecordApi().getRecords("datasheet_id", queryParam);

Add Record

Class RecordMap is a key-value structure like Map<String, Object>, all thing you do is converting json to map, you can use convert util from sdk provide which is named JacksonConverter, you also can use jackson api build json structure data, more detail please reference unit test.

you can add record through two difference way, id or name, default is name fieldKey.

using default fieldKey name example:

// Build Record Map by jackson api
ObjectNode fieldMap = JsonNodeFactory.instance.objectNode()
        // simple data
        .put("fieldName", "string")
        .put("number", 1234);
        // sub tree node
        .set("city", JsonNodeFactory.instance.arrayNode().add("NewYork").add("Bejing"));
// put record map into fields key
ObjectNode fields = JsonNodeFactory.instance.objectNode().set("fields", fieldMap);
// only one record, warp record into array node
ArrayNode arrayNode = JsonNodeFactory.instance.arrayNode().add(fields);
// convert json to Map List
List<RecordMap> recordMaps = JacksonConverter.unmarshalToList(RecordMap.class, arrayNode);
// create record request
CreateRecordRequest recordRequest = new CreateRecordRequest()
    .withRecords(recordMaps);
// ok
List<Record> newRecords = vikaApiClient.getRecordApi().addRecords("datasheet_id", recordRequest);

using fieldKey id example:

// Build Record Map by jackson api
ObjectNode fieldMap = JsonNodeFactory.instance.objectNode()
        // simple data
        .put("fld_id", "string")
        .put("fld_id", 1234);
        // sub tree node
        .set("fld_id", JsonNodeFactory.instance.arrayNode().add("NewYork").add("Bejing"));
// put record map into fields key
ObjectNode fields = JsonNodeFactory.instance.objectNode().set("fields", fieldMap);
// only one record, warp record into array node
ArrayNode arrayNode = JsonNodeFactory.instance.arrayNode().add(fields);
// convert json to Map List
List<RecordMap> recordMaps = JacksonConverter.unmarshalToList(RecordMap.class, arrayNode);
// create record request
CreateRecordRequest recordRequest = new CreateRecordRequest()
    .withRecords(recordMaps)
    .withFieldKey(FieldKey.ID);
// ok
List<Record> newRecords = vikaApiClient.getRecordApi().addRecords("datasheet_id", recordRequest);

Update Record

update record also provide two difference way to modifying data, using fieldKey id or name, default is name fieldKey.