jms-spec
  1. jms-spec
  2. JMS_SPEC-122

Typos in javadocs for ConnectionFactory.createContext

    Details

    • Type: Bug Bug
    • Status: Open
    • Priority: Major Major
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Labels:
      None

      Description

      1. There's a typo in the javadocs for ConnectionFactory.createContext(int sessionMode)

      In the paragraph "In a Java EE web or EJB container, when there is an active JTA transaction in progress: ", change:

      Since the argument is ignored, developers are recommended to use createSession(), which has no arguments, instead of this method.

      to:

      Since the argument is ignored, developers are recommended to use createContext(), which has no arguments, instead of this method.

      2. There's a typo in the javadocs for ConectionFactory.createContext(String userName, String password, int sessionMode):

      In the paragraph "In a Java EE web or EJB container, when there is an active JTA transaction in progress: ", change:

      Since the argument is ignored, developers are recommended to use createSession(), which has no sessionMode parameter, instead of this method.

      to:

      Since the argument is ignored, developers are recommended to use createContext(String userName, String password), which has no sessionMode parameter, instead of this method.

        Activity

        Hide
        Nigel Deakin added a comment - - edited

        Proposed changes to ConnectionFactory#createContext(int sessionMode):

        Existing text

        Since the argument is ignored, developers are recommended to use createSession(), which has no arguments, instead of this method.

        Replacement text

        Since the argument is ignored, developers are recommended to use createContext() instead of this method.

        Proposed changes to ConnectionFactory#createContext(String userName, String password, int sessionMode):

        Existing text

        Since the argument is ignored, developers are recommended to use createSession(), which has no arguments, instead of this method.

        Replacement text

        Since the argument is ignored, developers are recommended to use createContext(String userName, String password) instead of this method.

        Show
        Nigel Deakin added a comment - - edited Proposed changes to ConnectionFactory#createContext(int sessionMode): Existing text Since the argument is ignored, developers are recommended to use createSession() , which has no arguments, instead of this method. Replacement text Since the argument is ignored, developers are recommended to use createContext() instead of this method. Proposed changes to ConnectionFactory#createContext(String userName, String password, int sessionMode): Existing text Since the argument is ignored, developers are recommended to use createSession() , which has no arguments, instead of this method. Replacement text Since the argument is ignored, developers are recommended to use createContext(String userName, String password) instead of this method.
        Show
        Nigel Deakin added a comment - Updated source for javax.jms.JMSContext can be viewed at, and downloaded from, https://java.net/projects/jms-spec/sources/repository/content/jms2.0a/src/main/java/javax/jms/ConnectionFactory.java?rev=319 Diffs can be viewed at https://java.net/projects/jms-spec/sources/repository/diff/jms2.0a/src/main/java/javax/jms/ConnectionFactory.java?rev1=317&rev2=319

          People

          • Assignee:
            Unassigned
            Reporter:
            Nigel Deakin
          • Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

            • Created:
              Updated: