Page History

...

Every module that you install in Geronimo, whether it is a service, application, resource, etc., can be configured via a deployment plan. These deployment plans are XML files based on XML Schemas containing the configuration details for a specific application module or component. The Java EE 5 specification defines standard deployment descriptors such as web.xml, application.xml, etc. In some cases, the deployment descriptor is all that is required to install a module into a Geronimo server. However, in many cases, server-specific configuration is required when modules are installed. This server-specific configuration is accomplished by using Geronimo deployment plans.
Geronimo deployment plans can be packaged along with the application or specified externally at deployment time. If provided during deployment, this plan will overwrite any other Geronimo specific deployment plan provided with the application.
To package the deployment plans in you application you have to follow some naming conventions and place the file in a specific directory within your packaged application. For example, in a web application you would include the `geronimo-web.xml` under the /WEB-INF directory, same place where you are also providing the `web.xml` descriptor, all within the WAR. For an enterprise application you would include the `geronimo-application.xml` under the /META-INF directory, same place where you are also providing the `application.xml` descriptor, all within the WAR.
The Java EE 5 specification also let's you use Annotations where you add resource references, dependencies, etc. directly in the code. Geronimo provides a Deployment plan wizard that automatically generates the necessary deployment plans based on the standard deployment descriptors and annotations.
Note
The default namespace of the above XML document is `http://java.sun.com/xml/ns/javaee^{Image Removed}`. The XML elements that do not have a namespace prefix belong to the default namespace.
With Servlet 2.5 specification, many of the declarations done through `web.xml` can also be done through corresponding annotations in the servlets and JSPs. When both annotations and web.xml are provided, the declarations in web.xml takes precedence over annotations.
The web module connects to back end datasource using its JNDI name `jdbc/DataSource` as declared in the `web.xml`.
Note
The default namespace of the above XML document is `http://java.sun.com/xml/ns/javaee^{Image Removed}`. The XML elements that do not have a namespace prefix belong to the default namespace.
In EJB3.0, most of the deployment descriptor declarations can be done through the corresponding annotations in the bean class. However, if a deployment descriptor is supplied (`ejb-jar.xml`), the declarations in the deployment descriptor will override the annotations.
The ejb module connects to back end datasource using its JNDI name `jdbc/DataSource` as declared in the `ejb-jar.xml`. It also declares that the ejb is a stateless session bean and provides an interceptor class for the bean. The interceptor class will have callback methods which container calls when the corresponding events occur in the bean's life cycle.
...

Here is a list of all Java EE 5 annotations supported by Geronimo:

JSR	Annotation	Deployment Descriptor Tag(s)	Supported in	Notes
JSR 250 (Common Annotations)	1. javax.annotation.Generated			The only annotation with SOURCE retention. All the others are RUNTIME.
	2. javax.annotation.PostConstruct	<post-construct>	Client JAR EJB JAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	3. javax.annotation.PreDestroy	<pre-destroy>	Client JAR EJB JAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	4. javax.annotation.Resource	1. <env-entry>	EJB JAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	4. javax.annotation.Resource	2. <service-ref>	EJB JAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	4. javax.annotation.Resource	3. <resource-ref>	EJB JAR RAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	4. javax.annotation.Resource	4. <message-destination-ref>	EJB JAR RAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	4. javax.annotation.Resource	5. <resource-env-ref>	EJB JAR RAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	4. javax.annotation.Resource	6. <webservice-context>	EJB JAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	5. javax.annotation.Resources			Same as javax.annotation.Resource
	6. javax.annotation.security.DeclareRoles	<security-role-ref>	EJB JAR WAR
	7. javax.annotation.security.DenyAll		EJB JAR WAR	Not supported in servlets. See Java™ Platform, Enterprise Edition (Java EE) Specification, v5, Page 141, Section EE.6.24, Table EE.6-E
	8. javax.annotation.security.PermitAll	<unchecked>	EJB JAR WAR	Not supported in servlets. See Java™ Platform, Enterprise Edition (Java EE) Specification, v5, Page 141, Section EE.6.24, Table EE.6-E
	9. javax.annotation.security.RolesAllowed	<role-name>	EJB JAR WAR	Not supported in servlets. See Java™ Platform, Enterprise Edition (Java EE) Specification, v5, Page 141, Section EE.6.24, Table EE.6-E
	10. javax.annotation.security.RunAs	<run-as>	EJB JAR WAR	Servlets only. See Java™ Platform, Enterprise Edition (Java EE) Specification, v5, Page 141, Section EE.6.24, Table EE.6-E
