tcpconnectionhandlerlistener.java

J2ME MIDP_Example_Applications

// Copyright 2003 Nokia Corporation.
//
// THIS SOURCE CODE IS PROVIDED 'AS IS', WITH NO WARRANTIES WHATSOEVER,
// EXPRESS OR IMPLIED, INCLUDING ANY WARRANTY OF MERCHANTABILITY, FITNESS
// FOR ANY PARTICULAR PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE
// OR TRADE PRACTICE, RELATING TO THE SOURCE CODE OR ANY WARRANTY OTHERWISE
// ARISING OUT OF ANY PROPOSAL, SPECIFICATION, OR SAMPLE AND WITH NO
// OBLIGATION OF NOKIA TO PROVIDE THE LICENSEE WITH ANY MAINTENANCE OR
// SUPPORT. FURTHERMORE, NOKIA MAKES NO WARRANTY THAT EXERCISE OF THE
// RIGHTS GRANTED HEREUNDER DOES NOT INFRINGE OR MAY NOT CAUSE INFRINGEMENT
// OF ANY PATENT OR OTHER INTELLECTUAL PROPERTY RIGHTS OWNED OR CONTROLLED
// BY THIRD PARTIES
//
// Furthermore, information provided in this source code is preliminary,
// and may be changed substantially prior to final release. Nokia Corporation
// retains the right to make changes to this source code at
// any time, without notice. This source code is provided for informational
// purposes only.
//
// Nokia and Nokia Connecting People are registered trademarks of Nokia
// Corporation.
// Java and all Java-based marks are trademarks or registered trademarks of
// Sun Microsystems, Inc.
// Other product and company names mentioned herein may be trademarks or
// trade names of their respective owners.
//
// A non-exclusive, non-transferable, worldwide, limited license is hereby
// granted to the Licensee to download, print, reproduce and modify the
// source code. The licensee has the right to market, sell, distribute and
// make available the source code in original or modified form only when
// incorporated into the programs developed by the Licensee. No other
// license, express or implied, by estoppel or otherwise, to any other
// intellectual property rights is granted herein.


// unnamed package

interface TCPConnectionHandlerListener
{
    // indicates that a socket connection has been opened from a remote peer
    // (remote address and port); 'handler' is used to send messages to
    // the remote peer
    void handleConnectionOpen(TCPConnectionHandler handler,
                              String remoteAddress,
                              int remotePort);


    // indicates that a connection to the remote entity failed
    void handleConnectionOpenError(TCPConnectionHandler handler,
                                   String remoteAddress,
                                   int remotePort);


    // indicate that a message was received from a particular connection;
    // 'handler' is used to send messages to the remote peer
    void handleConnectionMessage(TCPConnectionHandler handler,
                                 String remoteAddress,
                                 int remotePort,
                                 byte[] messageBytes);


    // indicates that the connection from remote peer was just closed;
    // it tells to the listener that 'handler' should no longer be used
    void handleConnectionClose(TCPConnectionHandler handler,
                               String remoteAddress,
                               int remotePort);


    // ideally this method should be in a seperate interface,
    // but it is convienent to put it here
    void handleError(String errorMessage);
}