1 /* 2 * Copyright (C) 2004 Sun Microsystems, Inc. All rights reserved. Use is 3 * subject to license terms. 4 * 5 * This program is free software; you can redistribute it and/or modify 6 * it under the terms of the Lesser GNU General Public License as 7 * published by the Free Software Foundation; either version 2 of the 8 * License, or (at your option) any later version. 9 * 10 * This program is distributed in the hope that it will be useful, but 11 * WITHOUT ANY WARRANTY; without even the implied warranty of 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 13 * General Public License for more details. 14 * 15 * You should have received a copy of the GNU General Public License 16 * along with this program; if not, write to the Free Software 17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 18 * USA. 19 */ 20 21 package org.jdesktop.jdic.desktop.internal; 22 23 import java.net.URL; 24 25 26 /** 27 * The <code>BrowserService</code> interface provides interaction with 28 * the system default browser. 29 */ 30 public interface BrowserService { 31 /** 32 * Launches the system default browser to show the given URL. 33 * 34 * @param url the given URL. 35 * @throws LaunchFailedException if the system browser is found but fails to be launched. 36 */ 37 public void show(URL url) throws LaunchFailedException; 38 39 /** 40 * Opens the given URL in the target window of the system default browser. 41 * 42 * @param url the given URL. 43 * @param target the given target browser window name. 44 * @throws LaunchFailedException if the system browser is found but fails to be launched. 45 */ 46 public void show(URL url, String target) throws LaunchFailedException; 47 } 48