org.apache.tapestry5.services
Interface ClientDataEncoder

All Known Implementing Classes:

ClientDataEncoderImpl

public interface ClientDataEncoder

A service used when a component or service needs to encode some amount of data on the client as a string. The string may be a query parameter, hidden form field, or a portion of a URL. The default implementation converts the object output stream into a Base64 string.

Since:

5.1.0.1

Method Summary

ClientDataSink	createSink() Creates a sink for client data.
ObjectInputStream	decodeClientData(String clientData) Decodes data previously obtained from ClientDataSink.getClientData().
ObjectInputStream	decodeEncodedClientData(String clientData) Decoes client data obtained via ClientDataSink.getEncodedClientData().

Method Detail

createSink

ClientDataSink createSink()

Creates a sink for client data. The sink provides an output stream and ultimately, a string representation of the data sent to the stream.

Returns:

a new sink

decodeClientData

ObjectInputStream decodeClientData(String clientData)
                                   throws IOException

Decodes data previously obtained from ClientDataSink.getClientData().

Parameters:

clientData - encoded client data

Returns:

stream of decoded data

Throws:

IOException

decodeEncodedClientData

ObjectInputStream decodeEncodedClientData(String clientData)
                                          throws IOException

Decoes client data obtained via ClientDataSink.getEncodedClientData().

Parameters:

clientData - URLEncoded client data

Returns:

stream of objects

Throws:

IOException

Since:

5.1.0.4