Editing GWT (section)

==Development==

===Development Environment===
The same as [[GAE#Development_Environment|Google Application Engine Environment]]. Under the hood there is:

* GWT Java Compiler
* GWT Shell
** logging console
** embedded Tomcat Server
** hosted mode browser (in contrast to normal ''web'' mode)

===Development Process===

====New Project====
Directoy structure (Details see [http://code.google.com/intl/de-DE/webtoolkit/doc/latest/DevGuideOrganizingProjects.html#DevGuideDirectoriesPackageConventions here]):

 <Project>/
   src/
     <Project>/
       [[GWT#The_module_XML_file|<Project>.gwt.xml]]
       client/
         [[GWT#Module_Class|<Project>.java]]
   war/
     [[GWT#Host_Page|<Project>.html]]
     [[GWT##Application_Style_Sheet|<Project>.css]]

====Specific Configuration Files====

=====The module XML file=====
It contains the definition of the GWT module, the collection of resources that comprise a GWT application or a shared package. In the module XML file, you specify your application's [[#Entry_Point_Class|entry point class]]. In order to compile, a GWT module must specify an entry point. If a GWT module has no entry point, then it can only be inherited by other modules. It is possible to include other modules that have entry points specified in their module XML files. If so, then your module would have multiple entry points. Each entry point is executed in sequence.

=====Host Page=====
The code for a web application executes within an HTML document. In GWT, we call this the host page. The host page references the application style sheet and references the path of JavaScript source code (generated by GWT) responsible for the dynamic elements on the page. The contents of the entire body element can be generated dynamically.


=====Entry Point Class=====
An entry point class (module class) is a simple client-side class that implements the com.google.gwt.core.client.EntryPoint interface, which defines a single method: onModuleLoad().

=====Application Style Sheet=====

====Implementation====

=====Service Definition=====

 @RemoteServiceRelativePath("login")
 '''public''' '''interface''' MyService
   '''extends''' com.google.gwt.user.client.rpc.RemoteService
 {
   ...
 }

Services are technically servets. That's why the RemoteServiceRelativePath annotations contains the are name which also has to be configured in the web.xml file in the servlet mapping section.

=====Service Implementation=====
 '''public class''' MyServiceImpl 
   '''extends''' RemoteServiceServlet 
   '''implements''' MyService
 {
   ...
 }

Adjust [[GAE#New_Project|web.xml]]:

  <servlet>
    <servlet-name>MyService</servlet-name>  
    <servlet-class><package>.MyServiceImpl</servlet-class>
  </servlet>

  <servlet-mapping>
    <servlet-name>MyService</servlet-name>
    <url-pattern>/service</url-pattern>
  </servlet-mapping>

====Run/Debug Project====

=====Run=====
*''Project Context Menu -> Run As -> Web Application'' or
*''Project Context Menu -> Run As -> Run Configuration -> Web Application -> <Projectname>''
*Copy URL from Development Console and paste in browser (first time on computer will ask to install Google Web Toolkit Developer Plugin)