Class HostServices


  • public final class HostServices
    extends Object
    This class provides HostServices for an Application. This includes methods to get the code base and document base for an Application, and to show a web page in a browser.
    Since:
    JavaFX 2.0
    • Method Detail

      • getCodeBase

        public final String getCodeBase()
        Gets the code base URI for this application. This method returns the directory containing the application jar file. If the application is not packaged in a jar file, this method returns the empty string.
        Returns:
        the code base URI for this application.
      • getDocumentBase

        public final String getDocumentBase()
        Gets the document base URI for this application. This method returns the URI of the current directory.
        Returns:
        the document base URI for this application.
      • resolveURI

        public final String resolveURI​(String base,
                                       String rel)
        Resolves the specified relative URI against the base URI and returns the resolved URI.

        Example:

             HostServices services = getHostServices();
             String myImage = services.resolveURI(services.getDocumentBase(),
                                                  "image.jpg");
             Image image = new Image(myImage);
         
        Parameters:
        base - the base URI against which to resolve the relative URI
        rel - the relative URI to be resolved
        Returns:
        the fully resolved URI.
        Throws:
        NullPointerException - if either the base or the rel strings are null.
        IllegalArgumentException - if there is an error parsing either the base or rel URI strings, or if there is any other error in resolving the URI.
      • showDocument

        public final void showDocument​(String uri)
        Opens the specified URI in a new browser window or tab. The determination of whether it is a new browser window or a tab in an existing browser window will be made by the browser preferences. Note that this will respect the pop-up blocker settings of the default browser; it will not try to circumvent them.
        Parameters:
        uri - the URI of the web page that will be opened in a browser.