provided.client.model.task

Class GetInfo

java.lang.Object

provided.client.model.task.GetInfo

All Implemented Interfaces:

java.io.Serializable, ITask<java.lang.String>

public class GetInfo
extends java.lang.Object
implements ITask<java.lang.String>

Task that gets the server's system properties plus demonstrates that it can carry internal data to a remote system when the entire object is serialized and sent over.

Author:

swong

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private double[]	dArray An array carried along to prove that internal data is transmitted too.
static ITaskFactory<java.lang.String>	FACTORY An ITaskFactory for this task
private java.lang.String	input Input string given to the constructor
private static long	serialVersionUID UID for well-defined serialization
private ILocalTaskViewAdapter	taskView Adapter to the local view.

Constructor Summary

Constructors

Constructor and Description
GetInfo(java.lang.String input) Constructor for the class.

Method Summary

Modifier and Type	Method and Description
java.lang.String	execute() Display the internal string on the server's console.
ITaskResultFormatter<java.lang.String>	getFormatter() Returns an formatter that creates a string of the form: "GetInfo: System properties = [result] (input = [input])" Notice how the "input" value is not part of the result, but that the formatter can use it anyway because the formatter is closing over the whole task.
private void	readObject(java.io.ObjectInputStream stream) Reinitializes transient fields upon deserialization.
void	setTaskViewAdapter(ILocalTaskViewAdapter viewAdapter) Sets the task view adapter to a new value.

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

UID for well-defined serialization

See Also:

Constant Field Values

taskView

private transient ILocalTaskViewAdapter taskView

Adapter to the local view. Marked "transient" so that it is not serialized and instead is reattached at the destination (the server).

input

private java.lang.String input

Input string given to the constructor

dArray

private double[] dArray

An array carried along to prove that internal data is transmitted too.

FACTORY

public static final ITaskFactory<java.lang.String> FACTORY

An ITaskFactory for this task

Constructor Detail

GetInfo

public GetInfo(java.lang.String input)

Constructor for the class.

Parameters:

input - A string to carry around.

Method Detail

execute

public java.lang.String execute()
                         throws java.rmi.RemoteException

Display the internal string on the server's console. Get the server's system properties and calculate the sum of the internal data.

Specified by:

execute in interface ITask<java.lang.String>

Returns:

the server's system properties and the sum of the internal array as a string.

Throws:

java.rmi.RemoteException - if a network error occurs

readObject

private void readObject(java.io.ObjectInputStream stream)
                 throws java.io.IOException,
                        java.lang.ClassNotFoundException

Reinitializes transient fields upon deserialization. See the Serializable marker interface docs. taskView is set to a default value for now (ILocalTaskViewAdapter.DEFAULT_ADAPTER).

Parameters:

stream - The object stream with the serialized data

Throws:

java.io.IOException - if the input stream cannot be read correctly

java.lang.ClassNotFoundException - if the class file associated with the input stream cannot be located.

setTaskViewAdapter

public void setTaskViewAdapter(ILocalTaskViewAdapter viewAdapter)

Sets the task view adapter to a new value. Tests connection by sending a string representation of the dArray structure. Called by the server to attach the task to its view.

Specified by:

setTaskViewAdapter in interface ITask<java.lang.String>

Parameters:

viewAdapter - the adapter to the view.

getFormatter

public ITaskResultFormatter<java.lang.String> getFormatter()

Returns an formatter that creates a string of the form: "GetInfo: System properties = [result] (input = [input])" Notice how the "input" value is not part of the result, but that the formatter can use it anyway because the formatter is closing over the whole task.

Specified by:

getFormatter in interface ITask<java.lang.String>

Returns:

A formatter customized for this task object.