# Deployment Descriptor Visual Editor: EJB

Use to configure platform-specific descriptor settings for entity beans when your target server is the GlassFish Server.

The EJB tab does not contain nodes by default because the EJBs in your project by default do not have any properties. If any configuration information for an enterprise bean is not specified in the `glassfish-ejb-jar.xml` file, it defaults to a corresponding setting in the EJB container if an equivalency exists.

If you want to add descriptor properties to `glassfish-ejb-jar.xml` for an EJB in your project, you first need to create an entry for that EJB by clicking Add EJB. When you add an EJB, a node appears in the tab with a default name for the EJB. Expand the EJB node to edit the EJB properties.

This dialog box enables you to edit the following properties:

Element | Description
--- | ---
Name | Specifies the name field contains the name of the bean. Changing this name does not change the name of the bean in your project.
JNDI Name | Specifies the JNDI name of the entity bean. In the case of session beans, this name specifies the global JNDI name of the EJBHome object. This name is required if the session bean exposes a remote view.
Pass by Reference | Specifies the passing method used by the enterprise bean calling a remote interface method in another bean co-located within the same process. If unselected (default), the enterprise bean uses pass-by-value semantics for calls to remote interfaces. If selected, pass-by-reference semantics is used. Using pass-by-reference results in non-portable applications.

Each EJB node contains the following sections for editing deployment descriptor properties of reference elements:

- References

  - EJB References
  - Resource References
  - Resource Environment References
  - Web Service Clients
- Web Service Endpoints

If no reference element exists, you can create new references elements to the descriptor file by selecting the section title and then clicking the button to add a new reference element. When you create a new reference element it is visible as a node under the section. The IDE generates a default reference name.

EJB References

Element | Description
--- | ---
EJB Reference Name | Displays the EJB Reference name.
JNDI Name | Specifies the JNDI name for the EJB reference. This field should not be empty.

Resource References

Element | Description
--- | ---
Resource Reference Name | Displays the Resource Reference name.
JNDI Name | Specifies the JNDI name for the Resource reference.
Principal Name | Specifies the principal name for the Resource reference. (Optional) If you enter a principal name, you must also provide a password.
Principal Password | Specifies the Principal password. Required if the Principal name is provided.

Resource Environment References

Element | Description
--- | ---
Resource Environment Reference Name | Displays the Resource Environment Reference name.
JNDI Name | Specifies the JNDI name for the Resource Environment reference. This field should not be empty.

Web Service Clients

Element | Description
--- | ---
Add Web Service Reference | Adds descriptor properties for a web service.

Web Service Endpoints

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 fields should automatically be prepopulated with entries corresponding to the ports defined for this service in `webservices.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.