steve wrote:
Just to clarify...
The new API will acctually start appearing in 3.3. Session.connection() will remain also, to be removed in 4.0. This gives people a chance to try and get used to the new API and gives us a chance to incorporate feedback before we actually remove Session.connection().
More than likely the API/SPI will come from parts of the work currently in the sandbox/jdbc
FWIW, I think it is improper to deprecate a method *before* providing a reasonable alternative. From the VM spec:
"A class, interface, method, or field may be marked using a Deprecated attribute to indicate that the class, interface, method, or field has been superseded."
http://java.sun.com/docs/books/jvms/sec ... html#78232
From java.sun.com documentation on "How and When To Deprecate APIs":
"A deprecated class or method is like that. It is no longer important. It is so unimportant, in fact, that you should no longer use it, since it has been superseded and may cease to exist in the future."
http://java.sun.com/javase/6/docs/techn ... ation.html
Emphasis here on "has been superseded".
From "The Java API Document Generator":
"Adds a comment indicating that this API should no longer be used (even though it may continue to work)."
http://java.sun.com/j2se/1.5.0/docs/too ... deprecated
-sullymandias