com.google.appinventor.components.runtime

Class TinyWebDB

java.lang.Object

com.google.appinventor.components.runtime.AndroidNonvisibleComponent

com.google.appinventor.components.runtime.TinyWebDB

All Implemented Interfaces:

Component

public class TinyWebDB
extends AndroidNonvisibleComponent
implements Component

The TinyWebDB component communicates with a Web service to store and retrieve information. Although this component is usable, it is very limited and meant primarily as a demonstration for people who would like to create their own components that talk to the Web. The accompanying Web service is at (http://appinvtinywebdb.appspot.com). The component has methods to store a value under a tag and to retrieve the value associated with the tag. The interpretation of what "store" and "retrieve" means is up to the Web service. In this implementation, all tags and values are strings (text). This restriction may be relaxed in future versions.

Field Summary

Fields inherited from class com.google.appinventor.components.runtime.AndroidNonvisibleComponent

form

Fields inherited from interface com.google.appinventor.components.runtime.Component

ACCELEROMETER_SENSITIVITY_MODERATE, ACCELEROMETER_SENSITIVITY_STRONG, ACCELEROMETER_SENSITIVITY_WEAK, ALIGNMENT_CENTER, ALIGNMENT_NORMAL, ALIGNMENT_OPPOSITE, ASSET_DIRECTORY, BUTTON_SHAPE_DEFAULT, BUTTON_SHAPE_OVAL, BUTTON_SHAPE_RECT, BUTTON_SHAPE_ROUNDED, COLOR_BLACK, COLOR_BLUE, COLOR_CYAN, COLOR_DEFAULT, COLOR_DKGRAY, COLOR_GRAY, COLOR_GREEN, COLOR_LTGRAY, COLOR_MAGENTA, COLOR_NONE, COLOR_ORANGE, COLOR_PINK, COLOR_RED, COLOR_WHITE, COLOR_YELLOW, DEFAULT_VALUE_COLOR_BLACK, DEFAULT_VALUE_COLOR_BLUE, DEFAULT_VALUE_COLOR_CYAN, DEFAULT_VALUE_COLOR_DEFAULT, DEFAULT_VALUE_COLOR_DKGRAY, DEFAULT_VALUE_COLOR_GRAY, DEFAULT_VALUE_COLOR_GREEN, DEFAULT_VALUE_COLOR_LTGRAY, DEFAULT_VALUE_COLOR_MAGENTA, DEFAULT_VALUE_COLOR_NONE, DEFAULT_VALUE_COLOR_ORANGE, DEFAULT_VALUE_COLOR_PINK, DEFAULT_VALUE_COLOR_RED, DEFAULT_VALUE_COLOR_WHITE, DEFAULT_VALUE_COLOR_YELLOW, DIRECTION_EAST, DIRECTION_MAX, DIRECTION_MIN, DIRECTION_NONE, DIRECTION_NORTH, DIRECTION_NORTHEAST, DIRECTION_NORTHWEST, DIRECTION_SOUTH, DIRECTION_SOUTHEAST, DIRECTION_SOUTHWEST, DIRECTION_WEST, FONT_DEFAULT_SIZE, LAYOUT_ORIENTATION_HORIZONTAL, LAYOUT_ORIENTATION_VERTICAL, LENGTH_FILL_PARENT, LENGTH_PREFERRED, LENGTH_UNKNOWN, SLIDER_MAX_VALUE, SLIDER_MIN_VALUE, SLIDER_THUMB_VALUE, TOAST_LENGTH_LONG, TOAST_LENGTH_SHORT, TYPEFACE_DEFAULT, TYPEFACE_MONOSPACE, TYPEFACE_SANSSERIF, TYPEFACE_SERIF

Constructor Summary

Constructors

Constructor and Description
TinyWebDB(ComponentContainer container) Creates a new TinyWebDB component.

Method Summary

Methods

Modifier and Type	Method and Description
void	GetValue(java.lang.String tag) GetValue asks the Web service to get the value stored under the given tag.
void	GotValue(java.lang.String tagFromWebDB, java.lang.Object valueFromWebDB) Indicates that a GetValue server request has succeeded.
java.lang.String	ServiceURL() Returns the URL of the web service database.
void	ServiceURL(java.lang.String url) Specifies the URL of the Web service.
void	StoreValue(java.lang.String tag, java.lang.Object valueToStore) Asks the Web service to store the given value under the given tag
void	ValueStored() Event indicating that a StoreValue server request has succeeded.
void	WebServiceError(java.lang.String message) Indicates that the communication with the Web service signaled an error

Methods inherited from class com.google.appinventor.components.runtime.AndroidNonvisibleComponent

getDispatchDelegate

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.appinventor.components.runtime.Component

getDispatchDelegate

Constructor Detail

TinyWebDB

public TinyWebDB(ComponentContainer container)

Creates a new TinyWebDB component.

Parameters:

container - the Form that this component is contained in.

Method Detail

ServiceURL

public java.lang.String ServiceURL()

Returns the URL of the web service database.

ServiceURL

public void ServiceURL(java.lang.String url)

Specifies the URL of the Web service. The default value is the demo service running on App Engine.

StoreValue

public void StoreValue(java.lang.String tag,
              java.lang.Object valueToStore)

Asks the Web service to store the given value under the given tag

Parameters:

tag - The tag to use

valueToStore - The value to store. Can be any type of value (e.g. number, text, boolean or list).

ValueStored

public void ValueStored()

Event indicating that a StoreValue server request has succeeded.

GetValue

public void GetValue(java.lang.String tag)

GetValue asks the Web service to get the value stored under the given tag. It is up to the Web service what to return if there is no value stored under the tag. This component just accepts whatever is returned.

Parameters:

tag - The tag whose value is to be retrieved.

GotValue

public void GotValue(java.lang.String tagFromWebDB,
            java.lang.Object valueFromWebDB)

Indicates that a GetValue server request has succeeded.

Parameters:

valueFromWebDB - the value that was returned. Can be any type of value (e.g. number, text, boolean or list).

WebServiceError

public void WebServiceError(java.lang.String message)

Indicates that the communication with the Web service signaled an error

Parameters:

message - the error message