Quick Start Guide

This instruction explains minimal set of steps you should do to start working with the library. For more detailed instructions and how-to dcoumentation please visit the FAQ page.

If you are a newcomer in GWT programming please click this link first.

So to make it work do the next steps:

  • Include advanced-components-X.X.X.jar in the classpath of your GWT application, where X.X.X is a version number of the library.
  • Make an inheritance link to the library module

<module>

    <inherits name='com.google.gwt.user.User'/>
    <inherits name='org.gwt.advanced.Grid'/>

    <entry-point class='mypackage.Test'/>

</module>
  • Create the mypackage.Test entry point and type the following code in the body of the onModuleLoad() method

//create a new model containing employees
Editable model = new EditableGridDataModel(
    new Object[][] {
        new String[]{"John", "Doe"},
        new String[]{"Piter", "Walkman"},
        new String[]{"Rupert", "Brown"}
    }
);

// create a new grid of employees
GridPanel panel = new GridPanel();
    panel.createEditableGrid(
        new String[]{"First Name", "Surname"},
        new Class[]{LabelCell.class, LabelCell.class},
        null
    ).setModel(model);

RootPanel.get().add(panel);
This code creates one grid containing a list of employees. All columns are sortable and all cells are editable. But this sample doesn't send data to an RPC service to persist it. So, it's just a simple client side application.
  • Create the index.htmlfile in the public folder.

<html>
<head>
    <title>Advanced GWT Components Demo Application</title>
    <meta name='gwt:module' content='org.gwt.advanced.Demo'>
    <link id="advancedTheme" type="text/css" rel="stylesheet" href="./advanced/themes/default/theme.css"/>
    <link type="text/css" rel="stylesheet" href="css/demo.css"/>
</head>
<body>
<script language="javascript" src="org.gwt.advanced.Demo.nocache.js"></script>
<iframe id="__gwt_historyFrame" style="width:0;height:0;border:0"></iframe>
</body>
</html>
  • IMPORTANT NOTE. If you do not use Maven to compile GWT projects, you might also need to add the following line into .gwt.xml file.
<stylesheet src="advanced/themes/default/theme.css"/>    
  • Now compile the entry point and deploy WAR file
  • Open your favorite browser and type something like http://localhost:8080/mypackage.Test/. The host name and port number may be different.

If your project utilizes Maven, you can also add the following dependency:

    

<dependency>
     <groupId>net.sf.advanced-gwt</groupId>
     <artifactId>advanced-gwt</artifactId>
     <version>X.X.X</version>
     <scope>provided</scope>
</dependency>