com.dahuatech.hutool.core.swing.DesktopUtil Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of java-sdk-common Show documentation

Dahua ICC Open API SDK for Java

There is a newer version: 1.0.13.10

package com.dahuatech.hutool.core.swing;

import com.dahuatech.hutool.core.io.IORuntimeException;
import com.dahuatech.hutool.core.util.URLUtil;

import java.awt.*;
import java.io.File;
import java.io.IOException;
import java.net.URI;

/**
 * 桌面相关工具（平台相关）

 * Desktop 类允许 Java 应用程序启动已在本机桌面上注册的关联应用程序，以处理 URI 或文件。
 *
 * @author looly
 * @since 4.5.7
 */
public class DesktopUtil {

  /**
   * 获得{@link Desktop}
   *
   * @return {@link Desktop}
   */
  public static Desktop getDsktop() {
    return Desktop.getDesktop();
  }

  /**
   * 使用平台默认浏览器打开指定URL地址
   *
   * @param url URL地址
   */
  public static void browse(String url) {
    browse(URLUtil.toURI(url));
  }

  /**
   * 使用平台默认浏览器打开指定URI地址
   *
   * @param uri URI地址
   * @since 4.6.3
   */
  public static void browse(URI uri) {
    final Desktop dsktop = getDsktop();
    try {
      dsktop.browse(uri);
    } catch (IOException e) {
      throw new IORuntimeException(e);
    }
  }

  /**
   * 启动关联应用程序来打开文件
   *
   * @param file URL地址
   */
  public static void open(File file) {
    final Desktop dsktop = getDsktop();
    try {
      dsktop.open(file);
    } catch (IOException e) {
      throw new IORuntimeException(e);
    }
  }

  /**
   * 启动关联编辑器应用程序并打开用于编辑的文件
   *
   * @param file 文件
   */
  public static void edit(File file) {
    final Desktop dsktop = getDsktop();
    try {
      dsktop.edit(file);
    } catch (IOException e) {
      throw new IORuntimeException(e);
    }
  }

  /**
   * 使用关联应用程序的打印命令, 用本机桌面打印设备来打印文件
   *
   * @param file 文件
   */
  public static void print(File file) {
    final Desktop dsktop = getDsktop();
    try {
      dsktop.print(file);
    } catch (IOException e) {
      throw new IORuntimeException(e);
    }
  }

  /**
   * 使用平台默认浏览器打开指定URL地址
   *
   * @param mailAddress 邮件地址
   */
  public static void mail(String mailAddress) {
    final Desktop dsktop = getDsktop();
    try {
      dsktop.mail(URLUtil.toURI(mailAddress));
    } catch (IOException e) {
      throw new IORuntimeException(e);
    }
  }
}