/*
 * Copyright (c) 2011, 2020 Oracle and/or its affiliates. All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v. 2.0, which is available at
 * http://www.eclipse.org/legal/epl-2.0.
 *
 * This Source Code may also be made available under the following Secondary
 * Licenses when the conditions for such availability set forth in the
 * Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
 * version 2 with the GNU Classpath Exception, which is available at
 * https://www.gnu.org/software/classpath/license.html.
 *
 * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
 */

package org.glassfish.grizzly.asyncqueue;

Common interface for entities that may be written to a Channel. 
Since:
2.2/**
 * Common interface for entities that may be written to a {@link java.nio.channels.Channel}.
 *
 * @since 2.2
 */
public interface WritableMessage {

    
Return true if this message has data remaining to be written.
Returns:
true if this message has data remaining to be written./**
     * Return <code>true</code> if this message has data remaining to be written.
     *
     * @return <code>true</code> if this message has data remaining to be written.
     */
    boolean hasRemaining();

    
Return the number of bytes remaining to be written.
Returns:
the number of bytes remaining to be written./**
     * Return the number of bytes remaining to be written.
     * 
     * @return the number of bytes remaining to be written.
     */
    int remaining();

    
Perform message specific actions to release resources held by the entity backing this WritableMessage.
Returns:
true if successfully released/**
     * Perform message specific actions to release resources held by the entity backing this <code>WritableMessage</code>.
     * 
     * @return true if successfully released
     */
    boolean release();

    
Returns true if the message represents an external resource (for example FileTransfer), which is not loaded in memory. 
Returns:
False, if the message is located in memory (like Buffer)./**
     * Returns <tt>true</tt> if the message represents an external resource (for example
     * {@link org.glassfish.grizzly.FileTransfer}), which is not loaded in memory.
     *
     * @return <tt>False</tt>, if the message is located in memory (like {@link org.glassfish.grizzly.Buffer}).
     */
    boolean isExternal();
}