X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=src%2Fjexer%2Fnet%2FTelnetServerSocket.java;h=3c5b3077ba591ff706b564ed3dd5955675e61240;hb=12b90437b5f22c2ae6e9b9b14c3b62b60f6143e5;hp=ed3975cad633ebd9027fe17cdd87e0f65f12b8fa;hpb=ea91242c4516c212e07f06c1a7d44ab912018e36;p=fanfix.git diff --git a/src/jexer/net/TelnetServerSocket.java b/src/jexer/net/TelnetServerSocket.java index ed3975c..3c5b307 100644 --- a/src/jexer/net/TelnetServerSocket.java +++ b/src/jexer/net/TelnetServerSocket.java @@ -1,51 +1,57 @@ -/** +/* * Jexer - Java Text User Interface * - * License: LGPLv3 or later - * - * This module is licensed under the GNU Lesser General Public License - * Version 3. Please see the file "COPYING" in this directory for more - * information about the GNU Lesser General Public License Version 3. + * The MIT License (MIT) * - * Copyright (C) 2015 Kevin Lamonte + * Copyright (C) 2019 Kevin Lamonte * - * This program is free software; you can redistribute it and/or - * modify it under the terms of the GNU Lesser General Public License - * as published by the Free Software Foundation; either version 3 of - * the License, or (at your option) any later version. + * Permission is hereby granted, free of charge, to any person obtaining a + * copy of this software and associated documentation files (the "Software"), + * to deal in the Software without restriction, including without limitation + * the rights to use, copy, modify, merge, publish, distribute, sublicense, + * and/or sell copies of the Software, and to permit persons to whom the + * Software is furnished to do so, subject to the following conditions: * - * This program is distributed in the hope that it will be useful, but - * WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - * General Public License for more details. + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. * - * You should have received a copy of the GNU Lesser General Public - * License along with this program; if not, see - * http://www.gnu.org/licenses/, or write to the Free Software - * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA - * 02110-1301 USA + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL + * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER + * DEALINGS IN THE SOFTWARE. * * @author Kevin Lamonte [kevin.lamonte@gmail.com] * @version 1 */ package jexer.net; -import java.io.InputStream; import java.io.IOException; -import java.io.OutputStream; import java.net.InetAddress; import java.net.ServerSocket; import java.net.Socket; +import java.net.SocketException; /** * This class provides a ServerSocket that return TelnetSocket's in accept(). */ -public final class TelnetServerSocket extends ServerSocket { +public class TelnetServerSocket extends ServerSocket { + + // ------------------------------------------------------------------------ + // Variables -------------------------------------------------------------- + // ------------------------------------------------------------------------ + - // ServerSocket interface ------------------------------------------------- + // ------------------------------------------------------------------------ + // Constructors ----------------------------------------------------------- + // ------------------------------------------------------------------------ /** * Creates an unbound server socket. + * + * @throws IOException if an I/O error occurs */ public TelnetServerSocket() throws IOException { super(); @@ -53,6 +59,10 @@ public final class TelnetServerSocket extends ServerSocket { /** * Creates a server socket, bound to the specified port. + * + * @param port the port number, or 0 to use a port number that is + * automatically allocated. + * @throws IOException if an I/O error occurs */ public TelnetServerSocket(final int port) throws IOException { super(port); @@ -61,6 +71,12 @@ public final class TelnetServerSocket extends ServerSocket { /** * Creates a server socket and binds it to the specified local port * number, with the specified backlog. + * + * @param port the port number, or 0 to use a port number that is + * automatically allocated. + * @param backlog requested maximum length of the queue of incoming + * connections. + * @throws IOException if an I/O error occurs */ public TelnetServerSocket(final int port, final int backlog) throws IOException { @@ -71,6 +87,13 @@ public final class TelnetServerSocket extends ServerSocket { /** * Create a server with the specified port, listen backlog, and local IP * address to bind to. + * + * @param port the port number, or 0 to use a port number that is + * automatically allocated. + * @param backlog requested maximum length of the queue of incoming + * connections. + * @param bindAddr the local InetAddress the server will bind to + * @throws IOException if an I/O error occurs */ public TelnetServerSocket(final int port, final int backlog, final InetAddress bindAddr) throws IOException { @@ -78,14 +101,29 @@ public final class TelnetServerSocket extends ServerSocket { super(port, backlog, bindAddr); } + // ------------------------------------------------------------------------ + // ServerSocket ----------------------------------------------------------- + // ------------------------------------------------------------------------ + /** * Listens for a connection to be made to this socket and accepts it. The * method blocks until a connection is made. + * + * @return the new Socket + * @throws IOException if an I/O error occurs */ @Override public Socket accept() throws IOException { - Socket socket = super.accept(); - return new TelnetSocket(socket); + if (isClosed()) { + throw new SocketException("Socket is closed"); + } + if (!isBound()) { + throw new SocketException("Socket is not bound"); + } + + Socket socket = new TelnetSocket(); + implAccept(socket); + return socket; } - + }