--- title: Handling Browser Windows order: 1 layout: page --- [[advanced.windows]] = Handling Browser Windows The UI of a Vaadin application runs in a web page displayed in a browser window or tab. An application can be used from multiple UIs in different windows or tabs, either opened by the user using an URL or by the Vaadin application. In addition to native browser windows, Vaadin has a [classname]#Window# component, which is a floating panel or __sub-window__ inside a page, as described in <>. * __Native popup windows__. An application can open popup windows for sub-tasks. * __Page-based browsing__. The application can allow the user to open certain content to different windows. For example, in a messaging application, it can be useful to open different messages to different windows so that the user can browse through them while writing a new message. * __Bookmarking__. Bookmarks in the web browser can provide an entry-point to some content provided by an application. * __Embedding UIs__. UIs can be embedded in web pages, thus making it possible to provide different views to an application from different pages or even from the same page, while keeping the same session. See <>. Use of multiple windows in an application may require defining and providing different UIs for the different windows. The UIs of an application share the same user session, that is, the [classname]#VaadinSession# object, as described in <>. Each UI is identified by a URL that is used to access it, which makes it possible to bookmark application UIs. UI instances can even be created dynamically based on the URLs or other request parameters, such as browser information, as described in <>. Because of the special nature of AJAX applications, use of multiple windows uses require some caveats. //// TODO Re-enable We will go through them later in <xref linkend="advanced.windows.caveats"/>. //// [[advanced.windows.popup]] == Opening Pop-up Windows ((("popup windows"))) ((("windows", "popup"))) Pop-up windows are native browser windows or tabs opened by user interaction with an existing window. Due to browser security reasons, it is made inconvenient for a web page to open popup windows using JavaScript commands. At the least, the browser will ask for a permission to open the popup, if it is possible at all. This limitation can be circumvented by letting the browser open the new window or tab directly by its URL when the user clicks some target. This is realized in Vaadin with the [classname]#BrowserWindowOpener# component extension, which causes the browser to open a window or tab when the component is clicked. [[advanced.windows.popup.ui]] === The Pop-up Window UI A popup Window displays an [classname]#UI#. The UI of a popup window is defined just like a main UI in a Vaadin application, and it can have a theme, title, and so forth. For example: [source, java] ---- @Theme("book-examples") public static class MyPopupUI extends UI { @Override protected void init(VaadinRequest request) { getPage().setTitle("Popup Window"); // Have some content for it VerticalLayout content = new VerticalLayout(); Label label = new Label("I just popped up to say hi!"); label.setSizeUndefined(); content.addComponent(label); content.setComponentAlignment(label, Alignment.MIDDLE_CENTER); content.setSizeFull(); setContent(content); } } ---- [[advanced.windows.popup.popping]] === Popping It Up A popup window is opened using the [classname]#BrowserWindowOpener# extension, which you can attach to any component. The constructor of the extension takes the class object of the UI class to be opened as a parameter. You can configure the features of the popup window with [methodname]#setFeatures()#. It takes as its parameter a comma-separated list of window features, as defined in the HTML specification. status=[parameter]#0|1#:: Whether the status bar at the bottom of the window should be enabled. [parameter]##:: scrollbars:: Enables scrollbars in the window if the document area is bigger than the view area of the window. resizable:: Allows the user to resize the browser window (no effect for tabs). menubar:: Enables the browser menu bar. location:: Enables the location bar. toolbar:: Enables the browser toolbar. height=[parameter]#value#:: Specifies the height of the window in pixels. width=[parameter]#value#:: Specifies the width of the window in pixels. For example: [source, java] ---- // Create an opener extension BrowserWindowOpener opener = new BrowserWindowOpener(MyPopupUI.class); opener.setFeatures("height=200,width=300,resizable"); // Attach it to a button Button button = new Button("Pop It Up"); opener.extend(button); ---- The resulting popup window, which appears when the button is clicked, is shown in <>. [[figure.advanced.windows.popup.popping]] .A Popup Window image::img/windows-popup.png[] [[advanced.windows.popup.target]] === Popup Window Name (Target) The target name is one of the default HTML target names ( [parameter]#_new#, [parameter]#_blank#, [parameter]#_top#, etc.) or a custom target name. How the window is exactly opened depends on the browser. Browsers that support tabbed browsing can open the window in another tab, depending on the browser settings. [[advanced.windows.popup.url]] === URL and Session The URL path for a popup window UI is by default determined from the UI class name, by prefixig it with " [literal]#++popup/++#". For example, for the example UI giver earlier, the URL would be [literal]#++/book-examples/book/popup/MyPopupUI++#. [[advanced.windows.popup-closing]] == Closing Popup Windows Besides closing popup windows from a native window close button, you can close them programmatically by calling the JavaScript [methodname]#close()# method as follows. [source, java] ---- public class MyPopup extends UI { @Override protected void init(VaadinRequest request) { setContent(new Button("Close Window", event -> {// Java 8 // Close the popup JavaScript.eval("close()"); // Detach the UI from the session getUI().close(); })); } } ---- lidate_keychecksum Nextcloud server, a safe home for all your data: https://github.com/nextcloud/serverwww-data
aboutsummaryrefslogtreecommitdiffstats
blob: bf36bf5d5c191c335d91ec1a9a27dbf424d088c9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
<?php
/**
 * SPDX-FileCopyrightText: 2017-2024 Nextcloud GmbH and Nextcloud contributors
 * SPDX-FileCopyrightText: 2016 ownCloud, Inc.
 * SPDX-License-Identifier: AGPL-3.0-only
 */
