com.neurosys.template.model.renderadapters

Class SimpleDynamicFieldsRenderAdapter<T>

java.lang.Object

com.neurosys.template.model.renderadapters.SimpleDynamicFieldsRenderAdapter<T>

Type Parameters:

T - as input Type to the whole process

All Implemented Interfaces:

CustomTemplateRenderAdapter<T,org.apache.wicket.model.IModel,org.apache.wicket.Component,org.apache.wicket.MarkupContainer>, Serializable

public class SimpleDynamicFieldsRenderAdapter<T>
extends Object
implements CustomTemplateRenderAdapter<T,org.apache.wicket.model.IModel,org.apache.wicket.Component,org.apache.wicket.MarkupContainer>

Author:

Arjun Dhar

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface com.neurosys.template.model.CustomTemplateRenderAdapter

CustomTemplateRenderAdapter.Nothing

Field Summary

Fields inherited from interface com.neurosys.template.model.CustomTemplateRenderAdapter

nothing

Constructor Summary

Constructors

Constructor and Description
SimpleDynamicFieldsRenderAdapter()

Method Summary

Modifier and Type	Method and Description
org.apache.wicket.Component	getComponentForType(MetaItem metaItem, String fieldComponentName, org.apache.wicket.model.IModel model, org.apache.wicket.MarkupContainer container, T modelObject, User user) One can override to customize specific components or impose some manual override over what is dynamically generated.
String	getItemRefId(MetaItem metaItem) When rendering Items, for Feedback we may want to target messages to sections in the form.
Object	processItem(T entity, MetaItem metaItem, org.apache.wicket.Component coreEntityDataField, User user, Object... contextParams) For each meta item handle processing on submit and derive the value to be submitted/persisted back
void	reset() During Ajax calls a Render Adapter maybe called multiple times.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleDynamicFieldsRenderAdapter

public SimpleDynamicFieldsRenderAdapter()

Method Detail

getComponentForType

public org.apache.wicket.Component getComponentForType(MetaItem metaItem,
                                                       String fieldComponentName,
                                                       org.apache.wicket.model.IModel model,
                                                       org.apache.wicket.MarkupContainer container,
                                                       T modelObject,
                                                       User user)

One can override to customize specific components or impose some manual override over what is dynamically generated. When selecting type if both Field and ContentFacetMeta exist then ContentFacetMeta is given preference as it is defined by Config in a Template

Other than the usual types TEXT, HIDDEN, PASSWORD, CHECK_BOX, TEXT_AREA, some complex types supported and their rendering is as follows
(Note that the fragment name convention is <ContentType name>_<Field/property Name> for REF, JSON, JSON_ARRAY, ARRAY and <ContentType name> for other complex types):

• ContentType.IMG - Core field name 'currentImg' of type StaticImageComponent - Renders the image and the ability to upload a new one
• ContentType.REF - Core field name 'input' of type HiddenField - A reference to some values. the values can be derived from other input support defined on the UI.
  Example Colors. One may choose to use a Color palette to represent the colors available. The palette can be defined directly by the UI and only the resultant values selected can be put in the core hidden field associated with the server component.
• ContentType.ARRAY - Core field name 'input' of type HiddenField - Supports an array of comma separated values (Strings)
• ContentType.JSON - Core field name 'input' of type HiddenField - If an Object is being used then it will be marshaled/serialized into JSON format automatically and processed as such.
  The Object de-serialization should ideally support to and from JSON format.
• ContentType.JSON_ARRAY - Core field 'name' input of type HiddenField - If an Array of Object(s) is being used then it will be marshaled/serialized into JSON format automatically and processed as such.
  The Object de-serialization should ideally support to and from JSON format.

  
        Usage Sample :
			<wicket:panel>

		<tr wicket:id="items">			
			<td><span wicket:id="fieldName" /><div wicket:id="feedback" style='background-color:#EEEEEE'></div></td>
			<td><div wicket:id="productField"></div></td>
		</tr>

		<!-- Specific complex types -->
		<wicket:fragment wicket:id="REF_colors">
			Color(s): -- Deprecated, colors now ARRAY type
			<input wicket:id="input" type='hidden' />			
		</wicket:fragment>
		<wicket:fragment wicket:id="ARRAY_colors">
			Color(s):
			<input wicket:id="input" type='hidden' />			
		</wicket:fragment>
		<wicket:fragment wicket:id="JSON_size">
			Size:
			<input wicket:id="input" type='hidden' />			
		</wicket:fragment>
		<wicket:fragment wicket:id="JSON_ARRAY_relatedGroups">
			Related Groups:
			<input wicket:id="input" type='hidden' />			
		</wicket:fragment>

	</wicket:panel>
  

Specified by:

getComponentForType in interface CustomTemplateRenderAdapter<T,org.apache.wicket.model.IModel,org.apache.wicket.Component,org.apache.wicket.MarkupContainer>

Parameters:

metaItem - as MetaItem

fieldComponentName - as the rendering fieldComponentName or Id (of the component to be created)

model - as MODEL of the value extracted from the original modelObject for the MetaItem. This is a variable that would typically be extracted from the modeObject using the MetaItem, however there is complex logic that can vary and hence is expected to be provided to this method.

container - as CONTAINER_COMPONENT containing the produced component

modelObject - as the core domain Object/Entity

user - as com.neurosys.security.auth.domain.User for any Authorization related needs @nullable true

Returns:

COMPONENT

See Also:

ProductDetailsTemplatePanel#getComponentForType(MetaItem, String, MODEL, CONTAINER_COMPONENT, com.neurosys.products.domain.Product)

processItem

public Object processItem(T entity,
                          MetaItem metaItem,
                          org.apache.wicket.Component coreEntityDataField,
                          User user,
                          Object... contextParams)
                   throws Exception

Description copied from interface: CustomTemplateRenderAdapter

For each meta item handle processing on submit and derive the value to be submitted/persisted back

Specified by:

processItem in interface CustomTemplateRenderAdapter<T,org.apache.wicket.model.IModel,org.apache.wicket.Component,org.apache.wicket.MarkupContainer>

Returns:

Object value for the entity form field
Note: null or CustomTemplateRenderAdapter.Nothing (nothing). Nothing should not be persisted or used, it implies it should be ignored.

Throws:

Exception

getItemRefId

public String getItemRefId(MetaItem metaItem)

Description copied from interface: CustomTemplateRenderAdapter

When rendering Items, for Feedback we may want to target messages to sections in the form. A convention needs to exist to target a particular component generated from a MetaItem

Specified by:

getItemRefId in interface CustomTemplateRenderAdapter<T,org.apache.wicket.model.IModel,org.apache.wicket.Component,org.apache.wicket.MarkupContainer>

Parameters:

metaItem - as MetaItem

Returns:

String

reset

public void reset()

Description copied from interface: CustomTemplateRenderAdapter

During Ajax calls a Render Adapter maybe called multiple times.
Some states may need to be reset.

Specified by:

reset in interface CustomTemplateRenderAdapter<T,org.apache.wicket.model.IModel,org.apache.wicket.Component,org.apache.wicket.MarkupContainer>