# 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.xm`l 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,

Copyright © 2015, Oracle and/or its affiliates. All rights reserved.