wolframalpha-client's Introduction

wolframalpha-client

Java client for wolframalpha API

Build status

Known issues

Saw incorrect SSL configuration of some wolfram servers during testing causing async pod download to fail with SSL handshake exception. Seems to be fixed now, but if it would appear again - would need to implement workaround as it is described in related issues

Overview

This library provides base RESTful binding to a WolframAlpha API to all endpoints that have API documentation at this moment.

Supported APIs:

Simple API
Documentation : reference

byte[] query(@Param("literal") String literal,
                 @Param("appid") String appId,
                 @Param("layout") Layout layout,
                 @Param("background") String background,
                 @Param("foreground") String foreground,
                 @Param("fontsize") int fontsize,
                 @Param("width") int width,
                 @Param("units") Units units,
                 @Param("timeout") int timeout);

Returns image from API response as raw binary array.

Short answer API
Documentation : reference

String getShortAnswer(@Param("literal") String literal,
                          @Param("appid") String appId,
                          @Param("units") Units units,
                          @Param("timeout") int timeout)

Returns string from API response.

Spoken results API
Documentation : reference

String getSpokenResults(@Param("literal") String literal,
                        @Param("appid") String appId,
                        @Param("units") Units units,
                        @Param("timeout") int timeout);

Returns string from API response.

Full results API - WIP
Documentation : reference
Supported features:
- Result format selection: IMAGE, IMAGEMAP, MINPUT, MOUTPUT, PLAINTEXT, CELL, MATHML, SOUND, WAV
- ImageMap bindings
- Basic MathMl bindings - raw xml object
- Pods/Subpods with attributes
- Assumptions
- Cells
- Location selection
- Pod states
- Async requests