WingsBuilder is a Groovy builder for the wingS Framework

Contribution Overview

You can use WingSBuilder in the same fashion as Swing Builder. Most of the constructs provided by the original SwingBuilder are supported in WingSBuilder, thanks to the efforts of the wingS team in following the Swing model very closely. WingSBuilder also supports wingS specific components and the ability to attach your own components through widget() and container().

The following is an example of WingSBuilder in action

class GuessingGame {
   GuessingGame(){
      def randomNr = (new Random().nextInt(10) + 1) as String
      def builder = new WingSBuilder()

      /* STitledBorder was removed in wings-3.1
      def border = SBorderFactory.createSTitledBorder(
                    SBorderFactory.createSLineBorder([0,0,255] as Color, 2),
                    "Guessing Game")
      */
      def border = SBorderFactory.createSLineBorder([0,0,255] as Color, 2)
      def font = new SFont( null, SFont.BOLD, 14 )

      def frame = builder.frame( title: "Guessing Game" ) {
         panel( border: border){
            gridLayout( columns: 1, rows: 5, vgap: 10)
            label("Hello World - this is wingS (+WingSBuilder&Groovy)!",
                  font: font)
            label("We want fun, so let's play a game!" +
                  "Try to guess a number between 1 and 10.")
            textField( id: "answer" )
            button( text: "Guess!", actionPerformed: { event ->
               def value = builder.answer.text
               if( value == randomNr ){
                  builder.message.text = "Congratulations! You guessed my number!"
               }else{
                  builder.message.text = "No - '${value}' is not the right number. Try again!"
               }
            })
            label( id: "message" )
         }
      }

      frame.visible = true
   }
}

Which is rendered in FireFox as

Team Members

Andres Almiray [aalmiray at users dot sourceforge dot net]

Download

wingsbuilder-1.0

Installing

Just drop the wingsbuilder jar file along with its dependencies into your weabpp's lib directory.

Pre-requisites

WingS 3.1 and Groovy 1.5 are required to run WingSBuilder.

Documentation

Alphabetical list of SwingBuilder compatible components

Alphabetical list of WingS specific components

Alphabetical list of WingX specific components

Developers

Andres Almiray

Source Control

http://svn.codehaus.org/groovy-contrib/wingsbuilder

Building

WingSBuilder uses Maven2 as its build tool, which means that if you want to
build your own version of WingSBuilder from source you'll need to have it
installed.  Follow the instructions at http://maven.apache.org
Once Maven2 is installed you will also need to install 2 files from the wingS
distribution (but it wouldn't hurt to check at http://mvnrepository.org
if they are already there). The files are:

   wings-3.1.jar
   wingx-3.1.jar

If the files are not found in any Maven2 repository the you'll need to
download the source from http://wingsframework.org, follow the compile &
install instructions, the jars should be at build/web/WEB-INF/lib
Install them on your local Maven2 repo with the following command

 mvn install:installFile -DgroupId=org.wings -Dversion=3.1 -Dpackaging=jar \
     -DartifactId=<depname> -Dfile=<jarfile>

where 'depname' is any of [wings, wingx] with its corresponding jarfile

Contributing

Please contact the team members by e-mail.

Community

Mailing List(s)

http://groovy.codehaus.org/Mailing+Lists

Issue tracker

http://jira.codehaus.org/secure/BrowseProject.jspa?id=10242