wit-java

A Java Library For Wit.ai

License	The Apache Software License, Version 2.0
Categories	Java Languages CLI User Interface
GroupId	com.clivern
ArtifactId	wit-java
Last Version	1.0.0
Release Date	Feb 27, 2018
Type	jar
Description	wit-java A Java Library For Wit.ai
Project URL	https://github.com/clivern/wit-java
Source Code Management	https://github.com/clivern/wit-java

Download wit-java

Filename	Size
wit-java-1.0.0.pom
wit-java-1.0.0.jar	21 KB
wit-java-1.0.0-sources.jar	18 KB
wit-java-1.0.0-javadoc.jar	80 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.clivern/wit-java/ -->
<dependency>
    <groupId>com.clivern</groupId>
    <artifactId>wit-java</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.clivern/wit-java/
implementation 'com.clivern:wit-java:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.clivern/wit-java/
implementation ("com.clivern:wit-java:1.0.0")

Apache Buildr

'com.clivern:wit-java:jar:1.0.0'

Apache Ivy

<dependency org="com.clivern" name="wit-java" rev="1.0.0">
  <artifact name="wit-java" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.clivern', module='wit-java', version='1.0.0')
)

Scala SBT

libraryDependencies += "com.clivern" % "wit-java" % "1.0.0"

Leiningen

[com.clivern/wit-java "1.0.0"]

Dependencies

compile (2)

Group / Artifact	Type	Version
org.tinylog : tinylog	jar	1.3.2
com.squareup.okhttp3 : okhttp	jar	3.9.1

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

Wit-Java

Wit-Java Is A Java Library For Wit.ai

Current Version: 1.0.0

Installation

To add a dependency using Maven, use the following:

<dependency>
  <groupId>com.clivern</groupId>
  <artifactId>wit-java</artifactId>
  <version>1.0.0</version>
</dependency>

To add a dependency using Gradle, use the following:

dependencies {
  compile 'com.clivern:wit-java:1.0.0'
}

To add a dependency using Scala SBT, use the following:

libraryDependencies += "com.clivern" % "wit-java" % "1.0.0"

Usage

After adding the package as a dependency, Please read the following steps:

Basic Configurations

In order to cofigure the package create config.properties file with the following data

wit_api_id=app id here
wit_access_token=access token here

logging_level=tarce or debug or info or warning or error
logging_file_path=src/main/java/resources/
logging_file_format=current_date or app
logging_log_type=file or console or both
logging_current_date_format=yyyy-MM-dd
logging_append=true or false
logging_buffered=true or false

Please Note That You can put configs manually using set method of config class like the following:

Config config = new Config();
config.set("wit_api_id", "app id here");
config.set("wit_access_token", "access token here");
config.put("logging_level", "tarce or debug or info or warning or error");
config.put("logging_file_path", "src/main/java/resources/");
config.put("logging_file_format", "current_date or app");
config.put("logging_log_type", "file or console or both");
config.put("logging_current_date_format", "yyyy-MM-dd");
config.put("logging_append", "true or false");
config.put("logging_buffered", "true or false");
config.configLogger();

Both wit_api_id and wit_access_token can be changed with each request with setAppId and setAccessToken methods. I will let you know within the docs whenever you can override them.

Get all Apps

To get an array of all apps that you own.

import com.clivern.wit.api.App;
import com.clivern.wit.api.endpoint.AppEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

App getApp = new App(AppEndpoint.GET);
// To Use another App Id different from the one on your properties file
// getApp.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// getApp.setAccessToken("Your Custom Access Token Here");
String result = "";
String error = "";

