| // |
| // ======================================================================== |
| // Copyright (c) 1995-2017 Mort Bay Consulting Pty. Ltd. |
| // ------------------------------------------------------------------------ |
| // All rights reserved. This program and the accompanying materials |
| // are made available under the terms of the Eclipse Public License v1.0 |
| // and Apache License v2.0 which accompanies this distribution. |
| // |
| // The Eclipse Public License is available at |
| // http://www.eclipse.org/legal/epl-v10.html |
| // |
| // The Apache License v2.0 is available at |
| // http://www.opensource.org/licenses/apache2.0.php |
| // |
| // You may elect to redistribute this code under either of these licenses. |
| // ======================================================================== |
| // |
| |
| package org.eclipse.jetty.io; |
| |
| import java.nio.ByteBuffer; |
| |
| /** |
| * <p>A {@link ByteBuffer} pool.</p> |
| * <p>Acquired buffers may be {@link #release(ByteBuffer) released} but they do not need to; |
| * if they are released, they may be recycled and reused, otherwise they will be garbage |
| * collected as usual.</p> |
| */ |
| public interface ByteBufferPool |
| { |
| /** |
| * <p>Requests a {@link ByteBuffer} of the given size.</p> |
| * <p>The returned buffer may have a bigger capacity than the size being |
| * requested but it will have the limit set to the given size.</p> |
| * |
| * @param size the size of the buffer |
| * @param direct whether the buffer must be direct or not |
| * @return the requested buffer |
| * @see #release(ByteBuffer) |
| */ |
| public ByteBuffer acquire(int size, boolean direct); |
| |
| /** |
| * <p>Returns a {@link ByteBuffer}, usually obtained with {@link #acquire(int, boolean)} |
| * (but not necessarily), making it available for recycling and reuse.</p> |
| * |
| * @param buffer the buffer to return |
| * @see #acquire(int, boolean) |
| */ |
| public void release(ByteBuffer buffer); |
| } |