org.wicketstuff.select2

Interface ChoiceProvider<T>

Type Parameters:

T - type of choice object

All Superinterfaces:

org.apache.wicket.util.io.IClusterable, org.apache.wicket.model.IDetachable, Serializable

All Known Implementing Classes:

HomePage.CountriesProvider, StringTextChoiceProvider, TextChoiceProvider

public interface ChoiceProvider<T>
extends org.apache.wicket.model.IDetachable

Acts as a bridge between Select2 components and the application's domain model.

The two important services provided by implementations are:

• Feeding choices, represented by the application's domain objects, to Select2 components
• Transcoding said choices to and from Json so they can consumed by Select2

For the most common usecase where each choice is rendered as a text string see TextChoiceProvider.

Author:

igor

Method Summary

Methods

Modifier and Type	Method and Description
void	query(String term, int page, Response<T> response) Queries application for choices that match the search term and adds them to the response
Collection<T>	toChoices(Collection<String> ids) Converts a list of choice ids back into application's choice objects.
void	toJson(T choice, org.apache.wicket.ajax.json.JSONWriter writer) Converts the specified choice to Json.

Methods inherited from interface org.apache.wicket.model.IDetachable

detach

Method Detail

query

void query(String term,
         int page,
         Response<T> response)

Queries application for choices that match the search term and adds them to the response

Parameters:

term - search term

page - requested search term results page

response - aggregate for matching choices as well as other response options

toJson

void toJson(T choice,
          org.apache.wicket.ajax.json.JSONWriter writer)
            throws org.apache.wicket.ajax.json.JSONException

Converts the specified choice to Json.

At the very least each choice should contain an id attribute. If no custom rendering function is specified, the text attribute should also be provided

Example: If mapping a User {Long id, String name} using default rendering the code should look like this:

 toJson(User choice, JSONWriter writer)
 {
        writer.key("id").value(choice.getId()).key("text").value(choice.getName());
 }
 

Parameters:

choice - choice to convert

writer - Json writer that should be used to covnert the choice

Throws:

org.apache.wicket.ajax.json.JSONException

toChoices

Collection<T> toChoices(Collection<String> ids)

Converts a list of choice ids back into application's choice objects. When the choice provider is attached to a single-select component the ids collection will contain exactly one id, and a collection containing exactly one choice should be returned.

Parameters:

ids - collection containing choice ids

Returns:

collection containing application choice objects