JSR	Annotation	Deployment Descriptor Tag(s)	Supported in	Notes
JSR-220 (EJB 3.0)	1. javax.ejb.ActivationConfigProperty	<activation-config-property>	Client JAR EJB JAR
	2. javax.ejb.ApplicationException	<application-exception>	Client JAR EJB JAR
	3. javax.ejb.EJB	1. <ejb-ref>	Client JAR EJB JAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	3. javax.ejb.EJB	2. <ejb-local-ref>	Client JAR EJB JAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	4. javax.ejb.EJBs			Same as javax.ejb.EJB
	5. javax.ejb.Init		Client JAR EJB JAR
	6. javax.ejb.Local	<local>	Client JAR EJB JAR WAR
	7. javax.ejb.LocalHome	<local-home>	Client JAR EJB JAR
	8. javax.ejb.MessageDriven	<message-driven>	Client JAR EJB JAR
	9. javax.ejb.PostActivate	<post-activate>	Client JAR EJB JAR
	10. javax.ejb.PrePassivate	<pre-passivate>	Client JAR EJB JAR
	11. javax.ejb.Remote	<remote>	Client JAR EJB JAR WAR
	12. javax.ejb.RemoteHome	<home>	Client JAR EJB JAR
	13. javax.ejb.Remove		Client JAR EJB JAR
	14. javax.ejb.Stateful	<stateful>	Client JAR EJB JAR
	15. javax.ejb.Stateless	<stateless>	Client JAR EJB JAR WAR
	16. javax.ejb.Timeout		Client JAR EJB JAR
	17. javax.ejb.TransactionAttribute	<trans-attribute>	Client JAR EJB JAR
	18. javax.ejb.TransactionManagement		Client JAR EJB JAR
JSR	Annotation	Deployment Descriptor Tag(s)	Supported in	Notes
JSR-220 (EJB 3.0)	1. javax.interceptor.AroundInvoke	<around-invoke>	EJB JAR WAR
	2. javax.interceptor.ExcludeClassInterceptors	<exclude-class-interceptors>	EJB JAR WAR
	3. javax.interceptor.ExcludeDefaultInterceptors	<exclude-default-interceptors>	EJB JAR WAR
	4. javax.interceptor.Interceptors	<interceptors>	EJB JAR WAR
JSR	Annotation	Deployment Descriptor Tag(s)	Supported in	Notes
JSR-181 (Web Services Metadata 2.0)	1. javax.jws.HandlerChain	<handler-chain>	EJB JAR WAR HC	See Web Services Metadata for the JavaTM Platform, Section 4.6 Annotation HandlerChain
	2. javax.jws.Oneway		EJB JAR WAR
	3. javax.jws.WebMethod		Client JAR EJB JAR WAR
	4. javax.jws.WebParam		Client JAR EJB JAR WAR
	5. javax.jws.WebResult		Client JAR EJB JAR WAR
	6. javax.jws.WebService	<service-ref-type>	Client JAR EJB JAR WAR
	7. javax.jws.soap.InitParam		EJB JAR WAR
	8. javax.jws.soap.SOAPBinding		EJB JAR WAR
	9. javax.jws.soap.SOAPMessageHandler		EJB JAR WAR
	10. javax.jws.soap.SOAPMessageHandlers			Same as javax.jws.soap.SOAPMessageHandler
