GWT 应用程序组成

精华

小牛编辑

195浏览

2023-03-14

GWT应用程序组成部分

在我们开始使用 GWT 创建实际的“HelloWorld”应用程序之前，让我们看看 GWT 应用程序的实际部分包含哪些：

GWT 应用程序由以下四个重要部分组成，其中最后一部分是可选的，但前三部分是强制性的。

模块描述符
公共资源
客户端代码
服务端代码

典型 gwt 应用程序HelloWord不同部分的示例位置如下所示：

名称	描述
项目根目录	HelloWorld/
模块描述符	src/com/xnip/HelloWorld.gwt.xml
公共资源	src/com/xnip/war/
客户端代码	src/com/xnip/client/
服务端代码	src/com/xnip/server/

模块描述符

模块描述符是 XML 形式的配置文件，用于配置 GWT 应用程序。

模块描述符文件扩展名为 *.gwt.xml，其中 * 是应用程序的名称，该文件应位于项目的根目录中。

以下将是 HelloWorld 应用程序的默认模块描述符 HelloWorld.gwt.xml

<?xml version = "1.0" encoding = "utf-8"?>
<module rename-to = 'helloworld'>
   <!-- inherit the core web toolkit stuff.                        -->
   <inherits name = 'com.google.gwt.user.user'/>

   <!-- inherit the default gwt style sheet.                       -->
   <inherits name = 'com.google.gwt.user.theme.clean.Clean'/>

   <!-- specify the app entry point class.                         -->
   <entry-point class = 'cn.xnip.client.HelloWorld'/>

   <!-- specify the paths for translatable code                    -->
   <source path = '...'/>
   <source path = '...'/>

   <!-- specify the paths for static files like html, css etc.     -->
   <public path = '...'/>
   <public path = '...'/>

   <!-- specify the paths for external javascript files            -->
   <script src = "js-url" />
   <script src = "js-url" />

   <!-- specify the paths for external style sheet files            -->
   <stylesheet  src = "css-url" />
   <stylesheet  src = "css-url" />
</module>

以下是有关模块描述符中使用的不同部分的简要详细信息。

节点名称	描述
<module rename-to = "helloworld">	应用程序的名称。
<inherits name = "logical-module-name" />	应用程序中添加了其他 gwt 模块，就像在 java 应用程序中所做的一样。可以通过这种方式继承任意数量的模块。
<entry-point class = "classname" />	指定将开始加载 GWT 应用程序的类的名称。可以添加任意数量的入口点类，并按照它们在模块文件中出现的顺序依次调用它们。因此，当您的第一个入口点的 onModuleLoad() 完成时，将立即调用下一个入口点。
<source path = "path" />	指定了 GWT 编译器将搜索源编译的源文件夹的名称。
<public path = "path" />	公共路径是项目中存储 GWT 模块引用的静态资源（例如 CSS 或图像）的位置。默认公共路径是存储模块 XML 文件的公共子目录。
<script src="js-url" />	自动注入位于 src 指定位置的外部 JavaScript 文件。
<stylesheet src="css-url" />	自动注入位于 src 指定位置的外部 CSS 文件。

公共资源

这些是 GWT 模块引用的所有文件，例如 Host HTML 页面、CSS 或图像。

可以使用模块配置文件中的 <public path = "path" /> 元素配置这些资源的位置。默认情况下，它是存储模块 XML 文件的公共子目录。

当您将应用程序编译为 JavaScript 时，可以在公共路径上找到的所有文件都将复制到模块的输出目录中。

最重要的公共资源是用于调用实际 GWT 应用程序的主机页面。应用程序的典型 HTML 主机页面可能根本不包含任何可见的 HTML 正文内容，但始终希望通过 <script.../> 标记包含 GWT 应用程序，如下所示：

<html>
   <head>
      <title>Hello World</title>
      <link rel = "stylesheet" href = "HelloWorld.css"/>
      <script language = "javascript" src = "helloworld/helloworld.nocache.js">
      </script>
   </head>
   
   <body>
      <h1>Hello World</h1>
      <p>Welcome to first GWT application</p>
   </body>
</html>

以下是我们包含在我们的主机页面中的示例样式表：

body {
   text-align: center;
   font-family: verdana, sans-serif;
}

h1 {
   font-size: 2em;
   font-weight: bold;
   color: #777777;
   margin: 40px 0px 70px;
   text-align: center;
}

客户端代码

这是为实现应用程序的业务逻辑而编写的实际 Java 代码，GWT 编译器将其转换为 JavaScript，最终将在浏览器中运行。这些资源的位置可以使用模块配置文件中的 <source path = "path" /> 元素进行配置。

例如，入口点代码将用作客户端代码，其位置将使用 <source path = "path" /> 指定。

模块入口点是任何可分配给EntryPoint并且可以在没有参数的情况下构造的类。当一个模块被加载时，每个入口点类都会被实例化，并且它的EntryPoint.onModuleLoad()方法被调用。示例 HelloWorld 入口点类如下：

public class HelloWorld implements EntryPoint {
   public void onModuleLoad() {
      Window.alert("Hello, World!");
   }
}

服务器端代码

这是您的应用程序的服务器端部分，它非常可选。如果您不在应用程序中进行任何后端处理，那么您不需要这部分，但是如果后端需要一些处理并且您的客户端应用程序与服务器交互，那么您将必须开发这些组件。