IntelliJ IDEA 2018.1 Help

Enabling Web Service Client Development Support Through a Dedicated Facet

This approach is applicable if you are going to develop the client side for a Web service of one of the following types:

  • GlassFish/JAXWS2.X RI/Netro 1.X/JWSDP2.0.
  • Apache Axis.
  • RESTful Web Service.

IntelliJ IDEA creates the relevant Web services client module structure and identifies all the necessary libraries automatically through the dedicated Web Services Client facet. Besides, IntelliJ IDEA either locates the previously downloaded required libraries or suggests to download them to the location of your choice.

A Web Services Client facet can be added to the module directly without a parent Web facet.

To enable Web Service Client development support through a dedicated facet, do one of the following

In either case, IntelliJ IDEA will download the predefined WS engine implementation version.

  • Create a Java module with the dedicated Web Services Client facet. Besides setting up the relevant module structure and providing all the necessary libraries automatically, IntelliJ IDEA will create a sample package with a HelloWorldClient class, which you can use as an example or populate it as necessary to develop your application.
  • Add the dedicated facet to an existing module.

To create a module for a Web service client application

  1. Do one of the following:
    • If you are going to create a new project: click Create New Project on the Welcome screen or select File | New | Project.

      As a result, the New Project wizard opens.

    • If you are going to add a module to an existing project: open the projectyou want to add a module to, and select File | New | Module.

      As a result, the New Module wizard opens.

  2. On the first page of the wizard, in the left-hand pane, select Java. In the right-hand part of the page, specify the JDK that you are going to use.
  3. Under Additional Libraries and Frameworks, select the WebServices Client checkbox.
  4. Select the desired WS engine implementation from the Version list.
  5. You'll need a library that implements the selected WS engine. You can choose to use an existing library, create and use a new one, download the library files if they are not yet available on your computer, or postpone setting up the library until a later time.
    • Use library. Select the library to be used from the list (if the corresponding library is already defined in IntelliJ IDEA).

      Create. If the corresponding library files (.jar) are already available on your computer, you can arrange those files in a library and use that new library. To do that, click Create and select the necessary files in the dialog that opens. (Use the Ctrl key for multiple selections.)

      Optionally, click Configure to edit the selected library. (For an existing library the Edit Library dialog will open, for the library that you have just created - the Create Library dialog.)

    • Download. Select this option to download the WS engine implementation. (The downloaded files will be arranged in a library.)

      Optionally, click Configure to edit the library settings and contents. (The Downloading Options dialog will open.)

    • Set up library later. Select this option to postpone setting up the library until a later time.

    Configure. Click this button to edit the settings for the library selected next to Use library or the one that is about to be downloaded.

    Click Next.

  6. Specify the name and location settings. For more information, see Project Name and Location or Module Name and Location.

    Click Finish.

To add the dedicated facets to an existing module

  1. Open the Project tool window (e.g. View | Tool Windows | Project).
  2. Right-click the module of interest and select Add Framework Support.
  3. In the left-hand pane of the Add Frameworks Support dialog that opens, select the WebServices Client checkbox.
  4. If you want sample client code to be generated, select the corresponding checkbox.
  5. Select the desired WS engine implementation from the Version list.
  6. You'll need a library that implements the selected WS engine. You can choose to use an existing library, create and use a new one, download the library files if they are not yet available on your computer, or postpone setting up the library until a later time.
    • Use library. Select the library to be used from the list (if the corresponding library is already defined in IntelliJ IDEA).

      Create. If the corresponding library files (.jar) are already available on your computer, you can arrange those files in a library and use that new library. To do that, click Create and select the necessary files in the dialog that opens. (Use the Ctrl key for multiple selections.)

      Optionally, click Configure to edit the selected library. (For an existing library the Edit Library dialog will open, for the library that you have just created - the Create Library dialog.)

    • Download. Select this option to download the WS engine implementation. (The downloaded files will be arranged in a library.)

      Optionally, click Configure to edit the library settings and contents. (The Downloading Options dialog will open.)

    • Set up library later. Select this option to postpone setting up the library until a later time.

    Configure. Click this button to edit the settings for the library selected next to Use library or the one that is about to be downloaded.

  7. Click OK in the Add Frameworks Support dialog.
Last modified: 24 July 2018

See Also