JSR	Annotation	Deployment Descriptor Tag(s)	Supported in	Notes
JSR-220 (JPA 1.0)	1. javax.persistence.AssociationOverride		EJB JAR WAR
	2. javax.persistence.AssociationOverrides			Same as javax.persistence.AssociationOverride
	3. javax.persistence.AttributeOverride		EJB JAR WAR
	4. javax.persistence.AttributeOverrides			javax.persistence.AttributeOverride
	5. javax.persistence.Basic		EJB JAR WAR
	6. javax.persistence.Column		EJB JAR WAR
	7. javax.persistence.ColumnResult		EJB JAR WAR
	8. javax.persistence.DiscriminatorColumn		EJB JAR WAR
	9. javax.persistence.DiscriminatorValue		EJB JAR WAR
	10. javax.persistence.Embeddable		EJB JAR WAR
	11. javax.persistence.Embedded		EJB JAR WAR
	12. javax.persistence.EmbeddedId		EJB JAR WAR
	13. javax.persistence.Entity		EJB JAR WAR
	14. javax.persistence.EntityListeners		EJB JAR WAR
	15. javax.persistence.EntityResult		EJB JAR WAR
	16. javax.persistence.Enumerated		EJB JAR WAR
	17. javax.persistence.ExcludeDefaultListeners		EJB JAR WAR
	18. javax.persistence.ExcludeSuperclassListeners		EJB JAR WAR
	19. javax.persistence.FieldResult		EJB JAR WAR
	20. javax.persistence.GeneratedValue		EJB JAR WAR
	21. javax.persistence.Id		EJB JAR WAR
	22. javax.persistence.IdClass		EJB JAR WAR
	23. javax.persistence.Inheritance		EJB JAR WAR
	24. javax.persistence.JoinColumn		EJB JAR WAR
	25. javax.persistence.JoinColumns			Same as javax.persistence.JoinColumn
	26. javax.persistence.JoinTable		EJB JAR WAR
	27. javax.persistence.Lob		EJB JAR WAR
	28. javax.persistence.ManyToMany		EJB JAR WAR
	29. javax.persistence.ManyToOne		EJB JAR WAR
	30. javax.persistence.MapKey		EJB JAR WAR
	31. javax.persistence.MappedSuperclass		EJB JAR WAR
	32. javax.persistence.NamedNativeQueries		EJB JAR WAR
	33. javax.persistence.NamedNativeQuery		EJB JAR WAR
	34. javax.persistence.NamedQueries		EJB JAR WAR
	35. javax.persistence.NamedQuery		EJB JAR WAR
	36. javax.persistence.OneToMany		EJB JAR WAR
	37. javax.persistence.OneToOne		EJB JAR WAR
	38. javax.persistence.OrderBy		EJB JAR WAR
	39. javax.persistence.PersistenceContext	<persistence-context-ref>	EJB JAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	40. javax.persistence.PersistenceContexts			Same as javax.persistence.PersistenceContext
	41. javax.persistence.PersistenceProperty	<persistence-property>	EJB JAR WAR
	42. javax.persistence.PersistenceUnit	<persistence-unit-ref>	EJB JAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	43. javax.persistence.PersistenceUnits			Same as javax.persistence.PersistenceUnits
	44. javax.persistence.PostLoad		EJB JAR WAR
	45. javax.persistence.PostPersist		EJB JAR WAR
	46. javax.persistence.PostRemove		EJB JAR WAR
	47. javax.persistence.PostUpdate		EJB JAR WAR
	48. javax.persistence.PrePersist		EJB JAR WAR
	49. javax.persistence.PreRemove		EJB JAR WAR
	50. javax.persistence.PreUpdate		EJB JAR WAR
	51. javax.persistence.PrimaryKeyJoinColumn		EJB JAR WAR
	52. javax.persistence.PrimaryKeyJoinColumns			Same as javax.persistence.PrimaryKeyJoinColumn
	53. javax.persistence.QueryHint		EJB JAR WAR
	54. javax.persistence.SecondaryTable		EJB JAR WAR
	55. javax.persistence.SecondaryTables			Same as javax.persistence.SecondaryTable
	56. javax.persistence.SequenceGenerator		EJB JAR WAR
	57. javax.persistence.SqlResultSetMapping		EJB JAR WAR
	58. javax.persistence.SqlResultSetMappings			Same as javax.persistence.SqlResultSetMapping
	59. javax.persistence.Table		EJB JAR WAR
	60. javax.persistence.TableGenerator		EJB JAR WAR
	61. javax.persistence.Temporal		EJB JAR WAR
	62. javax.persistence.Transient		EJB JAR WAR
	63. javax.persistence.UniqueConstraint		EJB JAR WAR
	64. javax.persistence.Version		EJB JAR WAR
