org.javarosa.core.model.actions.setgeopoint

Class SetGeopointAction

java.lang.Object

org.javarosa.core.model.actions.Action

org.javarosa.core.model.actions.setgeopoint.SetGeopointAction

All Implemented Interfaces:

Externalizable

Direct Known Subclasses:

StubSetGeopointAction

public abstract class SetGeopointAction
extends Action

Abstract implementation of odk:setgeopoint action. Concrete implementations must: - provide a way to request location updates when the action is triggered - use saveLocationValue(String) to write a location to the model - provide a no-argument constructor with no body for serialization - get registered by the PrototypeManager

Constructor Summary

Constructors

Constructor and Description
SetGeopointAction()
SetGeopointAction(TreeReference targetReference)

Method Summary

Modifier and Type	Method and Description
TreeReference	getContextualizedTargetReference()
TreeReference	getTargetReference()
TreeReference	processAction(FormDef model, TreeReference contextRef) Process actions that were triggered in the form.
void	readExternal(DataInputStream in, PrototypeFactory pf)
abstract void	requestLocationUpdates() Client-specific location request.
void	saveLocationValue(String location) Save the location to the model.
void	setTargetReference(TreeReference targetReference)
void	writeExternal(DataOutputStream out)

Methods inherited from class org.javarosa.core.model.actions.Action

getName

Methods inherited from class java.lang.Object

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

Constructor Detail

SetGeopointAction

public SetGeopointAction()

SetGeopointAction

public SetGeopointAction(TreeReference targetReference)

Method Detail

getTargetReference

public TreeReference getTargetReference()

getContextualizedTargetReference

public TreeReference getContextualizedTargetReference()

setTargetReference

public void setTargetReference(TreeReference targetReference)

processAction

public final TreeReference processAction(FormDef model,
                                         TreeReference contextRef)

Description copied from class: Action

Process actions that were triggered in the form. NOTE: Currently actions are only processed on nodes that are WITHIN the context provided, if one is provided. This will need to get changed possibly for future action types.

Specified by:

processAction in class Action

Returns:

TreeReference targeted by the action or null if the action wasn't completed.

requestLocationUpdates

public abstract void requestLocationUpdates()

Client-specific location request. Implementations could immediately read a location and write it to the model if available or could initiate a request and asynchronously write the location when available.

saveLocationValue

public final void saveLocationValue(String location)

Save the location to the model.

readExternal

public void readExternal(DataInputStream in,
                         PrototypeFactory pf)
                  throws IOException,
                         DeserializationException

Specified by:

readExternal in interface Externalizable

Overrides:

readExternal in class Action

Throws:

IOException

DeserializationException

writeExternal

public void writeExternal(DataOutputStream out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Overrides:

writeExternal in class Action

Throws:

IOException