11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package jdk.internal.misc;
  27 
  28 public interface JavaLangRefAccess {
  29 
  30     /**
  31      * Help ReferenceHandler thread process next pending
  32      * {@link java.lang.ref.Reference}








  33      *
  34      * @return {@code true} if there was a pending reference and it
  35      *         was enqueue-ed or {@code false} if there was no
  36      *         pending reference
  37      */
  38     boolean tryHandlePendingReference();
  39 }

  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package jdk.internal.misc;
  27 
  28 public interface JavaLangRefAccess {
  29 
  30     /**
  31      * Triggers discovery of new Reference(s) and returns the phase sequence number
  32      * in which they were discovered or previous phase sequence number if no new
  33      * Reference(s) were discovered.
  34      */
  35     int discoverReferences();
  36 
  37     /**
  38      * Blocks until all Reference(s) that were discovered in given
  39      * {@code discoveryPhase} (as returned by {@link #discoverReferences()})
  40      * have been enqueued.
  41      *
  42      * @param discoveryPhase the discovery phase sequence number.
  43      * @throws InterruptedException if interrupted while waiting.

  44      */
  45     void awaitReferencesEnqueued(int discoveryPhase) throws InterruptedException;
  46 }