com.holonplatform.vaadin.device.DeviceInfo Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of holon-vaadin Show documentation
Holon Vaadin integration
There is a newer version: 5.4.0
/*
 * Copyright 2016-2017 Axioma srl.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */
package com.holonplatform.vaadin.device;

import java.util.Optional;

import com.holonplatform.core.internal.utils.ObjectUtils;
import com.holonplatform.vaadin.internal.device.DefaultDeviceInfo;
import com.vaadin.server.VaadinRequest;
import com.vaadin.server.VaadinService;
import com.vaadin.server.VaadinSession;

/**
 * Provides informations about client device in which application is running
 * 
 * @see UserAgentInspector
 * 
 * @since 5.0.0
 */
public interface DeviceInfo extends UserAgentInspector {

	/**
	 * Name of the session attribute to cache DeviceInfo instance
	 */
	public static final String SESSION_ATTRIBUTE_NAME = DeviceInfo.class.getName();

	/**
	 * Get client screen width in pixels
	 * @return Client screen width, or -1 if not available at method call time
	 */
	int getScreenWidth();

	/**
	 * Get client screen height in pixels
	 * @return Client screen height, or -1 if not available at method call time
	 */
	int getScreenHeight();

	/**
	 * Get application viewport width in pixels
	 * @return Application viewport width, or -1 if not available at method call time
	 */
	int getViewPortWidth();

	/**
	 * Get application viewport height in pixels
	 * @return Application viewport height, or -1 if not available at method call time
	 */
	int getViewPortHeight();

	/**
	 * Build a DeviceInfo instance using given header values
	 * @param userAgentHeader the User-Agent header
	 * @param httpAcceptHeader the Accept header
	 * @return The {@link DeviceInfo}
	 */
	static DeviceInfo create(String userAgentHeader, String httpAcceptHeader) {
		UserAgentInspector uai = UserAgentInspector.create(userAgentHeader, httpAcceptHeader);
		if (uai == null) {
			throw new IllegalStateException("Failed to create a UserAgentInspector");
		}
		return new DefaultDeviceInfo(uai);
	}

	/**
	 * Build a DeviceInfo instance using a {@link VaadinRequest}
	 * @param request Vaadin request
	 * @return The {@link DeviceInfo}
	 */
	static DeviceInfo create(VaadinRequest request) {
		UserAgentInspector uai = UserAgentInspector.create(request);
		if (uai == null) {
			throw new IllegalStateException("Failed to create a UserAgentInspector");
		}
		return new DefaultDeviceInfo(uai);
	}

	/**
	 * Get current DeviceInfo, if available.
	 * 
	 * DeviceInfo is created using current {@link VaadinRequest}, if available. It is cached into {@link VaadinSession}
	 * for further requests.
	 * 
	 * @return Optional DeviceInfo, empty if it cannot be found in session and no current request is available to create
	 *         a new instance
	 */
	static Optional get() {
		final VaadinSession session = VaadinSession.getCurrent();
		if (session != null) {
			ensureInited(session);
			return Optional.ofNullable((DeviceInfo) session.getAttribute(SESSION_ATTRIBUTE_NAME));
		}
		return Optional.empty();
	}

	/**
	 * Ensure that a {@link DeviceInfo} is available from given Vaadin session. For successful
	 * initialization, a {@link VaadinService#getCurrentRequest()} must be available.
	 * @param session Vaadin session (not null)
	 */
	static void ensureInited(VaadinSession session) {
		ObjectUtils.argumentNotNull(session, "VaadinSession must be not null");
		session.access(() -> {
			if (session.getAttribute(SESSION_ATTRIBUTE_NAME) == null && VaadinService.getCurrentRequest() != null) {
				session.setAttribute(SESSION_ATTRIBUTE_NAME, create(VaadinService.getCurrentRequest()));
			}
		});
	}

}