java jxl 多页签_多窗口（页签）管理器

缺乏、安全感 2022-11-09 12:30 191阅读 0赞

引入原因

为了支持钻取、多屏联动等需求，必须能够对同属于平台界面的多个浏览器窗口(或多个浏览器页签)进行管理和通信，基于此引入了多窗口管理器WinMan。

引入方式

通常情况下，无需额外引入额外的脚本文件。

WinMan的脚本文件被自动加入到了装饰器的所有模板(包括缺省模板和嵌入模板)中，因此无需手动引入。

注意：如果在无装饰器的页面使用，则需要手工引入WinMan。

依赖

WinMan使用了HTML5规范的localStorage来存储窗口信息，以及postMessage在多个窗口间进行通信，因此必须使用现代浏览器才能够正常使用多窗口管理功能。

如果想了解这些实现技术，可参考：

工作机制与约定

主窗口

第一个打开的平台页面的窗口被自动认定为主窗口。

区别于主窗口，之后打开的窗口都成为子窗口，当主窗口关闭后或重新登录(进入登录页面)时，所有子窗口都会被自动关闭。

识别窗口

窗口通过window.name的值来识别，主窗口的window.name被自动设置为mainWindow，子窗口的window.name则由打开人负责在打开窗口时设置(不可能再使用mainWindow)，如果不设置，则有WinMan随机生成。

window.name是窗口的唯一标识符，是重要的属性，WinMan的绝大多数功能都需要此值来定位窗口。

窗口的创建

不论是通过何种方法创建的窗口，如：点击界面弹出的新窗口

通过浏览器的在新窗口或新标签页打开功能打开的窗口

手动在浏览器中打开的新窗口，并输入了平台页面的URL

只要显示的是平台的页面，且页面使用了带有WinMan的装饰器或者手工引入了WinMan，则此窗口可会被WinMan自动管理起来。

窗口信息

每当有窗口创建时，WinMan就会将此窗口的相关信息保存都localStorage中，这些信息包括：name - string，窗口的window.name

title - string，窗口当前的Title值，会随浏览实时更新

url - string，窗口当前的URL地址，会随浏览实时更新

heartbeat - long，窗口心跳时间，即最近活动时间

closed - bool，是否已关闭，可能不存在

窗口的关闭与销毁

window对象可以监听unload事件，但此事件并不像字面理解的那样，仅在窗口关闭时才产生，当浏览器的URL地址发生变化，页面即将转向新的页面时，同样会出发此事件。因此我们无法准确的判定窗口是否被关闭。因此对于窗口存活性的管理，只能够降级处理，我们引入了窗口心跳。

窗口心跳

即当窗口存活时，子窗口自动向主窗口发送心跳，同时更新title

url

heartbeat

的属性值。

而主窗口会不停地轮询(默认间隔5秒)所有已经记录的窗口信息，如果发现某个窗口的心跳时间已经有3个轮询窗口没有更新，则判定此窗口已经关闭，并设置此窗口信息的closed属性为true。

各个子窗口在发送心跳的同时，也会检测主窗口是否存活，如果发现主窗口已经关闭，则会在数秒后自动关闭。

当检测到窗口关闭后，窗口信息并不会被销毁，而仅标记为已关闭。

窗口信息的清除

如上述，由于无法准确的判断窗口关闭事件，因此无法在关闭窗口后清理存储在localStorage中的窗口信息，容易产生脏数据。

为了尽可能减少脏数据的影响，我们采用了这种的方案，在显示登录页面时，清除掉localStorage中存储的窗口信息。

API

获取实例

window.WinMan

所有窗口管理器的调用都需要以此为起点，WinMan为单例。

获取所有窗口信息

var object = window.WinMan.getWindowsInfo()

object为普通的Object对象，key为窗口名称；value为窗口信息对象，对象结构详见获取窗口信息。

返回结果既包含当前存活的窗口，也包含已经关闭的窗口。区分是否为已经关闭的窗口，可检查窗口信息对象中是否含有closed属性，且属性值为true。

获取当前打开窗口信息

var object = window.WinMan.getOpenWindowsInfo()

object结果与获取所有窗口信息相同，但仅包含当前仍然存活的窗口。

获取窗口信息

var object = window.WinMan.getWindowInfo(name)

object为普通Object对象，包含的属性包括：name - 窗口名称

title - 当前窗口标题，随窗口内浏览页面的变化而随之变化

url - 当前窗口内页面的URL地址，随窗口浏览页面的变化而随之变化

heartbeat - 心跳时间，即最后一次侦测到此窗口存活的时间，long型表示

closed - 窗口实例是否已经关闭，属性存在且为true时，则表示已经关闭；否则则表示尚未关闭

获取窗口实例对象

var win = window.WinMan.getWindowInstance(name)

win即为窗口的Javascript对象。

打开新窗口

window.WinMan.openWindow(url, name, features)

使用url打开一个名为name的新窗口，窗口的属性由features指定。如果名为name的窗口已经存在，则直接在存在的窗口中打开url。

注：目前此接口仅对window.open方法进行了封装，无附加操作。

关闭窗口

window.WinMan.closeWindow(name)

如果名为name的窗口为存活状态，则关闭之。

注册命令处理器

window.WinMan.registerCmdHandler(cmd, handler)

用于在存活的窗口中注册一个命令处理器，用于接收到命令消息时，执行特定的操作。参数说明：cmd - string，命令。如果已经注册过相同命令的处理器，则使用新的覆盖

handler - function，命令处理器函数，此函数可以接收参数，参数长度不少于1。第一个参数为发出命令的源窗口window实例，其余参数则在调用sendMessage命令时传入

此接口仍然返回WinMan对象，也就是说此方法支持链式调用，即

window.WinMan.registerCmdHandler('cmd1', handler1).registerCmdHanddler('cmd2', handler2)

发送消息

window.WinMan.sendMessage(name, message)

用于向存活的窗口发送命令，执行特定的操作。参数说明：name - string，目标窗口名称

message - object，消息体，结构为

cmd - string，命令，必需

arguments - array，命令处理函数所需的额外参数

创建消息对象

window.WinMan.createMessage(cmd, args...)

方便快速创建消息体参数。

提供一个记录窗口创建的例子来更直观地说明注册命令处理器、发送消息和创建消息对象的用法。可以在主窗口添加以下代码

window.WinMan.registerCmdHandler('log', function(sourceWindow, content) \{

content && console && console.debug(content);

\})

在任意新打开的窗口的页面添加以下代码

window.WinMan.sendMessage('mainWindow', window.WinMan.createMessage('log', 'New window\[' + window.name + '\] has been created @' + new Date() + '.'));

这样，当一个新的窗口打开后，就可以在调试工具控制台看到一条日志记录了。

java jxl 多页签_多窗口（页签）管理器

发表评论取消回复

还没有评论，来说两句吧...

相关阅读

相关 java后台给pfd文件指定单页或多页签章

相关【Vue】页签的常用写法

相关 IDEA快捷键、字体、多页签设置

相关 java jxl 多页签_多窗口（页签）管理器

相关 scala 使用jxl导出多sheet页

相关分页下方页签的显示

相关 vue-multi-tab--一个让你在SPA里使用多页签的框架页

相关 secureCRT同一个窗口打开多个页签

相关页签中加按钮 odoo里面

相关 vue-multi-tab--一个让你在SPA里使用多页签的框架页