jsr322-experts@connector-spec.java.net

[jsr322-experts] BootstrapContext::getUniqueId

From: Jesper Pedersen <jesper.pedersen_at_redhat.com>
Date: Tue, 22 Jan 2013 15:03:23 -0500

Hi,

I had a chance to look at subject.

There are multiple things to consider, since

* A BootstrapContext instance is tied to a ResourceAdapter instance
* A BootstrapContext instance is tied to a WorkManager instance
* A WorkManager instance maybe a DistributedWorkManager instance
* A Work instance may implement ResourceAdapterAssociation
* Other components implementing ResourceAdapterAssociation

So we are dealing with a complex network of object, which may be
distributed across a cluster.

With that in mind I'm ok with the following JavaDoc

/**
  * Returns an unique identifier for the BootstrapContext instance.
  *
  * The value returned is a non-<code>null</code> string.
  * The empty string is a valid value.
  *
  * It is recommended that the value, if defined, is human-readable
  * including the Java letters, digits, underscore (_),
  * dot (.) and minus (-) as defined by the Java Language Specification.
  *
  * @return The value
  */
public String getUniqueId();


In the specification text we can describe the recommended behavior in a
clustered / cloud environment.

Best regards,
  Jesper