net.java.sip.communicator.service.desktop
Interface DesktopService

All Known Implementing Classes:

DesktopServiceImpl

public interface DesktopService

The DesktopService manages the .

Author:

Yana Stamcheva

Method Summary

void	browse(URI uri) Launches the default browser to display a URI.
void	edit(File file) Launches the associated editor application and opens a file for editing.
void	open(File file) Launches the associated application to open the file.
void	print(File file) Prints a file with the native desktop printing facility, using the associated application's print command.

Method Detail

open

void open(File file)
          throws NullPointerException,
                 IllegalArgumentException,
                 UnsupportedOperationException,
                 IOException,
                 SecurityException

Launches the associated application to open the file.

Parameters:

file - the file to be opened

Throws:

NullPointerException - if file is null

IllegalArgumentException - if the specified file dosen't exist

UnsupportedOperationException - if the current platform does not support the Desktop.Action.OPEN action

IOException - if the specified file has no associated application or the associated application fails to be launched

SecurityException - if a security manager exists and its SecurityManager.checkRead(java.lang.String) method denies read access to the file, or it denies the AWTPermission("showWindowWithoutWarningBanner") permission, or the calling thread is not allowed to create a subprocess

print

void print(File file)
           throws NullPointerException,
                  IllegalArgumentException,
                  UnsupportedOperationException,
                  IOException,
                  SecurityException

Prints a file with the native desktop printing facility, using the associated application's print command.

Parameters:

file - the file to be opened

Throws:

NullPointerException - if file is null

IllegalArgumentException - if the specified file dosen't exist

UnsupportedOperationException - if the current platform does not support the Desktop.Action.OPEN action

IOException - if the specified file has no associated application or the associated application fails to be launched

SecurityException - if a security manager exists and its SecurityManager.checkRead(java.lang.String) method denies read access to the file, or it denies the AWTPermission("showWindowWithoutWarningBanner") permission, or the calling thread is not allowed to create a subprocess

edit

void edit(File file)
          throws NullPointerException,
                 IllegalArgumentException,
                 UnsupportedOperationException,
                 IOException,
                 SecurityException

Launches the associated editor application and opens a file for editing.

Parameters:

file - the file to open for editing

Throws:

NullPointerException - if file is null

IllegalArgumentException - if the specified file dosen't exist

UnsupportedOperationException - if the current platform does not support the Desktop.Action.OPEN action

IOException - if the specified file has no associated application or the associated application fails to be launched

SecurityException - if a security manager exists and its SecurityManager.checkRead(java.lang.String) method denies read access to the file, or it denies the AWTPermission("showWindowWithoutWarningBanner") permission, or the calling thread is not allowed to create a subprocess

browse

void browse(URI uri)
            throws NullPointerException,
                   IllegalArgumentException,
                   UnsupportedOperationException,
                   IOException,
                   SecurityException

Launches the default browser to display a URI.

Parameters:

uri - the URI to be displayed in the user default browser

Throws:

NullPointerException - if file is null

IllegalArgumentException - if the specified file dosen't exist

UnsupportedOperationException - if the current platform does not support the Desktop.Action.OPEN action

IOException - if the specified file has no associated application or the associated application fails to be launched

SecurityException - if a security manager exists and its SecurityManager.checkRead(java.lang.String) method denies read access to the file, or it denies the AWTPermission("showWindowWithoutWarningBanner") permission, or the calling thread is not allowed to create a subprocess