Linda,
Looks good overall. I assume the JMS resource configuration will adapt
more depending on what comes out of the JMS 2 EG resource bootstrap API?
Thanks,
Reza
On 10/13/2011 1:44 PM, Linda DeMichiel wrote:
> The consensus of the group has been that the resource-specific approach
> to metadata is preferable.
>
> I'd like to follow up on the earlier discussion regarding specification
> of configurability information with regard to resource-specific resource
> annotations.
>
> We believe that we can address this by means of a suitable set of
> required elements and suitable defaults.
>
> The proposed semantics are as follows:
>
> The values specified for required elements must be observed.
>
> In general, non-default values specified for optional elements *should*
> be observed. Changing the values set for some optional elements (e.g.,
> transactional) may cause the application to break. Changing the values
> set for optional elements related to quality of service (e.g., pool
> sizes,
> idle times, etc.) may affect the performance of the application.
>
> The following default values used in the DataSourceDefinition,
> JMSConnectionFactoryDefinition, JMSDestinationDefinition,
> MailSessionDefinition, and ConnectorResourceDefinition indicate that
> an element value has *not* been set:
> * integer-valued elements: -1
> * string-valued elements: ""
> * array-valued elements {}
>
>
> An implementation of this specification may choose suitable
> server-specific
> default values for optional elements for which values have not been set.
> An implementation of this specification may place restrictions on and/or
> alter values set for optional elements related to quality of service.
>
> Definitions for the proposed annotations are given below. If the expert
> group agrees with this approach, I'll follow up with corresponding XML.
>
>
> -Linda
>
> ---------
>
>
> package javax.jms;
>
> import static java.lang.annotation.ElementType.TYPE;
> import java.lang.annotation.Retention;
> import static java.lang.annotation.RetentionPolicy.RUNTIME;
> import java.lang.annotation.Target;
>
> @Retention(RUNTIME)
> @Target({TYPE, METHOD, FIELD})
> public @interface JMSConnectionFactoryDefinition {
> String description() default "";
> String name();
> String className() default "";
> String resourceAdapterName() default "";
> String user() default "";
> String password() default "";
> String clientId() default "";
> boolean transactional() default true;
> int initialPoolSize() default -1;
> int maxPoolSize() default -1;
> int minPoolSize() default -1;
> int maxIdleTime() default -1;
> int connectionTimeout() default -1;
> String[] properties() default {};
> }
>
>
> -----
>
> package javax.jms;
>
> import static java.lang.annotation.ElementType.TYPE;
> import java.lang.annotation.Retention;
> import static java.lang.annotation.RetentionPolicy.RUNTIME;
> import java.lang.annotation.Target;
>
> @Retention(RUNTIME)
> @Target({TYPE, METHOD, FIELD})
> public @interface JMSDestinationDefinition {
> String description() default "";
> String name();
> String className();
> String resourceAdapterName() default "";
> String resourceName() "";
> String[] properties() default {};
> }
>
>
> -----
>
> package javax.mail;
>
> import static java.lang.annotation.ElementType.TYPE;
> import java.lang.annotation.Retention;
> import static java.lang.annotation.RetentionPolicy.RUNTIME;
> import java.lang.annotation.Target;
>
>
> @Retention(RUNTIME)
> @Target({TYPE})
> public @interface MailSessionDefinition {
> String description() default "";
> String name();
> String storeProtocol() default "";
> String storeProtocolClass() default "";
> String transportProtocol() default "";
> String transportProtocolClass() default "";
> String host() default "";
> String user() default "";
> String from() default "";
> String[] properties() default {};
> }
>
>
> ------
>
> package javax.resource;
>
> import static java.lang.annotation.ElementType.TYPE;
> import java.lang.annotation.Retention;
> import static java.lang.annotation.RetentionPolicy.RUNTIME;
> import java.lang.annotation.Target;
>
> @Retention(RUNTIME)
> @Target({TYPE})
> public @interface ConnectorResourceDefinition {
> String description() default "";
> String name();
> String className();
> String[] properties() default {};
> }
>
>
>
>
> -----
> No virus found in this message.
> Checked by AVG - www.avg.com
> Version: 2012.0.1831 / Virus Database: 2090/4552 - Release Date: 10/14/11
>
>