com.digi.wva.util

Class WvaUtil

java.lang.Object

com.digi.wva.util.WvaUtil

public final class WvaUtil
extends Object

Utility methods for the WVA Android library.

Method Summary

Methods

Modifier and Type	Method and Description
static DateTime	dateTimeFromString(String timestamp) Parse the given time string into a corresponding DateTime object.
static String	getConfigKeyFromUri(String uri) Given a web services URI or sub-path, intelligently parse out the correct top-level key to use when applying configuration to the WVA.
static String	getEndpointFromUri(String uri) Extract the last path piece from the given URI.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

dateTimeFromString

public static DateTime dateTimeFromString(String timestamp)

Parse the given time string into a corresponding DateTime object.

Parameters:

timestamp - the time string to parse

Returns:

the parsed DateTime object

getEndpointFromUri

public static String getEndpointFromUri(String uri)

Extract the last path piece from the given URI.

     assert getEndpointFromUri("foo/bar/baz").equals("baz");
 

Parameters:

uri - the path string to parse

Returns:

the section of the given path following the last slash character (/), or null if uri is null or empty

getConfigKeyFromUri

public static String getConfigKeyFromUri(String uri)

Given a web services URI or sub-path, intelligently parse out the correct top-level key to use when applying configuration to the WVA.

For example, when interacting with ws/config/canbus/1, the JSON we send down must have the top-level key canbus.

Parameters:

uri - the full request path, or a section of that, to be used when applying configuration to the WVA

Returns:

• The first piece of the given path following config/, if config/ is present in the path. This represents the settings group being configured, which is the correct string to use as the top-level key.
• null if the last piece of the path is config, implying that we will be unable to decide which key to use (because it is not clear what is being configured).
• The first piece of the path, if config is not found as a section of the path. This implies that uri is the path under ws/config/ being used, and as such, the first section of the path represents the settings group being configured.