namespace OCA\Files_External\Command;

use OC\Core\Command\Base;
use OC\User\NoUserException;
use OCA\Files_External\Lib\StorageConfig;
use OCA\Files_External\Service\BackendService;
use OCA\Files_External\Service\GlobalStoragesService;
use OCA\Files_External\Service\ImportLegacyStoragesService;
use OCA\Files_External\Service\StoragesService;
use OCA\Files_External\Service\UserStoragesService;
use OCP\IUserManager;
use OCP\IUserSession;
use Symfony\Component\Console\Input\ArrayInput;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Output\OutputInterface;

class Import extends Base {
	public function __construct(
		private GlobalStoragesService $globalService,
		private UserStoragesService $userService,
		private IUserSession $userSession,
		private IUserManager $userManager,
		private ImportLegacyStoragesService $importLegacyStorageService,
		private BackendService $backendService,
	) {
		parent::__construct();
	}

	protected function configure(): void {
		$this
			->setName('files_external:import')
			->setDescription('Import mount configurations')
			->addOption(
				'user',
				'',
				InputOption::VALUE_OPTIONAL,
				'user to add the mount configurations for, if not set the mount will be added as system mount'
			)
			->addArgument(
				'path',
				InputArgument::REQUIRED,
				'path to a json file containing the mounts to import, use "-" to read from stdin'
			)
			->addOption(
				'dry',
				'',
				InputOption::VALUE_NONE,
				'Don\'t save the imported mounts, only list the new mounts'
			);
		parent::configure();
	}

	protected function execute(InputInterface $input, OutputInterface $output): int {
		$user = (string)$input->getOption('user');
		$path = $input->getArgument('path');
		if ($path === '-') {
			$json = file_get_contents('php://stdin');
		} else {
			if (!file_exists($path)) {
				$output->writeln('<error>File not found: ' . $path . '</error>');
				return self::FAILURE;
			}
			$json = file_get_contents($path);
		}
		if (!is_string($json) || strlen($json) < 2) {
			$output->writeln('<error>Error while reading json</error>');
			return self::FAILURE;
		}
		$data = json_decode($json, true);
		if (!is_array($data)) {
			$output->writeln('<error>Error while parsing json</error>');
			return self::FAILURE;
		}

		$isLegacy = isset($data['user']) || isset($data['group']);
		if ($isLegacy) {
			$this->importLegacyStorageService->setData($data);
			$mounts = $this->importLegacyStorageService->getAllStorages();
			foreach ($mounts as $mount) {
				if ($mount->getBackendOption('password') === false) {
					$output->writeln('<error>Failed to decrypt password</error>');
					return self::FAILURE;
				}
			}
		} else {
			if (!isset($data[0])) { //normalize to an array of mounts
				$data = [$data];
			}
			$mounts = array_map([$this, 'parseData'], $data);
		}

		if ($user) {
			// ensure applicables are correct for personal mounts
			foreach ($mounts as $mount) {
				$mount->setApplicableGroups([]);
				$mount->setApplicableUsers([$user]);
			}
		}

		$storageService = $this->getStorageService($user);

		$existingMounts = $storageService->getAllStorages();

		foreach ($mounts as $mount) {
			foreach ($existingMounts as $existingMount) {
				if (
					$existingMount->getMountPoint() === $mount->getMountPoint() &&
					$existingMount->getApplicableGroups() === $mount->getApplicableGroups() &&
					$existingMount->getApplicableUsers() === $mount->getApplicableUsers() &&
					$existingMount->getBackendOptions() === $mount->getBackendOptions()
				) {
					$output->writeln('<error>Duplicate mount (' . $mount->getMountPoint() . ')</error>');
					return self::FAILURE;
				}
			}
		}

		if ($input->getOption('dry')) {
			if (count($mounts) === 0) {
				$output->writeln('<error>No mounts to be imported</error>');
				return self::FAILURE;
			}
			$listCommand = new ListCommand($this->globalService, $this->userService, $this->userSession, $this->userManager);
			$listInput = new ArrayInput([], $listCommand->getDefinition());
			$listInput->setOption('output', $input->getOption('output'));
			$listInput->setOption('show-password', true);
			$listCommand->listMounts($user, $mounts, $listInput, $output);
		} else {
			foreach ($mounts as $mount) {
				$storageService->addStorage($mount);
			}
		}
		return self::SUCCESS;
	}

	private function parseData(array $data): StorageConfig {
		$mount = new StorageConfig($data['mount_id']);
		$mount->setMountPoint($data['mount_point']);
		$mount->setBackend($this->getBackendByClass($data['storage']));
		$authBackend = $this->backendService->getAuthMechanism($data['authentication_type']);
		$mount->setAuthMechanism($authBackend);
		$mount->setBackendOptions($data['configuration']);
		$mount->setMountOptions($data['options']);
		$mount->setApplicableUsers($data['applicable_users'] ?? []);
		$mount->setApplicableGroups($data['applicable_groups'] ?? []);
		return $mount;
	}

	private function getBackendByClass(string $className) {
		$backends = $this->backendService->getBackends();
		foreach ($backends as $backend) {
			if ($backend->getStorageClass() === $className) {
				return $backend;
			}
		}
	}

	protected function getStorageService(string $userId): StoragesService {
		if (empty($userId)) {
			return $this->globalService;
		}

		$user = $this->userManager->get($userId);
		if (is_null($user)) {
			throw new NoUserException("user $userId not found");
		}
		$this->userSession->setUser($user);
		return $this->userService;
	}
}