1 /* 2 * Copyright (c) 2011 jMonkeyEngine 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions are 7 * met: 8 * 9 * * Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 12 * * Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 16 * * Neither the name of 'jMonkeyEngine' nor the names of its contributors 17 * may be used to endorse or promote products derived from this software 18 * without specific prior written permission. 19 * 20 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 21 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 22 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 23 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 24 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 25 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 26 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 27 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 28 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 29 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 30 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 31 */ 32 33 package com.jme3.network; 34 35 import java.io.IOException; 36 import java.net.InetAddress; 37 38 /** 39 * A Client whose network connection information can 40 * be provided post-creation. The actual connection stack 41 * will be setup the same as if Network.connectToServer 42 * had been called. 43 * 44 * @version $Revision: 8979 $ 45 * @author Paul Speed 46 */ 47 public interface NetworkClient extends Client 48 { 49 /** 50 * Connects this client to the specified remote server and ports. 51 */ connectToServer( String host, int port, int remoteUdpPort )52 public void connectToServer( String host, int port, int remoteUdpPort ) throws IOException; 53 54 /** 55 * Connects this client to the specified remote server and ports. 56 * 57 * @param address The hosts internet address. 58 * @param port The remote TCP port on the server to which this client should 59 * send reliable messages. 60 * @param remoteUdpPort The remote UDP port on the server to which this client should 61 * send 'fast'/unreliable messages. Set to -1 if 'fast' traffic should 62 * go over TCP. This will completely disable UDP traffic for this 63 * client. 64 */ connectToServer( InetAddress address, int port, int remoteUdpPort )65 public void connectToServer( InetAddress address, int port, int remoteUdpPort ) throws IOException; 66 67 } 68