Show Navigation


Websocket autocomplete/ multi dependency selection plugin for grails 3

Owner: vahid | 3.0.4 | Apr 13, 2016 | Package | Issues | Source | License: Apache-2.0

dependencies {
    compile 'org.grails.plugins:boselecta:3.0.4'


Boselecta plugin

Side note - similar / related projects

Grails plugin that uses default WebSocket technology to interact with your domainClasses and produce dependent form / options that depend on one another. The format to define select functionality / auto complete are identical. Auto complete requires additional boolean values to be passed to make it auto complete.

Select box dependencies data comes from WebSocket Client running within your application (as part of the plugin)
AutoComplete input areas use HTML5 dataList, data for dataList provided by backend WebSocket Connection.

Walkthrough Video - youtube, Everything you need to know about boselecta


More information to help with diagram

BoSelecta can be incorporated to an existing grails app running ver 2>+. Supports both resource (pre 2.4) /assets (2.4+) based grails sites.

Plugin will work with tomcat 7.0.54 + (inc. 8) running java 1.7+

Dependency Grails 3:

    compile "org.grails.plugins:boselecta:3.0.4"

codebase for grails 3.X

Dependency Grails 2:

	compile ":boselecta:0.2" 

codebase for grails 2.X

######test site for grails 2

######test site for grails 3

###Latest updates (after video published): A further lock down has been introduced, with the assumption that most people will be looking up domain objects with single dependencies. This means, typically I expect an end user to map from continent to country to city and so on. So its one to one relationship between each object. For this reason the default call now only supports one relation, so:


domain will be the primary object itself (so a listing of that object, domain2 is the entity that it has that relationship with.

If you attempt to exceed and use domain3 and on. The plugin will not work. You can from now use selecta2 for those relations with depth


Testing plugin

Config.groovy overrides

[domainDepth explained] (

grails BoSelecta Plugin usage

JSON Formatting.

What is front-end / back-end WebSocket connections ?


Basic example:

Example 1: Connector / selectPrimary into default g:select box. (found in above testbo project)

  1. Initiate a master socket connection, <bo:connect handles all the information flowing back from backend websocket. So this is your main and only connection required on any given page. Take a note of the user and job names, they must match all the calls on this page.

Both the two code blocks below in one gsp:

<bo:connect user="myuser" job="job1" />

Now that we have configured our master listener, lets configure one connection with a relation that is returned to a normal blank select box

<form  action="example5">

id="MyCountry1" name="MyCountry1" job= "job1" user="myuser" domainDepth="0" formatting="JSON"
domain='ajaxdependancyselectexample.MyCountry' searchField='countryName' collectField='id'
domain2='ajaxdependancyselectexample.MyCity' bindid="" searchField2='cityName' collectField2='id'
appendValue='' appendName='Updated' noSelection="['': 'Please choose Continent']" setId="MyCity1" />

<g:select name="MyCity1" id="MyCity1" optionKey="id" optionValue="cityName" from="[]" required="required" noSelection="['': 'Please choose Country']" />
<input type=submit value=go> 

If you have used ajaxdependancy selection, a lot of the above input will look familiar. You are now giving the backend the ID of your primary selection MyCountry1, you are telling it what domain is which makes this a primary call and then returns MyCountry.countryName and to the primary box, you are then setting the setId as MyCity1 and saying domain2 is MyCity and to search/collect cityName/id.

Example 2: Connector / primary / into Secondary into g:select: (found in above testbo project)

Identical to above, but in this example we iterate over the relations using <bo:select passing domain2 object which be the next object so on the secondary objects there is no domain= value defined.

<bo:connect user="randomUser2" job="job2" />

<g:form name="myForm" action="example5">    
  id="MyContinent2" name="MyContinent2" setId="MyCountry11"
  job= "job2" user="randomUser2" domainDepth="0"    
  domain='ajaxdependancyselectexample.MyContinent' searchField='continentName' collectField='id'
  domain2='ajaxdependancyselectexample.MyCountry' bindid="" searchField2='countryName'
  appendValue='' appendName='Updated' collectField2='id' noSelection="['': 'Please choose Continent']" />

 <bo:selecta id="MyCountry11" name="MyCountry11"
 job= "job2" user="randomUser2" domainDepth="0" setId="MyCity11"
 domain2='ajaxdependancyselectexample.MyCity' bindid="" searchField2='cityName' collectField2='id'
 formatting="JSON" appendValue=''  appendName='Updated' noSelection="['': 'Please choose Continent']" />

 name="MyCity11" id="MyCity11" job= "job2" user="randomUser2" domainDepth="0" setId="MyShop12" 
 domain2='ajaxdependancyselectexample.MyShops' bindid="" searchField2='shopName' collectField2='id'
 appendValue='' appendName='Updated' formatting="JSON" noSelection="['': 'Please choose Country 1111']"/>

 name="MyShop12" id="MyShop12" optionKey="id" optionValue="shopName" 
 from="[]" required="required" noSelection="['': 'Please choose City']" 
 <g:submitButton name="submit"/>  

Example 3: Defined pre selected values across multiple objects + randomized user within gsp

Example 4: Defined pre selected values across less multiple objects + randomized user within controller

Example 5: Defined pre selected values same as example3 but with JSON return object

Example 6: Multiple relationship per domainClass example i.e. object1 has many up to Xth relations with object2 3 4..XXX

Example 7: applicable to all methods - reuse of the taglib multiple times on the same page

Example 8: No reference or loose dependency relation between a secondary called object and the next domainClass

Example 9: No reference relationship with secondary object that then returns back into a normal relationship object

Example 10: Primary object with a No reference relationship

Example 11: Auto complete a few hasMany to a noref relation Using the same Tag to acheive autoComplete In this example (not on actual link, the user is being defined as a variable and reused - this now makes it a dynamic user but same on that one page.

The difference with this call and select is that as you can see on the first example it has autoComplete="true" and if this is the primary object then also autoCompletePrimary="true", if second object it just needs the first tag. Follow example below.. There are two additional fields hiddenField and jsonField. In autoComplete, the results are returned from html5 dataList. I have added data-value and parse that into the hidden field for jsonField and hiddenField gets set to the or collectField of the value selected. The rest is like above.

<% def myuser = bo.randomizeUser('user': 'random1') %>

<bo:connect user="${myuser}" job="job3"/>

<form action="example5">

    autoComplete="true" autoCompletePrimary="true" 
    job="job3" user="${myuser}" id="MyContinent2" name="MyContinent2" setId="MyCountry11" 
    hiddenField="VahidHidden_" jsonField="VahidJSON_" formatting="JSON"
    domain='ajaxdependancyselectexample.MyContinent' searchField='continentName' collectField='id'
    domain2='ajaxdependancyselectexample.MyCountry' bindid="" 
    searchField2='countryName' collectField2='id' />
	job="job3" user="${myuser}" id="MyCountry11" name="MyCountry11" 
	hiddenField="NextHidden_" jsonField="NextJSON_" formatting="JSON"
	domain2='ajaxdependancyselectexample.MyCity' bindid=""
	searchField2='cityName' collectField2='id' setId="MyCity11" />
	job="job3" user="${myuser}" formatting="JSON"
	name="MyCity11" id="MyCity11" 
	hiddenField="myHidden_" jsonField="myJSON_"
	domain2='ajaxdependancyselectexample.MyShops' searchField2='shopName' collectField2='id' 
	bindid=""  setId="secondarySearch4" 
    	job= "job121" user="${myuser }"	formatting="JSON" id="secondarySearch4" name="NAMEOFBorough"  
	hiddenField="myHidden_" jsonField="myJSON_"
	domain2='ajaxdependancyselectexample.MyBorough' searchField='actualName' collectField='id' 
	bindid='myborough' value=''
    <input type=submit value=go>

Example 12: Select To AutoComplete

Example 13:AutoComplete To Select

Example 14: AutoComplete To Select from select to another select