Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-5057608

java.util.concurrent.ArrayBlockingQueue doc conflict

XMLWordPrintable



      Name: vsR10316 Date: 06/04/2004


      Filed By : SPB JCK team (###@###.###)
      JDK :
      JCK : 1.5
      Platform[s] : Solaris
      switch/Mode :
      JCK test owner : http://javaweb.eng/jct/sqe/JCK-tck/usr/owners.jto
      Failing Test [s] : N/A


      Specification excerpt:
      ======================
      --------- J2SE API spec v.1.5 ---------
      ...
      Documentation for class ArrayBlockingQueue:

      ....
      Attempts to offer an element to a full queue will result in the offer operation blocking; attempts to retrieve an element from an empty queue will similarly block.
      ....

      Documentation for method "offer" for this class:
      public boolean offer(E o)

          Inserts the specified element at the tail of this queue if possible, returning immediately if this queue is full.

      ...
      ---------- end-of-excerpt ---------------

      Problem description
      ===================
      There is conflict between class documentation and method's specification about blocking inserting and retrieving methods, e.g "offer" .

      JCK test source location:
      ==========================
      /java/re/jck/1.5/promoted/latest/JCK-runtime-15/tests
          
      ======================================================================

            martin Martin Buchholz
            duke J. Duke
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: