org.wicketstuff.openlayers.api.control
Class AbstractControl

java.lang.Object
  org.wicketstuff.openlayers.api.control.AbstractControl

All Implemented Interfaces:

java.io.Serializable, org.apache.wicket.IClusterable, IJavascriptComponent

Direct Known Subclasses:

Control, GetFeature, SelectFeatureControl, WMSGetFeatureInfo

public class AbstractControl
extends java.lang.Object
implements IJavascriptComponent

Author:

Michael O'Cleirigh Provides a base class for the IJavascriptControl interface that provides a default implementation for the javascript initialization and removal methods.

See Also:

Serialized Form

Constructor Summary

protected

AbstractControl(java.lang.String name, boolean externalizable)

Method Summary

java.lang.String	getId() Note: currently the naming of a component is related to the concrete class i.e.
java.lang.String	getJSadd(IOpenLayersMap map)
protected java.lang.String	getJSadd(IOpenLayersMap map, java.util.Map<java.lang.String,java.lang.String> parameters) A convenience wrapper to getJSadd(IOpenLayersMap, String) that builds the parameter string from the parameter map and then invokes the method.
protected java.lang.String	getJSadd(IOpenLayersMap map, java.lang.String parameterString) Calls map.addControl() for the generated initialization javascript using the parameterString if present.
protected java.lang.String	getJSadd(IOpenLayersMap map, java.lang.String javascriptClassName, java.util.Map<java.lang.String,java.lang.String> parameters)
protected java.lang.String	getJSadd(IOpenLayersMap map, java.lang.String javascriptClassName, java.lang.String parameterString)
protected java.lang.String	getJSinvoke(IOpenLayersMap map, java.lang.String invocation) A helper similiar to OpenLayersMap.getJSInvoke except instead of just getting the map context we get this control context from the root.
java.lang.String	getJSremove(IOpenLayersMap map)
org.apache.wicket.markup.html.resources.JavascriptResourceReference[]	getJSResourceReferences() In some cases a javascript component will provide its own javascript resource.
java.util.List<Layer>	getLayerList()
void	registerJavascriptEvent(IOpenLayersMap map, java.lang.String event, org.apache.wicket.model.IModel<java.lang.String> eventHandlingJavascriptModel) Allows javascript to be wired into events on this control.
void	setLayerList(java.util.List<Layer> layerList)

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractControl

protected AbstractControl(java.lang.String name,
                          boolean externalizable)

Method Detail

getJSadd

protected java.lang.String getJSadd(IOpenLayersMap map,
                                    java.util.Map<java.lang.String,java.lang.String> parameters)

A convenience wrapper to getJSadd(IOpenLayersMap, String) that builds the parameter string from the parameter map and then invokes the method.

Parameters:

map -

parameters -

Returns:

the initialization javascript that adds this control to the map using the parameters if given.

getJSadd

protected java.lang.String getJSadd(IOpenLayersMap map,
                                    java.lang.String javascriptClassName,
                                    java.util.Map<java.lang.String,java.lang.String> parameters)

getJSadd

protected java.lang.String getJSadd(IOpenLayersMap map,
                                    java.lang.String parameterString)

Calls map.addControl() for the generated initialization javascript using the parameterString if present.

Parameters:

map -

parameterString - contains comma separated list of parameters

Returns:

getJSadd

protected java.lang.String getJSadd(IOpenLayersMap map,
                                    java.lang.String javascriptClassName,
                                    java.lang.String parameterString)

Parameters:

map - the openlayers map java binding.

javascriptClassName - the name of the javascript class being invoked.

parameterString - the constructor parameters if any.

Returns:

the javascript to invoke the map.addControl() method containing the initialized constructor for the control type.

getJSadd

public java.lang.String getJSadd(IOpenLayersMap map)

Specified by:

getJSadd in interface IJavascriptComponent

Returns:

the rendered javascript to add this component to the map

getJSremove

public java.lang.String getJSremove(IOpenLayersMap map)

Specified by:

getJSremove in interface IJavascriptComponent

Returns:

the rendered javascript to remove this component from the map.

getId

public java.lang.String getId()

Description copied from interface: IJavascriptComponent

Note: currently the naming of a component is related to the concrete class i.e. a WMS layer would be 'wms' + getId() like: 'wms123456'. The id returned here is the number part not the layer identifier part.

Specified by:

getId in interface IJavascriptComponent

Returns:

the unique id for this component. Used for naming purposes.

registerJavascriptEvent

public void registerJavascriptEvent(IOpenLayersMap map,
                                    java.lang.String event,
                                    org.apache.wicket.model.IModel<java.lang.String> eventHandlingJavascriptModel)

Allows javascript to be wired into events on this control. The name of the event object in scope for the model value is 'evt'.

control.events.register("featureselected", this, function(evt) { modelValue <-- this is the content from the model. });

Note: This is not the method to use if you want to use ajax and have wicket to the event processing.

Parameters:

map - the map object that the control is bound to (will be bound to).

event - the name of the OpenLayersEvent

model - an IModel that provides the javascript text to be registered on the event.

getJSResourceReferences

public org.apache.wicket.markup.html.resources.JavascriptResourceReference[] getJSResourceReferences()

Description copied from interface: IJavascriptComponent

In some cases a javascript component will provide its own javascript resource. This is used by the map to add in the references.

Specified by:

getJSResourceReferences in interface IJavascriptComponent

Returns:

getJSinvoke

protected java.lang.String getJSinvoke(IOpenLayersMap map,
                                       java.lang.String invocation)

A helper similiar to OpenLayersMap.getJSInvoke except instead of just getting the map context we get this control context from the root.

Parameters:

map -

invocation -

Returns:

setLayerList

public void setLayerList(java.util.List<Layer> layerList)

getLayerList

public java.util.List<Layer> getLayerList()