JSR	Annotation	Deployment Descriptor Tag(s)	Supported in	Notes
JSR-222 (JAXB 2.0)	1. javax.xml.bind.annotation.XmlAccessorOrder		Client JAR EJB JAR WAR
	2. javax.xml.bind.annotation.XmlAccessorType		Client JAR EJB JAR WAR
	3. javax.xml.bind.annotation.XmlAnyAttribute		Client JAR EJB JAR WAR
	4. javax.xml.bind.annotation.XmlAnyElement		Client JAR EJB JAR WAR
	5. javax.xml.bind.annotation.XmlAttachmentRef		Client JAR EJB JAR WAR
	6. javax.xml.bind.annotation.XmlAttribute		Client JAR EJB JAR WAR
	7. javax.xml.bind.annotation.XmlElement		Client JAR EJB JAR WAR
	8. javax.xml.bind.annotation.XmlElementDecl		Client JAR EJB JAR WAR
	9. javax.xml.bind.annotation.XmlElementRef		Client JAR EJB JAR WAR
	10. javax.xml.bind.annotation.XmlElementRefs			Same as javax.xml.bind.annotation.XmlElementRef
	11. javax.xml.bind.annotation.XmlElementWrapper		Client JAR EJB JAR WAR
	12. javax.xml.bind.annotation.XmlElements			Same as javax.xml.bind.annotation.XmlElement
	13. javax.xml.bind.annotation.XmlEnum		Client JAR EJB JAR WAR
	14. javax.xml.bind.annotation.XmlEnumValue		Client JAR EJB JAR WAR
	15. javax.xml.bind.annotation.XmlID		Client JAR EJB JAR WAR
	16. javax.xml.bind.annotation.XmlIDREF		Client JAR EJB JAR WAR
	17. javax.xml.bind.annotation.XmlInlineBinaryData		Client JAR EJB JAR WAR
	18. javax.xml.bind.annotation.XmlList		Client JAR EJB JAR WAR
	19. javax.xml.bind.annotation.XmlMimeType		Client JAR EJB JAR WAR
	20. javax.xml.bind.annotation.XmlMixed		Client JAR EJB JAR WAR
	21. javax.xml.bind.annotation.XmlNs		Client JAR EJB JAR WAR
	22. javax.xml.bind.annotation.XmlRegistry		Client JAR EJB JAR WAR
	23. javax.xml.bind.annotation.XmlRootElement		Client JAR EJB JAR WAR
	24. javax.xml.bind.annotation.XmlSchema		Client JAR EJB JAR WAR
	25. javax.xml.bind.annotation.XmlSchemaType		Client JAR EJB JAR WAR
	26. javax.xml.bind.annotation.XmlSchemaTypes			Same as javax.xml.bind.annotation.XmlSchemaType
	27. javax.xml.bind.annotation.XmlTransient		Client JAR EJB JAR WAR
	28. javax.xml.bind.annotation.XmlType		Client JAR EJB JAR WAR
	29. javax.xml.bind.annotation.XmlValue		Client JAR EJB JAR WAR
	30. javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter		Client JAR EJB JAR WAR
	31. javax.xml.bind.annotation.adapters.XmlJavaTypeAdapters			Same as javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter
JSR	Annotation	Deployment Descriptor Tag(s)	Supported_in	Notes
JSR-224 (JAX-WS 2.0)	1. javax.xml.ws.BindingType		EJB JAR WAR
	2. javax.xml.ws.RequestWrapper		Client JAR EJB JAR WAR
	3. javax.xml.ws.ResponseWrapper		Client JAR EJB JAR WAR
	4. javax.xml.ws.ServiceMode		EJB JAR WAR
	5. javax.xml.ws.WebEndpoint		Client JAR EJB JAR WAR
	6. javax.xml.ws.WebFault		Client JAR EJB JAR WAR
	7. javax.xml.ws.WebServiceClient		Client JAR EJB JAR WAR
	8. javax.xml.ws.WebServiceProvider		EJB JAR WAR
	9. javax.xml.ws.WebServiceRef	<service-ref>	EJB JAR WAR TLD	See JavaServer Pages™ Specification Version 2.1, Section JSP.7.1.11 Resource Injection
	10. javax.xml.ws.WebServiceRefs			Same as javax.xml.ws.WebServiceRef
	11. javax.xml.ws.addressing.Action		EJB JAR WAR
	12. javax.xml.ws.addressing.FaultAction		EJB JAR WAR

Child pages

Versions Compared

Old Version 2

New Version Current

Key

Here is a list of all Java EE 5 annotations supported by Geronimo: