1 // $Id: IConnectHandler.java 1324 2007-06-13 06:06:02Z grro $ 2 /* 3 * Copyright (c) xsocket.org, 2006 - 2007. All rights reserved. 4 * 5 * This library is free software; you can redistribute it and/or 6 * modify it under the terms of the GNU Lesser General Public 7 * License as published by the Free Software Foundation; either 8 * version 2.1 of the License, or (at your option) any later version. 9 * 10 * This library is distributed in the hope that it will be useful, 11 * but WITHOUT ANY WARRANTY; without even the implied warranty of 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 13 * Lesser General Public License for more details. 14 * 15 * You should have received a copy of the GNU Lesser General Public 16 * License along with this library; if not, write to the Free Software 17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 18 * 19 * Please refer to the LGPL license at: http://www.gnu.org/copyleft/lesser.txt 20 * The latest copy of this software may be found on http://www.xsocket.org/ 21 */ 22 package org.xsocket.stream; 23 24 import java.io.IOException; 25 26 27 28 29 30 31 32 33 34 /** 35 * Handles new incomming connections. <br><br> 36 * 37 * E.g. 38 * <pre> 39 * public final class BlackIpHandler implements IConnectHandler { 40 * ... 41 * public boolean onConnect(INonBlockingConnection connection) throws IOException { 42 * connection.setAutoflush(false); 43 * connection.setFlushmode(FlushMode.ASYNC); 44 * 45 * ... 46 * return true; 47 * } 48 * } 49 * 50 * @author grro@xsocket.org 51 */ 52 public interface IConnectHandler extends IHandler { 53 54 55 /** 56 * handles a new incomming connection 57 * 58 * @return true for positive result of handling, false for negative result of handling 59 * @throws IOException If some other I/O error occurs. Throwing this exception causes that the underlying connection will be closed. 60 */ 61 public boolean onConnect(INonBlockingConnection connection) throws IOException; 62 } 63