if( wit.send(getApp) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.App;
import com.clivern.wit.api.endpoint.AppEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            App getApp = new App(AppEndpoint.GET);
            // To Use another App Id different from the one on your properties file
            // getApp.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // getApp.setAccessToken("Your Custom Access Token Here");

            if( wit.send(getApp) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Update an existing app

To Update an app with the given attributes.

import com.clivern.wit.api.App;
import com.clivern.wit.api.endpoint.AppEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

App updateApp = new App(AppEndpoint.UPDATE);
updateApp.setName("Clark");
updateApp.setLang("English");
updateApp.setPrivate("false");
updateApp.setDesc("Hello World");
updateApp.setTimezone("America/Los_Angeles");
// To Use another App Id different from the one on your properties file
// updateApp.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// updateApp.setAccessToken("Your Custom Access Token Here");

String result = "";
String error = "";

if( wit.send(updateApp) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.App;
import com.clivern.wit.api.endpoint.AppEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            App updateApp = new App(AppEndpoint.UPDATE);
            updateApp.setName("Clark");
            updateApp.setLang("English");
            updateApp.setPrivate("false");
            updateApp.setDesc("Hello World");
            updateApp.setTimezone("America/Los_Angeles");
            // To Use another App Id different from the one on your properties file
            // updateApp.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // updateApp.setAccessToken("Your Custom Access Token Here");

            if( wit.send(updateApp) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Delete an App

To Permanently delete the app.

import com.clivern.wit.api.App;
import com.clivern.wit.api.endpoint.AppEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

App deleteApp = new App(AppEndpoint.DELETE);
// To Use another App Id different from the one on your properties file
// deleteApp.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// deleteApp.setAccessToken("Your Custom Access Token Here");
String result = "";
String error = "";

if( wit.send(deleteApp) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.App;
import com.clivern.wit.api.endpoint.AppEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            App deleteApp = new App(AppEndpoint.DELETE);
            // To Use another App Id different from the one on your properties file
            // deleteApp.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // deleteApp.setAccessToken("Your Custom Access Token Here");
            if( wit.send(deleteApp) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Create a New App

To Create a new app for an existing user.

import com.clivern.wit.api.App;
import com.clivern.wit.api.endpoint.AppEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

App createApp = new App(AppEndpoint.CREATE);
createApp.setName("Clark");
createApp.setLang("English");
createApp.setPrivate("false");
createApp.setDesc("Hello World");
// To Use another App Id different from the one on your properties file
// createApp.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// createApp.setAccessToken("Your Custom Access Token Here");

String result = "";
String error = "";

if( wit.send(createApp) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.App;
import com.clivern.wit.api.endpoint.AppEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            App createApp = new App(AppEndpoint.CREATE);
            createApp.setName("Clark");
            createApp.setLang("English");
            createApp.setPrivate("false");
            createApp.setDesc("Hello World");
            // To Use another App Id different from the one on your properties file
            // createApp.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // createApp.setAccessToken("Your Custom Access Token Here");

            if( wit.send(createApp) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Get The Meaning of a Sentence

To extract the meaning from a sentence, based on the app data:

import com.clivern.wit.api.Message;
import com.clivern.wit.api.endpoint.MessageEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

Message message = new Message(MessageEndpoint.GET);
message.setQ("Good Morning");
//message.setContext("");
//message.setMsgId("789");
//message.setThreadId("fb_th");
//message.setN(6);
//message.setVerbose(true);

// To Use another App Id different from the one on your properties file
// message.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// message.setAccessToken("Your Custom Access Token Here");

String result = "";
String error = "";

if( wit.send(message) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.Message;
import com.clivern.wit.api.endpoint.MessageEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            Message message = new Message(MessageEndpoint.GET);
            message.setQ("Good Morning");
            //message.setContext("");
            //message.setMsgId("789");
            //message.setThreadId("fb_th");
            //message.setN(6);
            //message.setVerbose(true);

            // To Use another App Id different from the one on your properties file
            // message.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // message.setAccessToken("Your Custom Access Token Here");

            if( wit.send(message) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Get Entities

To get a list of available entities for the app.

import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

Entity entity = new Entity(EntityEndpoint.GET_ENTITIES);

// To Use another App Id different from the one on your properties file
// entity.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// entity.setAccessToken("Your Custom Access Token Here");

String result = "";
String error = "";

if( wit.send(entity) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            Entity entity = new Entity(EntityEndpoint.GET_ENTITIES);

            // To Use another App Id different from the one on your properties file
            // entity.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // entity.setAccessToken("Your Custom Access Token Here");

            if( wit.send(entity) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }

        }
    }
}

Create Entity

To Create a new entity with the given attributes.

import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

Entity entity = new Entity(EntityEndpoint.CREATE_ENTITY);
entity.setId("favorite_city"); // required
entity.setDoc("A city that I like"); //optional

// To Use another App Id different from the one on your properties file
// entity.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// entity.setAccessToken("Your Custom Access Token Here");

String result = "";
String error = "";

if( wit.send(entity) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            Entity entity = new Entity(EntityEndpoint.CREATE_ENTITY);
            entity.setId("favorite_city"); // required
            entity.setDoc("A city that I like"); //optional

            // To Use another App Id different from the one on your properties file
            // entity.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // entity.setAccessToken("Your Custom Access Token Here");

            if( wit.send(entity) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Get Entity

To get entity data and values.

import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

Entity entity = new Entity(EntityEndpoint.GET_ENTITY);
entity.setEntityId("favorite_city");

// To Use another App Id different from the one on your properties file
// entity.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// entity.setAccessToken("Your Custom Access Token Here");

String result = "";
String error = "";

if( wit.send(entity) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            Entity entity = new Entity(EntityEndpoint.GET_ENTITY);
            entity.setEntityId("favorite_city");

            // To Use another App Id different from the one on your properties file
            // entity.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // entity.setAccessToken("Your Custom Access Token Here");

            if( wit.send(entity) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Update Entity

To Update an entity with the given attributes.

import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

Entity entity = new Entity(EntityEndpoint.UPDATE_ENTITY);
entity.setEntityId("favorite_land");
entity.setId("favorite_city");
entity.setDoc("These are lands worth going to");
entity.setValues(new String[]{
    "{\"value\": \"Paris\",\"expressions\": [\"Paris\", \"City of Light\", \"Capital of FR\"]}",
    "{\"value\": \"London\",\"expressions\": [\"London\", \"City of Dreams\", \"Capital of UK\"]}",
    "{\"value\": \"Amsterdam\",\"expressions\": [\"Amsterdam\", \"City of Love\", \"Capital of NL\"]}"
});

// To Use another App Id different from the one on your properties file
// entity.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// entity.setAccessToken("Your Custom Access Token Here");

String result = "";
String error = "";

if( wit.send(entity) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            Entity entity = new Entity(EntityEndpoint.UPDATE_ENTITY);
            entity.setEntityId("favorite_land");
            entity.setId("favorite_city");
            entity.setDoc("These are lands worth going to");
            entity.setValues(new String[]{
                "{\"value\": \"Paris\",\"expressions\": [\"Paris\", \"City of Light\", \"Capital of FR\"]}",
                "{\"value\": \"London\",\"expressions\": [\"London\", \"City of Dreams\", \"Capital of UK\"]}",
                "{\"value\": \"Amsterdam\",\"expressions\": [\"Amsterdam\", \"City of Love\", \"Capital of NL\"]}"
            });

            // To Use another App Id different from the one on your properties file
            // entity.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // entity.setAccessToken("Your Custom Access Token Here");

            if( wit.send(entity) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Delete Entity

To Permanently delete an entity.

import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

Entity entity = new Entity(EntityEndpoint.DELETE_ENTITY);
entity.setEntityId("favorite_land");

// To Use another App Id different from the one on your properties file
// entity.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// entity.setAccessToken("Your Custom Access Token Here");

String result = "";
String error = "";

if( wit.send(entity) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            Entity entity = new Entity(EntityEndpoint.DELETE_ENTITY);
            entity.setEntityId("favorite_land");

            // To Use another App Id different from the one on your properties file
            // entity.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // entity.setAccessToken("Your Custom Access Token Here");

            if( wit.send(entity) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Create Entity Value

To Add new values to a keyword entity.

import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

Entity entity = new Entity(EntityEndpoint.CREATE_ENTITY_VALUE);
entity.setEntityId("favorite_city");
entity.setValue("London");
entity.setExpressions(new String[]{"London", "Big Ben City"});
entity.setMetadata("CITY_1234");

// To Use another App Id different from the one on your properties file
// entity.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// entity.setAccessToken("Your Custom Access Token Here");

String result = "";
String error = "";

if( wit.send(entity) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            Entity entity = new Entity(EntityEndpoint.CREATE_ENTITY_VALUE);
            entity.setEntityId("favorite_city");
            entity.setValue("London");
            entity.setExpressions(new String[]{"London", "Big Ben City"});
            entity.setMetadata("CITY_1234");

            // To Use another App Id different from the one on your properties file
            // entity.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // entity.setAccessToken("Your Custom Access Token Here");

            if( wit.send(entity) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Delete Entity Value

To Remove a given value from an entity.

import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

Entity entity = new Entity(EntityEndpoint.DELETE_ENTITY_VALUE);
entity.setEntityId("favorite_city");
entity.setEntityValue("London");

// To Use another App Id different from the one on your properties file
// entity.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// entity.setAccessToken("Your Custom Access Token Here");

String result = "";
String error = "";

if( wit.send(entity) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            Entity entity = new Entity(EntityEndpoint.DELETE_ENTITY_VALUE);
            entity.setEntityId("favorite_city");
            entity.setEntityValue("London");

            // To Use another App Id different from the one on your properties file
            // entity.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // entity.setAccessToken("Your Custom Access Token Here");

            if( wit.send(entity) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Create Entity Value Expression

To Create a new expression for a keyword entity.

import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

Entity entity = new Entity(EntityEndpoint.CREATE_ENTITY_VALUE_EXPRESSION);
entity.setEntityId("favorite_city");
entity.setEntityValue("London");
entity.setExpression("Britain Capital");

// To Use another App Id different from the one on your properties file
// entity.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// entity.setAccessToken("Your Custom Access Token Here");

String result = "";
String error = "";

if( wit.send(entity) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            Entity entity = new Entity(EntityEndpoint.CREATE_ENTITY_VALUE_EXPRESSION);
            entity.setEntityId("favorite_city");
            entity.setEntityValue("London");
            entity.setExpression("Britain Capital");

            // To Use another App Id different from the one on your properties file
            // entity.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // entity.setAccessToken("Your Custom Access Token Here");

            if( wit.send(entity) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Delete Entity Value Expression

To Remove an expression from an entity.

import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

//....


Config config = new Config();
config.loadPropertiesFile("config.properties");
config.configLogger();

Wit wit = new Wit(config);

Entity entity = new Entity(EntityEndpoint.DELETE_ENTITY_VALUE_EXPRESSION);
entity.setEntityId("favorite_city");
entity.setEntityValue("London");
entity.setExpressionValue("Britain Capital");

// To Use another App Id different from the one on your properties file
// entity.setAppId("Your Custom App ID Here");
// To Use Another Access Token Different From The one on your properties file
// entity.setAccessToken("Your Custom Access Token Here");

String result = "";
String error = "";

if( wit.send(entity) ){
    result = wit.getResponse();
}else{
    error = wit.getError();
}

So in case we use spark java framework, Our code can be look like the following:

package com.clivern.test;

import static spark.Spark.*;
import com.clivern.wit.api.Entity;
import com.clivern.wit.api.endpoint.EntityEndpoint;
import com.clivern.wit.util.Config;
import com.clivern.wit.Wit;

/**
 * Main Class
 *
 * @since 1.0.0
 */
public class Main {

    public static void main(String[] args)
    {
        get("/", (request, response) -> {

            Config config = new Config();
            config.loadPropertiesFile("src/main/java/resources/config.properties");
            config.configLogger();

            Wit wit = new Wit(config);

            Entity entity = new Entity(EntityEndpoint.DELETE_ENTITY_VALUE_EXPRESSION);
            entity.setEntityId("favorite_city");
            entity.setEntityValue("London");
            entity.setExpressionValue("Britain Capital");

            // To Use another App Id different from the one on your properties file
            // entity.setAppId("Your Custom App ID Here");
            // To Use Another Access Token Different From The one on your properties file
            // entity.setAccessToken("Your Custom Access Token Here");

            if( wit.send(entity) ){
                return wit.getResponse();
            }else{
                return wit.getError();
            }
        }
    }
}

Misc

Changelog

Version 1.0.0:

Initial Release.

Acknowledgements

© 2018, Clivern. Released under The Apache Software License, Version 2.0.

Wit-Java is authored and maintained by @clivern.

Versions

Version
1.0.0 Feb 27, 2018