匿名访问界面 - CUBA 框架开发者手册

3.5.20. 匿名访问界面

默认情况下，匿名（未认证）用户会话只能访问登录界面。通过扩展登录界面，可以在界面上添加任何信息，甚至添加 WorkArea 组件，然后便能在该组件内为匿名用户打开其它界面。但是一旦用户登录了，所有在匿名模式下打开的界面都会关闭。

有时也许我们需要将某些应用程序的界面呈现给用户而无论用户是否进行登录认证。比如下面这个需求：

当用户打开应用程序，他们能看见欢迎界面.
还有一个信息界面，提供公共访问的信息。信息界面必须在最高层的界面窗口展示，比如，不带主菜单和其它主窗口的控制。
用户可以从欢迎界面或者直接通过浏览器输入 URL 打开信息界面。
还有，用户需要能从欢迎界面跳转到登录界面并以认证用户的身份继续在系统里操作。

下面我们看看实现步骤。

创建信息界面并使用 @Route 注解其控制器类，提供能使用链接方式打开的功能：

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<window xmlns="http://schemas.haulmont.com/cuba/screen/window.xsd"
        caption="msg://caption"
        messagesPack="com.company.demo.web.info">
    <layout margin="true">
        <label value="Info" stylename="h1"/>
    </layout>
</window>

package com.company.demo.web.info;

import com.haulmont.cuba.gui.Route;
import com.haulmont.cuba.gui.screen.*;

@UiController("demo_InfoScreen")
@UiDescriptor("info-screen.xml")
@Route(path = "info") (1)
public class InfoScreen extends Screen {
}

1	- 指定该界面的地址。当该界面在最高层打开的时候，地址栏会显示类似 `http://localhost:8080/app/#info` 的地址。

在项目中扩展默认的主界面，以实现需要的欢迎界面。在 Studio 的界面创建向导中使用 Main screen … 中的一种作为模板，然后在 initialLayout 元素中添加一些组件，示例：

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<window xmlns="http://schemas.haulmont.com/cuba/screen/window.xsd"
        xmlns:ext="http://schemas.haulmont.com/cuba/window-ext.xsd"
        extends="/com/haulmont/cuba/web/app/main/main-screen.xml">
    <layout>
        <hbox id="horizontalWrap">
            <workArea id="workArea">
                <initialLayout>
                    <label id="welcomeLab" stylename="h1" value="Welcome!"/>
                    <button id="openInfoBtn" caption="Go to Info screen"/>
                </initialLayout>
            </workArea>
        </hbox>
    </layout>
</window>

package com.company.demo.web.main;

import com.company.demo.web.info.InfoScreen;
import com.haulmont.cuba.gui.Screens;
import com.haulmont.cuba.gui.components.Button;
import com.haulmont.cuba.gui.screen.*;
import com.haulmont.cuba.web.app.main.MainScreen;

import javax.inject.Inject;

@UiController("main")
@UiDescriptor("ext-main-screen.xml")
public class ExtMainScreen extends MainScreen {

    @Inject
    private Screens screens;

    @Subscribe("openInfoBtn")
    private void onOpenInfoBtnClick(Button.ClickEvent event) {
        screens.create(InfoScreen.class, OpenMode.ROOT).show(); (1)
    }
}

1	- 创建 `信息界面` 并且在用户点击按钮时在根窗口打开。

为了实现在用户进入应用程时打开欢迎界面而非登录界面，需要在 web-app.properties 文件添加以下属性：
cuba.web.initialScreenId = main cuba.web.allowAnonymousAccess = true
为匿名用户启用信息界面：启动应用程序，打开 Administration - 管理 > Roles - 角色，在角色编辑器创建 Anonymous 角色，然后为该角色开启能访问信息界面的权限。之后，将这个角色分配给 anonymous 用户。

最后，当用户打开应用程序时，他们能看到欢迎界面：

welcome_screen

用户不需要认证也能打开信息界面，或者点击登录按钮访问应用程序的安全部分。