Deployment Descriptor Visual Editor: Web Services

Use to edit the platform-specific deployment descriptors for web services in the project if you are deploying to the GlassFish server.

Depending on your application, the Web Services tab may have the following sections: Web Services, Web Service Clients, and Web Service Endpoints.

Web Services

Element Description

Add Web Service

Adds descriptor properties for a web service.

Each web service has the following properties: Web Service Description Name and WSDL Publish Location.

    Web Service Description Name

Specifies the web service description name as read from the corresponding entry for this service in your webservices.xml file.

    WSDL Publish Location

(Optional) Specifies a URL of a directory to which this web service's WSDL and any dependent files are published during deployment.

Note: The Web Services node is visible when a webservices.xml also exists in the project. In other words, this node only appears for web and enterprise bean projects that implement web services.

Web Service Clients

Element Description

Add Web Service Reference

Adds descriptor properties for a web service client.

Each web service client has the following properties: Service Reference Name, WSDL override, Port Information, and Selected Port Information.

    Service Reference Name

Specifies the web service description name as read from the corresponding entry for this service in your webservices.xml file.

    WSDL override

Specifies the URL to a WSDL document.

This URL overrides the WSDL document reference in the web-app.xml file.

    Port Information

Defines and configures the port information and properties of a Service reference.

Add a new port for a Service reference by clicking Add Port Information, or expand an existing port node to edit the properties of that port or to remove it.

    Selected Port Information

Adds or modifies the following properties for the web service client port:
  • Service Endpoint Interface
  • WSDL Port Namespace URI
  • WSDL Port Localpart - Specifies the local portion of the WSDL namespace.
  • Message Security - Enables you to edit the message security binding settings when selected.

Web Service Endpoints

The Web Service Endpoints section enables you to edit the properties of any endpoints exposed by a web service in the application. An endpoint identifies the final destination of a service or a message. In the web service context, an endpoint is the URL at which the service can be reached. The properties should automatically be prepopulated with entries corresponding to the ports defined for this service in webservices.xml.

Element Description

Add Endpoint

Adds descriptor properties for a web service endpoint.

Each web service client has the following properties: Port Component Name, Endpoint Address URI, Transport Guarantee, Debugging Enabled, Message Security, and Security Settings.

    Port Component Name

Specifies the port component name for this endpoint.

Matches the corresponding port component name in webservices.xml. You generally should not need to edit this field if the endpoint is already specified in webservices.xml file.

    Endpoint Address URI

Specifies the automatically generated endpoint address.

The Endpoint Address must be a fixed pattern. No * wildcards are allowed. The default value is the web service name for servlet-based endpoints or webservice/ejb-name for an EJB-based endpoint.

The Endpoint Address is combined with the web server root to form the fully-qualified endpoint address URI for a web service endpoint during deployment time.

The fully-qualified endpoint address URI is the URI at which the web service can be reached. The Endpoint Address is required for servlet endpoints if the servlet implements more than one endpoint and for all EJB endpoints.

    Transport Guarantee

Specifies the mode of communication between client and server.

The following options are available: NONE, INTEGRAL, AND CONFIDENTIAL

        NONE

Specifies that the application does not require any transport guarantees.

        INTEGRAL

Specify that the application requires that the data sent between the client and server be sent in such a way that it cannot be changed in transit.

        CONFIDENTIAL

Specifies that the application requires that the data be transmitted in a fashion that prevents other entities from observing the contents of the transmission.

    Debugging Enabled

Enables debugging.

    Message Security

If deselected, the application does not require authentication.

If selected, the application requires that the data be transmitted in a fashion that prevents other entities from observing the contents of the transmission.

If you select this option, you must click Edit Bindings to set the message-security-binding properties.

    Security Settings

Specifies the following authentication options if you are configuring an EJB web service endpoint: No Security, Message Security, and Login Configuration Realm.

        No Security

If selected, the application does not require any authentication.

        Message Security

If deselected, the application does not require authentication.

If selected, the application requires that the data be transmitted in a fashion that prevents other entities from observing the contents of the transmission.

If you select this option, you must click Edit Bindings to set the message-security-binding properties.

        Login Configuration Realm

If selected, you must specify a realm that exists on the GlassFish application server and specify one of the following authentication options: Basic or Client Certification.

            Basic

The application uses basic authentication, that is, a user ID and password.

            Client Certification

The application authenticates with a client certificate.

Note: For servlet endpoints, authentication is either configured in web.xml.


Related Topics

Developing Applications with NetBeans IDE,

Developing Applications with NetBeans IDE,

Developing Applications with NetBeans IDE,

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0.