|
NextApp Echo3 v3.0.b4 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ComponentSynchronizePeer
Peer for synchronizing the state of server-side Component
objects with their equivalent client-side instances.
Note about Context
s.
Any context passed to any method in a ComponentSynchronizePeer
must contain the following items:
SerialContext
Connection
PropertyPeerFactory
UserInstance
Method Summary | |
---|---|
java.lang.String |
getClientComponentType(boolean shortType)
Returns the remote client component type name. |
java.lang.Class |
getComponentClass()
Returns the Class of Component
supported by this peer. |
java.lang.Class |
getEventDataClass(java.lang.String eventType)
Returns the Class of the event data that will
be provided by the specified event type. |
java.util.Iterator |
getEventTypes(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component)
Determines the (client-side) types of events which, when fired on the client, can result in immediate server notification. |
java.lang.Class |
getInputPropertyClass(java.lang.String propertyName)
Returns the Class of the specified input
property of the component. |
java.lang.Object |
getOutputProperty(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component,
java.lang.String propertyName,
int propertyIndex)
Returns the value of a specific output property. |
java.util.Iterator |
getOutputPropertyIndices(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component,
java.lang.String propertyName)
Determines which indices of a particular property are set. |
java.lang.String |
getOutputPropertyMethodName(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component,
java.lang.String propertyName)
Returns the name of the method that should be invoked to set the property on the remote client. |
java.util.Iterator |
getOutputPropertyNames(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component)
Returns an Iterator over the collection of names of all
output properties that should be rendered to the remote client. |
java.util.Iterator |
getUpdatedOutputPropertyNames(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component,
nextapp.echo.app.update.ServerComponentUpdate update)
Returns an Iterator over the collection of names of all
output properties that should be rendered to the client to complete
the specified update . |
boolean |
hasListeners(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component,
java.lang.String clientEventType)
Determines if the specified component has any listeners registered of the specified event type. |
boolean |
hasUpdatedListeners(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component,
nextapp.echo.app.update.ServerComponentUpdate update,
java.lang.String clientEventType)
Determines if any server-side listeners for a specific client-side event type have been added or removed in the specified ServerComponentUpdate . |
void |
init(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component)
Initializes the peer. |
boolean |
isOutputPropertyIndexed(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component,
java.lang.String propertyName)
Determines if the specified output property is indexed. |
boolean |
isOutputPropertyReferenced(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component,
java.lang.String propertyName)
Determines if the specified property should be rendered-by-reference. |
void |
processEvent(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component,
java.lang.String eventType,
java.lang.Object eventData)
Processes an event received from the client. |
void |
storeInputProperty(nextapp.echo.app.util.Context context,
nextapp.echo.app.Component component,
java.lang.String propertyName,
int propertyIndex,
java.lang.Object newValue)
Processes a property update from the client. |
Method Detail |
---|
java.lang.String getClientComponentType(boolean shortType)
shortType
- flag indicating whether short type or normal type name should be returned
java.lang.Class getComponentClass()
Class
of Component
supported by this peer.
Class
java.lang.Class getEventDataClass(java.lang.String eventType)
Class
of the event data that will
be provided by the specified event type.
eventType
- the type of the event
Class
java.util.Iterator getEventTypes(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component)
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
component
- the Component
being rendered
Iterator
over a collection of String
s
of the remote client event type namesjava.lang.Class getInputPropertyClass(java.lang.String propertyName)
Class
of the specified input
property of the component.
propertyName
- the name of the property
Class
java.lang.Object getOutputProperty(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component, java.lang.String propertyName, int propertyIndex)
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
component
- the Component
being renderedpropertyName
- the name of the property being renderedpropertyIndex
- the property index (only relevant for indexed properties, -1 will
be provided for non-indexed properties)
java.util.Iterator getOutputPropertyIndices(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component, java.lang.String propertyName)
isOutputPropertyIndexed()
has returned true.
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
component
- the componentpropertyName
- the property name
Iterator
that returns the set indices in
incrementing order as Integer
sjava.lang.String getOutputPropertyMethodName(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component, java.lang.String propertyName)
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
component
- the componentpropertyName
- the property name
java.util.Iterator getOutputPropertyNames(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component)
Iterator
over the collection of names of all
output properties that should be rendered to the remote client. Only the
names of properties with non-default values should be returned.
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
component
- the component
Iterator
of property namesjava.util.Iterator getUpdatedOutputPropertyNames(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component, nextapp.echo.app.update.ServerComponentUpdate update)
Iterator
over the collection of names of all
output properties that should be rendered to the client to complete
the specified update
. Only the names of properties taht
have been updated by the update
should be returned (including
those whose values have changed to null. Client-specific
may be included as necessary.
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
component
- the componentupdate
- the ServerComponentUpdate
being rendered
Iterator
of property names to update on the clientboolean hasListeners(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component, java.lang.String clientEventType)
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
component
- the componentclientEventType
- the client-side event type
boolean hasUpdatedListeners(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component, nextapp.echo.app.update.ServerComponentUpdate update, java.lang.String clientEventType)
ServerComponentUpdate
.
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
component
- the componentupdate
- the ServerComponentUpdate
to processclientEventType
- the client-side event
void init(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component)
Component
for the first time.
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
component
- the component being renderedboolean isOutputPropertyIndexed(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component, java.lang.String propertyName)
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
component
- the componentpropertyName
- the property name
boolean isOutputPropertyReferenced(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component, java.lang.String propertyName)
equals()
and hashCode()
or
the same reference must be used for reference-based rendering to be effective.
Rendering-by-reference is often best used for rendering model properties, e.g., a
ListModel
that might be used by several listboxes on the same screen.
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
component
- the componentpropertyName
- the property name
void processEvent(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component, java.lang.String eventType, java.lang.Object eventData)
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
ClientMessage
ClientUpdateManager
component
- the updated Component
eventType
- the type of the eventeventData
- arbitrary component/event-specific event-related datavoid storeInputProperty(nextapp.echo.app.util.Context context, nextapp.echo.app.Component component, java.lang.String propertyName, int propertyIndex, java.lang.Object newValue)
context
- the relevant Context
, provides
standard contextual information described in class description, in
addition to the following:
ClientMessage
ClientUpdateManager
component
- the updated Component
propertyName
- the name of the propertypropertyIndex
- the index of the property
(or -1 in the typical case of a non-indexed property)newValue
- the new value of the property
|
NextApp Echo3 v3.0.b4 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |