📜  GWT-历史课程

📅  最后修改于: 2020-10-25 04:46:18             🧑  作者: Mango


GWT应用程序通常是运行JavaScript的单页应用程序,并且不包含很多页面,因此浏览器无法跟踪用户与应用程序的交互。要使用浏览器的历史记录功能,应用程序应为每个可导航页面生成唯一的URL片段。

GWT提供了历史机制来处理这种情况。

GWT使用术语令牌,该令牌只是应用程序可以解析以返回特定状态的字符串。应用程序会将此标记作为URL片段保存在浏览器的历史记录中。

例如,将名为“ pageIndex1”的历史记录令牌添加到URL,如下所示:

http://www.tutorialspoint.com/HelloWorld.html#pageIndex0

历史管理工作流程

第1步-启用历史记录支持

为了使用GWT历史记录支持,我们必须首先将以下iframe嵌入到我们的宿主HTML页面中。


第2步-将令牌添加到历史记录

以下示例统计信息如何将令牌添加到浏览器历史记录

int index = 0;
History.newItem("pageIndex" + index);    

第3步-从历史记录中检索令牌

当用户使用浏览器的前进/后退按钮时,我们将检索令牌并相应地更新我们的应用程序状态。

History.addValueChangeHandler(new ValueChangeHandler() {
   @Override
   public void onValueChange(ValueChangeEvent event) {
      String historyToken = event.getValue();
      /* parse the history token */
      try {
         if (historyToken.substring(0, 9).equals("pageIndex")) {
            String tabIndexToken = historyToken.substring(9, 10);
            int tabIndex = Integer.parseInt(tabIndexToken);
            /* select the specified tab panel */
            tabPanel.selectTab(tabIndex);
         } else {
            tabPanel.selectTab(0);
         }
      } catch (IndexOutOfBoundsException e) {
         tabPanel.selectTab(0);
      }
   }
});    

现在,让我们看一下历史记录类的实际应用。

历史课-完整示例

本示例将带您通过简单的步骤来演示GWT应用程序的历史记录管理。请按照以下步骤更新我们在GWT-创建应用程序一章中创建的GWT应用程序

Step Description
1 Create a project with a name HelloWorld under a package com.tutorialspoint as explained in the GWT – Create Application chapter.
2 Modify HelloWorld.gwt.xml, HelloWorld.css, HelloWorld.html and HelloWorld.java as explained below. Keep rest of the files unchanged.
3 Compile and run the application to verify the result of the implemented logic.

以下是修改后的模块描述符src / com.tutorialspoint / HelloWorld.gwt.xml的内容



   
   

   
   

   
     
   
   
   


以下是修改后的样式表文件war / HelloWorld.css的内容

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;
}

以下是修改后的HTML主机文件war / HelloWorld.html的内容

Hello World
      
      
   
   
   
      
      

History Class Demonstration

让我们拥有Java文件src / com.tutorialspoint / HelloWorld.java的以下内容,我们将使用这些内容演示GWT代码中的历史记录管理。

package com.tutorialspoint.client;

import com.google.gwt.core.client.EntryPoint;

import com.google.gwt.event.logical.shared.SelectionEvent;
import com.google.gwt.event.logical.shared.SelectionHandler;
import com.google.gwt.event.logical.shared.ValueChangeEvent;
import com.google.gwt.event.logical.shared.ValueChangeHandler;

import com.google.gwt.user.client.History;
import com.google.gwt.user.client.ui.HTML;
import com.google.gwt.user.client.ui.RootPanel;
import com.google.gwt.user.client.ui.TabPanel;

public class HelloWorld implements EntryPoint {

   /**
    * This is the entry point method.
    */
   public void onModuleLoad() {
      /* create a tab panel to carry multiple pages */  
      final TabPanel tabPanel = new TabPanel();

      /* create pages */
      HTML firstPage = new HTML("

We are on first Page.

"); HTML secondPage = new HTML("

We are on second Page.

"); HTML thirdPage = new HTML("

We are on third Page.

"); String firstPageTitle = "First Page"; String secondPageTitle = "Second Page"; String thirdPageTitle = "Third Page"; tabPanel.setWidth("400"); /* add pages to tabPanel*/ tabPanel.add(firstPage, firstPageTitle); tabPanel.add(secondPage,secondPageTitle); tabPanel.add(thirdPage, thirdPageTitle); /* add tab selection handler */ tabPanel.addSelectionHandler(new SelectionHandler() { @Override public void onSelection(SelectionEvent event) { /* add a token to history containing pageIndex History class will change the URL of application by appending the token to it. */ History.newItem("pageIndex" + event.getSelectedItem()); } }); /* add value change handler to History this method will be called, when browser's Back button or Forward button are clicked and URL of application changes. */ History.addValueChangeHandler(new ValueChangeHandler() { @Override public void onValueChange(ValueChangeEvent event) { String historyToken = event.getValue(); /* parse the history token */ try { if (historyToken.substring(0, 9).equals("pageIndex")) { String tabIndexToken = historyToken.substring(9, 10); int tabIndex = Integer.parseInt(tabIndexToken); /* select the specified tab panel */ tabPanel.selectTab(tabIndex); } else { tabPanel.selectTab(0); } } catch (IndexOutOfBoundsException e) { tabPanel.selectTab(0); } } }); /* select the first tab by default */ tabPanel.selectTab(0); /* add controls to RootPanel */ RootPanel.get().add(tabPanel); } }

准备好所有更改后,让我们像在GWT-创建应用程序一章中那样,以开发模式编译和运行应用程序。如果您的应用程序一切正常,这将产生以下结果-

GWT历史演示

  • 现在,单击每个选项卡以选择不同的页面。

  • 您应该注意到,当选择每个选项卡时,将更改应用程序URL并将#pageIndex添加到该URL。

  • 您还可以看到浏览器的后退和前进按钮现已启用。

  • 使用浏览器的前进和后退按钮,您将看到相应地选择了不同的选项卡。