users@connector-spec.java.net

[connector-spec-users] [jsr322-experts] MessageEndpointFactory

From: Jesper Pedersen <jesper.pedersen_at_redhat.com>
Date: Fri, 11 Jan 2013 12:44:29 -0500

Hi,

As Wilson pointed out during our call we have a problem with the

  MessageEndpointFactory::createEndpoint(XAResource, long)

method.

Implementation of MessageEndpointFactory / MessageEndpoint against older
versions of the JCA specification doesn't contain this method, so in
that light I think we should improve our documentation.

For the JavaDoc part:

* Add a @since 1.6
* Add a @throws NoSuchMuchException Thrown in cases where the
implementation targets JCA 1.0 or JCA 1.5

For specification 13.3:

"Note, that MessageEndpointFactory implementations that have been
implemented against previous versions of this specification will not
contain the method createEndpoint(XAResource, long) and will therefore
throw a NoSuchMethodException. It is recommended that this exception is
caught and createEndpoint(XAResource) is tried as a fall-back.".


Or something like that :)

Best regards,
  Jesper