tcprawmessenger.java

High performance DB query

/*
 * @(#)$Id: TCPRawMessenger.java,v 1.4 2004/07/02 23:59:22 huebsch Exp $
 *
 * Copyright (c) 2001-2004 Regents of the University of California.
 * All rights reserved.
 *
 * This file is distributed under the terms in the attached BERKELEY-LICENSE
 * file. If you do not find these files, copies can be found by writing to:
 * Computer Science Division, Database Group, Universite of California,
 * 617 Soda Hall #1776, Berkeley, CA 94720-1776. Attention: Berkeley License
 *
 * Copyright (c) 2003-2004 Intel Corporation. All rights reserved.
 *
 * This file is distributed under the terms in the attached INTEL-LICENSE file.
 * If you do not find these files, copies can be found by writing to:
 * Intel Research Berkeley, 2150 Shattuck Avenue, Suite 1300,
 * Berkeley, CA, 94704.  Attention:  Intel License Inquiry.
 */


package services.network.tcpraw;

import java.net.InetSocketAddress;
import java.nio.ByteBuffer;

/**
 * Interface TCPRawMessenger
 *
 */
public interface TCPRawMessenger {

    /**
     * Method convertStringToBuffer
     *
     * @param string
     * @return
     */
    public ByteBuffer convertStringToBuffer(String string);

    /**
     * Method listen
     *
     * @param portNumber
     * @param client
     * @return
     */
    public boolean listen(Integer portNumber, TCPRawClient client);

    /**
     * Stop listening on a specific port
     *
     * @param portNumber
     */
    public void release(Integer portNumber);

    /**
     * Create a TCP connection and begin the process of connecting,
     * involves sending data data. The connection can be used with
     * send immediately, although data will wait till connection is
     * established
     *
     * @param destination
     * @param client
     * @return
     */
    public TCPRawConnection connect(InetSocketAddress destination,
                                    TCPRawClient client);

    /**
     * Destroys the connection, making ineligible for future use
     *
     * @param connection
     */
    public void disconnect(TCPRawConnection connection);
}