Hosting Java applets

Using the Java Notes® classes, application developers can create applets that perform server tasks, such as opening a session and retrieving information from a database access control list. The server can host the applet and when a client requests it, download the applet to the browser.

About this task

To run Java applets created with Java Notes® classes on a Domino® Web server, you must enable the Domino® IIOP (DIIOP) task on the server. This task allows Domino® and the browser client to use the Domino® Object Request Broker (ORB) server program. The Domino® ORB processes the applet requests and transmits the information to the browser client to communicate. You must enable both the Domino® IIOP task and the Internet Inter-ORB protocol (IIOP) on the server before users can access the Domino® ORB to run the Java applets.

Application designers must create applets with the Java Notes® classes and, in addition, they must specify that the applets can use the Domino® ORB to communicate with browser clients. Application designers specify this setting when they add the applets to a document or form.

For information on designing Web applications and on the Java Notes® classes, see IBM® Domino® Designer 9.0.1 Social Edition Help.

To set up the Domino® ORB, do the following.

Procedure

  1. Open the Server document you want to edit.
  2. Choose Ports > Internet Ports > DIIOP and complete these fields:
    Table 1. Domino® IIOP (DIIOP) port setup

    Field

    Enter

    TCP/IP port number

    The name of the port the Domino® IIOP task listens on. Do not change this port unless you have assigned port number 63148 (the default) to another task.

    Note: The default on Linux servers is 60148 because of an operating system restriction.

    TCP/IP port status

    Choose one:

    • Enabled (default) -- To allow communication over this port.
    • Disabled -- To prevent communication over this port.
  3. Choose Internet Protocols > DIIOP. For the field Number of threads, enter The number of threads you want to allow the DIIOP server task to process at the same time. The default is 10.
  4. Click Security and complete these fields in the Programmability Restrictions section:
    Table 2. Programmability Restriction settings

    Field

    Enter

    Run restricted Java/Javascript/COM

    The name that the applet or application uses to access the server. Applet or application names entered in this field are allowed to run programs created using a restricted set of Java and JavaScript features. If the applet or application logs on anonymously, enter the word Anonymous in this field.

    Run unrestricted Java/Javascript/COM

    The name that the applet or application uses to access the server. Applet or application names entered in this field are allowed to run programs created using all Java and JavaScript features. If the applet or application logs on anonymously, enter the word Anonymous in this field.

  5. To restrict the level of authentication for Internet clients, choose a setting in the Internet server authentication field on the Security tab and save the document.
  6. If necessary, edit the ServerTasks setting in the NOTES.INI file to include the DIIOP task.
  7. Set up SSL server authentication, name and password authentication, or anonymous access to the IIOP port for the application or applet.
  8. Define server access by browser clients that use Java and JavaScript. If the applet or application uses name-and-password authentication, enter the name for the applet or application. Otherwise, use the name Anonymous when setting up server access.
  9. Restart the server.